给六台机器上一张网:WireGuard 组网从地址规划到故障分层的落地实录

我这个草根站长手里有六台机器:一台主力 VPS 跑博客,一台便宜的小鸡专门存备份,一台在国内做中转,家里还有台闲置的 NUC 当作私有网盘,另外两台是给朋友帮忙维护的站。过去我给它们之间配对,用的都是 SSH 端口映射、frp 或者干脆把管理面板绑 0.0.0.0 再加一层 Nginx 的 BasicAuth。这些做法能跑,但每加一台机器就要重新配一遍端口、记一遍端口号,半年之后连自己都忘了哪台机器上哪个端口是干什么的。

后来换成了 WireGuard 做组网,整个内网只有一张网段表,机器之间的互通和公网入口彻底分开。这篇把我从第一版配置跑到稳定运行四个月的完整过程写下来,重点放在真实会踩的坑上,不讲那种「三行配置就能连」的演示。

先说结论:组网解决的到底是什么问题

我们不是在解决「能不能连上」,而是在解决三件更麻烦的事:

  • 身份:谁是谁。用公钥就是唯一的身份,比「知道 IP 和密码」可靠得多。
  • 边界:哪些机器可以互相访问,哪些只能单向访问。这个在网络层说清楚,比在应用层加一堆白名单清楚得多。
  • 可迁移:换一台 VPS、换一个家宽,只要改一张表里的一个字段,其他配置完全不动。

如果只是想让一台机器连到另一台,SSH 隧道永远更快。组网的价值在第三台、第四台机器加进来之后才开始显现。

地址规划:组网第一天就要定的事,后面改起来要动全部机器

WireGuard 的隧道地址段建议用 10.66.x.x 这样不太可能和真实内网撞车的私有段。我第一版随手用了 10.0.0.x,结果家里路由器的 LAN 就是 10.0.0.0/24,隧道一建立,家里那台 NUC 访问路由器管理页就被劫走了,排查了快半小时才发现是路由冲突。

规划规则我总结成三条:

  • 整张表用同一个 /16,例如 10.66.0.0/16,每台机器给一个固定地址,绝不靠自动分配。
  • 按角色分段:10.66.10.x 是公网 VPS,10.66.20.x 是家里和办公室的机器,10.66.30.x 是给朋友用的受控接入。以后要整体加防火墙规则,按段写就行。
  • 每台机器的隧道地址和它的公钥写在同一张表里,表本身放在私有 Git 仓库里,改一行 review 一次。

校验冲突的办法很土但有效:在每台机器上先跑 ip route 看一眼已有的路由表,确认 10.66.0.0/16 不在里面。这一步三十秒,能省掉半天。

服务端配置:一个接口、一张对端表、一条转发规则

服务端只管一件事:接受连接、把包转发给正确的对端。下面是跑了四个月的那份配置结构(私钥用文件读取,不直接写进配置):

[Interface]
Address = 10.66.10.1/16
ListenPort = 51820
PrivateKey = <从 /etc/wireguard/private.key 读取,权限 600>
PostUp = iptables -A FORWARD -i %i -j ACCEPT; iptables -A FORWARD -o %i -j ACCEPT
PostDown = iptables -D FORWARD -i %i -j ACCEPT; iptables -D FORWARD -o %i -j ACCEPT

[Peer]
# 家里 NUC
PublicKey = 
AllowedIPs = 10.66.20.11/32

[Peer]
# 备份小鸡
PublicKey = <备份机的公钥>
AllowedIPs = 10.66.10.3/32

几个容易想当然的地方:

AllowedIPs 不是「允许谁进来」,是「这个对端的地址属于谁」。 服务端每个 Peer 的 AllowedIPs 写 /32 单地址,意思是「这个公钥对应的流量来自这个地址」。客户端一侧的 AllowedIPs 才是「要把哪些目标地址的路由交给这个隧道」。同样一个字段,两个方向含义完全不同,这是我第一次配的时候最懵的地方。

如果在服务端把所有 Peer 的 AllowedIPs 写成 10.66.0.0/16,那把所有对端的地址范围混在一起了,机器之间能不能互通就变成看谁先发包,行为不可预测。

PostUp 的转发规则在一部分 VPS 上不生效。 Debian 系的云镜像里,默认 FORWARD 链可能被 cloud-init 塞了一条 REJECT 在前边,你 A 插在末尾的 ACCEPT 永远轮不到。稳妥的做法是统一改成在前端插入(iptables -I FORWARD 1 -i %i -j ACCEPT),或者干脆用 nftables 单独建一条 forward 链,链路清晰,也不会和云厂商的规则打架。

内核参数不能忘。 要让隧道流量能转发到别处(比如从家里机器访问公网 VPS 的内网服务),net.ipv4.ip_forward=1 必须开,并且要写进 /etc/sysctl.d/ 里,不然重启后丢失,症状是「重启前能通,重启后突然不通」,很容易误判成 WireGuard 坏了。

客户端配置:Keepalive 只该写在一侧

家里和办公室的机器在 NAT 后面,NAT 映射会超时,所以这些机器必须带 PersistentKeepalive = 25,定期朝服务端发包以维持映射。服务端不需要写这一项,写了反而多一份无谓流量。

我的实测数据:25 秒保活的情况下,一条空闲隧道每天大约有 3~5MB 流量,可以忽略。但如果你在移动网络按流量计费的机器上带保活,就得重新算笔账。还有一种情况是机器经常休眠(笔记本),休眠后 Keepalive 会在唤醒时集中发包,网络确实会抖一下,这种情况可以把间隔放宽到 60 秒。

下面是客户端一侧的完整配置:

[Interface]
Address = 10.66.20.11/16
PrivateKey = <本机私钥>
DNS = 10.66.10.1

[Peer]
PublicKey = <服务端公钥>
Endpoint = 203.0.113.10:51820
AllowedIPs = 10.66.0.0/16
PersistentKeepalive = 25

注意这里 Endpoint 必须是服务端的公网地址,不能写隧道地址。我见过有人两台机器互相写对方的隧道地址,结果就是谁也连不上——隧道建立之前,隧道地址没有意义。

全隧道还是分流:AllowedIPs 决定一切

客户端 AllowedIPs 写 10.66.0.0/16 就是只有内网走隧道,上网还是走本地宽带,这是绝大多数人想要的。写 0.0.0.0/0 就是全流量走隧道,所有上网行为都从服务端出口出去,适合在公共 Wi-Fi 用,但会给服务端带来成倍的带宽压力。

如果家里路由器要访问内网服务(比如私有网盘挂在 NUC 的 8080 上),不需要每台设备都装客户端,把路由器当成一个 Peer 就行,路由器的 LAN 段通过 NUC 转发进来。这时 NUC 的 AllowedIPs 要加上路由器的 LAN 段,并且 NUC 上要开 ip_forward。

用 wg-quick 之外的方式:systemd 里的几个细节

wg-quick up wg0 很方便,但它在启动时会自己创建接口、配路由、调 resolvconf,出问题时日志很模糊。生产环境我最终改成了原生 systemd 单元,好处是开机顺序明确、日志落 journald、失败能收到告警。

一个必须注意的点:在只有一条隧道的机器上,wg-quick 里的 DNS = 会调 resolvconf 改写 /etc/resolv.conf,而 Debian 12 默认用 systemd-resolved,两者会互相打架,症状是隧道起来之后本地上网解析全挂。解决办法是用 systemd-resolved 的 resolvectl dns wg0 10.66.10.1 来配置,而不是让 wg-quick 去碰 resolv.conf。这一条我在两台机器上都踩过,一模一样的症状。

故障排查:四个命令定位到问题在哪一层

WireGuard 的排查逻辑非常清晰,因为它分「握手」和「数据」两层。常用命令:

# 1. 接口是否起来,有没有地址
ip addr show wg0

# 2. 有没有完成握手(关键)
wg show

# 3. 包是否真的在进出
wg show wg0 transfer

# 4. 内核层面丢在哪里
dmesg | grep -i wireguard

wg show 的输出里,latest handshake 是最灵敏的指标。如果这一栏是空的或者超过三分钟,说明握手根本没成功,问题在 UDP 端口、公钥、Endpoint 三者之间,和路由、防火墙(除了 UDP 端口本身)都无关。这种情况下你在机器上查 ip route、查 iptables 都没用,先查 UDP 能不能到。

如果握手时间很新,但 ping 不通对端,那就进入第二层:包到了但没回。这时看 transfer 计数,发出去有增长、收回来的没增长,基本就是对方 AllowedIPs 没写你的地址,或者对方没开转发、或者对方的 FORWARD 链在拦。

第三种很诡异的情况:ping 通,TCP 不通。多半是 MTU 问题。WireGuard 自己会加 80 字节开销,隧道内的有效 MTU 一般按 1420 算。如果客户端网卡 MTU 是 1500 而隧道没设 MTU,大包会被分片然后丢掉,表现就是小请求(ICMP、小一点的 HTTP 头)正常,一到传文件、传图片就挂住。解决办法是在接口上加 MTU = 1420,或者用 ping -M do -s 1400 逐级测出真实上限。

安全收口:组网之后最容易被忽略的三件事

第一件,也是最重要的:管理面板不要再绑公网地址了。即使已经组网。 很多人组完网就以为万事大吉,实际上原来的 8080 面板还开在公网,只是自己改用隧道访问了。应该在防火墙上把公网侧的这些端口全部关掉,只在 wg0 接口上监听。Nginx 里可以配 listen 10.66.10.1:8080;,iptables 里对 wg0 之外的所有来源 DROP。

第二件,私钥权限。/etc/wireguard/private.key 必须 600 且属主 root。wg-quick 会提示这一点但只是警告,忽略了之后其他用户可以读走私钥,之前的所有安全假设就没了。

第三件,撤销访问要彻底。删掉 Peer 只是让这张表里没有记录,但对方的公钥如果还在别的地方出现过、或者对方还持有你的服务端公钥,你需要一并考虑。我做的处理是:给朋友的接入单独开一个 wg1 接口,和主内网物理隔离,只在 wg1 上放一个反向代理,能访问什么由代理决定,而不是由路由决定。这个设计让我们在帮别人维护站点时,从来没有担心过对方能看到主内网的其他机器。

什么时候该用别的方案

WireGuard 不是万能的。如果两台机器都在 NAT 后面,且双方都没有公网地址,WireGuard 直连是配不出来的,需要一台有公网地址的中转做 Endpoint,流量会绕一圈。这种情况下 Tailscale 这类方案打洞成功率更高,代价是多了一个外部控制面。我的判断标准是:所有机器至少有一台有公网地址,就用原生 WireGuard,配置全在自己手里;如果一台公网机器都没有,或者需要经常临时加入新设备,就用带控制面的方案省时间。

这套组网跑下来,最实际的收获不是「省了端口号」,而是所有机器之间的访问关系变成了一个文件、一张表,看一眼就知道谁能连谁。以前排查一次内网访问问题要登录三台机器看配置,现在只需要看这一个文件。

Last modification:November 20th, 2026 at 08:26 pm

Leave a Comment