WireGuard VPN 搭建指南
WireGuard VPN 搭建指南
适用:Debian 12 / Ubuntu 云服务器 + Windows 客户端。本站服务端虚拟 IP 为
10.0.0.1,客户端10.0.0.2。最后更新:2026-11-20
一、服务端配置
1. 切换到 root 用户
sudo -i2. 安装 WireGuard
apt update
apt install -y wireguard iptables
iptables用于下面的 NAT 转发规则,最小化系统镜像里可能没有预装。
3. 生成服务端密钥对
# 密钥目录,仅 root 可访问
install -d -m 700 /etc/wireguard
cd /etc/wireguard
# 生成私钥,再由私钥推导公钥
wg genkey > server_private.key
wg pubkey < server_private.key > server_public.key
# 显式收紧权限,不依赖 umask 继承
chmod 600 server_private.key server_public.key
ls -l server_private.key server_public.key查看密钥(稍后使用):
cat server_private.key # 填到 wg0.conf 的 PrivateKey
cat server_public.key # 填到客户端配置的 PublicKey为什么不用 umask 077
很多教程会写成 umask 077 后再 wg genkey | tee ...,这在"一次性粘贴整段到同一个 shell"时确实有效,但很脆:
| 问题 | 说明 |
|---|---|
| 只影响当前 shell | 分行粘贴、分次执行、重开终端或 sudo -i 之外执行时,umask 不会延续,私钥可能以 644 落地 |
| 是全局状态 | 设置后该会话里创建的所有文件都变成 600/700,容易造成后续操作权限异常 |
| 无法自证 | 敲完不知道到底生效没有 |
用 chmod 600 显式指定权限,与执行方式、shell 状态都无关,且可以用 ls -l 当场确认。
私钥
server_private.key等于服务器的 VPN 身份,不要提交到 Git、不要贴到聊天工具、不要随配置一起备份到公开位置。泄露后任何人都能冒充服务端。
4. 创建服务端配置文件
vim /etc/wireguard/wg0.conf内容如下(PrivateKey 填服务端私钥,PublicKey 先留空,等客户端生成后填入):
[Interface]
PrivateKey = 服务端私钥
ListenPort = 51820
Address = 10.0.0.1/24
PostUp = iptables -A FORWARD -i wg0 -j ACCEPT; iptables -A FORWARD -o wg0 -j ACCEPT; iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
PostDown = iptables -D FORWARD -i wg0 -j ACCEPT; iptables -D FORWARD -o wg0 -j ACCEPT; iptables -t nat -D POSTROUTING -o eth0 -j MASQUERADE
[Peer]
PublicKey = 客户端公钥
AllowedIPs = 10.0.0.2/32写完后同样收紧权限(wg-quick 会检查配置里是否有私钥,权限过宽会警告):
chmod 600 /etc/wireguard/wg0.conf注意
eth0需替换为服务器实际网卡名,用ip route | grep default查看,常见为eth0、ens3、ens5AllowedIPs精确到/32,只允许该客户端使用这个虚拟 IP- 多个客户端就写多个
[Peer]段,IP 依次用10.0.0.2/32、10.0.0.3/32
5. 开启 IP 转发
echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf
sysctl -p
sysctl net.ipv4.ip_forward # 应输出 16. 启动 WireGuard 服务
systemctl enable wg-quick@wg0
systemctl start wg-quick@wg0
systemctl status wg-quick@wg0 --no-pager看到下面这样就是成功的:
Active: active (exited) since ...active (exited) 不是错误。 wg-quick@ 是 Type=oneshot 服务:它执行完 wg-quick up 建好网卡就退出,systemd 记为 active (exited)。真正要验证的是握手:
wg输出里 peer 段出现 latest handshake 和收发流量才算打通。
7. 安全组放行 UDP 51820
在阿里云控制台安全组入方向添加规则:
| 协议 | 端口 | 授权对象 |
|---|---|---|
| UDP | 51820 | 0.0.0.0/0 |
这一步必须做,否则客户端无法握手(表现为服务端 wg 里看不到 peer,或只有 peer 没有 handshake)。
二、客户端配置(Windows)
1. 安装客户端
官网下载安装:https://www.wireguard.com/install/
2. 生成客户端密钥对
打开客户端 → 「新建空隧道」,会自动生成客户端公钥和私钥,并弹出配置窗口。
3. 编辑客户端配置
把配置窗口内容替换为:
[Interface]
PrivateKey = 客户端私钥(自动生成)
Address = 10.0.0.2/32
DNS = 223.5.5.5
[Peer]
PublicKey = 服务端公钥
Endpoint = 你的服务器公网IP:51820
AllowedIPs = 10.0.0.0/24
PersistentKeepalive = 25注意
PublicKey必须填服务端公钥(服务器上cat /etc/wireguard/server_public.key),别填成客户端自己的Endpoint用服务器公网 IP,格式IP:51820,英文冒号、不加空格AllowedIPs只决定"哪些目标 IP 走 VPN"。只想访问 VPN 内网和服务器内网,填10.0.0.0/24即可;要访问服务器所在内网其他网段,再加该网段(如172.23.0.0/16)。不要填0.0.0.0/0,那会把全部上网流量都绕道服务器PersistentKeepalive = 25用于客户端在 NAT 后面时维持隧道
4. 保存并连接
点击「保存」,再点「连接」,状态显示对勾即已连接。
三、将客户端公钥填入服务端
- 在 Windows 客户端复制客户端公钥
- 回到服务器,编辑
/etc/wireguard/wg0.conf,把[Peer]段的PublicKey换成客户端公钥 - 重启服务端:
systemctl restart wg-quick@wg0
wg # 确认公钥已加载四、测试连通性
1. 在 Windows 上 ping 服务端虚拟 IP
ping 10.0.0.1能通说明隧道已建立。
2. 在服务器上查看握手状态
wg正常输出类似:
interface: wg0
public key: <服务端公钥>
private key: (hidden)
listening port: 51820
peer: <客户端公钥>
endpoint: 117.154.89.205:20510
allowed ips: 10.0.0.2/32
latest handshake: 10 seconds ago
transfer: 1.2 MiB received, 2.3 MiB sentlatest handshake 与 transfer 都有数据,才算真正打通。
3. 通过 SSH 验证
ssh root@10.0.0.1通了就说明可以走 VPN 管理服务器,不必把 22 端口长期暴露在公网。
五、通过 VPN 连接 MySQL
1. 修改 MySQL 监听地址
编辑 /etc/mysql/mysql.conf.d/mysqld.cnf:
# 只监听 VPN 虚拟 IP,不让公网直接访问
bind-address = 10.0.0.1systemctl restart mysql2. 创建允许 VPN 网段访问的用户
CREATE USER 'vpnuser'@'10.0.0.%' IDENTIFIED BY '你的复杂密码';
GRANT ALL PRIVILEGES ON *.* TO 'vpnuser'@'10.0.0.%';
FLUSH PRIVILEGES;3. 从 Windows 连接
Navicat / DBeaver 填:主机 10.0.0.1、端口 3306、用户 vpnuser。命令行:
mysql -h 10.0.0.1 -P 3306 -u vpnuser -p数据库走 VPN 的好处:3306 不需要在安全组对外开放。
六、故障排查
1. 服务端 wg 里没有 peer
- 检查安全组 UDP 51820 是否放行
- 检查客户端
Endpoint是否填对,是否点了「连接」
2. 有 peer 但没有 latest handshake
- 服务端与客户端的公钥是否配对(
[Peer] PublicKey应填对方公钥,容易填反) - 客户端是否真的连上(WireGuard 客户端里点激活)
- 临时关闭 Windows 防火墙测试
- 端口被运营商/安全组拦时可换端口(如 51821),服务端
ListenPort、安全组、客户端Endpoint三处同步改
3. 握手成功但 ping 不通
sysctl net.ipv4.ip_forward # 必须是 1
iptables -t nat -L -n -v | grep MASQUERADE # 应有 wg0 → eth0 的规则缺规则时手工补:
iptables -A FORWARD -i wg0 -j ACCEPT
iptables -A FORWARD -o wg0 -j ACCEPT
iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE其它检查:
- 客户端
AllowedIPs是否包含10.0.0.0/24 - Windows 防火墙是否拦了 ICMPv4(临时关闭验证)
- 网卡名是否写错(
eth0/ens3)
4. 服务状态显示 active (exited)
正常,不是故障。 见 第 6 节。要判断是否真的工作,看 wg 的握手信息和能否 ping 通。
5. 重装系统后客户端连不上
重装会清空 /etc/wireguard,服务端密钥对重新生成后公钥已变,客户端配置里的 PublicKey 必须换成新的服务端公钥,否则握手失败。
七、日常使用
- 服务端已设为开机自启:
systemctl enable wg-quick@wg0 - Windows 客户端可在设置里勾选开机自动连接
- 家庭宽带公网 IP 变化不影响:客户端
Endpoint连的是服务器固定公网 IP,隧道会自动重连(配合PersistentKeepalive) - 访问服务器上的服务时用虚拟 IP(如
10.0.0.1:3306、10.0.0.1:22),无需在安全组暴露业务端口
鄂公网安备42011102006488号