wireguard客户端无法连接时，需先安装wireguard-tools或源码编译，再配置wg0.conf并启动；ubuntu用apt、centos启用epel后dnf、fedora直接dnf安装，验证wg --version，最后生成密钥、设权限、写配置。
如果您已在Linux系统上部署WireGuard服务端，但客户端无法建立隧道连接，则可能是由于客户端未正确安装或配置WireGuard组件。以下是针对Linux平台安装与配置WireGuard客户端的多种可行方法：
一、使用系统包管理器安装wireguard-tools
该方法适用于大多数主流发行版，依赖官方仓库提供预编译二进制包，安装快捷且兼容性高。需确保系统已启用对应源（如EPEL、universe等）。
1、对于Ubuntu/Debian系统，执行以下命令：
sudo apt update && sudo apt install wireguard-tools -y
2、对于CentOS/Rocky/AlmaLinux 8+系统，先启用EPEL源：
sudo dnf install epel-release -y && sudo dnf install kmod-wireguard wireguard-tools -y
3、对于Fedora系统，直接运行：
sudo dnf install wireguard-tools -y
4、验证安装结果：
wg --version
若输出类似“wireguard-tools v1.0.20210914”则表示安装成功
二、从源码编译安装wireguard-tools
该方法适用于内核版本较新但官方仓库尚未同步对应包的场景，或需自定义编译选项（如静态链接、禁用systemd依赖等）。要求系统已安装build-essential、make、gcc及内核头文件。
1、安装编译依赖：
sudo apt install build-essential libmnl-dev pkg-config git -y
2、克隆wireguard-tools官方仓库：
git clone https://git.zx2c4.com/wireguard-tools && cd wireguard-tools
3、执行编译与安装：
make && sudo make install
4、检查可执行文件路径：
ls /usr/local/bin/wg*
确认wg和wg-quick均存在于/usr/local/bin目录下
三、配置客户端接口并启动连接
完成安装后，需创建标准配置文件并加载接口。WireGuard客户端配置包含本地虚拟IP、私钥、服务端公钥、Endpoint地址及路由规则，所有字段必须严格匹配服务端Peer段定义。
1、创建配置目录并设置权限：
sudo mkdir -p /etc/wireguard && sudo chmod 700 /etc/wireguard
2、生成客户端密钥对：
cd /etc/wireguard && sudo umask 077 && wg genkey | sudo tee privatekey | wg pubkey | sudo tee publickey
3、编写客户端配置文件wg0.conf：
sudo tee /etc/wireguard/wg0.conf
[Interface]
PrivateKey = $(sudo cat privatekey)
Address = 10.0.0.2/24
[Peer]
PublicKey = 服务端公钥（需替换为实际值）
Endpoint = 服务端公网IP:51820（需替换为实际值）
AllowedIPs = 0.0.0.0/0
PersistentKeepAlive = 25
EOF
4、启用防火墙UDP端口（如使用firewalld）：
sudo firewall-cmd --add-port=51820/udp --permanent && sudo firewall-cmd --reload
5、启动客户端隧道：
sudo wg-quick up wg0
运行wg命令应显示已建立的peer及传输字节数
四、使用NetworkManager集成方式配置
该方法适合桌面环境用户，支持图形界面操作与网络会话自动恢复，避免手动管理wg-quick生命周期。要求系统已安装NetworkManager及wireguard-tools，并启用nmcli工具链。
1、安装NetworkManager插件（若未预装）：
sudo apt install network-manager-wireguard -y # Ubuntu/Debian
sudo dnf install NetworkManager-wireguard -y # Fedora/Rocky
2、重启NetworkManager服务：
sudo systemctl restart NetworkManager
3、通过nmcli导入配置：
sudo nmcli connection import type wireguard file /etc/wireguard/wg0.conf
4、启用连接：
sudo nmcli connection up "wg0"
连接状态可通过nmcli connection show wg0查看Active字段是否为yes
五、验证客户端连接状态与网络连通性
配置完成后必须验证隧道是否真正生效，包括内核模块加载、接口状态、路由表注入及跨网段通信能力。任何环节失败都将导致流量无法转发。
1、检查wireguard内核模块是否载入：
lsmod | grep wireguard
2、确认wg0接口已存在并分配IP：
ip -br a | grep wg0
3、查看当前路由表中是否注入AllowedIPs网段：
ip route | grep "via wg0"
4、测试与服务端虚拟IP的连通性：
ping -c 4 10.0.0.1
若收到4个响应包且无丢包，说明隧道层通信正常
