本教程适用于以下操作系统版本
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
本页内容
- 先决条件
- 安装 Wireguard
- 生成公钥/私钥对 为 Wireguard 服务器生成密钥对 为客户端生成密钥对
- 配置 Wireguard 服务器
- 通过 /etc/sysctl.conf 启用端口转发
- 为 Wireguard 服务器配置防火墙
- 启动 Wireguard 服务器
- 配置客户端机器并连接到 Wireguard 服务器
- 结论
- 为 Wireguard 服务器生成密钥对
- 为客户端生成密钥对
Wireguard 是一个免费的开源 VPN 协议,可作为 IPSec、IKEv2 和 OpenVPN 的替代方案。Wiruguard 专为 Linux 和 Unix 操作系统设计。它运行在 Linux 内核空间,这使得 Wireguard 更快且更可靠。Wireguard 用于在两台或多台计算机之间创建安全的隧道连接。
Wireguard 旨在取代 IPSec、IKEv2 和 OpenVPN 等 VPN 协议。Wireguard 更轻量、更快速、易于配置且更高效。同时,Wiregurad 并未牺牲 VPN 协议的安全性。Wireguard 支持现代最先进的加密技术,例如 Noise 协议框架、Curve25519、ChaCha20、Poly1305、BLAKE2、SipHash24、HKDF 以及安全可信的构造。
与 OpenVPN、IPSec 和 IKEv2 等其他 VPN 协议相比,wireguard 是一种较新的 VPN 协议。Wireguard 于 2015 年由 Jason A. Donenfeld 发布,作为替代的 VPN 协议,并在 2020 年由 Linus Torvalds 合并到 Linux 内核 v5.6,同年也被移植到 FreeBSD 13。
在本教程中,你将在 Debian 11 服务器上通过 Wireguard 安装并搭建一个 VPN 服务器。你将使用 Debian 11 服务器搭建一个 Wireguard VPN 服务器,然后配置一台客户端机器连接到该 Wireguard VPN 服务器。
至于客户端机器,你可以使用任何 Linux 发行版,但本示例使用了一台 Debian 机器。
先决条件
在开始本教程之前,你必须具备以下要求:
- 一台 Debian 11 服务器——本示例使用了一台主机名为 ' wireguard-server '、拥有外部静态 IP 地址 ' SERVER-IP ' 的 Debian 服务器。
- 一台用作客户端的 Linux 机器——你可以使用任何 Linux 发行版,但本示例使用了一台主机名为 'client1' 的 Debian 机器。
- 一个拥有 sudo/root 管理员权限的非 root 用户。
如果以上所有要求都已就绪,那就开始吧。
安装 Wireguard
在安装 Wireguard 之前,运行以下 apt 命令来更新并刷新你的 Debian 软件包索引。
sudo apt update
Debian 软件仓库更新完成后,运行以下 apt 命令在你的 Debian 服务器上安装 Wireguard 软件包。这同时也会安装 wireguard-tools 软件包,用于管理你的 Wireguard 服务器安装。
sudo apt install wireguard
当提示确认时,输入 y 确认并按 ENTER 继续。现在安装应该会开始。

Wireguard 已在你的服务器上安装完成,现在可以开始为 Wireguard 服务器和客户端生成公钥和私钥对。
生成公钥/私钥对
在此步骤中,你将为 Wireguard 服务器和客户端机器生成一个公钥和私钥对。这可以通过 wireguard-tools 软件包提供的 'wg' 命令行来完成。
服务器的密钥对将由 Wireguard 服务器使用,客户端机器将使用客户端的密钥对。如果你有多台客户端机器,可以为其生成多个客户端密钥对。
为 Wireguard 服务器生成密钥对
运行以下 ' wg genkey ' 命令来生成 Wireguard 服务器的私钥。然后,将私钥的权限更改为 ' 0400 ',这将禁用组和其他用户的读写权限。
在本示例中,你将生成私钥 '/etc/wireguard/server.key' 。
wg genkey | sudo tee /etc/wireguard/server.key
sudo chmod 0400 /etc/wireguard/server.key
随后你将在终端屏幕上收到一个随机的 base64 密钥输出。
接下来,运行以下命令 ' wg pubkey ' 来生成新的服务器公钥并保存到 ' /etc/wireguard/server.pub '。服务器公钥是从服务器私钥 ' /etc/wireguard/server.key ' 派生而来的。
sudo cat /etc/wireguard/server.key | wg pubkey | sudo tee /etc/wireguard/server.pub
随后你将在终端上收到一个随机 base64 公钥的输出。

现在你已经为 Wireguard 服务器生成了公钥和私钥对。私钥位于 '/etc/wireguard/server.key' ,公钥位于 '/etc/wireguard/server.pub '。
运行以下 cat 命令来显示并验证为 Wireguard 服务器生成的密钥对。
cat /etc/wireguard/server.key
cat /etc/wireguard/server.pub

为客户端生成密钥对
对于客户端密钥对,你可以在安装了 wireguard-tools 的任何机器(Wireguard 服务器或客户端)上生成。在此步骤中,你将通过 Wireguard 服务器生成客户端密钥对。
为服务器和客户端生成密钥对的过程是相同的,都是使用 ' wg genkey ' 命令生成私钥,并使用 ' wg pubkey ' 生成从私钥派生的公钥。
现在运行以下命令来创建一个新目录 ' /etc/wireguard/clients '。该目录将用于存储客户端密钥对。
mkdir -p /etc/wireguard/clients
运行以下 'wg genkey' 命令来生成客户端私钥并保存到 ' /etc/wireguard/clients/client1.key '。然后,通过 ' wg pubkey ' 命令生成客户端公钥并保存到 '/etc/wireguard/clients/client1.pub '。
wg genkey | tee /etc/wireguard/clients/client1.key
cat /etc/wireguard/clients/client1.key | wg pubkey | tee /etc/wireguard/clients/client1.pub

客户端密钥对已生成,公钥位于 '/etc/wireguard/clients/client1.pub',私钥为 ' /etc/wireguard/clients/client1.key '。运行以下命令来显示并验证生成的密钥对。
cat /etc/wireguard/clients/client1.key
cat /etc/wireguard/clients/client1.pub

配置 Wireguard 服务器
在此步骤中,你将为 Wireguard 服务器创建一个新的配置文件。但在那之前,你必须决定为 Wireguard VPN 服务器使用哪些子网。你也可以决定是否为你的 Wireguard VPN 服务器启用或禁用 IPv6。
在此示例中,Wireguard VPN 服务器将使用子网 '10.8.0.2/24' 的 IP 地址,并禁用 Wireguard VPN 的 IPv6。
使用以下 nano 编辑器命令创建一个新的 Wireguard 配置文件 '/etc/wireguard/wg0.conf '。
sudo nano /etc/wireguard/wg0.conf
首先,将以下行添加到文件中以定义 Wirguard 服务器详细信息。并确保将 ' PrivateKey ' 替换为 Wirguard 服务器私钥 ' server.key '。这样,Wireguard 服务器接口将在 IP 地址 ' 10.8.0.1 ' 上运行,开放客户端可用于连接的 UDP 端口 51820,而 SaveConfig 参数将确保任何更改都会保存到配置文件中,即使 Wireguard 接口处于关闭状态。
[Interface] # Wireguard Server private key - server.key PrivateKey = SIybp8GHtKIPtHPBOQFP1kbQg4UCLCMyNIfCLBQR2EA= # Wireguard interface will be run at 10.8.0.1 Address = 10.8.0.1/24 # Clients will connect to UDP port 51820 ListenPort = 51820 # Ensure any changes will be saved to the Wireguard config file SaveConfig = true
接下来,添加以下行以定义客户端对等连接。将 ' PublicKey ' 参数替换为客户端公钥 ' client1.pub '。' AllowedIPs ' 参数用于指定允许访问该对等节点的 Wireguard 客户端。在此示例中,仅允许 IP 为 ' 10.8.0.2 ' 的客户端访问该对等连接。但你也可以允许子网范围,例如 ' 10.8.0.0/24 '。
[Peer] # Wireguard client public key - client1.pub PublicKey = ENokvIsS2euXrmM4OVFHPmTdCZ4wfEIR/UHuGCW64lw= # clients' VPN IP addresses you allow to connect # possible to specify subnet ⇒ [10.8.0.0/24] AllowedIPs = 10.8.0.2/24
完成后保存文件并退出编辑器。
在创建好 Wireguard 服务器配置文件并添加客户端对等连接后,接下来你将在 Weireguard 服务器上设置端口转发,并配置防火墙以实现流量路由。
通过 /etc/sysctl.conf 启用端口转发
在此步骤中,你将通过文件 /etc/sysctl.conf' 在 Wireguard 服务器上启用端口转发。你可以在 Wireguard 服务器上为 IPv4 和 IPv6 同时启用端口转发。
首先,使用以下 nano 编辑器命令打开配置文件 '/etc/sysctl.conf '。
sudo nano /etc/sysctl.conf
将以下行添加到文件中。这将启用 Wireguard 服务器上的端口转发。你可以同时用于 IPv4 和 IPv6,或者在 Wireguard 服务器上禁用了 IPv6 的情况下仅使用 IPv4。
# Port Forwarding for IPv4 net.ipv4.ip_forward=1 # Port forwarding for IPv6 net.ipv6.conf.all.forwarding=1
完成后保存文件并退出编辑器。
接下来,运行以下 sysctl 命令工具以应用更改。
sudo sysctl -p
你将收到类似以下的输出——端口转发应立即生效。

在 Wireguard 服务器上启用端口转发后,接下来你将设置防火墙,将 Wireguard 客户端的流量路由到特定的网络接口。
为 Wireguard 服务器配置防火墙
在此步骤中,你将设置用于 Wireguard 服务器的防火墙,将客户端连接路由到用于访问互联网的正确网络接口。这也将允许 Wireguard 客户端通过 Wireguard 服务器上的特定接口访问互联网。
首先,运行以下 apt 命令在你的 Debian 服务器上安装 ufw 防火墙软件包。
sudo apt install ufw
在提示时输入 y 并按 ENTER 继续。

ufw 安装完成后,运行以下命令以开放 SSH 服务并启用 ufw 防火墙。
sudo ufw allow OpenSSH
sudo ufw enable
当提示确认启用 ufw 防火墙时,输入 y 并按 ENTER。ufw 防火墙现在应该已在你的系统上运行,并且已处于启用状态。

现在通过以下命令验证 ufw 防火墙状态。你应该收到类似 ' Status: active ' 的输出,这意味着 ufw 防火墙正在运行。
sudo ufw status
在 ufw 防火墙运行后,接下来你将配置它将 Wireguard 客户端连接路由到特定的网络接口。
现在运行以下命令来检查 Wireguard 服务器上的默认路由表接口。大多数情况下,这将会检测到用于访问互联网的接口,或承载公网 IP 地址的接口。
ip route list default
你将收到类似以下的输出——本示例中,接口 eth0 是 Wireguard 服务器的默认路由表。这也是用于访问互联网的接口。你的接口名称可能不同。

接下来,使用以下 nano 编辑器命令打开 Wireguard 服务器配置文件 ' /etc/wireguard/wg0.conf '。
sudo nano /etc/wireguard/wg0.conf
将以下行添加到 ' [Interface] ' 部分。
[Interface] ... .... PostUp = ufw route allow in on wg0 out on eth0 PostUp = iptables -t nat -I POSTROUTING -o eth0 -j MASQUERADE PostUp = ip6tables -t nat -I POSTROUTING -o eth0 -j MASQUERADE PreDown = ufw route delete allow in on wg0 out on eth0 PreDown = iptables -t nat -D POSTROUTING -o eth0 -j MASQUERADE PreDown = ip6tables -t nat -D POSTROUTING -o eth0 -j MASQUERADE
完成后保存文件并退出编辑器。
- 每当 Wirguard 服务器启动 VPN 隧道时,将执行 ' PostUp ' 参数。
- 每当 Wireguard 服务器停止 VPN 隧道时,将执行 ' PreDown ' 参数。
- 命令 ' ufw route allow in on wg0 out on eth0 ' 允许将进入 wg0 接口的流量转发到互联网接口 eth0。
- 命令 'iptables -t nat -I POSTROUTING -o eth0 -j MASQUERADE' 将启用伪装,并重写来自 wg0 接口的 IPv4 流量,使其看起来像是来自 Wireguard 服务器的直接连接。
- 命令 ' ip6tables -t nat -I POSTROUTING -o eth0 -j MASQUERADE ' 将启用伪装,并重写来自 wg0 接口的 IPv46traffics 流量,使其看起来像是来自 Wireguard 服务器的直接连接。
现在运行以下 ufw 命令以开放客户端将连接的 UDP 端口 51820。
sudo ufw allow 51820/udp
最后,运行以下命令以重新加载 ufw 防火墙并应用更改。然后,通过以下命令验证 ufw 规则列表。
sudo ufw reload
sudo ufw status
你将收到类似以下截图的输出——Wireguard 服务器用于客户端连接的 UDP 端口 51820 已添加到 ufw 防火墙。

现在,你已在 Wireguard 服务器上启用了端口转发并配置了防火墙。你现在可以启动 Wireguard 服务器了。
启动 Wireguard 服务器
在此步骤中,你将启动并启用 Wireguard 服务器。你还将验证 Wireguard 服务器,并验证由 Wireguard 服务创建的 wg0 接口。
运行以下 systemctl 命令工具来启动并启用 Wireguard 服务。服务 ' [email protected] ' 将在你的 Wireguard 服务器上创建并启用 Wireguard 接口 ' wg0 '。
sudo systemctl start
[email protected]
sudo systemctl enable
[email protected]
现在通过以下命令验证 Wireguard 服务。
sudo systemctl status
[email protected]
你将收到类似以下截图的输出——Wireguard 服务 ' [email protected] ' 正在运行且已启用。这也意味着 ' wg0 ' 接口已创建并正在运行。

运行以下命令来验证 Wireguard 服务器上的 'wg0' 接口。
ip a show wg0
你应该收到类似以下的输出——Wireguard 接口 wg0 获得了 IP 地址 ' 10.8.0.1 ',正如 Wireguard 配置文件 ' /etc/wireguard/wg0.conf ' 中所描述。

此外,你也可以通过如下的 ' wg-quic k' 命令来启动和停止 Wireguard。' wg-quick up ' 命令将启动 Wireguard 服务器,'wg-quick down ' 将停止 Wireguard 服务器。
sudo wg-quick up /etc/wireguard/wg0.conf
sudo wg-quick down /etc/wireguard/wg0.conf
在 Wireguard 服务器运行后,接下来你将配置客户端机器并将其连接到 Wireguard 服务器。
配置客户端机器并连接到 Wireguard 服务器
在此步骤中,你将通过安装 worguard-tools、为客户端创建新的 Wireguard 配置、连接到 Wireguard VPN 服务器,最后验证连接并确保客户端机器可以访问互联网和本地 VPN 网络,来完成客户端机器的配置。
在客户端机器上安装 ' wireguard-tools ' 软件包。这里使用 Debian 作为客户端,因此将使用 APT 命令。
sudo apt install wireguard-tools
安装应会自动开始。

wireguard-tools 安装完成后,使用以下 nano 编辑器命令创建一个新的配置文件 ' /etc/wireguard/wg-client1.conf '。
sudo nano /etc/wireguard/wg-client1.conf
将以下行添加到文件中。
[Interface] # Define the IP address for the client - must be matched with wg0 on Wireguard Server Address = 10.8.0.2/24 # specific DNS Server DNS = 1.1.1.1 # Private key for the client - client1.key PrivateKey = KPI59QH0jwc9wkUsW5Byci9ojXhz1322QXK52fQCE3E= [Peer] # Public key of the Wireguard server - server.pub PublicKey = Qt6oRLtlfAR490lTNb2K8TlbpwADV1j8NX7D5HY38EM= # Allow all traffic to be routed via Wireguard VPN AllowedIPs = 0.0.0.0/0 # Public IP address of the Wireguard Server Endpoint = SERVER-IP:51820 # Sending Keepalive every 25 sec PersistentKeepalive = 25
完成后保存并关闭文件。
在 ' [Interface] ' 部分,你必须定义以下内容:
- 客户端的 IP 地址必须与 Wireguard 服务器的子网相匹配。在本示例中,Wireguard 客户端将获得 IP 地址 '10.8.0.2'。
- 为客户端指定 DNS 服务器。
- 将 ' PrivateKey ' 参数替换为已生成的客户端私钥 ' client1.key '。在 ' [Peer]' 部分,你必须添加以下内容:
- 将 Wireguard 服务器公钥 ' server.pub ' 填入 PublicKey 参数。
- 指定 ' AllowedIPs ' 来限制 VPN 对等节点的访问,你可以指定网络子网,或者直接填入 0.0.0.0/0 以通过 VPN 隧道转发所有流量。
- 使用 Wireguard 服务器的公网 IP 地址或域名来指定 Endpoint 参数。
客户端配置创建完成后,运行以下命令在客户端机器上启动 Wireguard。
wg-quick up wg-client1
你应该收到类似以下截图的输出——将创建新的 Wireguard 接口 ' wg-client1 ',客户端机器应该已连接到运行在 ' SERVER-IP:51820 ' 上的 Wireguard 服务器。

运行以下命令来验证 Wireguard 接口 ' wg-client1 '。
ip a show wg-client1
你应该收到类似以下的输出——wg-client1 接口已启用,IP 地址为 ' 10.8.0.2 ',属于 Wireguard 服务器子网 ' 10.8.0.0/24' 的一部分。

你也可以通过 ' wg show ' 命令验证 Wireguard 连接。
在客户端机器上运行以下 ' wg show' 命令,你应该会收到类似以下的输出。
wg show
如果你已连接到正确的 Wireguard 服务器,你应该在 ' endpoint ' 部分看到 Wirguard 服务器 IP 地址,并看到 Wirguard 服务器公钥 ' server.pub '。

现在切换到 Wireguard 服务器并运行 ' wg show ' 命令。
wg show
你应该收到类似以下的输出——在 endpoint 部分,你将看到客户端的公网 IP 地址;在 peer 部分,你将看到客户端公钥 'client1.pub '。

最后,运行以下命令以确保客户端机器可以访问互联网或访问 Wireguard VPN 的内部网络子网。
ping -c5 10.8.0.1
ping -c5 1.1.1.1
ping -c5 duckduckgo.com
以下是你应该收到的输出:
客户端机器可以通过 IP 地址 '10.8.0.1 ' 连接到 Wireguard 服务器。

客户端机器可以访问互联网。所有流量都通过 Wireguard 服务器的公网 IP 地址进行路由。

如果你想在客户端机器上停止 Wrieguard,可以运行以下 ' wg-quick down ' 命令
wg-quick down wg-client1
你将收到类似以下的输出。此外,接口 wg-client1 将从客户端机器上消失。

现在你已在客户端机器上配置了 Wirguard VPN。你同时也验证了客户端机器与 Wireguard 服务器之间的连接。
结论
在本教程中,你已在 Debian 11 服务器上安装并配置了 Wireguard VPN。你还配置了一台 Debian 机器并成功连接到了 Wireguard VPN 服务器。
具体来说,你安装了 Wireguard VPN 软件包,为服务器和客户端生成了公钥和私钥对,配置了 UFW 防火墙将 VPN 流量路由到特定的网络接口,并通过 /etc/sysctl.conf 文件启用了端口转发。
有了这些基础,你现在可以通过为客户端生成另一个密钥对、在 Wireguard 服务器上定义对等连接,然后创建客户端机器将使用的新 Wireguard 配置文件,来向你的 Wireguard VPN 服务器添加更多客户端。要了解有关 Wireguard 的更多信息,请访问 Wireguard 官方文档。