跳转至

macOS客户端配置

创建配置文件目录(按需)

首先确保配置文件目录存在(brew 安装后一般已自动创建,可验证):

# M1/M2/M3 芯片
mkdir -p /opt/homebrew/etc/wireguard

# Intel 芯片(备用)
# mkdir -p /usr/local/etc/wireguard

编写 WireGuard 配置文件

新建配置文件(以常用的 wg0.conf 为例),替换为你的服务商提供的配置内容:

# 用编辑器打开配置文件(M1/M2/M3)
nano /opt/homebrew/etc/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 隧道

# 启动隧道(M1/M2/M3,需 sudo 权限)
sudo wg-quick up wg0

# 停止隧道
sudo wg-quick down wg0

验证隧道是否生效

# 查看隧道状态
wg show wg0

# 检查网络接口(会看到 wg0 接口)
ifconfig wg0

# 测试网络(验证是否走 WireGuard 隧道)
curl ip.cn  
# 查看出口IP是否为服务端IP

macOS 下的注意事项

  1. 权限问题:操作 wg-quick 必须加 sudo,否则会提示权限不足(无法创建网络接口)。
  2. 配置文件路径:M 芯片 macOS 优先用 /opt/homebrew/etc/wireguard/,不要放到 /etc/(默认无写入权限)。
  3. DNS 生效:macOS 下 wg-quick 的 DNS 配置可能需要手动刷新,若 DNS 不生效,可执行:
sudo scutil --dns  
# 查看当前DNS
sudo networksetup -setdnsservers Wi-Fi 8.8.8.8  
# 临时设置Wi-Fi的DNS
  1. 开机自启(可选) :macOS 下可通过 launchd 配置自启,避免每次手动启动:
# 创建自启配置文件
sudo nano /Library/LaunchDaemons/com.wireguard.wg0.plist
  1. 粘贴以下内容(替换路径为你的实际路径):
<?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>
  1. 加载并启动自启服务:
sudo launchctl load /Library/LaunchDaemons/com.wireguard.wg0.plist
sudo launchctl start com.wireguard.wg0

总结

  1. 核心结论:你的 WireGuard 工具已完全安装成功,无需再做安装相关操作。
  2. 关键步骤:创建配置文件 → 用 sudo wg-quick up wg0 启动隧道 → 验证出口 IP。
  3. 注意点:macOS 需关注配置文件路径(M 芯片用 /opt/homebrew/etc/)和 sudo 权限,这是最容易踩坑的地方。