中文

应用程序

在服务器上搭建 WireGuard VPN

在 Debian 或 Ubuntu 上安装 WireGuard,添加 Windows、macOS、Linux 和移动设备客户端,配置路由与防火墙,并将 SSH 限定在 VPN 内。

阅读约 9 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何将您的服务器变成 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.conf

PostUp 行在隧道启动时执行,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 51820

wg 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.conf

Windows 和 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.me

ping 应有响应,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@wg0

内核无法创建该接口。在容器中运行且宿主机不支持 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。

Linux 客户端上已禁用 IPv6。请从 AllowedIPs 中删除 ::/0。

参考资料