<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>VPN on 扎塔-Zata</title><link>https://www.zata.cc/tags/vpn/</link><description>Recent content in VPN on 扎塔-Zata</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><copyright>扎塔-Zata</copyright><lastBuildDate>Fri, 13 Nov 2026 02:27:46 +0800</lastBuildDate><atom:link href="https://www.zata.cc/tags/vpn/index.xml" rel="self" type="application/rss+xml"/><item><title>Tailscale 详解：控制面、DERP 与自建 Headscale</title><link>https://www.zata.cc/p/tailscale-guide/</link><pubDate>Fri, 13 Nov 2026 00:40:00 +0800</pubDate><guid>https://www.zata.cc/p/tailscale-guide/</guid><description>&lt;img src="https://www.zata.cc/p/tailscale-guide/images/index/index.svg" alt="Featured image of post Tailscale 详解：控制面、DERP 与自建 Headscale" />&lt;h2 id="系列文章">系列文章
&lt;/h2>&lt;table>
&lt;thead>
&lt;tr>
&lt;th>篇&lt;/th>
&lt;th>主题&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>&lt;a class="link" href="../wireguard-guide/" >一&lt;/a>&lt;/td>
&lt;td>WireGuard 原理与跨 VPC 站点互联&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>二（本篇）&lt;/td>
&lt;td>Tailscale：控制面、DERP 与自建 Headscale&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;hr>
&lt;p>上一篇的结论是：WireGuard 只做数据面，配置文件是静态的，所以&amp;quot;两台机器很舒服，二十台机器很难受&amp;quot;。&lt;/p>
&lt;p>Tailscale 就是来解决&amp;quot;难受&amp;quot;的。它一行加密代码都没自己写，&lt;strong>用的是同一套 WireGuard 数据面&lt;/strong>，补上的是控制面。&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>&lt;/th>
&lt;th>裸 WireGuard&lt;/th>
&lt;th>Tailscale&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>加密隧道&lt;/td>
&lt;td>你配&lt;/td>
&lt;td>自动&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>密钥交换&lt;/td>
&lt;td>手工复制&lt;/td>
&lt;td>控制面下发&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>找到对方&lt;/td>
&lt;td>写死 &lt;code>Endpoint&lt;/code>&lt;/td>
&lt;td>自动发现 + NAT 穿透&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>访问控制&lt;/td>
&lt;td>&lt;code>AllowedIPs&lt;/code>&lt;/td>
&lt;td>策略文件（ACL）&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>加一台机器&lt;/td>
&lt;td>改所有对端配置&lt;/td>
&lt;td>装完登录即可&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>依赖&lt;/td>
&lt;td>无&lt;/td>
&lt;td>一个控制面（可以是自建的）&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;hr>
&lt;h2 id="一三个名词先对齐">一、三个名词先对齐
&lt;/h2>&lt;p>刚接触 Tailscale 的人容易被它的术语绕住，其实只有三个：&lt;/p>
&lt;ul>
&lt;li>&lt;strong>tailnet&lt;/strong>：一个虚拟私有网络，对应一个账号/组织。所有设备都在这个逻辑网络里。&lt;/li>
&lt;li>&lt;strong>node（设备）&lt;/strong>：加入 tailnet 的一台机器，可以是服务器、笔记本、手机、容器。&lt;/li>
&lt;li>&lt;strong>coordination server（协调服务器）&lt;/strong>：控制面。它知道所有节点的公钥、地址和当前可达端点，负责把它们互相介绍给对方。&lt;/li>
&lt;/ul>
&lt;p>关键认知：&lt;strong>协调服务器不转发业务流量&lt;/strong>。它只做介绍人。数据永远在两端之间直连（打不通才走中继）。&lt;/p>
&lt;hr>
&lt;h2 id="二架构控制面数据面derp">二、架构：控制面、数据面、DERP
&lt;/h2>&lt;p>&lt;img src="https://www.zata.cc/p/tailscale-guide/images/index/ts-architecture.svg"
loading="lazy"
alt="Tailscale 架构：控制面只做身份与密钥协调，节点之间优先直连走 WireGuard 隧道；直连打不通时通过 DERP 中继兜底，中继只转发加密后的密文"
>&lt;/p>
&lt;p>三条路径，按优先级：&lt;/p>
&lt;ol>
&lt;li>&lt;strong>直连（direct）&lt;/strong>：两端 NAT 打洞成功，UDP 点对点。延迟最低，走的是真实网络路径。&lt;/li>
&lt;li>&lt;strong>DERP 中继（relayed）&lt;/strong>：打洞失败时，流量经 Tailscale 的 DERP 服务器转发。&lt;strong>它转发的是已加密的 WireGuard 包&lt;/strong>，DERP 自己也解不开内容。&lt;/li>
&lt;li>&lt;strong>两者都不可用&lt;/strong>：连不上。&lt;/li>
&lt;/ol>
&lt;p>DERP 是全网的兜底，所以它必须高可用。Tailscale 官方维护了一批节点，你也可以自建（&lt;code>derper&lt;/code>）。&lt;/p>
&lt;blockquote>
&lt;p>这一点常被误解：很多人以为 Tailscale 的流量&amp;quot;都过他们服务器&amp;quot;。默认不是——只有打洞失败的那部分才走 DERP，而且 DERP 看到的只是密文。&lt;/p>
&lt;/blockquote>
&lt;hr>
&lt;h2 id="三上手五分钟能通">三、上手：五分钟能通
&lt;/h2>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># Linux&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">curl -fsSL https://tailscale.com/install.sh &lt;span class="p">|&lt;/span> sh
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># macOS&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">brew install --cask tailscale
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 登录并加入 tailnet&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">sudo tailscale up
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 看状态&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tailscale status
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 测试到另一台设备&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tailscale ping &amp;lt;hostname&amp;gt;
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>&lt;code>tailscale status&lt;/code> 的输出里，每行末尾会标 &lt;code>direct&lt;/code> 或 &lt;code>relay &amp;quot;xxx&amp;quot;&lt;/code>：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">100.64.0.1 node-a zata@ linux -
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">100.64.0.2 node-b zata@ macOS active; direct 203.0.113.10:41641, tx 1204 rx 980
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">100.64.0.3 node-c zata@ android idle, tx 0 rx 0; relay &amp;#34;hkg&amp;#34;, tx 88 rx 0
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>第三行就是&amp;quot;打洞失败、走香港中继&amp;quot;的典型样子。&lt;/p>
&lt;p>&lt;code>tailscale ping&lt;/code> 比系统 &lt;code>ping&lt;/code> 更有用：它走 Tailscale 自己的 disco 协议，会明确告诉你这一跳是直连还是中继，以及是否已经完成 WireGuard 握手。&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">tailscale ping node-b
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># pong from node-b (100.64.0.2) via 203.0.113.10:41641 in 12ms&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 或者&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># pong from node-b (100.64.0.2) via DERP(hkg) in 48ms&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;hr>
&lt;h2 id="四地址与命名">四、地址与命名
&lt;/h2>&lt;p>Tailscale 给每台设备分配一个 &lt;code>100.64.0.0/10&lt;/code> 段内的地址——这是 &lt;strong>CGNAT 保留段&lt;/strong>，选它是因为几乎不可能和你现有的内网冲突。&lt;/p>
&lt;p>配套的是 &lt;strong>MagicDNS&lt;/strong>：设备用主机名就能互访，不用记 IP。&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">ssh node-b &lt;span class="c1"># 而不是 ssh 100.64.0.2&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">curl http://node-b:8000/health
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>主机名可以改，在管理后台或 &lt;code>tailscale up --hostname=xxx&lt;/code>。重装系统后旧记录会保留，记得清理，否则 &lt;code>tailscale status&lt;/code> 里会堆一堆离线设备。&lt;/p>
&lt;hr>
&lt;h2 id="五nat-穿透什么时候会走-derp">五、NAT 穿透：什么时候会走 DERP
&lt;/h2>&lt;p>这是 Tailscale 最有价值、也最容易出问题的地方。&lt;/p>
&lt;h3 id="51-它试了什么">5.1 它试了什么
&lt;/h3>&lt;ol>
&lt;li>向 STUN 服务器查询自己的公网映射（UDP 3478）&lt;/li>
&lt;li>尝试 UPnP / NAT-PMP / PCP 让网关开个口&lt;/li>
&lt;li>通过控制面交换双方的候选端点，同时向对方发包打洞&lt;/li>
&lt;li>成功 → 直连；失败 → DERP&lt;/li>
&lt;/ol>
&lt;p>打洞能否成功，取决于两端的 NAT 类型。&lt;strong>对称型 NAT（symmetric NAT）&lt;/strong> 是最常见的失败原因——同一个内网地址访问不同目标时，映射端口不一样，导致对方拿到的候选端口无效。&lt;/p>
&lt;h3 id="52-怎么判断">5.2 怎么判断
&lt;/h3>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">tailscale netcheck
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>输出里重点看：&lt;/p>
&lt;ul>
&lt;li>&lt;code>UDP: true&lt;/code> — UDP 出网是否可用（false 基本只能走 DERP）&lt;/li>
&lt;li>&lt;code>MappingVariesByDestIP: true&lt;/code> — 就是对称型 NAT&lt;/li>
&lt;li>&lt;code>PortMapping: UPnP / NAT-PMP / none&lt;/code>&lt;/li>
&lt;li>&lt;code>Nearest DERP&lt;/code> — 最近的中继在哪，决定走中继时的延迟&lt;/li>
&lt;/ul>
&lt;h3 id="53-什么情况下必然是中继">5.3 什么情况下必然是&amp;quot;中继&amp;quot;
&lt;/h3>&lt;table>
&lt;thead>
&lt;tr>
&lt;th>情况&lt;/th>
&lt;th>结果&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>企业防火墙只放 TCP 443&lt;/td>
&lt;td>走 DERP（DERP 就是 HTTPS）&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>双侧对称 NAT&lt;/td>
&lt;td>大概率中继&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>云主机安全组只开特定端口&lt;/td>
&lt;td>看是否放行 UDP 41641&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>蜂窝网络（部分运营商）&lt;/td>
&lt;td>常见中继&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;strong>云上部署的一个实操点&lt;/strong>：安全组要放行入站 &lt;strong>UDP 41641&lt;/strong>（或 Tailscale 随机选的端口），否则直连概率大幅下降。它不开放也能工作，只是全走中继——延迟和带宽都会变差，而且很多人不会注意到。&lt;/p>
&lt;hr>
&lt;h2 id="六访问控制策略文件">六、访问控制：策略文件
&lt;/h2>&lt;p>默认是&amp;quot;同一 tailnet 内全通&amp;quot;。生产环境一定要收紧，靠的是一份策略文件（HuJSON，允许注释的 JSON）。&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-json" data-lang="json">&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="nt">&amp;#34;groups&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="nt">&amp;#34;group:ops&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">[&lt;/span>&lt;span class="s2">&amp;#34;alice@example.com&amp;#34;&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="s2">&amp;#34;bob@example.com&amp;#34;&lt;/span>&lt;span class="p">]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">},&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="nt">&amp;#34;tagOwners&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="nt">&amp;#34;tag:prod&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">[&lt;/span>&lt;span class="s2">&amp;#34;group:ops&amp;#34;&lt;/span>&lt;span class="p">]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">},&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="nt">&amp;#34;grants&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">[&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span> &lt;span class="nt">&amp;#34;src&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">[&lt;/span>&lt;span class="s2">&amp;#34;group:ops&amp;#34;&lt;/span>&lt;span class="p">],&lt;/span> &lt;span class="nt">&amp;#34;dst&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">[&lt;/span>&lt;span class="s2">&amp;#34;tag:prod&amp;#34;&lt;/span>&lt;span class="p">],&lt;/span> &lt;span class="nt">&amp;#34;ip&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">[&lt;/span>&lt;span class="s2">&amp;#34;tcp:22&amp;#34;&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="s2">&amp;#34;tcp:443&amp;#34;&lt;/span>&lt;span class="p">]&lt;/span> &lt;span class="p">},&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span> &lt;span class="nt">&amp;#34;src&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">[&lt;/span>&lt;span class="s2">&amp;#34;autogroup:member&amp;#34;&lt;/span>&lt;span class="p">],&lt;/span> &lt;span class="nt">&amp;#34;dst&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">[&lt;/span>&lt;span class="s2">&amp;#34;tag:prod&amp;#34;&lt;/span>&lt;span class="p">],&lt;/span> &lt;span class="nt">&amp;#34;ip&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="p">[&lt;/span>&lt;span class="s2">&amp;#34;tcp:443&amp;#34;&lt;/span>&lt;span class="p">]&lt;/span> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>三个概念值得分清：&lt;/p>
&lt;ul>
&lt;li>&lt;strong>user&lt;/strong>：登录的人，身份来自 SSO（Google / GitHub / 微软 / OIDC）。&lt;/li>
&lt;li>&lt;strong>tag&lt;/strong>：给机器打标签，机器没有&amp;quot;人&amp;quot;的身份，用 tag 表达角色（&lt;code>tag:prod&lt;/code>、&lt;code>tag:db&lt;/code>）。&lt;/li>
&lt;li>&lt;strong>group&lt;/strong>：人的集合，方便批量授权。&lt;/li>
&lt;/ul>
&lt;p>写 ACL 的两个常见错误：一是给 &lt;code>tag:db&lt;/code> 放行了 &lt;code>autogroup:member&lt;/code> 的 22 端口，等于全公司可登数据库；二是忘了机器换人后 tag 没回收。&lt;/p>
&lt;blockquote>
&lt;p>还有一层可选防护叫 &lt;strong>tailnet lock&lt;/strong>：用你自己保管的签名密钥验证节点公钥，防止控制面被攻破后偷偷塞一台机器进来。它的代价是每次加设备要手动签名，团队大了会嫌麻烦，但对安全敏感的部署值得开。&lt;/p>
&lt;/blockquote>
&lt;hr>
&lt;h2 id="七子网路由与出口节点">七、子网路由与出口节点
&lt;/h2>&lt;p>这两个功能把&amp;quot;点对点&amp;quot;扩展成&amp;quot;整网段接入&amp;quot;，也是和上一篇场景最能对应上的部分。&lt;/p>
&lt;h3 id="71-子网路由subnet-router">7.1 子网路由（subnet router）
&lt;/h3>&lt;p>把某个内网网段接进 tailnet。比如办公室里有个 &lt;code>192.168.1.0/24&lt;/code>：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 在能访问该网段的那台机器上&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tailscale up --advertise-routes&lt;span class="o">=&lt;/span>192.168.1.0/24
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 然后去管理后台批准这条路由（默认不生效）&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 其他设备上&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tailscale up --accept-routes
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>&lt;strong>默认必须后台批准&lt;/strong>，这是刻意的：否则任何一台被入侵的机器都能宣称&amp;quot;我能到达 0.0.0.0/0&amp;quot;。&lt;/p>
&lt;h3 id="72-出口节点exit-node">7.2 出口节点（exit node）
&lt;/h3>&lt;p>让设备的所有出网流量走某个节点：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 提供出口的机器&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tailscale up --advertise-exit-node
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 使用方&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tailscale up --exit-node&lt;span class="o">=&lt;/span>node-a --exit-node-allow-lan-access
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>这正好对应上一篇&amp;quot;让 B 的流量从 A 出去&amp;quot;的需求——区别是：裸 wg 要自己写策略路由和 NAT，Tailscale 一条命令加一次后台点击。&lt;/p>
&lt;p>&lt;strong>但代价不同&lt;/strong>：裸 wg 的出口规则完全在自己手里；Tailscale 的出口节点、路由和 ACL 由控制面下发。出口 IP 仍然是 exit node 自己的公网 IP——即使客户端到 exit node 走的是 DERP 中继，DERP 也只转发密文，不改变出口。要确认的是 exit node 本身是否多出口或有 NAT 地址池，而不是它有没有走 DERP。&lt;/p>
&lt;hr>
&lt;h2 id="八密钥与生命周期">八、密钥与生命周期
&lt;/h2>&lt;table>
&lt;thead>
&lt;tr>
&lt;th>项&lt;/th>
&lt;th>说明&lt;/th>
&lt;th>注意&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>node key&lt;/td>
&lt;td>每台设备一把，自动轮换&lt;/td>
&lt;td>设备被重置后旧 key 残留&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>auth key&lt;/td>
&lt;td>用于无人值守加入&lt;/td>
&lt;td>设过期时间，别用&amp;quot;永不过期&amp;quot;&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>ephemeral node&lt;/td>
&lt;td>标记为临时，离线后自动清理&lt;/td>
&lt;td>适合容器、CI&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>key expiry&lt;/td>
&lt;td>默认 180 天过期，需要重新认证&lt;/td>
&lt;td>服务器在管理后台 Machines → 设备菜单关闭 key expiry；CLI 没有这个开关&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>pre-approved&lt;/td>
&lt;td>免后台批准（路由/出口）&lt;/td>
&lt;td>便利与风险并存&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 生成一次性 auth key（在管理后台或 CLI）&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tailscale up --authkey&lt;span class="o">=&lt;/span>tskey-auth-xxxxx --hostname&lt;span class="o">=&lt;/span>ci-runner --ephemeral
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>一个血泪点：&lt;strong>服务器的 key 到期后会掉线&lt;/strong>，而且不一定有明显的告警。生产机器记得关掉过期，或者把到期提醒接进监控。&lt;/p>
&lt;hr>
&lt;h2 id="九和裸-wireguardzerotier-对比">九、和裸 WireGuard、ZeroTier 对比
&lt;/h2>&lt;table>
&lt;thead>
&lt;tr>
&lt;th>&lt;/th>
&lt;th>裸 WireGuard&lt;/th>
&lt;th>Tailscale&lt;/th>
&lt;th>ZeroTier&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>数据面&lt;/td>
&lt;td>WireGuard&lt;/td>
&lt;td>WireGuard&lt;/td>
&lt;td>自研协议&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>控制面&lt;/td>
&lt;td>无&lt;/td>
&lt;td>官方 SaaS / 可自建&lt;/td>
&lt;td>官方 SaaS / 可自建&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>地址段&lt;/td>
&lt;td>自己定&lt;/td>
&lt;td>100.64.0.0/10&lt;/td>
&lt;td>自定（默认 10.x）&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>NAT 穿透&lt;/td>
&lt;td>靠一端有公网&lt;/td>
&lt;td>自动，失败走 DERP&lt;/td>
&lt;td>自动，失败走中继&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>ACL&lt;/td>
&lt;td>&lt;code>AllowedIPs&lt;/code>&lt;/td>
&lt;td>策略文件&lt;/td>
&lt;td>规则表&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>客户端覆盖&lt;/td>
&lt;td>全平台&lt;/td>
&lt;td>全平台，体验最好&lt;/td>
&lt;td>全平台&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>额外依赖&lt;/td>
&lt;td>无&lt;/td>
&lt;td>控制面 + DERP&lt;/td>
&lt;td>控制面 + 中继&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>适合&lt;/td>
&lt;td>少量固定机器&lt;/td>
&lt;td>团队、移动设备&lt;/td>
&lt;td>团队、偏网络层&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>选型其实只有一句话：&lt;strong>你能列出所有 peer 的 IP 和密钥吗？&lt;/strong> 能，裸 wg；不能，Tailscale 这类。&lt;/p>
&lt;hr>
&lt;h2 id="十自建控制面headscale">十、自建控制面：Headscale
&lt;/h2>&lt;p>Headscale 是控制面的开源实现，客户端仍然用 Tailscale 官方程序，只是把 &lt;code>--login-server&lt;/code> 指向你自己的实例。&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">tailscale up --login-server&lt;span class="o">=&lt;/span>https://headscale.example.com
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="101-它能做什么">10.1 它能做什么
&lt;/h3>&lt;ul>
&lt;li>节点注册与密钥分发、MagicDNS、ACL 策略&lt;/li>
&lt;li>子网路由、出口节点&lt;/li>
&lt;li>OIDC 登录（接自己的身份源）&lt;/li>
&lt;li>可自建 DERP&lt;/li>
&lt;/ul>
&lt;h3 id="102-它缺什么">10.2 它缺什么
&lt;/h3>&lt;ul>
&lt;li>&lt;strong>tailnet lock 没有&lt;/strong>，控制面被攻破就没有第二道防线&lt;/li>
&lt;li>管理后台是 CLI，没有官方那种 Web UI（社区有第三方的）&lt;/li>
&lt;li>部分新特性滞后，客户端升级可能带来兼容问题&lt;/li>
&lt;li>官方移动端对第三方控制面的支持有限，安卓/iOS 上体验不如 SaaS&lt;/li>
&lt;/ul>
&lt;h3 id="103-什么时候值得自建">10.3 什么时候值得自建
&lt;/h3>&lt;ul>
&lt;li>合规要求流量与身份数据不出自己的边界&lt;/li>
&lt;li>机器都在自己的云上，控制面顺手就部署了&lt;/li>
&lt;li>能接受&amp;quot;出问题自己修&amp;quot;&lt;/li>
&lt;/ul>
&lt;p>如果只是想省事，官方 SaaS 的免费额度对个人和小团队够用；自建 Headscale 省的是钱和依赖，花的是运维时间。&lt;/p>
&lt;hr>
&lt;h2 id="十一排障">十一、排障
&lt;/h2>&lt;table>
&lt;thead>
&lt;tr>
&lt;th>症状&lt;/th>
&lt;th>先看什么&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>能 ping 通但延迟高&lt;/td>
&lt;td>&lt;code>tailscale ping&lt;/code> 看是否 &lt;code>via DERP&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>突然全部走中继&lt;/td>
&lt;td>&lt;code>tailscale netcheck&lt;/code> 的 UDP 与 MappingVariesByDestIP&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>某台机器加入不了&lt;/td>
&lt;td>&lt;code>tailscale status&lt;/code> 是否 &lt;code>offline&lt;/code>，key 是否过期&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>子网路由不生效&lt;/td>
&lt;td>后台是否批准；客户端是否 &lt;code>--accept-routes&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>出口节点无效&lt;/td>
&lt;td>是否 &lt;code>--advertise-exit-node&lt;/code> 且已批准&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>MagicDNS 解析失败&lt;/td>
&lt;td>&lt;code>tailscale dns status&lt;/code>，或系统 DNS 被别的软件接管&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>容器里连不上&lt;/td>
&lt;td>容器需要 &lt;code>/dev/net/tun&lt;/code> 与 &lt;code>NET_ADMIN&lt;/code>，或用 userspace 模式&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>常用命令：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">tailscale status --json &lt;span class="p">|&lt;/span> jq &lt;span class="s1">&amp;#39;.Peer[] | {HostName, Relay, Online}&amp;#39;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tailscale netcheck
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tailscale ping --verbose node-b
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tailscale debug derp-map &lt;span class="c1"># 看 DERP 拓扑&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;hr>
&lt;h2 id="十二什么时候不该用">十二、什么时候不该用
&lt;/h2>&lt;ul>
&lt;li>&lt;strong>两三台固定 IP 的服务器&lt;/strong>：裸 wg 更直接，少一层依赖（就是上一篇的场景）。&lt;/li>
&lt;li>&lt;strong>要求出口 IP 绝对稳定&lt;/strong>：确认 exit node 自身的公网出口和 NAT 行为；DERP 只影响路径，不影响出口 IP。&lt;/li>
&lt;li>&lt;strong>合规禁止第三方协调&lt;/strong>：要么自建 Headscale，要么回到裸 wg。&lt;/li>
&lt;li>&lt;strong>只需要 HTTP 转发&lt;/strong>：反向代理更简单。&lt;/li>
&lt;li>&lt;strong>内网本来就通&lt;/strong>：同 VPC、已有专线，再加一层纯属自找麻烦。&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="小结">小结
&lt;/h2>&lt;p>Tailscale 的价值不在加密，而在&lt;strong>把控制面自动化&lt;/strong>：&lt;/p>
&lt;ol>
&lt;li>&lt;strong>控制面不搬数据&lt;/strong>。它只负责让两端认识彼此，数据面永远是端到端加密。&lt;/li>
&lt;li>&lt;strong>DERP 是兜底不是常态&lt;/strong>。看到 &lt;code>relay&lt;/code> 就该查 NAT 和防火墙，而不是当成正常。&lt;/li>
&lt;li>&lt;strong>它确实少了一层可控性&lt;/strong>。出口节点选择、路径、密钥生命周期都受控制面影响，生产环境要逐条确认。&lt;/li>
&lt;li>&lt;strong>自建 Headscale 能拿回控制权&lt;/strong>，但要接受功能滞后和没有 tailnet lock。&lt;/li>
&lt;/ol>
&lt;p>上一篇的手工 wg 适合&amp;quot;我知道每一台机器在哪&amp;quot;；这一篇的 Tailscale 适合&amp;quot;机器会变、人会加、IP 会漂&amp;quot;。&lt;/p></description></item><item><title>WireGuard 详解：从加密原理到跨 VPC 站点互联</title><link>https://www.zata.cc/p/wireguard-guide/</link><pubDate>Fri, 13 Nov 2026 00:20:00 +0800</pubDate><guid>https://www.zata.cc/p/wireguard-guide/</guid><description>&lt;img src="https://www.zata.cc/p/wireguard-guide/images/index/index.svg" alt="Featured image of post WireGuard 详解：从加密原理到跨 VPC 站点互联" />&lt;p>WireGuard 是一个跑在内核里的三层 VPN。它的配置只有一个接口、一对密钥和若干 peer，没有证书链、没有 IKE 协商、没有几百页的 RFC。&lt;/p>
&lt;p>但它的&amp;quot;简单&amp;quot;是有代价的：&lt;strong>大部分坑都藏在语义里&lt;/strong>——&lt;code>AllowedIPs&lt;/code> 既是路由表又是访问控制表，&lt;code>0.0.0.0/0&lt;/code> 会触发一套你看不到的策略路由，MTU 不对则表现为&amp;quot;能 ping 通但网页打不开&amp;quot;。这篇文章把这些语义拆开讲，最后用一次真实的跨 VPC 组网收尾。&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>你想做的事&lt;/th>
&lt;th>WireGuard 合适吗&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>两台机器/两个网段私网互通&lt;/td>
&lt;td>✅ 首选&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>把自己电脑接进公司内网&lt;/td>
&lt;td>✅ 首选&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>让 A 机房的机器从 B 机房的公网 IP 出去&lt;/td>
&lt;td>✅ 本文场景二&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>按用户身份授权、审计谁访问了什么&lt;/td>
&lt;td>❌ 它只有密钥，没有用户&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>突破网络限制访问外网&lt;/td>
&lt;td>⚠️ 能用，但特征明显、易被识别&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>大规模中心化管控（几百台、动态策略）&lt;/td>
&lt;td>⚠️ 裸 wg 缺控制面，看 &lt;a class="link" href="../tailscale-guide/" >Tailscale&lt;/a> / Headscale&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;hr>
&lt;h2 id="一它是什么不是什么">一、它是什么，不是什么
&lt;/h2>&lt;p>&lt;strong>是&lt;/strong>：一个 L3（网络层）隧道。两端各有一个虚拟网卡 &lt;code>wg0&lt;/code>，往里写的包会被加密封装，从真实网卡发出去；对端解开后还原成原始 IP 包。上层看到的就是两张网卡在同一个网段里。&lt;/p>
&lt;p>&lt;img src="https://www.zata.cc/p/wireguard-guide/images/index/wg-tunnel.svg"
loading="lazy"
alt="WireGuard 数据面：应用发出的包命中 AllowedIPs 后由 wg0 加密，经 eth0 走 UDP 51820 送到对端；对端解封后用同一个 AllowedIPs 校验源地址，不匹配则静默丢弃"
>&lt;/p>
&lt;p>&lt;strong>不是&lt;/strong>：&lt;/p>
&lt;ul>
&lt;li>不是代理。它不解析 HTTP，不区分应用，TCP/UDP/ICMP 同等对待。所以它能承载 MySQL、Redis 这类非 HTTP 流量，这是应用层代理做不到的。&lt;/li>
&lt;li>不是认证系统。没有用户名、没有权限模型，&lt;strong>持有私钥就能进&lt;/strong>。&lt;/li>
&lt;li>不是动态路由协议。不会交换路由，两端看到什么网段完全由配置决定。&lt;/li>
&lt;li>不是 zerotier / tailscale 那种&amp;quot;开箱即用的网状网&amp;quot;。那些是产品，WireGuard 是它们的底座之一。&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="二为什么它快">二、为什么它快
&lt;/h2>&lt;p>快不是因为加密弱，而是因为&lt;strong>把所有决策都提前做完了&lt;/strong>：&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>设计&lt;/th>
&lt;th>效果&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>数据面在内核态&lt;/td>
&lt;td>没有用户态/内核态拷贝，吞吐接近线速&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>密码学原语固定&lt;/td>
&lt;td>Curve25519 / ChaCha20-Poly1305 / BLAKE2s / HKDF，不做算法协商，不存在降级攻击面&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>无连接、无会话状态机&lt;/td>
&lt;td>每个包独立处理，不需要维护连接表&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>一个包一个密钥索引&lt;/td>
&lt;td>收包时靠 4 字节的 receiver index 直接找到 peer，不用遍历&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>代码量约 4000 行&lt;/td>
&lt;td>可审计性是它最大的安全资产&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>对比常见方案：&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>&lt;/th>
&lt;th>WireGuard&lt;/th>
&lt;th>OpenVPN&lt;/th>
&lt;th>IPsec&lt;/th>
&lt;th>Tailscale&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>传输层&lt;/td>
&lt;td>UDP&lt;/td>
&lt;td>UDP/TCP&lt;/td>
&lt;td>ESP&lt;/td>
&lt;td>UDP（wg）&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>握手&lt;/td>
&lt;td>1-RTT&lt;/td>
&lt;td>TLS 多轮&lt;/td>
&lt;td>IKE 多轮&lt;/td>
&lt;td>1-RTT + 控制面&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>配置复杂度&lt;/td>
&lt;td>低&lt;/td>
&lt;td>中&lt;/td>
&lt;td>高&lt;/td>
&lt;td>极低&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>内核实现&lt;/td>
&lt;td>✅&lt;/td>
&lt;td>❌（默认）&lt;/td>
&lt;td>✅&lt;/td>
&lt;td>✅（复用 wg）&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>需要额外控制面&lt;/td>
&lt;td>否&lt;/td>
&lt;td>否&lt;/td>
&lt;td>否&lt;/td>
&lt;td>是&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>移动端漫游&lt;/td>
&lt;td>原生支持&lt;/td>
&lt;td>一般&lt;/td>
&lt;td>一般&lt;/td>
&lt;td>好&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;hr>
&lt;h2 id="三控制面与数据面tailscale-补的是什么">三、控制面与数据面：Tailscale 补的是什么
&lt;/h2>&lt;p>前面讲的都是&lt;strong>数据面&lt;/strong>：加密、封装、路由、MTU。但一个组网系统还有另一半——&lt;strong>控制面&lt;/strong>：谁和谁能通、怎么找到对方、密钥从哪来。&lt;/p>
&lt;p>WireGuard 故意不碰这一层。它只有一个配置文件，而配置文件是静态的。&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>控制面要做的事&lt;/th>
&lt;th>裸 WireGuard 怎么做&lt;/th>
&lt;th>规模化之后&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>身份&lt;/td>
&lt;td>一把密钥 = 一个 peer&lt;/td>
&lt;td>100 台机器 = 100 把密钥手工交换&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>地址分配&lt;/td>
&lt;td>自己在 &lt;code>Address&lt;/code> 里写&lt;/td>
&lt;td>网段冲突靠人脑记&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>密钥轮换&lt;/td>
&lt;td>&lt;code>wg genkey&lt;/code> 重来一遍&lt;/td>
&lt;td>换一把要通知所有对端&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>找到对方&lt;/td>
&lt;td>手工写 &lt;code>Endpoint&lt;/code>&lt;/td>
&lt;td>IP 变了就得挨个改&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>NAT 穿透&lt;/td>
&lt;td>有一端必须有固定可达地址&lt;/td>
&lt;td>两边都在 NAT 后面就没戏&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>访问控制&lt;/td>
&lt;td>&lt;code>AllowedIPs&lt;/code> 手工维护&lt;/td>
&lt;td>N 台机器是 N² 条关系&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>审计&lt;/td>
&lt;td>没有&lt;/td>
&lt;td>只能抓包&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>这就是为什么&amp;quot;两台机器&amp;quot;用裸 wg 最舒服，&amp;ldquo;二十台机器 + 一堆笔记本&amp;quot;就该上控制面了。控制面不是为了加密更强，而是为了&lt;strong>把上面那张表从人工操作变成自动分发&lt;/strong>。&lt;/p>
&lt;p>&lt;img src="https://www.zata.cc/p/wireguard-guide/images/index/wg-plane.svg"
loading="lazy"
alt="控制面与数据面的分工：控制面负责身份、密钥分发、地址分配和直连协调，数据面只负责按已下发的状态加密封装；两者可以完全分离，控制面甚至可以自建"
>&lt;/p>
&lt;p>分界线是这样的：&lt;/p>
&lt;ul>
&lt;li>&lt;strong>数据面&lt;/strong>跑在两端机器上，负责&amp;quot;这个包怎么加密、发给谁&amp;rdquo;——WireGuard 的全部。&lt;/li>
&lt;li>&lt;strong>控制面&lt;/strong>跑在别的地方（也可以是自己的另一台机器），负责&amp;quot;你该有哪些 peer、密钥是什么、它们现在在哪&amp;quot;——WireGuard 完全没有。&lt;/li>
&lt;/ul>
&lt;p>这个划分解释了一个常见困惑：Tailscale、Headscale、Netmaker 这些工具&lt;strong>没有发明新的加密协议&lt;/strong>，用的还是 WireGuard 的包格式和内核模块，只是补上了控制面。所以它们的流量特征、MTU、性能表现和裸 wg 基本一致，差别全在&amp;quot;配置从哪来&amp;quot;。&lt;/p>
&lt;blockquote>
&lt;p>判断要不要控制面，看一个指标就够：&lt;strong>你能否列出所有 peer 的 IP 和密钥。&lt;/strong> 能，就继续手写；不能，就上控制面。这部分展开见下一篇 &lt;a class="link" href="../tailscale-guide/" >Tailscale 详解&lt;/a>。&lt;/p>
&lt;/blockquote>
&lt;hr>
&lt;h2 id="四核心模型cryptokey-routing">四、核心模型：Cryptokey Routing
&lt;/h2>&lt;p>这是理解 WireGuard 的&lt;strong>唯一关键&lt;/strong>。&lt;/p>
&lt;p>一个 peer 长这样：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-ini" data-lang="ini">&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Peer]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PublicKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;对端公钥&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">AllowedIPs&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.99.0.2/32, 172.17.0.0/16&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">Endpoint&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.10.0.10:51820&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>&lt;code>AllowedIPs&lt;/code> 同时承担两个方向的责任：&lt;/p>
&lt;ul>
&lt;li>&lt;strong>出站（发）&lt;/strong>：查路由表，目标 IP 落在哪个 peer 的 &lt;code>AllowedIPs&lt;/code> 里，就用哪个 peer 的公钥加密发出。&lt;strong>它等价于路由表。&lt;/strong>&lt;/li>
&lt;li>&lt;strong>入站（收）&lt;/strong>：解出来的包，源 IP 必须落在该 peer 的 &lt;code>AllowedIPs&lt;/code> 里，否则&lt;strong>直接丢弃&lt;/strong>。&lt;strong>它等价于防火墙。&lt;/strong>&lt;/li>
&lt;/ul>
&lt;p>这个双向设计叫 &lt;strong>Cryptokey Routing&lt;/strong>：用密码学身份来绑 IP，让&amp;quot;谁发的&amp;quot;和&amp;quot;从哪来&amp;quot;成为同一件事。好处是不需要额外的 ACL，坏处是两个语义耦合在一起，改一个地方会同时影响路由和过滤。&lt;/p>
&lt;p>举个例子：如果你在 A 上写 &lt;code>AllowedIPs = 10.99.0.2/32&lt;/code>，但 B 实际用 &lt;code>10.99.0.3&lt;/code> 发过来，包会被静默丢弃，而 &lt;code>wg show&lt;/code> 显示握手正常——这是最常见的&amp;quot;配置看不出错但就是不通&amp;quot;。&lt;/p>
&lt;p>&lt;img src="https://www.zata.cc/p/wireguard-guide/images/index/wg-cryptokey.svg"
loading="lazy"
alt="AllowedIPs 的双向语义：出站时它当路由表选 peer，入站时它当防火墙校验源 IP，源地址不在其中就被静默丢掉，表现为握手正常但 ping 不通"
>&lt;/p>
&lt;hr>
&lt;h2 id="五握手与密钥轮换">五、握手与密钥轮换
&lt;/h2>&lt;p>WireGuard 用 &lt;strong>Noise_IK&lt;/strong> 握手（IK = 发起方已知对端静态公钥），一次往返完成：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">发起方 响应方
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> │ Handshake Initiation (encrypted static + timestamp) │
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├──────────────────────────────────────────────────────&amp;gt;│
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> │&amp;lt;──────────────────────────────────────────────────────┤
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> │ Handshake Response (encrypted empty) │
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>&lt;img src="https://www.zata.cc/p/wireguard-guide/images/index/wg-handshake.svg"
loading="lazy"
alt="WireGuard 握手时序：发起方发送加密的静态公钥与时间戳，响应方回一个加密空包，一次往返后双方派生收发分离的会话密钥，随后数据包用会话密钥加密"
>&lt;/p>
&lt;p>握手成功后双方各派生一对会话密钥（收发分离），随后所有数据包用 ChaCha20-Poly1305 加密。&lt;/p>
&lt;p>几个值得知道的细节：&lt;/p>
&lt;ul>
&lt;li>&lt;strong>每 2 分钟重新握手&lt;/strong>（&lt;code>REKEY_AFTER_TIME&lt;/code>），3 分钟后旧密钥作废（&lt;code>REJECT_AFTER_TIME&lt;/code>）。所以密钥是不断轮换的，具备前向保密。&lt;/li>
&lt;li>&lt;strong>握手是有状态的，数据是无状态的&lt;/strong>。握手结果缓存在内核里，后面的包直接用。&lt;/li>
&lt;li>&lt;strong>有防 DoS 的 cookie 机制&lt;/strong>：握手包过大或压力大时，服务端回一个 cookie，要求客户端证明自己收得到回包，避免伪造源 IP 的放大攻击。&lt;/li>
&lt;li>&lt;strong>时间戳单调递增&lt;/strong>，防止重放握手包。所以&lt;strong>两端时钟差太多会握手失败&lt;/strong>（容器里没同步时间是个经典坑）。&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="六安装">六、安装
&lt;/h2>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># Debian / Ubuntu&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">apt install -y wireguard
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 内核 5.6 以上自带模块，5.6 以下需要 dkms&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">modprobe wireguard &lt;span class="o">&amp;amp;&amp;amp;&lt;/span> lsmod &lt;span class="p">|&lt;/span> grep wireguard
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># CentOS / Rocky&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">dnf install -y wireguard-tools
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># macOS&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">brew install wireguard-tools
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># Windows&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 官方客户端：https://www.wireguard.com/install/&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>工具主要是两个命令：&lt;code>wg&lt;/code>（配置与状态）和 &lt;code>wg-quick&lt;/code>（读配置文件建接口）；生成密钥用 &lt;code>wg genkey&lt;/code> / &lt;code>wg pubkey&lt;/code> 子命令。&lt;/p>
&lt;hr>
&lt;h2 id="七最小可用配置两台机器点对点">七、最小可用配置：两台机器点对点
&lt;/h2>&lt;h3 id="71-生成密钥">7.1 生成密钥
&lt;/h3>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="nb">umask&lt;/span> &lt;span class="m">077&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">wg genkey &lt;span class="p">|&lt;/span> tee privatekey &lt;span class="p">|&lt;/span> wg pubkey &amp;gt; publickey
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">cat privatekey publickey
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>&lt;code>umask 077&lt;/code> 是必须的——私钥文件权限太宽 &lt;code>wg-quick&lt;/code> 会直接拒绝加载。&lt;/p>
&lt;h3 id="72-两端配置">7.2 两端配置
&lt;/h3>&lt;p>A（&lt;code>10.99.0.1&lt;/code>，公网 &lt;code>1.1.1.1&lt;/code>）：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-ini" data-lang="ini">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># /etc/wireguard/wg0.conf&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Interface]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">Address&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.99.0.1/24&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">ListenPort&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">51820&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PrivateKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;A 的私钥&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Peer]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PublicKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;B 的公钥&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">AllowedIPs&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.99.0.2/32&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>B（&lt;code>10.99.0.2&lt;/code>，公网 &lt;code>2.2.2.2&lt;/code>，主动连 A）：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-ini" data-lang="ini">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># /etc/wireguard/wg0.conf&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Interface]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">Address&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.99.0.2/24&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PrivateKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;B 的私钥&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Peer]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PublicKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;A 的公钥&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">AllowedIPs&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.99.0.1/32&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">Endpoint&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">1.1.1.1:51820&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PersistentKeepalive&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">25&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="73-启动">7.3 启动
&lt;/h3>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">wg-quick up wg0 &lt;span class="c1"># 立即生效&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">systemctl &lt;span class="nb">enable&lt;/span> --now wg-quick@wg0 &lt;span class="c1"># 开机自启&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">wg show &lt;span class="c1"># 看握手状态&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>&lt;code>wg show&lt;/code> 的输出里，&lt;code>latest handshake&lt;/code> 是判断链路的&lt;strong>第一指标&lt;/strong>：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">interface: wg0
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> public key: &amp;lt;A 公钥&amp;gt;
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> private key: (hidden)
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> listening port: 51820
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">peer: &amp;lt;B 公钥&amp;gt;
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> endpoint: 2.2.2.2:51820
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> allowed ips: 10.99.0.2/32
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> latest handshake: 12 seconds ago
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> transfer: 1.24 KiB received, 2.31 KiB sent
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;hr>
&lt;h2 id="八配置逐行解释">八、配置逐行解释
&lt;/h2>&lt;table>
&lt;thead>
&lt;tr>
&lt;th>字段&lt;/th>
&lt;th>作用&lt;/th>
&lt;th>常见错误&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>&lt;code>Address&lt;/code>&lt;/td>
&lt;td>本端隧道内 IP，&lt;strong>带掩码&lt;/strong>&lt;/td>
&lt;td>写成 &lt;code>10.99.0.1&lt;/code> 不带 &lt;code>/24&lt;/code> 会导致对端不可达&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>&lt;code>ListenPort&lt;/code>&lt;/td>
&lt;td>本端 UDP 端口&lt;/td>
&lt;td>只在一端写，另一端当客户端时不写也行&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>&lt;code>PrivateKey&lt;/code>&lt;/td>
&lt;td>本端私钥&lt;/td>
&lt;td>权限必须 &lt;code>600&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>&lt;code>PublicKey&lt;/code>（peer 内）&lt;/td>
&lt;td>对端公钥&lt;/td>
&lt;td>与私钥搞混是最常见的复制错误&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>&lt;code>AllowedIPs&lt;/code>&lt;/td>
&lt;td>对端&amp;quot;拥有&amp;quot;的网段&lt;/td>
&lt;td>写大段会抢走本地路由&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>&lt;code>Endpoint&lt;/code>&lt;/td>
&lt;td>对端可达地址&lt;/td>
&lt;td>只在&lt;strong>主动发起&lt;/strong>的一端写；有公网的一端可不写&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>&lt;code>PersistentKeepalive&lt;/code>&lt;/td>
&lt;td>保活间隔（秒）&lt;/td>
&lt;td>NAT 后面的peer 必须写，推荐 25&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>关于 &lt;code>Endpoint&lt;/code>：WireGuard 是&amp;quot;谁先说话谁定地址&amp;quot;。NAT 后面的那一端主动发起，NAT 网关就建立了一条映射；之后对端发的包能顺着这条映射回来。如果两边都在 NAT 后面，必须&lt;strong>至少一端&lt;/strong>有固定可达地址，否则握手发不出去。&lt;/p>
&lt;hr>
&lt;h2 id="九场景二让一台机器成为出口网关">九、场景二：让一台机器成为出口网关
&lt;/h2>&lt;p>需求：B 在另一个机房，希望 B 上的流量从 A 的公网 IP 出去（为了过白名单、为了统一出口 IP）。&lt;/p>
&lt;h3 id="91-先弄清一件事能不能直接默认路由指过去">9.1 先弄清一件事：能不能直接&amp;quot;默认路由指过去&amp;quot;
&lt;/h3>&lt;p>单看网络常识，你可能会想：在 B 上 &lt;code>ip route add default via &amp;lt;A 的私网 IP&amp;gt;&lt;/code> 不就行了？&lt;/p>
&lt;p>&lt;strong>在同一二层网络里可以，跨 VPC / 跨机房不行。&lt;/strong> 原因是路由的下一跳必须是&lt;strong>链路层可达&lt;/strong>的：&lt;/p>
&lt;ul>
&lt;li>内核要发往下一跳，得先 ARP 出它的 MAC。ARP 只在同一个广播域（同一 vSwitch / 同一子网）里有效。&lt;/li>
&lt;li>如果 A 在另一个 VPC，B 的 eth0 上 ARP &lt;code>A 的私网 IP&lt;/code> 没有人应答，包发不出去。&lt;/li>
&lt;li>即使强行 &lt;code>onlink&lt;/code>，包也只是被送到 B 自己的网关，而 B 的网关只会按&amp;quot;目的 IP 是否属于对端 VPC&amp;quot;来转发，&lt;strong>不会把 A 当路由器&lt;/strong>。&lt;/li>
&lt;/ul>
&lt;p>这就是隧道存在的意义：&lt;strong>隧道把 A 变成了一个二层可达的下一跳&lt;/strong>。&lt;code>wg0&lt;/code> 建起来之后，&lt;code>10.99.0.1&lt;/code> 就在 B 的直连网段里，ARP 有回应，路由成立。&lt;/p>
&lt;blockquote>
&lt;p>这一点在云上尤其反直觉：VPC 对等连接能让 &lt;code>ping&lt;/code> 通，但那只是&amp;quot;目的地属于对端 CIDR 的包能过去&amp;quot;，&lt;strong>不支持把对端机器当作下一跳，也不传递路由&lt;/strong>。所以&amp;quot;能 ping 通&amp;quot;和&amp;quot;能当网关&amp;quot;是两件完全不同的事。&lt;/p>
&lt;/blockquote>
&lt;p>&lt;img src="https://www.zata.cc/p/wireguard-guide/images/index/wg-gateway.svg"
loading="lazy"
alt="两种做法对比：直接指定对端私网 IP 作下一跳会因二层不可达而失败，包只会被送到本端 VPC 网关按目的 CIDR 转发；建隧道后网关成为二层可达的下一跳，容器流量经 NAT 从网关公网 IP 出去"
>&lt;/p>
&lt;h3 id="92-网关侧a要做的三件事">9.2 网关侧（A）要做的三件事
&lt;/h3>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-ini" data-lang="ini">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># A: /etc/wireguard/wg0.conf&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Interface]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">Address&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.99.0.1/24&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">ListenPort&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">51820&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PrivateKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;A 的私钥&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">sysctl -w net.ipv4.ip_forward=1&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -A FORWARD -i wg0 -o eth0 -j ACCEPT&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -A FORWARD -i eth0 -o wg0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -t nat -A POSTROUTING -s 10.99.0.0/24 -o eth0 -j MASQUERADE&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostDown&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -D FORWARD -i wg0 -o eth0 -j ACCEPT&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostDown&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -D FORWARD -i eth0 -o wg0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostDown&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -t nat -D POSTROUTING -s 10.99.0.0/24 -o eth0 -j MASQUERADE&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Peer]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PublicKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;B 的公钥&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">AllowedIPs&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.99.0.2/32&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>三件事：&lt;/p>
&lt;ol>
&lt;li>&lt;strong>开转发&lt;/strong>：&lt;code>net.ipv4.ip_forward=1&lt;/code>。没有它，包进来就被丢。&lt;/li>
&lt;li>&lt;strong>放行 FORWARD&lt;/strong>：很多系统默认 &lt;code>FORWARD&lt;/code> 是 DROP。注意 Docker 会往 FORWARD 里插自己的链，如果你的规则顺序不对，会被 docker 的 DROP 吃掉。&lt;/li>
&lt;li>&lt;strong>做源地址转换&lt;/strong>：把 &lt;code>10.99.0.0/24&lt;/code> 的源改成 A 的公网 IP，否则对端（比如数据库）回包不知道怎么回到 10.99.x.x。&lt;/li>
&lt;/ol>
&lt;p>云厂商的安全组也要放行：&lt;strong>入站 UDP 51820 只允许对端 IP&lt;/strong>，不要 &lt;code>0.0.0.0/0&lt;/code>。&lt;/p>
&lt;h3 id="93-客户端侧b为什么要用策略路由">9.3 客户端侧（B）：为什么要用策略路由
&lt;/h3>&lt;p>朴实做法是在 B 上写：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-ini" data-lang="ini">&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Peer]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PublicKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;A 的公钥&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">AllowedIPs&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">0.0.0.0/0&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">Endpoint&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">1.1.1.1:51820&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>但 &lt;code>AllowedIPs = 0.0.0.0/0&lt;/code> 会带来一个死循环风险：所有包都进隧道 → 隧道的外层包本身也要走默认路由 → 又进隧道。&lt;/p>
&lt;p>&lt;code>wg-quick&lt;/code> 已经处理了这个问题，它做的是这三步，而&lt;strong>不是&lt;/strong>直接改默认路由：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">ip route add default dev wg0 table &lt;span class="m">51820&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">ip rule add not fwmark &lt;span class="m">51820&lt;/span> table &lt;span class="m">51820&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">ip rule add table main suppress_prefixlength &lt;span class="m">0&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>逐条解释：&lt;/p>
&lt;ul>
&lt;li>新建一张路由表 &lt;code>51820&lt;/code>，默认路由指向 &lt;code>wg0&lt;/code>。&lt;/li>
&lt;li>&lt;code>not fwmark 51820&lt;/code>：带 fwmark 51820 的包（也就是 WireGuard 自己发出去的加密包）&lt;strong>不查这张表&lt;/strong>，走主表正常出去，死循环解开。&lt;/li>
&lt;li>&lt;code>suppress_prefixlength 0&lt;/code>：主表里比 &lt;code>/0&lt;/code> 更具体的路由优先命中，所以局域网、内网路由不会被隧道抢走。&lt;/li>
&lt;/ul>
&lt;p>&lt;strong>这也是为什么&amp;quot;&lt;code>AllowedIPs&lt;/code> 写大段&amp;quot;很危险&lt;/strong>：它会静默地改变整台机器的路由判决，包括 Docker 的容器网段、云厂商的元数据地址。&lt;/p>
&lt;p>如果只想让特定网段走隧道，就别用 &lt;code>0.0.0.0/0&lt;/code>：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-ini" data-lang="ini">&lt;span class="line">&lt;span class="cl">&lt;span class="na">AllowedIPs&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">172.16.0.0/12, 10.0.0.0/8&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="94-验证出口真的变了">9.4 验证出口真的变了
&lt;/h3>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">curl -s https://ifconfig.me &lt;span class="c1"># 应该返回 A 的公网 IP&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">wg show wg0 transfer &lt;span class="c1"># 看字节数是否在涨&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>如果 &lt;code>ifconfig.me&lt;/code> 返回的还是 B 自己的 IP，但 &lt;code>curl&lt;/code> 能通，说明&lt;strong>路由没生效&lt;/strong>（包走了主表的默认路由），不是隧道没建起来。&lt;/p>
&lt;hr>
&lt;h2 id="十容器怎么走隧道">十、容器怎么走隧道
&lt;/h2>&lt;p>有两种思路，差别在&amp;quot;在哪一层做 NAT&amp;quot;。&lt;/p>
&lt;h3 id="101-宿主机-snat推荐">10.1 宿主机 SNAT（推荐）
&lt;/h3>&lt;p>容器保持自己的网段不变，由宿主机把容器流量丢进隧道：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># B 上：容器网段 -&amp;gt; wg0&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">iptables -t nat -A POSTROUTING -s 172.31.0.0/24 -o wg0 -j MASQUERADE
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>同时在 B 的 &lt;code>AllowedIPs&lt;/code> 里加上目标网段（比如数据库所在网段），A 侧的 &lt;code>AllowedIPs&lt;/code> 要包含 B 的容器网段，否则 A 会把回包丢掉（Cryptokey Routing 的入站校验）。&lt;/p>
&lt;h3 id="102-让容器直接路由">10.2 让容器直接路由
&lt;/h3>&lt;p>把 &lt;code>wg0&lt;/code> 的路由推给容器需要 &lt;code>--cap-add=NET_ADMIN&lt;/code> 或直接共享宿主机网络，一般不值得。&lt;/p>
&lt;h3 id="103-docker-的两个坑">10.3 Docker 的两个坑
&lt;/h3>&lt;p>&lt;strong>坑一：Docker 会改 FORWARD 链。&lt;/strong> 它插入自己的 &lt;code>DOCKER-USER&lt;/code> / &lt;code>DOCKER-FORWARD&lt;/code>，并且把 &lt;code>FORWARD&lt;/code> 策略设为 DROP。如果隧道流量被丢，先查：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">iptables -L FORWARD -n -v --line-numbers &lt;span class="p">|&lt;/span> head -20
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>&lt;strong>坑二：&lt;code>docker0&lt;/code> 的网段可能和对端 IP 撞车。&lt;/strong> Docker 默认用 &lt;code>172.17.0.0/16&lt;/code>，如果你的对端私网 IP 正好是 &lt;code>172.17.x.x&lt;/code>，宿主机访问对端时会走 &lt;code>docker0&lt;/code> 而不是 &lt;code>eth0&lt;/code>，表现为&amp;quot;隧道是好的，但就是连不上那台机器&amp;quot;。&lt;/p>
&lt;p>改掉就好，顺手也把 &lt;code>bip&lt;/code> 统一一下：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-json" data-lang="json">&lt;span class="line">&lt;span class="cl">&lt;span class="c1">// /etc/docker/daemon.json
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1">&lt;/span>&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="nt">&amp;#34;bip&amp;#34;&lt;/span>&lt;span class="p">:&lt;/span> &lt;span class="s2">&amp;#34;172.31.0.1/24&amp;#34;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>改完 &lt;code>systemctl restart docker&lt;/code>（会重建容器，挑窗口）。比打一条 &lt;code>/32&lt;/code> 主机路由补丁干净得多。&lt;/p>
&lt;hr>
&lt;h2 id="十一mtu-与-mss最隐蔽的坑">十一、MTU 与 MSS：最隐蔽的坑
&lt;/h2>&lt;h3 id="111-1420-是怎么来的">11.1 1420 是怎么来的
&lt;/h3>&lt;p>隧道要加壳。一个 1500 字节的物理帧，装进去的真实数据要减掉：&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>开销&lt;/th>
&lt;th>字节&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>外层 IP 头（IPv4 / IPv6）&lt;/td>
&lt;td>20 / 40&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>UDP 头&lt;/td>
&lt;td>8&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>WireGuard 头（type + receiver index + counter）&lt;/td>
&lt;td>16&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Poly1305 认证标签&lt;/td>
&lt;td>16&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>IPv4 外层：&lt;code>1500 - 60 = 1440&lt;/code>；IPv6 外层：&lt;code>1500 - 80 = 1420&lt;/code>。&lt;/p>
&lt;p>&lt;code>wg-quick&lt;/code> 默认写 &lt;strong>1420&lt;/strong>，是按最坏情况（IPv6 外层）预留的。如果你的外层确定是 IPv4，可以调到 1440 多拿 20 字节。&lt;/p>
&lt;p>&lt;img src="https://www.zata.cc/p/wireguard-guide/images/index/wg-mtu.svg"
loading="lazy"
alt="MTU 拆解：1500 字节的帧减去外层 IP、UDP、WG 头和认证标签共 60 或 80 字节，IPv4 外层得到 1440，IPv6 外层得到 wg-quick 默认的 1420"
>&lt;/p>
&lt;p>在 &lt;code>[Interface]&lt;/code> 里显式写：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-ini" data-lang="ini">&lt;span class="line">&lt;span class="cl">&lt;span class="na">MTU&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">1420&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="112-症状">11.2 症状
&lt;/h3>&lt;p>MTU 不对的典型表现，&lt;strong>极其容易误判成&amp;quot;网络不稳定&amp;quot;&lt;/strong>：&lt;/p>
&lt;ul>
&lt;li>&lt;code>ping&lt;/code> 通、&lt;code>ssh&lt;/code> 能登、小请求正常&lt;/li>
&lt;li>一传大文件 / 打开复杂网页就卡死、超时&lt;/li>
&lt;li>TLS 握手偶尔失败（证书链包比较大）&lt;/li>
&lt;li>&lt;code>curl&lt;/code> 小接口正常，返回 JSON 大了就断&lt;/li>
&lt;/ul>
&lt;p>根因是：路径 MTU 发现（PMTUD）依赖 ICMP &lt;code>Fragmentation Needed&lt;/code>，而很多云环境和防火墙把这类 ICMP 丢了，发送方永远不知道要减小分片。&lt;/p>
&lt;h3 id="113-两种修法">11.3 两种修法
&lt;/h3>&lt;p>&lt;strong>修一：MSS clamp（推荐，最省事）&lt;/strong>&lt;/p>
&lt;p>在网关的 FORWARD 链上直接把 TCP MSS 改小：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">iptables -t mangle -A FORWARD -i wg0 -p tcp --tcp-flags SYN,RST SYN &lt;span class="se">\
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="se">&lt;/span> -j TCPMSS --clamp-mss-to-pmtu
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 或者写死，1420 - 40 = 1380&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">iptables -t mangle -A FORWARD -i wg0 -p tcp --tcp-flags SYN,RST SYN &lt;span class="se">\
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="se">&lt;/span> -j TCPMSS --set-mss &lt;span class="m">1380&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>放 &lt;code>PostUp&lt;/code> 里自动化。注意它&lt;strong>只管 TCP&lt;/strong>，UDP（比如 QUIC）不吃这套。&lt;/p>
&lt;p>&lt;strong>修二：验证到底能过多大的包&lt;/strong>&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># -M do 禁止分片，-s 是 ICMP 载荷；1420 MTU 对应 1392&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">ping -M &lt;span class="k">do&lt;/span> -s &lt;span class="m">1392&lt;/span> 10.99.0.1
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>如果 1392 不通但 1372 通，说明实际可用 MTU 还要低 20 字节，说明外层是 IPv6 或中间有额外封装（VXLAN、GRE 叠加时很常见）。&lt;/p>
&lt;hr>
&lt;h2 id="十二allowedips-的四个坑">十二、AllowedIPs 的四个坑
&lt;/h2>&lt;ol>
&lt;li>&lt;strong>写太宽&lt;/strong>：&lt;code>0.0.0.0/0&lt;/code> 会把云厂商元数据地址（&lt;code>100.100.100.200&lt;/code> / &lt;code>169.254.169.254&lt;/code>）也吞进隧道，导致读不到实例元数据。要么加 &lt;code>ip rule&lt;/code> 排除，要么别用全量。&lt;/li>
&lt;li>&lt;strong>两端不对称&lt;/strong>：A 的 &lt;code>AllowedIPs&lt;/code> 必须包含 B 实际使用的&lt;strong>源 IP&lt;/strong>，否则 B 发来的包在 A 侧被静默丢弃。&lt;code>wg show&lt;/code> 里 transfer 只有 received 没有 sent，就是这个症状。&lt;/li>
&lt;li>&lt;strong>同段重叠&lt;/strong>：两个 peer 的 &lt;code>AllowedIPs&lt;/code> 有交集时，只有更具体的条目优先，行为取决于插入顺序，非常难排查。&lt;/li>
&lt;li>&lt;strong>改完不重启&lt;/strong>：&lt;code>wg-quick down &amp;amp;&amp;amp; up&lt;/code> 才会重建路由规则；只 &lt;code>systemctl restart&lt;/code> 有时不够。&lt;/li>
&lt;/ol>
&lt;hr>
&lt;h2 id="十三真实案例跨-vpc-的两台阿里云-ecs">十三、真实案例：跨 VPC 的两台阿里云 ECS
&lt;/h2>&lt;p>这是促使我写这篇文章的一次实际组网。&lt;/p>
&lt;h3 id="131-拓扑">13.1 拓扑
&lt;/h3>&lt;table>
&lt;thead>
&lt;tr>
&lt;th>&lt;/th>
&lt;th>A（网关）&lt;/th>
&lt;th>B（容器出口走 A）&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>公网 IP&lt;/td>
&lt;td>203.0.113.10&lt;/td>
&lt;td>198.51.100.20&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>私网 IP&lt;/td>
&lt;td>10.10.0.10/24&lt;/td>
&lt;td>10.20.0.10/24&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>私网网关&lt;/td>
&lt;td>10.10.0.1&lt;/td>
&lt;td>10.20.0.1&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>VPC&lt;/td>
&lt;td>vpc-aaa…&lt;/td>
&lt;td>vpc-bbb…&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>地域&lt;/td>
&lt;td>上海&lt;/td>
&lt;td>上海&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>两台在&lt;strong>不同 VPC&lt;/strong>，靠 VPC 对等连接打通，&lt;code>ping&lt;/code> 双向 3/3、0.46ms。&lt;/p>
&lt;h3 id="132-一个反直觉的现象">13.2 一个反直觉的现象
&lt;/h3>&lt;p>既然私网通，直觉上直接 &lt;code>ip route add default via 10.10.0.10&lt;/code> 就行了。实测不行。&lt;/p>
&lt;p>看两台的私网路由表就明白了：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># B 上&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">10.10.0.10 via 10.20.0.1 dev eth0 &lt;span class="c1"># 下一跳是 B 自己的 VPC 网关&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># A 上&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">10.20.0.10 via 10.10.0.1 dev eth0 &lt;span class="c1"># 下一跳是 A 自己的 VPC 网关&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>两边都不是直连对端，而是&lt;strong>各自绕自己的 VPC 网关&lt;/strong>。对等连接是点对点的：它只保证&amp;quot;目的地址属于对端 CIDR 的包能过去&amp;quot;，&lt;strong>不支持把对端 ECS 当作下一跳，也不传递路由&lt;/strong>。&lt;/p>
&lt;p>所以 &lt;code>default via 10.10.0.10&lt;/code> 在链路层就不成立——ARP 到的是 VPC 网关，网关看目的地址是公网，直接送公网出口，根本不会进 A。&lt;/p>
&lt;p>&lt;strong>结论：跨 VPC 想让 A 当出口，必须建隧道。&lt;/strong> 在同一 VPC 内则可以走&amp;quot;路由表下一跳 = ECS 实例&amp;quot;（该实例需开启 IP 转发），不需要隧道——这是两者的本质区别，也是选型时最该先确认的一件事：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 两台各跑一次，确认是不是同一个 VPC&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">curl -s http://100.100.100.200/latest/meta-data/vpc-id
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">curl -s http://100.100.100.200/latest/meta-data/vswitch-id
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="133-落地配置">13.3 落地配置
&lt;/h3>&lt;p>这套配置只让 B 的容器网段走隧道，B 宿主机的默认出口保持不动。容器网桥以 &lt;code>docker_gwbridge&lt;/code> 为例，实际名称按 &lt;code>docker network inspect&lt;/code> 的结果替换。&lt;/p>
&lt;p>B（容器出口客户端）：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-ini" data-lang="ini">&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Interface]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">Address&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.99.0.2/24&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PrivateKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;B&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">MTU&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">1420&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">Table&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">off&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">sysctl -w net.ipv4.ip_forward=1&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -t mangle -A PREROUTING -i docker_gwbridge -j MARK --set-mark 0x64&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">ip route add default dev wg0 table 100&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">ip rule add fwmark 0x64 table 100&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -t nat -A POSTROUTING -s 172.31.0.0/24 -o wg0 -j MASQUERADE&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostDown&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -t nat -D POSTROUTING -s 172.31.0.0/24 -o wg0 -j MASQUERADE&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostDown&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">ip rule del fwmark 0x64 table 100&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostDown&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">ip route del default dev wg0 table 100&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostDown&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -t mangle -D PREROUTING -i docker_gwbridge -j MARK --set-mark 0x64&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Peer]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PublicKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;A&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">AllowedIPs&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">0.0.0.0/0&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">Endpoint&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.10.0.10:51820 # 走私网，不出公网&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PersistentKeepalive&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">25&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>A（网关）：&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-ini" data-lang="ini">&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Interface]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">Address&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.99.0.1/24&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">ListenPort&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">51820&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PrivateKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;A&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">MTU&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">1420&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">sysctl -w net.ipv4.ip_forward=1&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -A FORWARD -i wg0 -o eth0 -j ACCEPT&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -A FORWARD -i eth0 -o wg0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -t nat -A POSTROUTING -s 10.99.0.0/24 -o eth0 -j MASQUERADE&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostUp&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -t mangle -A FORWARD -i wg0 -p tcp --tcp-flags SYN,RST SYN -j TCPMSS --clamp-mss-to-pmtu&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostDown&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -D FORWARD -i wg0 -o eth0 -j ACCEPT&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostDown&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -D FORWARD -i eth0 -o wg0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PostDown&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">iptables -t nat -D POSTROUTING -s 10.99.0.0/24 -o eth0 -j MASQUERADE&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">[Peer]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">PublicKey&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">&amp;lt;B&amp;gt;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">AllowedIPs&lt;/span> &lt;span class="o">=&lt;/span> &lt;span class="s">10.99.0.2/32 # B 的容器已在 B 上 SNAT 成 10.99.0.2&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="134-验证">13.4 验证
&lt;/h3>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># B 的宿主机：仍然是 B 自己的公网 IP&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">curl -s https://ifconfig.me &lt;span class="c1"># -&amp;gt; 198.51.100.20&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># B 的容器：应变成 A 的公网 IP&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">docker run --rm curlimages/curl -s https://ifconfig.me &lt;span class="c1"># -&amp;gt; 203.0.113.10&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 确认宿主机的默认路由没有被 wg0 接管&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">ip route get 1.1.1.1 &lt;span class="c1"># 应显示 dev eth0&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>第三条容易被忽略：如果 B 还对外提供别的服务，&lt;strong>必须确认只有该走隧道的流量走了隧道&lt;/strong>，主机自身的默认出口不能变。上面用 &lt;code>Table = off&lt;/code> + fwmark 只把标记过的容器流量送进 table 100，宿主机默认路由仍在 main 表；&lt;code>ip route get&lt;/code> 看的是内核实际选路，比 &lt;code>curl --interface&lt;/code> 更能证明默认出口没变。&lt;/p>
&lt;h3 id="135-这次组网的两个额外收获">13.5 这次组网的两个额外收获
&lt;/h3>&lt;ul>
&lt;li>&lt;strong>走私网建隧道，带宽不计费&lt;/strong>：外层是 &lt;code>10.20.0.10 → 10.10.0.10&lt;/code>，全程不出公网，只多 60 字节头部。&lt;/li>
&lt;li>&lt;strong>上游白名单不用改&lt;/strong>：如果 RDS / Nacos 的白名单里本来就有 A 的公网 IP，NAT 之后源 IP 仍是 A，白名单零改动。这是&amp;quot;让 A 当出口&amp;quot;相比&amp;quot;把 B 迁进 A 的 VPC&amp;quot;最大的成本优势。&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="十四安全边界">十四、安全边界
&lt;/h2>&lt;p>WireGuard 很安全，但它的安全边界非常锐利：&lt;strong>私钥 = 完整身份&lt;/strong>。&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>项&lt;/th>
&lt;th>要求&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>私钥文件&lt;/td>
&lt;td>&lt;code>600&lt;/code>，不进版本库，不进备份的明文快照&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>安全组 / 防火墙&lt;/td>
&lt;td>UDP 51820 只对&lt;strong>具体对端 IP&lt;/strong> 开放，不要 &lt;code>0.0.0.0/0&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>&lt;code>AllowedIPs&lt;/code>&lt;/td>
&lt;td>按最小必要写，它同时是防火墙规则&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>密钥轮换&lt;/td>
&lt;td>员工离职 / 设备丢失要立即删 peer，&lt;strong>没有&amp;quot;改密码&amp;quot;这回事&lt;/strong>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>审计&lt;/td>
&lt;td>wg 本身没有访问日志，需要审计只能靠网络层抓包或上层应用日志&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>几个常被忽略的点：&lt;/p>
&lt;ul>
&lt;li>&lt;strong>不要把服务端配置整份发出去排障&lt;/strong>。&lt;code>wg0.conf&lt;/code> 里的 &lt;code>PrivateKey&lt;/code> 泄露等于把内网入口送人。发之前把 &lt;code>PrivateKey&lt;/code> 行删掉，或者只发 &lt;code>wg show&lt;/code> 的脱敏输出。&lt;/li>
&lt;li>&lt;strong>一台机器一把密钥&lt;/strong>。共用一把密钥时，撤销一个人就得让所有人重配。&lt;/li>
&lt;li>&lt;strong>隧道不等于隔离&lt;/strong>。能进隧道不代表能被信任，容器、数据库的访问控制还要在各自层面做。&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="十五日常运维命令">十五、日常运维命令
&lt;/h2>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-bash" data-lang="bash">&lt;span class="line">&lt;span class="cl">wg show &lt;span class="c1"># 全部接口 + 握手 + 流量&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">wg show wg0 transfer &lt;span class="c1"># 只看流量（判断是否真有数据）&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">wg show wg0 latest-handshakes &lt;span class="c1"># 只看握手时间戳&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">wg show wg0 endpoints &lt;span class="c1"># 看对端当前地址（NAT 后很有用）&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">wg-quick up wg0 / down wg0 &lt;span class="c1"># 起停&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">wg syncconf wg0 &amp;lt;&lt;span class="o">(&lt;/span>wg-quick strip wg0&lt;span class="o">)&lt;/span> &lt;span class="c1"># 改配置后热加载，不断连&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">ip -4 rule show &lt;span class="c1"># 确认策略路由是否生效&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">ip route show table &lt;span class="m">51820&lt;/span> &lt;span class="c1"># 看 wg-quick 建的那张表&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">tcpdump -ni wg0 -c &lt;span class="m">20&lt;/span> &lt;span class="c1"># 抓隧道内的明文包（已解密）&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>&lt;code>wg syncconf&lt;/code> 值得记住：改 &lt;code>AllowedIPs&lt;/code> 或加 peer 时用它，比 &lt;code>down/up&lt;/code> 少一次断连。&lt;/p>
&lt;hr>
&lt;h2 id="十六排障表">十六、排障表
&lt;/h2>&lt;table>
&lt;thead>
&lt;tr>
&lt;th>症状&lt;/th>
&lt;th>大概率原因&lt;/th>
&lt;th>查什么&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>&lt;code>latest handshake&lt;/code> 一直空&lt;/td>
&lt;td>握手包没到 / 私钥配对错 / 时钟偏差大&lt;/td>
&lt;td>&lt;code>tcpdump -ni eth0 udp port 51820&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>握手正常但 ping 不通&lt;/td>
&lt;td>&lt;code>AllowedIPs&lt;/code> 不含对端实际源 IP&lt;/td>
&lt;td>&lt;code>wg show&lt;/code> 的 transfer 是否只有一半&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>单向通&lt;/td>
&lt;td>一侧 FORWARD 或 MASQUERADE 缺&lt;/td>
&lt;td>&lt;code>iptables -L FORWARD -n -v&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>&lt;code>ping&lt;/code> 通但 TCP 卡死&lt;/td>
&lt;td>MTU / MSS&lt;/td>
&lt;td>&lt;code>ping -M do -s 1392&lt;/code>、加 TCPMSS&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>能连隧道内 IP，不能连隧道外&lt;/td>
&lt;td>对端没开 &lt;code>ip_forward&lt;/code>&lt;/td>
&lt;td>&lt;code>sysctl net.ipv4.ip_forward&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>容器不走隧道&lt;/td>
&lt;td>容器网段没在 &lt;code>AllowedIPs&lt;/code> / 没 SNAT&lt;/td>
&lt;td>&lt;code>iptables -t nat -L POSTROUTING -n -v&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>宿主机连不上某台内网机&lt;/td>
&lt;td>&lt;code>docker0&lt;/code> 网段与目标重叠&lt;/td>
&lt;td>&lt;code>ip route get &amp;lt;目标IP&amp;gt;&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>改动后行为不变&lt;/td>
&lt;td>只改了文件没重载&lt;/td>
&lt;td>&lt;code>wg syncconf&lt;/code> 或 &lt;code>down/up&lt;/code>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;code>ip route get 10.99.0.2&lt;/code> 是排查的第一条命令：它直接告诉你内核&lt;strong>实际&lt;/strong>会从哪个接口、走哪个源地址发出去，比看配置文件可靠。&lt;/p>
&lt;hr>
&lt;h2 id="十七什么时候不该用-wireguard">十七、什么时候不该用 WireGuard
&lt;/h2>&lt;ul>
&lt;li>&lt;strong>需要按人授权、审计、动态策略&lt;/strong>：你没有用户模型，得靠 &lt;a class="link" href="../tailscale-guide/" >Tailscale&lt;/a> 这类带控制面的方案，或自建 Headscale。&lt;/li>
&lt;li>&lt;strong>只有 HTTP 流量要转发&lt;/strong>：反向代理更简单，还省掉一层网络复杂度。&lt;/li>
&lt;li>&lt;strong>两端在同一 vSwitch&lt;/strong>：直接内网互通，加隧道是自找麻烦。&lt;/li>
&lt;li>&lt;strong>云上已经有一个可用的私网路由方案&lt;/strong>：比如同 VPC 下用&amp;quot;路由表下一跳 = ECS 实例&amp;quot;，或者云企业网已经打通，这时隧道是重复建设。&lt;/li>
&lt;li>&lt;strong>需要 TCP 模式穿透极严格防火墙&lt;/strong>：wg 只走 UDP，被限 UDP 时只能上 wstunnel 之类的封装。&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="小结">小结
&lt;/h2>&lt;p>WireGuard 的配置只有十几行，但要把它用对，需要记住三件事：&lt;/p>
&lt;ol>
&lt;li>&lt;strong>&lt;code>AllowedIPs&lt;/code> 是路由表 + 防火墙，改它等于同时改两个东西。&lt;/strong>&lt;/li>
&lt;li>&lt;strong>下一跳必须二层可达&lt;/strong>，所以&amp;quot;跨 VPC 借道另一台机器&amp;quot;必须建隧道；能 ping 通不代表能当网关。&lt;/li>
&lt;li>&lt;strong>MTU 不对的表现是&amp;quot;小包正常、大包卡死&amp;quot;&lt;/strong>，别把它当成网络抖动。&lt;/li>
&lt;/ol>
&lt;p>剩下的都是工程细节：私钥像密码一样管、安全组只放对端、容器网段记得在两端 &lt;code>AllowedIPs&lt;/code> 里对齐。&lt;/p></description></item></channel></rss>