注意:旧的 Python 版本已定稿且不再维护。 其说明位于本文件末尾。它与当前的 C 版本 不兼容。请仅使用 C 版本。
如果你有一台拥有公网 IP 且端口未被过滤的服务器, 你可以在该服务器上运行 NAT Tunnel (NT) 服务端,并在 位于 NAT 之后的机器上运行 NT 客户端。 服务端需要 2 个开放端口:一个用于与 NT 客户端通信(--admin),另一个供普通客户端连接 (--public:这是你希望用户使用的端口)。
NT 客户端会向服务端的 admin IP/端口发起连接。 一旦服务端收到新连接,它就会通知 NT 客户端,后者随即向服务端创建一条新的隧道连接, 该连接随后被连接到 NT 客户端一侧 所需的服务(--local)。
NT 客户端与 NT 服务端之间在 admin 接口上的连接由共享密钥保护,以防未经授权的使用。 能够拦截数据包的对手如果密钥复杂度不足, 就可能破解该密钥。建议至少使用 10 个 随机字符和数字。
示例: 你有一台 HTTP 服务器正在本地机器的 80 端口上监听。 你希望将其通过云服务器/VPS 等的公网 IP 的 8000 端口对外提供。 我们在云服务器上使用 7000 端口作为控制通道。
服务端:
./natsrv --mode server --secret-file secret.txt --server-key server.key --public 0.0.0.0:8000 --admin 0.0.0.0:7000
客户端:
./natsrv --mode client --secret-file secret.txt --server-pubkey PUBKEY_HEX --local localhost:80 --admin example.com:7000
IPv4 和 IPv6 在所有地方均可使用。地址语法为 host:port。 对于 IPv6 字面量请使用方括号:[::1]:8080、[2001:db8::1]:7000。 不带方括号的裸 IPv6 地址会被拒绝,因为 冒号会使端口产生歧义。对于主机名,优先使用 IPv4, IPv6 作为回退;显式的数字字面量 对其所属地址族始终优先。监听地址 0.0.0.0 表示 IPv4 所有接口,:: 表示 IPv6 所有接口。 在传输中,服务端对 IPv4 以 ip:port 形式报告对端, 对 IPv6 以 [ip]:port 形式报告,双方都能解析这两种形式。
一次性生成服务端签名密钥:
./natsrv --genkey server.key
这会以 0600 权限写入私钥,并打印 公钥的十六进制字符串。将该十六进制字符串作为 --server-pubkey 提供给客户端。服务端需要 --server-key,客户端 需要 --server-pubkey。在共享机器上优先使用 --secret-file PATH 而非 --secret,因为 --secret 会通过 ps aux 泄露。
使用普通的 GNU Make(3.82 或更新版本)构建:
make
这会生成 ./natsrv。Makefile 在第一个目标之前以 -include config.mak 开头,因此本地的 config.mak 可以永久设置 CFLAGS、CPPDFGS、LDFLAGS 等变量。Makefile 会通过 CFLAGS += -Wall -std=c99 追加自己的默认值。Make 命令行上的选项 也会传递进去:
make CPPFLAGS=-DHAVE_GETRANDOM
make CFLAGS="-Wall -Wextra -std=c99 -pedantic"
make USE_SODIUM=1
make clean
HAVE_GETRANDOM:默认情况下随机数来自 /dev/urandom。 定义 HAVE_GETRANDOM 可改用 getrandom() 系统调用 (Linux 3.17+ / glibc 2.25+)。两条路径都会安全失败。 默认链接 -lpthread,使用 USE_SODIUM=1 时额外链接 -lsodium。代码本身是 C99 且可移植,不含 GNU99 扩展。缩进使用制表符,遵循 microsocks 代码风格。
隧道加密使用 XSalsa20。默认情况下由 内置的 TweetNaCl 代码(tweetnacl.c、tweetnacl.h)提供。 使用 USE_SODIUM=1 时则改为链接 libsodium。sha256.c 中的 sha256 代码 是从零编写的;默认构建 无需任何加密库。
在支持 Intel SHA 扩展的 x86 上,当编译器定义了 SHA 和 SSSE3 时,sha256.c 会自动使用 SHA-NI 内建函数。标量实现仍作为回退。 无需 -march=native 即可启用:
make CPPFLAGS="-msha -msse4.1"
构建出的二进制文件需要任何支持 SHA-NI 和 SSE4.1 的 x86 CPU,而不需要其他 -march=native 特性。不带这些标志的普通 make 仍然可以在任何地方使用。
在 i7-1160G7 上测量,16 KiB 块的原始 SHA256:标量 -O2 约为 257 MB/s,SHA-NI -O2 约为 1574 MB/s(约快 6 倍)。
隧道套接字具有发送和接收超时,通过 --timeout SECS 设置(默认 1800,0 表示禁用)。默认值刻意保守:慢速服务器(例如低于每秒 10 个 token 的 llama.cpp),或巨大的系统提示上传,可能合法地阻塞数分钟。较短的值会杀死此类隧道;较长的值会延迟死套接字检测。控制套接字永远不会获得超时,因此空闲的控制连接不会被杀死。
所有套接字都使用 TCP 保活,在空闲时间每 30 秒探测一次(间隔 5 秒,3 次探测),因此静默死亡的对方会在约 45 秒内被检测到,而不是默认的 2 小时。
客户端和服务器都运行一个轮询循环。两端都不会阻塞在 accept 中。客户端同时轮询控制套接字和备用套接字,并在备用套接字出现数据、错误或每 5 秒未通过死亡检查时重新武装备用套接字。服务器同时轮询管理监听器、公共监听器、控制套接字和备用套接字。因此,服务器在没有备用套接字时仍会服务公共端口,并且永远不会停止监视控制套接字。
在没有活动备用套接字时到达的公共连接会立即被重置。对方会看到失败,而不是挂起。已经显示 FIN 或 RST 的备用套接字会在配对前被丢弃并重新武装,因此死亡的备用套接字永远不会进入隧道。仅可读数据不会被视为即将配对的备用套接字的死亡,因为隧道字节可能合法地处于传输中。
使用以下命令运行整个测试套件:
make test
这需要 python3,并首先构建 natsrv。测试套件在回环端口上启动真实的服务器和客户端进程。每个测试都有自己的端口、工作目录和日志,因此失败永远不会泄漏到下一个测试。
测试可以按名称选择,并列出:
python3 tests/natt.py --list
python3 tests/natt.py spare_rst control_rst
故障注入使用位于管理端口前面的 TCP 代理(tests/natt.py,类 FaultProxy)。每个被接受的连接按接受顺序获得一个 id,并从其客户端 hello 中读取角色,因此控制套接字和备用套接字可以被区分开。测试可以用 RST 丢弃一个连接,用 FIN 丢弃它,或冻结它,即在两个套接字都保持打开的情况下停止转发字节。对控制套接字的冻结模拟静默死亡的路径。对方内核在回环上会继续应答保活探测,因此 control_blackhole 测试改用 iptables 丢弃数据包。该测试需要 root,否则会被跳过。
慢速测试通过 TCP 保活检测黑洞,大约需要 45 秒。它们仅在请求时运行:
make test-slow
所有控制台输出都发送到 stderr,每行通过一次 dprintf() 调用(宏 dolog,移植自 microsocks 的 sockssrv.c)。stderr 不是行缓冲的,而 dprintf 直接写入 fd。两者都不需要 stdio 锁,因此 dolog 从任何线程调用都是安全的,并且一行之后不需要 fflush。使用 2> file 重定向日志。
时间戳与消息属于同一次 dprintf 调用。因此并发握手永远不会在一行内交错。实践中只有主线程会打印,因此顺序保持可读。
帮助文本(--help)是对 CLI 调用的应答,发送到 stdout。其他所有内容,包括 --genkey 输出,都发送到 stderr。
每个连接到管理端口的对端都会收到一个服务器 hello,随后有 1.5 秒的期限来发送有效的客户端 hello。没有共享密钥的对端无法通过 MAC 校验,其套接字会被重置。因此,一次随机的端口扫描 只会消耗一次握手,并且绝不会断开 活跃的控制套接字。只有证明拥有共享 密钥的对端才能替换活跃的控制套接字,重启后的客户端 正是以此方式接管连接。握手在主轮询循环内 运行,因此停滞的扫描器最多只会将 循环延迟一个 hello 期限。
二进制长度前缀帧:类型字节加上大端序 uint16 负载长度再加上负载。类型:1 服务器 hello, 2 客户端 hello,3 控制,4 隧道,5 错误,6 关闭。 隧道数据本身是备用通道上隧道帧内部的原始字节流, 当请求字节为 2(sk2)时使用 XSalsa20 加密。控制帧携带 CONN 对端 地址,并且始终加密。
握手为 2 次往返。服务器发送临时 X25519 公钥、能力字节、16 字节 nonce,以及来自其长期密钥的 Ed25519 签名。客户端使用其固定的服务器公钥进行验证, 然后发送自己的临时密钥、一个请求字节(0 adm,1 skt 明文隧道,2 sk2 加密隧道),以及一个基于会话记录、以 X25519 共享密钥加上来自 --secret 或 --secret-file 的共享密钥为密钥的 MAC。该 MAC 即客户端授权; 仅有共享密钥而没有临时私钥无法完成授权, 而临时交换提供了前向保密。流密钥派生自共享密钥 加上会话记录哈希。CONN 对端地址在控制通道上始终 加密,即使服务器允许未加密的隧道流量也是如此。默认情况下隧道是 加密的。该选项可以提高吞吐量,或在后端已经加密(例如 HTTPS)时 减少开销。它仅适用于隧道流量;控制流量保持 加密。 能力字节的第 0 位在线路上镜像该设置。
密钥:服务器签名密钥通过上文所述的 --genkey 生成。在共享主机上,优先使用 --secret-file PATH 而非 --secret。
以下文本是旧的仅 Python 文档。它 并不描述 nt02 C 线路协议。
服务器(IPv4):
natsrv.py --mode server --secret s3cretP4ss --public 0.0.0.0:8000 --admin 0.0.0.0:7000
客户端(IPv4):
natsrv.py --mode client --secret s3cretP4ss --local localhost:80 --admin example.com:7000
服务器(IPv6,注意方括号):
natsrv.py --mode server --secret s3cretP4ss --public [::]:8000 --admin [::]:7000
客户端(IPv6 上游,IPv4 本地):
natsrv.py --mode client --secret s3cretP4ss --local localhost:80 --admin [2001:db8::1]:7000