在服务器上搭建 WireGuard VPN
在 Debian 或 Ubuntu 上安装 WireGuard,添加 Windows、macOS、Linux 和移动设备客户端,配置路由与防火墙,并将 SSH 限定在 VPN 内。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何将您的服务器变成 WireGuard 网关。您的设备通过加密隧道连接到它,之后即可访问服务器上的私有服务,并且在需要时还可以使用服务器的 IP 地址访问互联网。
完成本指南后,您将拥有一个随服务器启动的 VPN、一个可正常使用的首个客户端,以及添加或吊销设备的方法。
订购服务器
本指南适用于由您自行管理的服务器:
前提条件
- 运行 Debian 12 或 13,或 Ubuntu 22.04 或 24.04 的服务器
- 使用具有
sudo权限的用户进行 SSH 访问 - 服务器的公网 IPv4 地址,本文记作
您的服务器IP - 一台客户端设备:Windows、macOS、Linux、Android 或 iOS
地址规划与端口
本指南使用以下取值。如果 10.8.0.0/24 已在您的某个网络中使用,请选择其他网段。
| 元素 | 值 |
|---|---|
| VPN 接口 | wg0 |
| VPN 网络 | 10.8.0.0/24 |
| 服务器在 VPN 中的地址 | 10.8.0.1 |
| 第一个客户端 | 10.8.0.2 |
| 需要开放的入站端口 | 51820/udp |
本指南在隧道中路由 IPv4。客户端配置同时会阻止 IPv6,以防其绕过 VPN。
步骤 1:安装 WireGuard
相关系统的 Linux 内核已集成 WireGuard。发行版的官方软件包提供 wg 和 wg-quick 工具。请打开 root shell,然后安装它们:
sudo -i
apt update
apt install -y wireguard iptables qrencode除非另有说明,需要在服务器上运行的命令都在该 root shell 中执行。
步骤 2:启用 IPv4 路由
服务器必须能够将客户端的数据包转发到互联网:
cat > /etc/sysctl.d/99-wireguard.conf <<EOF
net.ipv4.ip_forward = 1
EOF
sysctl -p /etc/sysctl.d/99-wireguard.conf该命令应显示 net.ipv4.ip_forward = 1。
步骤 3:生成服务器密钥
cd /etc/wireguard
umask 077
wg genkey | tee server.key | wg pubkey > server.pub
IFACE=$(ip -4 route show default | awk '{print $5; exit}')
echo "$IFACE"最后一条命令会显示公网网络接口,例如 eth0 或 ens18。如果没有任何输出,说明服务器没有默认的 IPv4 路由:请先解决这个问题再继续。请保持该 shell 处于打开状态,因为下一步会用到变量 IFACE。
步骤 4:创建服务器配置
cat > /etc/wireguard/wg0.conf <<EOF
[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = $(cat /etc/wireguard/server.key)
PostUp = iptables -t nat -A POSTROUTING -s 10.8.0.0/24 -o $IFACE -j MASQUERADE
PostUp = iptables -I FORWARD -i %i -o $IFACE -j ACCEPT
PostUp = iptables -I FORWARD -i $IFACE -o %i -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
PreDown = iptables -t nat -D POSTROUTING -s 10.8.0.0/24 -o $IFACE -j MASQUERADE
PreDown = iptables -D FORWARD -i %i -o $IFACE -j ACCEPT
PreDown = iptables -D FORWARD -i $IFACE -o %i -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
EOF
chmod 600 /etc/wireguard/wg0.confPostUp 行在隧道启动时执行,PreDown 行在隧道停止时执行。它们将客户端的地址隐藏在服务器地址之后,并允许客户端的流量穿过这台机器。%i 会被替换为接口名称,此处为 wg0。这些规则被放在 FORWARD 链的最前面:即使 UFW 或 Docker 默认阻止转发,它们也同样生效。
步骤 5:开放防火墙
如果 UFW 处于启用状态,请允许 WireGuard 端口:
ufw allow 51820/udp
ufw status步骤 6:启动 VPN
systemctl enable --now wg-quick@wg0
systemctl status wg-quick@wg0 --no-pager
wg show
ss -lun | grep 51820wg show 应显示接口 wg0、其公钥以及端口 51820。该服务会随服务器自动重新启动。
步骤 7:添加客户端
请为客户端选择一个名称,以及 VPN 中的一个空闲地址。每添加一个新客户端,都要修改这两个值:
cd /etc/wireguard
umask 077
mkdir -p clients
CLIENT=laptop
CLIENT_IP=10.8.0.2
wg genkey | tee clients/$CLIENT.key | wg pubkey > clients/$CLIENT.pub
wg genpsk > clients/$CLIENT.psk
cat >> wg0.conf <<EOF
[Peer]
# $CLIENT
PublicKey = $(cat clients/$CLIENT.pub)
PresharedKey = $(cat clients/$CLIENT.psk)
AllowedIPs = $CLIENT_IP/32
EOF
systemctl reload wg-quick@wg0重新加载会应用客户端列表,而不会断开已连接的客户端。预共享密钥在 WireGuard 中是可选的:它会增加一层对称加密。
然后创建供设备使用的文件:
cat > clients/$CLIENT.conf <<EOF
[Interface]
PrivateKey = $(cat clients/$CLIENT.key)
Address = $CLIENT_IP/32
DNS = 1.1.1.1, 9.9.9.9
[Peer]
PublicKey = $(cat server.pub)
PresharedKey = $(cat clients/$CLIENT.psk)
Endpoint = 您的服务器IP:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25
EOF当设备位于路由器或 NAT 网络之后时,PersistentKeepalive = 25 可保持隧道畅通。
步骤 8:连接设备
从 WireGuard 官方页面安装应用,然后导入配置。
Android 和 iOS
在终端中显示二维码,然后在应用中通过添加隧道的功能扫描它:
qrencode -t ansiutf8 < clients/$CLIENT.confWindows 和 macOS
显示该文件:
cat clients/$CLIENT.conf将其内容复制到您电脑上的文件 laptop.conf 中,然后在应用中通过 Import tunnel(s) from file 导入。接着启用该隧道。
Linux
在该电脑上安装 wireguard,然后将配置复制到 /etc/wireguard/wg0.conf:
sudo apt install -y wireguard
sudo nano /etc/wireguard/wg0.conf
sudo chmod 600 /etc/wireguard/wg0.conf
sudo wg-quick up wg0要停止隧道,请使用 sudo wg-quick down wg0。
删除服务器上的机密文件
设备配置完成后,服务器不再需要它的私钥。在服务器上执行:
shred -u clients/$CLIENT.key clients/$CLIENT.psk clients/$CLIENT.conf验证运行情况
在服务器上,该客户端应显示 latest handshake,并且 transfer 计数器不断增长:
wg show在 Linux 或 macOS 客户端上,依次测试隧道和出口地址:
ping -c 3 10.8.0.1
curl -4 https://ifconfig.meping 应有响应,curl 应显示 您的服务器IP。在 Windows 上,请使用 ping 10.8.0.1,然后在浏览器中查看您的公网 IP 地址。
选择经过隧道的流量
客户端的 AllowedIPs 参数决定哪些流量会发送到 VPN 中:
| 需求 | 客户端的 AllowedIPs |
|---|---|
| 所有流量都经过服务器 | 0.0.0.0/0, ::/0 |
| 仅 VPN 网络 | 10.8.0.0/24 |
| VPN 以及服务器所在的一个私有网络 | 10.8.0.0/24, 192.168.50.0/24 |
使用 ::/0 时,IPv6 流量会进入隧道,但不会从隧道中出去,因为本指南只路由 IPv4。应用随后会回退到 IPv4,不会有流量泄漏到 VPN 之外。
若要访问与服务器相连的私有网络,还需要为该接口添加 PostUp 和 PreDown 行(参照步骤 4),然后重启隧道。
在服务器端,AllowedIPs 指明每个客户端可以使用的地址。请为每个客户端保留一个 /32 地址。若要访问位于某个客户端后面的网络,请将其添加到该行,例如 AllowedIPs = 10.8.0.3/32, 192.168.1.0/24。该客户端自身也必须允许路由到它的网络。
让客户端之间互相通信
根据 FORWARD 链的策略,客户端之间可能能够也可能无法互相访问。若要固定这一行为,请在 /etc/wireguard/wg0.conf 的 [Interface] 部分添加下面两组行中的一组。
允许互相通信:
PostUp = iptables -I FORWARD -i %i -o %i -j ACCEPT
PreDown = iptables -D FORWARD -i %i -o %i -j ACCEPT禁止互相通信:
PostUp = iptables -I FORWARD -i %i -o %i -j DROP
PreDown = iptables -D FORWARD -i %i -o %i -j DROP[Interface] 部分的更改需要重启才能生效,这会短暂中断 VPN:
systemctl restart wg-quick@wg0将 SSH 限定在 VPN 内
VPN 验证通过后,您可以在公网地址上关闭 SSH。本节假定 UFW 已启用,并且默认拒绝入站连接,可以用 ufw status verbose 确认。如果您使用其他端口,请相应调整端口 22。
允许来自 VPN 的 SSH:
ufw allow in on wg0 to any port 22 proto tcp在已连接 VPN 的客户端上,打开一个新的会话:
ssh 您的用户名@10.8.0.1如果连接正常,请删除公网规则,然后检查结果:
ufw status numbered
ufw delete allow 22/tcp
ufw status verbose如果您的规则名称不同,例如 OpenSSH,请使用 ufw delete allow OpenSSH。您也可以按编号删除:ufw delete 编号。
吊销客户端
在 /etc/wireguard/wg0.conf 中删除该设备的 [Peer] 块,然后重新加载配置:
nano /etc/wireguard/wg0.conf
systemctl reload wg-quick@wg0
wg show该客户端不应再出现。同时请删除 /etc/wireguard/clients/laptop.pub。如果服务器的私钥已经泄露,请生成新的私钥,并将配置重新分发给所有客户端。
更新
工具通过 APT 更新,WireGuard 模块则随内核更新:
apt update
apt upgrade -y
wg --version内核更新后请重启服务器。VPN 会自动恢复运行,但如果 SSH 被限定在 VPN 内,请预先准备其他访问方式。
备份与恢复
文件夹 /etc/wireguard 包含密钥和客户端列表:
tar -czf /root/wireguard-$(date +%F).tar.gz -C /etc wireguard sysctl.d/99-wireguard.conf
chmod 600 /root/wireguard-$(date +%F).tar.gz该归档包含私钥:请加密后保存在服务器之外。
要在已安装相关软件包的服务器上恢复,请将 YYYY-MM-DD 替换为归档的日期:
tar -xzf /root/wireguard-YYYY-MM-DD.tar.gz -C /etc
sysctl -p /etc/sysctl.d/99-wireguard.conf
systemctl enable --now wg-quick@wg0如果公网接口的名称发生了变化,请在启动之前在 PostUp 和 PreDown 行中修正。
故障排除
wg show 中没有 latest handshake
客户端无法建立隧道。WireGuard 从不响应未经认证的数据包,因此端口扫描器无法说明任何问题。请在客户端尝试连接的同时,在服务器上观察流量是否到达:
apt install -y tcpdump
tcpdump -ni any udp port 51820- 没有任何数据包到达:请检查
Endpoint、UFW 规则以及客户端的网络。如果一切正常,请通过客户中心联系支持团队,确认上游是否存在过滤。 - 数据包到达但没有响应:密钥不匹配。请将客户端的
PublicKey与server.pub进行比对,并将[Peer]块中的密钥与客户端的密钥进行比对。
隧道已建立,但无法上网
请依次检查路由、NAT 和转发:
sysctl net.ipv4.ip_forward
ip -4 route show default
iptables -t nat -S POSTROUTING
iptables -S FORWARD规则中的接口必须是默认路由所使用的接口。如果不同,请修正 wg0.conf,然后运行 systemctl restart wg-quick@wg0。
VPN 正常,但域名无法解析
请在客户端上测试 ping 1.1.1.1。如果测试成功,则问题出在 DNS:请检查客户端的 DNS 行,或指定另一个解析器。
Linux 客户端上出现 resolvconf: command not found
wg-quick 需要该工具来应用 DNS 行。请安装 openresolv;如果您只路由 VPN 网络,也可以删除这一行。
iptables: command not found
缺少该软件包,这在 Debian 最小化安装中很常见。请安装它,然后重新启动服务:
apt install -y iptables
systemctl restart wg-quick@wg0RTNETLINK answers: Operation not supported
内核无法创建该接口。在容器中运行且宿主机不支持 WireGuard 的系统就属于这种情况。请使用 modprobe wireguard 检查模块。
modprobe: FATAL: Module wireguard not found
内核往往已更新但尚未重启。请将 uname -r 与 /lib/modules 的内容进行比较,然后重启服务器。
Key is not the correct length or format
某个密钥不完整,或多了一个字符。请完整复制它,不要包含空格或换行。
接口 wg0 已存在
消息中包含 already exists:该接口是在 systemd 之外启动的。请先停止它,然后重新启动服务:
wg-quick down wg0
systemctl restart wg-quick@wg0某些网站始终无法打开,或传输卡住
对于所经过的网络而言,数据包可能过大。请在客户端的 [Interface] 部分添加 MTU = 1380,然后重新启用隧道。如果问题依旧,请尝试 1280。
使用 ::/0 时出现 RTNETLINK answers: Permission denied
Linux 客户端上已禁用 IPv6。请从 AllowedIPs 中删除 ::/0。