3x-ui/internal/xray
MHSanaei 6843583706 fix(xray): fall back to the userspace TUN where kernel TUN cannot be set up
The core puts a WireGuard outbound on a kernel TUN whenever it holds
CAP_NET_ADMIN and noKernelTun is unset, the default for a hand-added outbound.
That needs a writable /proc/sys/net and /dev/net/tun, and where either is
missing the core does not fall back: it aborts the whole start. The shipped
docker-compose grants NET_ADMIN for fail2ban while Docker keeps /proc/sys
read-only and exposes no /dev/net/tun, so one such outbound took every inbound
down with the #6796 error; any unit or drop-in that keeps /proc/sys/net
read-only did the same.

xray.KernelTunBlocked probes once, from the panel process whose capabilities
and mounts the core inherits, whether the core would pick a kernel TUN it
cannot create. GetXrayConfig then sets noKernelTun on every WireGuard outbound,
so cold starts and hot reloads both get it. Hosts that can create the device
keep the kernel TUN.

Verified with the pinned core's "run -test" on the generated config, in a
NET_ADMIN container as docker-compose runs it and under systemd 257: the
container and the v3.10.0 unit report blocked and pass on gVisor, the container
fails with the #6796 error when the GetXrayConfig hook is bypassed, and the new
unit keeps the kernel TUN.

Refs #6796
2026-10-12 17:52:45 +02:00
..
dnsconf feat(sub): let the panel set the JSON subscription DNS servers (#6485) 2026-09-13 11:51:56 +02:00
geodata chore(build): bump Go toolchain to 1.27.0 2026-08-23 21:57:03 +02:00
api.go fix(node): apply a pushed inbound's client changes in place instead of rebuilding it 2026-10-12 16:22:30 +02:00
api_e2e_test.go feat(online): use xray online-stats API for onlines and access-log-free IP limit 2026-06-11 19:42:03 +02:00
api_masque_test.go style: trim MASQUE and XDRIVE comment blocks to two lines 2026-10-11 17:00:52 +02:00
api_reverse_test.go fix(clients): keep a vless reverse client's handler across a re-add (#6558) 2026-09-15 18:00:54 +03:00
api_routing_test.go feat(xray): update xray-core to v26.10.10 and adapt panel 2026-10-11 07:55:12 +02:00
api_shadowsocks_test.go fix(xray): stop the runtime user API from crashing xray-core 2026-07-28 13:52:10 +02:00
api_test.go Repo-wide self-correcting audit: 54 verified bug fixes (#5970) 2026-07-17 00:33:06 +02:00
api_traffic_test.go fix(xray): stop the runtime user API from crashing xray-core 2026-07-28 13:52:10 +02:00
api_users_e2e_test.go fix(node): apply a pushed inbound's client changes in place instead of rebuilding it 2026-10-12 16:22:30 +02:00
api_wireguard_test.go feat(wireguard): multi-client support 2026-06-28 00:44:38 +02:00
client_traffic.go feat(tuic): implement native in-process Go TUIC v5 server (#6577) 2026-10-03 02:56:02 +02:00
config.go feat(xray): update xray-core to v26.7.11 and adapt panel 2026-07-12 00:30:47 +02:00
config_test.go refactor: focused service files, leaf subpackages, and an internal/ layout (#5167) 2026-06-10 15:19:22 +02:00
hot_diff.go fix(node): apply a pushed inbound's client changes in place instead of rebuilding it 2026-10-12 16:22:30 +02:00
hot_diff_drops_users_test.go fix(xray): hot-apply Hysteria client changes without replacing the inbound (#6606) 2026-09-26 22:03:43 +02:00
hot_diff_test.go feat(xray): add the MASQUE protocol and transport 2026-10-11 10:28:49 +02:00
inbound.go refactor: focused service files, leaf subpackages, and an internal/ layout (#5167) 2026-06-10 15:19:22 +02:00
inbound_test.go refactor: focused service files, leaf subpackages, and an internal/ layout (#5167) 2026-06-10 15:19:22 +02:00
kernel_tun_linux.go fix(xray): fall back to the userspace TUN where kernel TUN cannot be set up 2026-10-12 17:52:45 +02:00
kernel_tun_other.go fix(xray): fall back to the userspace TUN where kernel TUN cannot be set up 2026-10-12 17:52:45 +02:00
log_writer.go fix(xray): guard log-writer race and bound handler gRPC deadlines (#5442) 2026-06-20 18:10:18 +02:00
log_writer_race_test.go Use efficient APIs and simplify loops 2026-06-23 14:12:28 +02:00
mutation_audit_test.go refactor(frontend): move form-item hints from extra to tooltip 2026-06-17 17:24:16 +02:00
online_test.go feat(inbounds): improve multi-node online attribution (#6164) 2026-08-15 17:40:35 +02:00
outbound_validation_test.go feat(xray): update xray-core to v26.9.30 and adapt panel 2026-10-02 13:54:39 +02:00
pia_wireguard_outbound_test.go feat(pia): add PIA login-and-add WireGuard outbounds (#6272) 2026-08-22 23:11:06 +02:00
process.go Write config.json after a hot apply (#6686) 2026-10-03 01:23:25 +02:00
process_other.go refactor: focused service files, leaf subpackages, and an internal/ layout (#5167) 2026-06-10 15:19:22 +02:00
process_persist_test.go Write config.json after a hot apply (#6686) 2026-10-03 01:23:25 +02:00
process_race_test.go Repo-wide self-correcting audit: 54 verified bug fixes (#5970) 2026-07-17 00:33:06 +02:00
process_test.go style: adopt golangci-lint v2 and resolve all findings 2026-06-27 15:42:22 +02:00
process_version_test.go fix(xray): synchronize lifecycle state (#6138) 2026-07-29 21:00:29 +02:00
process_windows.go style: adopt golangci-lint v2 and resolve all findings 2026-06-27 15:42:22 +02:00
shadowsocks2022.go fix(inbounds): refuse 2022-blake3-chacha20-poly1305 on shadowsocks inbounds 2026-10-11 21:20:07 +02:00
traffic.go docs(api): align OpenAPI with runtime contracts (#6409) 2026-09-04 15:23:41 +02:00