代理协议 · 配置文档

WireGuard 按 Peer 数量选择字段结构并检查隧道路由

本地接口与远端 Peer 的字段应分开填写,再检查隧道路由、保活、报文尺寸及远程解析的依赖关系。

  • private-key
  • public-key
  • allowed-ips
  • MTU
  • DNS
章节索引

流量怎样进入 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。
YAML
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