安装 WireGuard 的过程可以分为几个步骤，根据不同的操作系统和安装方法来配置。以下是详细的安装指南

原子VPN 2026-10-08 多平台网络连接翻墙工具 0 3

安装 WireGuard 软件包（推荐方法）

添加 WireGuard 的 PPA 源码库：
- 打开终端,输入以下命令以添加源码库：
```
sudo add-apt-repository ppa:netfilter/wireguard
sudo apt update
```
安装 WireGuard 和相关插件：
- 安装 WireGuard 和必要的系统插件：
```
sudo apt install wireguard
sudo apt install --install wireguard-backend
```
- 如果你使用的是内核模块版本,安装以下软件包：
```
sudo apt install wireguard-kernel
```

配置网络接口：

创建或选择 WireGuard 的网络接口：

sudo nft create peer public keyfile /path/to/wireguard-private-key.pem public

根据需要设置接口：
```
sudo nft rule add ip route 0.../ oif wg
```

启用 WireGuard 服务：

启用 wg-quick@.service 服务：

sudo systemctl enable wg-quick@wg
sudo systemctl start wg-quick@wg

连接到 WireGuard 网络：
- 使用你的客户端设备连接到服务器的 WireGuard 接口，可以使用以下命令（连接到 wg 接口）：
```
wg-attach wg /path/to/server-wireguard-public-key.pem
```
- 启用并连接接口：
```
wg up wg
```

手动安装 WireGuard（适合开发者）

下载 WireGuard 源码：

克隆仓库并进入目录：

git clone https://git.zx2c3.com/wireguard/wireguard.git
cd wireguard

安装依赖项：

安装编译工具和相关库：

sudo apt-get install build-essential
sudo apt-get install libgpg1-dev

编译 WireGuard：
- 编译并安装：
```
make -C src
sudo make -C src install
```
创建 WireGuard 接口：
- 使用 wginit 工具初始化接口：
```
sudo wginit
```

配置 WireGuard 服务：

修改配置文件,添加你的公钥和服务器信息：

sudo nano /etc/wireguard/wg.conf

[Interface]
PrivateKey = /path/to/wireguard-private-key.pem
ListenPort = 51821
[Peer]
PublicKey = /path/to/server-wireguard-public-key.pem
Endpoint = your-server-ip:51821
AllowedIPs = 0.../

启动 WireGuard 服务：

使用 systemd 启动：

sudo systemctl daemon-reload
sudo systemctl start wg
sudo systemctl enable wg

测试连接：
- 检查接口状态：
```
sudo wg show wg
```
- 从另一台设备连接并测试互联性。

使用 Ansible 进行自动化部署

准备 Ansible 角色：

创建一个 YAML 文件定义部署步骤：

- name: 安装 WireGuard
  hosts: all
  become: yes
  tasks:
    - name: 添加 PPA 源码库并更新
      apt:
        repo: ppa:netfilter/wireguard
        state: present
        update: yes
    - name: 安装 WireGuard 软件包
      apt:
        name: wireguard
        name: wireguard-backend
        state: present
    - name: 启用并启动 WireGuard 服务
      service:
        name: wg-quick@wg
        state: started
        enabled: yes

执行 Ansible playbook：

运行 playbook 并传递变量（如服务器 IP 和公钥路径）：

ansible-playbook deploy-wireguard.yml --extra-vars "server_ip=your-server-ip public_key_path=/path/to/public-key.pem"

故障排除

权限问题：确保运行命令时有足够权限，使用 sudo 或在 /etc/sudoers 中配置。
依赖项缺失：检查是否安装了所有必要的依赖项，尤其是编译工具和相关库。
配置错误：仔细检查配置文件，确保所有路径和信息正确无误。
日志查看：使用 journalctl 查看服务日志，定位问题所在：
```
sudo journalctl -u wg-quick@wg -b
```