macOS客户端配置¶
创建配置文件目录(按需)¶
首先确保配置文件目录存在(brew 安装后一般已自动创建,可验证):
# M1/M2/M3 芯片
mkdir -p /opt/homebrew/etc/wireguard
# Intel 芯片(备用)
# mkdir -p /usr/local/etc/wireguard
编写 WireGuard 配置文件¶
新建配置文件(以常用的 wg0.conf 为例),替换为你的服务商提供的配置内容:
配置文件模板(替换成你的实际参数):
[Interface]
PrivateKey = <在客户端本机生成的私钥>
Address = 分配给你的内网IP(如:10.0.0.2/32)
DNS = 可选DNS(如:8.8.8.8)
MTU = 1420
# macOS 推荐值
[Peer]
PublicKey = <服务端公钥>
Endpoint = 服务端IP:端口(如:203.0.113.89:51820)
AllowedIPs = 0.0.0.0/0
# 所有流量走隧道(按需改为特定网段)
PersistentKeepalive = 25
# 保持连接(NAT环境必备)
保存退出:按 Ctrl+O → 回车 → Ctrl+X。
启动 / 停止 WireGuard 隧道¶
验证隧道是否生效¶
# 查看隧道状态
wg show wg0
# 检查网络接口(会看到 wg0 接口)
ifconfig wg0
# 测试网络(验证是否走 WireGuard 隧道)
curl ip.cn
# 查看出口IP是否为服务端IP
macOS 下的注意事项¶
- 权限问题:操作
wg-quick必须加sudo,否则会提示权限不足(无法创建网络接口)。 - 配置文件路径:M 芯片 macOS 优先用
/opt/homebrew/etc/wireguard/,不要放到/etc/(默认无写入权限)。 - DNS 生效:macOS 下
wg-quick的 DNS 配置可能需要手动刷新,若 DNS 不生效,可执行:
- 开机自启(可选) :macOS 下可通过 launchd 配置自启,避免每次手动启动:
- 粘贴以下内容(替换路径为你的实际路径):
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict><key>Label</key><string>com.wireguard.wg0</string><key>ProgramArguments</key><array><string>/opt/homebrew/bin/wg-quick</string><string>up</string><string>wg0</string></array><key>RunAtLoad</key><true/><key>KeepAlive</key><true/><key>UserName</key><string>root</string></dict></plist>
- 加载并启动自启服务:
sudo launchctl load /Library/LaunchDaemons/com.wireguard.wg0.plist
sudo launchctl start com.wireguard.wg0
总结¶
- 核心结论:你的 WireGuard 工具已完全安装成功,无需再做安装相关操作。
- 关键步骤:创建配置文件 → 用
sudo wg-quick up wg0启动隧道 → 验证出口 IP。 - 注意点:macOS 需关注配置文件路径(M 芯片用
/opt/homebrew/etc/)和 sudo 权限,这是最容易踩坑的地方。