流量怎样进入 WireGuard
此处的 WireGuard 出站借助内建网络设备建立三层隧道。只有被分流至该出站的 TCP 或 UDP 连接才会进入其中,操作系统的默认路由不会因此被全部接管。
先区分本地接口与远端 Peer:地址、私钥描述本地;连接端点、公钥及 Allowed IPs 描述对端,填写时应放在各自所属层级。
只有单一 Peer 时怎样填写
单一 Peer 可采用顶层简写,将远端端点与公钥放在同一对象。创建本地隧道地址还需要 ip 或 ipv6,不能同时缺失。
name必填- 这是供策略组或规则使用的出站引用名。
type必填- 协议类型指定为
wireguard。 private-key必填- 在此填写以 Base64 表示的本地私钥,并妥善保管。
ip条件必填- 本地隧道的 IPv4 地址;若未填,就需提供
ipv6。 ipv6条件必填- 本地隧道的 IPv6 地址;仅使用 IPv4 时可不设置。
server必填- 指向对端 Peer 的主机地址,可为域名或 IP。
port必填- 此项是远端 WireGuard 实际监听的端口。
public-key必填- 对端公钥需要采用 Base64 编码。
- 单 Peer 简写路由处理
- 简写依本地地址族补出
0.0.0.0/0与::/0默认路由;顶层另设的allowed-ips不会被这里记录的逻辑读取。
多个 Peer 应放入数组
多对端配置以 peers 分项列出远端端点及密钥。本地 private-key、ip 或 ipv6 则留在顶层,用来描述共用接口。
各 Peer 的 allowed-ips 不可留空,多个对端还应按网段划分。启用 peers 后,顶层 server、port、public-key 及 pre-shared-key 不再读取;reserved 仍可作为对端未单设该项时的回退值。
| 所在层级 | 参数名称 | 填写目的 |
|---|---|---|
| 顶层对象 | private-key、ip、ipv6 | 描述共用的本地接口 |
| 顶层对象 | peers | 列出需要连接的各个 Peer |
| 顶层对象 | reserved | 为没有单独设置 reserved 的对端提供默认值 |
| 对端数组项 | server、port、public-key | 确定远端地址与公钥身份 |
| 对端数组项 | allowed-ips | 不得为空,并应避免多个对端网段混淆 |
| 对端数组项 | pre-shared-key、reserved | 依对端要求选填 |
建连后仍需检查的设置
初始化会先检查密钥及参数格式。若端点可达而隧道内没有数据,应继续核对保活、MTU 与 Allowed IPs,再检查入口分流条件。
pre-shared-key按需- 若使用额外预共享密钥,应以 Base64 表示,并与指定对端保持相同。
reserved按需- 这是 WireGuard 的保留值,仅在远端有要求时填写。
persistent-keepalive按需- 定期发送保活报文,时间单位为秒,适用于需要维持 NAT 映射的连接。
mtu按需- 设置内建隧道设备的 MTU;没有明确需求时可沿用预设。
udp按需- 决定应用侧的 UDP 流量能否通过该出站进入隧道。
dialer-proxy按需- 可以选用其他出站或策略组,作为连接此端点的路径。
解析器与隧道扩展
进入隧道的域名请求可使用该出站专用的 DNS。若远端使用扩展协议,还需核对双方扩展配置及其版本要求。
remote-dns-resolve按需- 设为
true后才允许借此出站远程解析;初始值为false。 dns条件生效- 这里列出解析服务器;仅在
remote-dns-resolve: true时参与工作。 amnezia-wg-option高级- 提供此对象会启用相应隧道扩展,各项值需对照远端设置。
对照标准参数设置找到对应项
先将 [Interface] 下的 Address、PrivateKey 对应到顶层;再把 [Peer] 的 Endpoint、PublicKey、AllowedIPs 对应到对端项。ListenPort 描述本地监听,不能直接当作远端 port。
示例密钥只展示格式,不能完成实际认证。自定网段时,allowed-ips 应放在 peers 的各对端项中,不能依赖顶层简写。
- 报 missing local address 时,先确认是否漏填本地
ip或ipv6。 - 密钥无法解码时,检查内容是否确为 Base64,避免误贴文件路径或十六进制表示。
- 报 missing allowed_ips 时,逐个检查 Peer 的网段列表,确保各项均非空。
- 已握手却没有数据,再依次核实公钥、Allowed IPs、防火墙、NAT 与 MTU。
proxies:
- name: wg-node
type: wireguard
private-key: ZXhhbXBsZS1jbGllbnQtcHJpdmF0ZS1rZXktMDAwMDA=
ip: 10.0.0.2
server: 203.0.113.10
port: 51820
public-key: ZXhhbXBsZS1wZWVyLXB1YmxpYy1rZXktMDAwMDAwMDA=
udp: true
mtu: 1408
persistent-keepalive: 25