25
0

将校园 VPN 运行在容器中:基于 WSL、Docker 与统一客户端的接入方案

2026-11-01
2026-11-02

本文记录在个人电脑上接入学校 VPN 的过程。文中的“统一客户端”指电脑上已有的网络接入与分流工具,支持规则分流、虚拟网卡(TUN)和 SOCKS5 节点。本文只讨论它与学校 VPN 的配合方式,不涉及其他用途。文中出现的校内地址仅用于说明流量走向,实际部署应以学校的授权范围和要求为准。

背景

访问课程平台、校内文件服务和实验虚拟机都需要连接学校 VPN。通常的做法是在每台电脑上安装学校提供的深信服客户端。登录本身并不复杂,问题在于该客户端会直接修改 Windows 的路由、DNS 和虚拟网卡配置。我遇到过客户端退出后网络状态未能恢复的情况,也遇到过它与电脑原有网络设置相互干扰的情况;更换设备后,安装、登录和排查又要重复一遍。

因此,我希望把深信服客户端与 Windows 网络环境隔离开,并交由电脑上已有的统一客户端集中管理。认证仍由官方客户端完成,校内域名和网段则由统一客户端识别、分流和转发。这样,日常使用时无需在各个应用中切换网络设置,深信服客户端也不再直接管理 Windows 的网卡。

具体目标如下:

  • 学校要求的扫码认证照常完成;
  • 校内资源经 VPN 访问,其他网站仍按原有规则访问;
  • Windows 重启后,只需启动 WSL 并打开图形界面扫码,无需重装客户端或修改路由。

这里所说的“无感访问”指认证完成后的业务访问,并非免登录。

需要说明的是,该方案没有绕过学校认证。账号登录和扫码均由本人在官方客户端中完成,学校侧的访问控制依然有效。

方案选择

在 Windows 上直接安装官方客户端步骤最少,但无法解决网卡和路由相互干扰的问题。在 WSL 中单独安装 Linux 客户端可以隔离部分影响,但图形界面、依赖和流量转发都需要自行处理。

最终我采用了开源项目 docker-easyconnect/docker-easyconnect 的 aTrust 容器方案。该项目将深信服 Linux 客户端封装在 Docker 中,对外提供 SOCKS5、HTTP 代理和图形操作入口。它是社区项目,并非深信服官方产品。本文使用其中的 hagb/docker-atrust 镜像,连接的是 aTrust,而不是项目中的 EasyConnect CLI 镜像。

选型时,我主要考虑故障是否便于定位、影响范围是否可控,能够登录只是基本要求:

方案优点在本场景中的限制
每台 Windows 电脑安装深信服客户端安装后即可使用,也是最常见的支持方式客户端直接修改宿主机网络,更换设备需重新配置;校内访问难以纳入已有分流规则
在 WSL 中直接安装 Linux 客户端与 Windows 网络栈部分隔离图形桌面、依赖、后台进程和共享代理均需自行处理
WSL + Docker 运行 aTrust客户端与宿主机隔离,自带图形入口和代理出口仍需处理 WSL 网络、认证状态、DNS 和本地分流

最终选择第三种:WSL Debian 运行 Docker,Windows 通过本机回环端口访问容器。网络并未因此变得简单,但复杂性被拆分到几个层次中,每一层都可以单独检查。

下图展示整体结构,以访问 10.196.0.20 为例。实线为业务流量,虚线为扫码认证时的人工操作路径:

学校网络
WSL Debian
Windows 宿主机
本机 127.0.0.1:1080
路由命中 utun7
noVNC 127.0.0.1:8080 扫码认证
学校 VPN 网关
校内应用与虚拟机
Docker Engine
aTrust 容器
SOCKS5 + utun7
浏览器与其他应用
统一客户端
规则分流 + 虚拟网卡

图中的 127.0.0.1 是 Windows 本机端口,经 WSL 的本机端口转发连接到 Docker 发布的端口。WSL 本身也有虚拟网卡和地址,但该地址在重启后可能变化,因此没有写入统一客户端的节点配置。容器内部还有独立的 eth0,登录后会出现 utun7。这三处“本机”分属不同的网络命名空间,排查时需要加以区分:

aTrust 容器网络命名空间
WSL Debian 网络命名空间
Windows 网络命名空间
WSL 本机端口转发
Docker 端口映射
默认路由出站,回到 Windows
eth0
Docker 网桥,默认出口
utun7
登录后由 aTrust 创建
WSL 虚拟网卡
地址重启后可能变化,不写入配置
Docker 发布端口
-p 127.0.0.1:1080:1080
127.0.0.1:1080 / 8080
浏览器和统一客户端连接的端口
统一客户端 TUN 虚拟网卡

整个方案包含两条路径。认证路径需要人工操作:在浏览器中打开 http://127.0.0.1:8080/ 的 noVNC 页面,于 aTrust 界面中连接学校网关并扫码。

学校 VPN 网关aTrust 客户端(容器内)noVNC 127.0.0.1:8080浏览器学校 VPN 网关aTrust 客户端(容器内)noVNC 127.0.0.1:8080浏览器用户打开 noVNC 页面1输入 VNC 密码2显示 aTrust 图形界面3填写网关地址并发起连接4建立控制连接(须直连)5返回登录二维码6手机扫码确认身份7认证通过,下发校内路由8创建 utun7 并写入路由表9用户

两个入口:系统代理和 TUN

Windows 应用进入统一客户端有两条不同路径。它们都可能经过同一个规则引擎,但入口条件不同,不能混为一谈:

入口常见应用规则引擎看到的特征典型结果
Windows 系统代理浏览器等遵守系统代理的应用请求先交给本机代理端口,通常不带 IN-TYPE,TUN按校园域名或 IP 网段规则送往容器 SOCKS5
TUN 虚拟网卡不使用应用层代理、直接建立 TCP 的应用连接被 TUN 捕获,带有 IN-TYPE,TUN按入口和目标继续匹配规则;授权 IP 网段应优先送往容器

同一台电脑上的浏览器和 vSphere Client 可能因此走不同链路。浏览器能打开校内网页,只能证明浏览器的系统代理路径可用,不能证明 vSphere 的 TUN 路径也可用。决定入口的首先是应用是否使用系统代理,不是目标本身是域名还是 IP;目标类型影响的是进入规则引擎后的匹配结果。

业务路径由统一客户端和容器共同完成:Windows 应用先通过系统代理或 TUN 进入统一客户端,规则决定是否选择 127.0.0.1:1080 的 SOCKS5;请求进入容器后,再由容器路由表决定经 utun7 还是 eth0 发出。

访问已确认授权的 10.196.0.0/23 时,正确链路是:

Windows 应用
  → 系统代理或 TUN
  → IP-CIDR 10.196.0.0/23
  → 容器 SOCKS5 127.0.0.1:1080
  → 容器路由 10.196.0.0/23 dev utun7
  → aTrust 封装后到学校 VPN 网关

这里的 IP-CIDR 规则是业务流量的入口规则,不是回环规则。只要容器确实存在对应的 utun7 路由,内层目标进入隧道后,aTrust 的外层目标会变成 VPN 网关,不会再次以原来的 10.196.x.x 目标命中同一条 IP 规则。

校内服务 10.196.0.20utun7 隧道容器 SOCKS5 :1080统一客户端浏览器校内服务 10.196.0.20utun7 隧道容器 SOCKS5 :1080统一客户端浏览器经系统代理请求校内地址1命中校园 VPN 规则2转发到 127.0.0.1:10803路由表命中 10.196.0.0/234经学校 VPN 网关到达5响应按原路返回6

如果应用不使用系统代理而直接建立 TCP,则入口改为 TUN。以 vSphere 访问 10.196.0.20 为例:

校内服务 10.196.0.20utun7 / aTrust容器 SOCKS5 :1080统一客户端规则统一客户端 TUNvSphere Client校内服务 10.196.0.20utun7 / aTrust容器 SOCKS5 :1080统一客户端规则统一客户端 TUNvSphere Client原生 TCP 连接1入口标记为 TUN2先匹配 10.196.0.0/233转发到 127.0.0.1:10804容器路由命中 utun75经学校 VPN 网关到达6响应按原路返回7

请求进入容器后经 utun7 还是 eth0 发出,由容器的路由表决定,无法仅凭域名规则推断。

容器的出口选择

这一判断发生在容器内部,即统一客户端已将请求交给 SOCKS5 之后。登录后,aTrust 在容器中创建 utun7,并下发部分校内网段的路由。目标 IP 命中这些路由时,Linux 将数据包交给 utun7;未命中时,按默认路由从 eth0 发出。

eth0 的出口经过 Docker 和 WSL,最终回到 Windows 网络,因此可能再次被统一客户端的 TUN 捕获。下图只说明容器如何选择网卡,不涉及统一客户端的防回环规则:

是,例如 10.196.0.20
否,例如 219.216.128.39
可能被
容器 SOCKS5 收到目标请求
目标 IP 命中容器 VPN 路由?
utun7 / aTrust 隧道
学校 VPN 网关
校内服务
eth0 / Docker / WSL 默认出口
Windows 网络路径
统一客户端 TUN 捕获

由此可见,流量会经过两次判断。第一次由容器路由表决定从 utun7 还是 eth0 发出;第二次发生在 eth0 出站的连接进入 Windows TUN 之后,由统一客户端的规则决定是否将其送回本机 SOCKS5。后文“代理回环”一节讨论的就是第二次判断引发的问题。

本机部署的关键配置

首先在 WSL Debian 中安装并启动 Docker,并通过 ls -l /dev/net/tun 确认 TUN 设备存在。Windows 上的统一客户端需要支持添加 SOCKS5 节点,并能按域名和 IP 网段分流。建议先单独启动容器,确认 VPN 本身可用后再接入统一客户端,以免同时排查两套网络。

容器需要 /dev/net/tun 和 NET_ADMIN 权限,否则无法创建 VPN 虚拟网卡。为避免将代理服务暴露给局域网,所有发布端口均绑定到 127.0.0.1。

执行启动命令前,应先在当前 shell 中设置 VNC_PASSWORD,不要将真实密码写入公开文章或脚本仓库。根据项目文档,VNC 密码最多为 8 个字符,超出部分无法原样用于 VNC 认证:

read -rsp 'VNC password (max 8 chars): ' VNC_PASSWORD
printf '\n'
docker run -d --name atrust --restart always \
  --device /dev/net/tun --cap-add NET_ADMIN \
  -e PASSWORD="$VNC_PASSWORD" \
  -e URLWIN=1 -e USE_NOVNC=1 -e VPN_TUN=utun7 \
  -v /root/.atrust-data:/root \
  -p 127.0.0.1:8080:8080 \
  -p 127.0.0.1:1080:1080 \
  -p 127.0.0.1:8888:8888 \
  -p 127.0.0.1:54631:54631 \
  --sysctl net.ipv4.conf.default.route_localnet=1 \
  hagb/docker-atrust:latest

该命令基于已有镜像创建容器,无需每次开机重新构建。--restart always 仅负责在 Docker 启动后拉起同一个容器。/root/.atrust-data 映射的是容器内的 /root,容器内其他路径不会因此持久化。

首次启动后,先进行基础检查:

docker ps --filter name=atrust
docker logs --tail 50 atrust
docker exec atrust ip link show utun7

utun7 存在仅表示客户端已创建虚拟网卡,并不能证明认证成功。扫码后还需检查学校是否下发了路由,例如本次环境中的 10.196.0.0/23 dev utun7:

docker exec atrust ip -4 route
docker exec atrust ip -4 route get 10.196.0.20

各端口用途如下:8080 为浏览器中的远程桌面,1080 为 SOCKS5,8888 为 HTTP 代理。54631 是 aTrust 的本地 Web 鉴权接口,并非登录页面,直接访问其根路径可能返回 Unsupport url。

学校网关地址在 aTrust 客户端中设置。我最初填写的是 https://vpn.neuedu.com/,连接后客户端实际保存的入口为 https://vpn.neuedu.com:4443,端口由服务端流程确定。

在统一客户端中,将 127.0.0.1:1080 添加为 SOCKS5 节点,并为校园流量单独建立选择组。节点和规则写在本地持久化的覆写配置中,而不是直接修改自动更新生成的配置,否则后续更新可能导致设置丢失。以下用类 YAML 写法说明最终配置的逻辑,具体字段需根据所用客户端调整:

# 示意:合并到已有配置,不能覆盖原有节点和规则
proxies:
  - name: 校园 VPN SOCKS5
    type: socks5
    server: 127.0.0.1
    port: 1080
    udp: false

proxy-groups:
  - name: 校园 VPN
    type: select
    proxies: [校园 VPN SOCKS5, DIRECT]

rules:
  # 第一层:VPN 网关直连,避免认证连接依赖自身
  - DOMAIN,vpn.neuedu.com,DIRECT
  # 第二层:已确认由 utun7 承载的授权私网,系统代理、TUN 两种入口都进入容器
  - IP-CIDR,10.196.0.0/23,校园 VPN,no-resolve
  # 第三层:域名类 TUN 回流不再送回本机 SOCKS5
  - AND,((IN-TYPE,TUN),(DOMAIN-SUFFIX,neuedu.com)),DIRECT
  - AND,((IN-TYPE,TUN),(DOMAIN-SUFFIX,neusoft.edu.cn)),DIRECT
  # 第四层:经系统代理进入的校园域名请求,送往容器
  - DOMAIN-SUFFIX,neuedu.com,校园 VPN
  - DOMAIN-SUFFIX,neusoft.edu.cn,校园 VPN

规则自上而下匹配,命中后即停止。四类规则的判断顺序如下:

是
否
是
否
是
否
是
否
一条连接进入统一客户端
目标是 VPN 网关
vpn.neuedu.com?
第一层:DIRECT
认证连接不依赖 VPN 自身
目标属于
10.196.0.0/23?
第二层:校园 VPN
发往 127.0.0.1:1080
入口是 TUN,
且目标属于校园域名?
第三层:DIRECT
域名回流不再送回容器
目标属于校园域名?
第四层:校园 VPN
发往 127.0.0.1:1080
继续匹配原有规则
普通网站不受影响

第一层使 VPN 网关本身直连。否则,用于建立 VPN 的控制连接可能被送入尚未建立的 VPN,形成自我依赖。

第二层是授权私网的业务入口。它必须排在域名类 TUN 例外之前,因为 vSphere 这类不使用系统代理的应用会从 TUN 进入;只要目标属于已确认的 10.196.0.0/23,就应送入容器,而不是直接出站。

第三层只处理域名类 TUN 回流。它不能证明连接来自容器,因为 IN-TYPE,TUN 只说明连接从 TUN 进入,并不区分容器回流和本地应用。这里保留它,是为了阻止那些经容器 eth0 默认出口发出的新域名连接再次选择同一个 SOCKS5。它不应扩大成授权私网 IP 的直连例外。

第四层处理经 Windows 系统代理进入的校园域名请求。域名和 IP 网段都需要配置:网页通常通过域名访问,而虚拟机、远程桌面和开发工具常直接连接私网 IP。10.196.0.0/23 是本次登录后实际观察到的授权路由,不能据此推断学校的全部私网地址都应经 VPN 访问。

规则按入口类型而非 WSL 的 IP 判断,原因是容器流量经 WSL 返回 Windows 后,统一客户端看到的源地址可能已变为虚拟网卡地址。IN-TYPE,TUN 判断的是该连接从哪个入口进入统一客户端,与 WSL 的动态 IP 无关。两类请求的处理结果对比如下:

请求进入统一客户端的方式首先命中的规则处理结果
浏览器经 Windows 系统代理进入校园域名或网段规则发往 127.0.0.1:1080 的容器 SOCKS5
vSphere 等应用经 TUN 进入,目标在 10.196.0.0/23IP-CIDR 网段规则发往 127.0.0.1:1080,容器经 utun7 出站
容器经 eth0 出站,被 Windows TUN 捕获后再次进入,目标是校园域名IN-TYPE,TUN 域名直连例外不选择本机 SOCKS5,回环在此终止

因此,要使浏览器请求按第一行处理,必须在 Windows 上开启统一客户端的系统代理,并从系统代理绕过列表中移除 10.*。如果浏览器访问私网 IP 时绕过系统代理,它会仅经 TUN 进入;在当前规则中,由于 IP-CIDR 规则排在前面,仍会进入容器。是否能访问最终取决于容器是否存在对应的 utun7 路由。

否,已移除
是,默认设置
浏览器访问
https://10.196.0.20/
系统代理绕过列表
包含 10.* ?
经系统代理进入统一客户端
命中校园域名规则
进入容器 SOCKS5,访问成功
绕过系统代理
改由 TUN 捕获
当前规则:TUN 进入 IP-CIDR
进入容器 SOCKS5

这组域名例外是本机双入口方案特有的防回环措施,并非通用的校园 VPN 配置。系统代理入口的校园请求进入 SOCKS5;已确认有 utun7 路由的授权 IP 则无论从系统代理还是 TUN 进入,都先命中 IP-CIDR 规则;容器自身经 eth0 出站的域名连接再次进入 TUN 后,才由域名直连例外终止回环。若某个私网目标没有对应的容器 VPN 路由,不能仅凭“它属于校园地址”判断不会回环,必须重新检查 ip route 和实际命中记录。

部署中遇到的问题

启动日志中的报错不一定表示失败

最初看到 ipv4: FIB table does not exist 和 Missing goto target for action goto 时,我以为容器没有启动成功。项目维护者在相关 Issue 中说明,前一类输出可能来自启动脚本的预期探测。

判断容器是否可用,应依次检查容器状态、VNC 是否启动、utun7 是否创建,以及登录后是否出现校内路由。此外,设置 VPN_TUN=utun7 可以让启动时的路由检测明确使用 aTrust 网卡。

端口无法打开页面:端口用途理解有误

8888 是 HTTP 代理,不是网站;54631 是认证接口,也不是管理页面。在未安装 VNC 客户端的情况下,可以开启 noVNC,通过 http://127.0.0.1:8080/ 操作 aTrust 图形界面。

登录成功但无法访问内网

本次最关键的冲突发生在 DNS 和路由层面。统一客户端的 Fake-IP 使用 198.18.0.0/16 网段,aTrust 登录后也接管了相关路由。校内域名一度被解析为 198.18.* 的虚拟地址,导致容器与 VPN 网关之间的 TLS 连接持续报错。

问题是通过以下几项观察定位的:

  • 在容器中查询 vpn.neuedu.com,得到的是 198.18.* 地址;
  • 容器路由表将该网段指向 utun7;
  • aTrust 核心日志每隔几秒输出一次 SSL connect error。

综合来看,与网关的连接本应在认证之前建立,却被送入了认证完成后才能正常工作的路径,依赖顺序发生了颠倒。修复前后的解析与连接过程对比如下:

学校 VPN 网关容器路由表DNS 解析(统一客户端 Fake-IP)aTrust(容器内)学校 VPN 网关容器路由表DNS 解析(统一客户端 Fake-IP)aTrust(容器内)修复前修复后:校园域名排除 Fake-IP,网关直连查询 vpn.neuedu.com198.18.x.x(Fake-IP 地址)连接 198.18.x.x下一跳 utun7(隧道尚未认证)TLS 握手失败,日志反复出现 SSL connect error查询 vpn.neuedu.com网关真实地址连接真实地址下一跳 eth0TLS 握手成功,进入扫码认证

解决方法是让学校相关域名不使用 Fake-IP,并使 VPN 网关直连。排除之后重新解析,网关恢复为真实地址,TLS 报错随之停止,经代理访问校内站点也能正常返回。由此可见,DNS 返回的地址会直接影响流量经由哪张网卡发出。

代理回环:容器的出站流量被送回容器本身

问题:容器出站连接再次命中代理规则

这是整个部署中最典型、也最容易被忽视的问题。

最初,我在统一客户端中只添加了“校内域名走校园 VPN SOCKS5”的规则。浏览器发出的请求处理正确:先进入统一客户端,再转发到 Docker 容器发布的 127.0.0.1:1080。问题在于,容器处理该请求时,还需要向外建立新的 TCP 连接。容器并非与 Windows 完全隔离的远程服务器,其 eth0 默认出口经过 Docker 和 WSL,最终仍回到 Windows 的网络路径。与此同时,统一客户端的虚拟网卡一直在接管这条路径上的流量。

以访问 disk.neusoft.edu.cn 为例:容器将其解析为 219.216.128.39,执行 ip route get 219.216.128.39 显示下一跳是容器 eth0 的默认路由,而不是 VPN 网卡 utun7。该连接经 WSL 回到 Windows 后,被统一客户端识别为校内域名,命中“走校园 VPN SOCKS5”的规则,再次被送往同一个本机容器。进入容器后又重复相同的过程,由此形成回环:

校园规则
目标连接走 eth0
被 Windows 虚拟网卡接管
再次命中校园规则
浏览器请求校内站点
统一客户端
系统代理入口
127.0.0.1:1080
Docker SOCKS5
Docker / WSL 出站
统一客户端
TUN 入口

绑定 127.0.0.1 只能限制哪些程序可以连接代理端口,无法阻止容器的出站流量再次被 Windows 虚拟网卡捕获。正因为节点位于本机,错误的规则才会指向节点自身,所以不能将本机回环地址视为防回环机制。

故障发生时,统一客户端的连接面板中出现了大量指向 disk.neusoft.edu.cn 的重复连接,目标连接始终未能建立,浏览器最终显示超时。如果只看到容器仍在运行、SOCKS5 端口可以握手,很容易误判服务正常。

修复:区分两次进入统一客户端的流量

修复只涉及一处改动:第二次进入统一客户端的连接,不能再选择同一个 SOCKS5 节点。

浏览器发出的原始请求与容器发起的目标连接是两条独立的连接,而不是同一条 TCP 连接在网卡之间循环。规则引擎会分别处理它们,因此可以按入口类型给出不同的结果。仍以 disk.neusoft.edu.cn 为例:

  1. 浏览器经 Windows 系统代理进入统一客户端。该请求不带 IN-TYPE,TUN 标记,跳过域名类 TUN 直连例外,命中 DOMAIN-SUFFIX,neusoft.edu.cn,校园 VPN,首次进入容器 SOCKS5。
  2. 容器解析目标地址,并通过 eth0 建立新连接。该连接经 WSL 回到 Windows,被虚拟网卡捕获,第二次进入统一客户端,此时入口类型为 TUN。
  3. 按原有规则,该连接会再次命中校园域名规则,被送回 127.0.0.1:1080,并从第 2 步开始重复。修复后,排在前面的 AND,((IN-TYPE,TUN),(DOMAIN-SUFFIX,neusoft.edu.cn)),DIRECT 优先命中,规则处理到此结束,连接不再返回 SOCKS5,回环由此中断。

换言之,规则从“校园域名一律交给容器”调整为“经系统代理进入的校园请求交给容器,已从 TUN 回流的连接不再交给容器”。此外,VPN 网关单独设置一条最高优先级的直连规则,防止认证所用的控制连接依赖尚未建立的 VPN。

修复后的流量如下图所示,仍以 disk.neusoft.edu.cn 为例。图中的两个“统一客户端”是同一程序的两次处理,而非安装了两个客户端:第一次按系统代理规则送入 SOCKS5,第二次识别为 TUN 回流后直连出站,不再返回容器。

浏览器使用系统代理
发送到本机 1080 端口
该连接经 eth0、WSL 出站,被 TUN 捕获
直接出站
浏览器打开校园网页
① 统一客户端第一次处理
入口:系统代理
决定:使用校园 VPN SOCKS5 节点
本机 Docker 容器
收到请求,向目标站点新建连接
② 同一个统一客户端第二次处理
入口:TUN 虚拟网卡
优先命中 DIRECT:不再转回容器
向目标站点发起连接
循环到此结束

与前面的问题图对比:修复前,第 ② 步再次选择校园 SOCKS5,箭头返回容器;修复后,第 ② 步优先命中 TUN 直连例外,箭头指向目标站点。改变的仅是这一次规则选择,虚拟网卡、VPN 和目标地址均保持不变。此处的 DIRECT 是统一客户端的直接出站动作,不会将请求交回校园 SOCKS5 规则。

该图只说明如何终止回环,容器内业务数据包的出口选择见前文“容器的出口选择”一节。防回环规则只能保证连接不再递归,目标能否访问仍取决于认证、授权和网络可达性。

还需说明的是,本方案并未将“从 TUN 进入”作为“来自容器”的身份依据,而是利用了当前配置下浏览器与容器使用不同入口这一事实。一个完全不使用系统代理、仅被 TUN 捕获、且访问校园域名的 Windows 程序,同样会被域名直连例外放行,未必能访问校内资源;访问已确认授权 IP 的程序则先命中 IP-CIDR 规则。若要覆盖更多域名类 TUN 程序,需要进一步区分流量来源。

验证分两步进行。首先用浏览器访问校内域名,在统一客户端的连接记录中确认其路径为“系统代理入口 → 校园 VPN SOCKS5 节点”;然后查看容器出站对应的新记录,确认其路径为“TUN 入口 → DIRECT”,且未再出现“校园 VPN SOCKS5”。同时,同一域名的连接数应停止异常增长,请求也不再因回环而超时。

最后再确认页面能否正常使用。若回环已消除但仍无法访问,应继续检查 aTrust 的授权路由和目标服务本身,而不应为了打开页面而删除防回环例外。

重启后再次失效:系统代理绕过列表(旧版规则下的记录)

Windows 系统代理默认可能绕过 10.* 等私网地址。绕过后,浏览器不再走“系统代理入口”,而可能改由 TUN 捕获。按照当前规则,只要 TUN 正常工作且容器存在 10.196.0.0/23 dev utun7,该 IP 仍会先命中 IP-CIDR 规则并进入容器;因此“绕过系统代理”与“必然回到直连”不能混为一谈。若 TUN 未开启、未捕获该连接,或授权路由不存在,绕过系统代理才会导致访问失败。

当时的旧版规则把 TUN 进入的 10.196.0.0/23 也设成了 DIRECT,因此浏览器一旦绕过系统代理,就会只经 TUN 进入并被放行,访问失败。当前规则已将 IP-CIDR 规则提前到域名类 TUN 例外之前;在当前配置下,绕过系统代理并不必然失败,但会改变入口,仍建议关闭 10.* 的系统代理绕过,以便浏览器稳定走“系统代理 → 容器 SOCKS5”这条可观察路径。该设置必须在重启后再次验证,单次 curl --proxy 成功并不能证明浏览器实际使用了系统代理。

浏览器统一客户端Windows 代理设置(注册表)浏览器统一客户端Windows 代理设置(注册表)恢复正常用户手动删除绕过项 10.*访问 10.196.0.20,经系统代理进入客户端或电脑重启写回默认绕过列表(含 10.*)再次绕过系统代理,连接超时在客户端设置中关闭“始终使用默认绕过”,移除 10.*此后每次启动都写入自定义列表重启后复测,仍经系统代理进入用户

当时的一组对照测试很有帮助:显式指定 127.0.0.1:7897 访问虚拟机时,HTTPS 连接可以建立;而同一台电脑上的 Edge 却报 ERR_CONNECTION_TIMED_OUT。这说明 VPN、SOCKS5 和统一客户端的分流功能本身正常,问题更可能在于浏览器请求没有进入统一客户端。据此检查 Windows 的代理绕过列表,才发现了 10.*。之后电脑重启、故障复现,也进一步证明该修改必须保存在统一客户端中,仅修改一次注册表是不够的。

连通后,校内虚拟机页面还可能提示 HTTPS 证书不受信任。这与网络超时属于不同问题:出现证书提示说明连接已到达服务器,应向学校确认服务地址和证书情况,而不应将关闭证书校验当作网络问题的解决方法。

容器自动启动不等于自动认证

WSL Debian 已启用 systemd,Docker 服务设置为开机启动,容器使用 --restart always。实测关闭并重新启动 Debian 后,Docker 和容器均能自动启动,noVNC 也可以访问。但扫码属于独立的身份认证步骤,无法由 Docker 的重启策略代替。从开机到可用的各个阶段如下,只有扫码一步需要人工完成:

启动 WSL Debian
systemd 自动拉起
restart always
noVNC 可访问
人工扫码
创建 utun7 并下发路由
WSL 启动
Docker 启动
容器运行
等待扫码认证
已认证
可访问校内资源
唯一的人工步骤

目前鉴权地址保存在容器的可写层中:同一容器重启后仍然保留,删除并重建容器则可能丢失。-v /root/.atrust-data:/root 只持久化了容器内的 /root,不能理解为整个 aTrust 安装目录都已持久化。如需频繁重建容器,应先明确客户端配置文件的位置和权限,再单独设计持久化挂载,避免覆盖整个镜像目录。

部署过程中还出现过核心服务反复退出、日志报 Could not bind: Address already in use 的情况。容器外层显示 Up、noVNC 能够返回页面,都不足以说明 aTrust 核心运行正常,还需检查 aTrustAgent 核心进程是否持续存在,以及登录后的路由是否稳定。当时的处理方式是清理容器运行残留并重新创建实例,镜像本身未做改动。这也说明,自动重启策略只能保证进程被拉起,不能保证应用逻辑正常。

分层排查

出现问题时,我按以下顺序逐层检查,每一步只回答一个问题:

层次检查方式能够说明的问题
WSL 与 Dockerdocker ps、docker logs容器是否运行,启动脚本是否报错
图形入口浏览器访问 http://127.0.0.1:8080/noVNC 是否可达;可达不代表 VPN 已登录
客户端与隧道docker exec atrust ip link show utun7 和 ip -4 route网卡是否建立,校内路由是否下发
代理节点分别从宿主机和 WSL 经 127.0.0.1:1080 访问校内站点SOCKS5 能否将请求送入隧道
规则与入口查看规则命中、连接链、Windows 系统代理及绕过列表浏览器请求是否到达正确节点
页面本身区分超时、HTTP 重定向和证书警告网络故障、待认证和证书问题需分开处理

按上表整理出的排查顺序如下,每个判断都对应一项具体检查:

否
是
否
是
否
是
否
是
302 跳转
证书警告
仍超时
校内页面无法访问
docker ps 显示
容器在运行?
查看 docker logs
检查 TUN 设备与 NET_ADMIN
ip -4 route 中有
经 utun7 的校内路由?
打开 noVNC 重新扫码
检查网关 DNS 是否为 Fake-IP
curl 经 socks5h://127.0.0.1:1080
能访问校内站点?
检查 aTrust 核心进程
与授权路由范围
浏览器请求出现在
“系统代理 → 校园 VPN”记录中?
检查系统代理开关
与绕过列表中的 10.*
页面返回什么?
网络已通
完成目标应用登录
已到达服务器
向学校确认证书
检查是否出现回环
及目标服务本身

例如,可以使用 curl --proxy socks5h://127.0.0.1:1080 -I https://校内站点/ 直接测试 SOCKS5。其中 socks5h 表示由代理端解析域名,便于观察容器侧 DNS 和 VPN 的实际效果。若返回 302 并跳转到学校认证页,说明网络路径已通,但目标应用尚未登录。若显式指定代理可以访问而浏览器仍然超时,应优先检查系统代理入口和绕过列表。

实现效果

完成认证后,浏览器可以正常打开已授权的校内域名和虚拟机地址。统一客户端将指定的域名和网段交给容器处理,其他网站仍按原有规则访问。深信服客户端运行在 WSL 的 Docker 容器中,Windows 上无需安装。容器和本地 SOCKS5 节点只监听本机回环地址,代理入口不会暴露给局域网。

该方案的核心在于明确划分三项职责:认证、分流,以及最终访问校内网络。故障排查也按此顺序进行:先检查容器与 VPN,再检查 SOCKS5,然后检查规则命中,最后检查浏览器的系统代理及绕过列表。

最后我进行了两项持久性验证。第一项是关闭并重新启动 WSL Debian,确认 Docker 与容器能够自动恢复,鉴权地址也仍然保留,说明服务具备恢复能力。第二项是重启 Windows,检查系统代理绕过设置是否仍然有效,前文所述的配置回写问题正是在这一步发现的。只有服务启动、扫码认证、规则命中和浏览器访问四项均通过验证,才能认为整条链路完整可用:

① 服务启动
容器运行,noVNC 可访问
② 扫码认证
utun7 与校内路由出现
③ 规则命中
浏览器走校园 VPN,回流走 DIRECT
④ 浏览器访问
Windows 重启后复测通过

后续计划:将认证节点迁移至公网服务器

未来可以考虑将认证客户端容器迁移到个人管理的服务器上,使多台设备共用同一个接入点,从而省去在每台电脑上维护 WSL 的成本。但这目前仍处于规划阶段,当前的本机方案不能直接部署到公网:SOCKS5、HTTP 代理、VNC/noVNC 和鉴权接口均不应暴露在公网上。

实施前需要先确认学校的使用规定,包括账号是否允许多设备并发、是否有设备绑定要求,然后再设计仅允许本人设备接入的加密私有通道、访问控制和凭据保管方式。公网节点还会带来新的问题,例如服务器到校园网关的可达性、扫码续期、故障恢复和审计。

较为合理的目标架构是:认证容器仍只监听服务器本机,个人设备先接入受控的私有网络,再访问该服务器的代理入口;图形认证界面仅在需要扫码时向本人设备开放。在这一架构下,公网服务器负责稳定运行和跨设备复用,身份认证仍由学校客户端完成。下图为规划中的结构,尚未实现:

个人服务器(规划)
本人设备
加密私有网络
加密私有网络
不开放代理、VNC 与鉴权接口
utun7
aTrust 容器
代理与 noVNC 仅监听本机
笔记本
手机
公网
学校 VPN 网关

迁移前需要验证三点:该服务器能够访问学校网关,账号策略允许这种使用方式,公网延迟不会影响校内服务的使用。本文尚未实现或验证这些内容,因此不将其作为现成教程给出。

若学校政策不允许集中接入,则继续采用本机容器方案。隔离网卡影响、减少重复配置,这两个最初的问题已经得到解决。

将校园 VPN 运行在容器中:基于 WSL、Docker 与统一客户端的接入方案
/archives/eSWQDH5d
作者
yuu
发布于
2026-11-01
许可协议
CC BY-NC-SA 4.0