自由档案馆|WireGuard 一键安装脚本(中文版)

⚠️ 重要提醒
因为WireGuard特征比较明显,国内可能无法使用!如果你不会执行各种复杂的命令,推荐使用 自由档案馆|VPN Web 管理面板。 它基于 sing-box,可视化界面、支持在线安装、多协议管理、多用户管理、二维码/链接生成、日志查看和协议启停, 新手也能更容易完成自建 VPN。

查看介绍与安装教程: https://iwantrun.com/vpn-proxy/17359.html

WireGuard 一键安装教程:

项目地址:https://github.com/iwantruncom/WireGuard-install-cn

感谢原作者 Angristan张狗剩同志

🚀 一键安装 📱 自动生成二维码 🧰 中文向导 🔒 本地生成密钥 💻 支持多平台

一、这篇教程适合谁?

很多新手想自己搭建 VPN,但一看到 Linux、端口、防火墙、密钥、客户端配置这些词,就会觉得很复杂。

其实,如果只是自己使用,或者给手机、电脑配置一个私人 WireGuard 节点,并不需要很高的技术门槛。本文介绍的 WireGuard 中文一键安装脚本,已经把复杂的安装过程简化成了中文向导,大部分选项直接按回车即可完成。

  • 适合想自己搭建私人 VPN 的用户
  • 适合不熟悉 Linux 命令的新手
  • 适合希望手机扫码快速连接的人
  • 适合想给手机、电脑、平板分别创建节点的人

二、什么是 WireGuard?

WireGuard 是一种轻量、高效、现代化的 VPN 协议。相比传统 VPN,它配置更简单、速度更快、资源占用更低,非常适合个人 VPS 搭建私人 VPN。

速度快 协议简洁,性能表现好。
配置简单 客户端导入配置即可使用。
多平台支持 支持 Windows、macOS、iOS、Android、Linux。

三、安装前需要准备什么?

1. 海外 VPS 建议使用Vultr、Linode、Hetzner、DigitalOcean等VPS,系统选择Ubuntu或CentOS。
2. SSH 工具 用于登录服务器执行安装命令。
3. WireGuard 客户端 手机或电脑安装官方客户端。

VPS 推荐配置

项目 建议
CPU 1 核即可
内存 512MB 以上
硬盘 5GB 以上
流量 越多越好
系统 Debian 12 或 Ubuntu 22.04 更适合新手
虚拟化 KVM 优先
注意:不建议使用 OpenVZ、LXC 容器、国内服务器,或者无法开放 UDP 端口的 VPS。WireGuard 使用 UDP 协议,如果服务商不支持 UDP 放行,可能会出现“显示已连接但无法上网”的问题。

四、支持哪些系统?

这个脚本支持常见 Linux 发行版,但需要使用 root 权限运行。

系统 最低版本要求
Debian 10 及以上
Ubuntu 18.04 及以上
Fedora 32 及以上
CentOS 8 及以上
新手建议:优先选择 Debian 12 或 Ubuntu 22.04,这两个系统兼容性较好,网上资料也更多。

五、如何 SSH 登录 VPS?

购买 VPS 后,你需要准备好下面这些信息:

  • 服务器 IP 地址
  • SSH 端口,通常是 22
  • 用户名,通常是 root
  • root 密码,或者 SSH 私钥

假设你的服务器 IP 是 1.2.3.4,用户名是 root,可以使用下面的命令登录:

SSH 登录服务器
ssh [email protected]

第一次登录时,终端可能会提示:

首次连接确认
yes

六、WireGuard 一键安装命令

SSH 登录 VPS 后,请确认你是 root 用户。如果不是 root 用户,可以先执行:

切换 root 用户
sudo su

然后执行下面三行命令:

WireGuard 中文一键安装命令
wget https://raw.githubusercontent.com/iwantruncom/WireGuard-install-cn/main/wireguard-install-cn.sh
chmod +x wireguard-install-cn.sh
./wireguard-install-cn.sh
说明:这三行命令分别是:下载脚本、添加执行权限、运行安装脚本。

七、安装过程怎么选择?

运行脚本后,会出现中文安装向导。一般情况下,新手不需要修改太多参数,大部分直接按回车即可。

服务器公网 IP 地址 如果脚本自动识别的 IP 和 VPS 后台显示的一样,直接回车即可。
公网网卡名称 常见名称是 eth0、ens3 等,一般默认即可。
WireGuard 接口名称 默认通常是 wg0,直接回车即可。
服务端内网 IP 默认通常是 10.66.66.1,直接回车即可。
WireGuard 监听端口 脚本会随机生成端口,例如 51413。这个端口后面需要在 VPS 防火墙里放行 UDP。
DNS 设置 默认一般是 1.1.1.1 和 8.8.8.8,新手可以直接回车。
重要:请记住安装时显示的 WireGuard 端口。后面必须在 VPS 安全组或防火墙中放行这个 UDP 端口。

八、安装完成后会自动做什么?

脚本会自动完成大部分配置,不需要你手动编辑 WireGuard 配置文件。

自动安装依赖 安装 WireGuard、iptables、qrencode 等组件。
自动生成密钥 服务端和客户端密钥在本地生成。
自动生成二维码 手机 WireGuard App 扫码即可导入配置。
自动启动服务 启动 wg-quick,并设置开机自启。
自动创建配置 生成客户端 .conf 配置文件。
支持管理菜单 可以添加、查看、删除客户端,也可以卸载。

九、手机如何连接 WireGuard?

iPhone 用户

  1. 打开 App Store
  2. 搜索 WireGuard
  3. 下载 WireGuard 官方 App
  4. 打开 App,点击右上角 +
  5. 选择“扫描二维码”
  6. 扫描服务器终端里显示的二维码
  7. 保存配置并打开开关连接
如果你使用中国区 Apple ID,可能搜不到 WireGuard。可以切换到美区、港区、台区等非中国大陆区 App Store 下载。

Android 用户

安卓用户可以在 Google Play 搜索 WireGuard,也可以前往 WireGuard 官网下载 APK。

WireGuard 官方客户端下载 https://www.wireguard.com/install/

十、电脑如何连接 WireGuard?

Windows、macOS、Linux 用户都可以安装 WireGuard 官方客户端,然后导入脚本生成的 .conf 配置文件。

WireGuard Windows / macOS / Linux 官方客户端 https://www.wireguard.com/install/

脚本生成的客户端配置文件通常在:

客户端配置文件路径示例
/root/wg0-client-你的客户端名称.conf

十一、Mac 如何下载配置文件?

如果你使用 Mac,可以在本地 Mac 终端执行 scp 命令,把服务器上的配置文件下载到本机下载目录。

Mac 下载配置文件
scp root@你的服务器IP:/root/wg0-client-你的客户端名称.conf ~/Downloads/

例如:

示例命令
scp [email protected]:/root/wg0-client-phone.conf ~/Downloads/

下载完成后,打开 WireGuard 客户端,导入这个 .conf 文件即可。

十二、Windows 如何下载配置文件?

Windows 新手推荐使用 WinSCP 下载配置文件,界面比较直观。

WinSCP 官方网站 https://winscp.net/
打开 WinSCP 协议选择 SFTP。
填写服务器信息 主机名填写你的 VPS IP,用户名通常是 root,端口通常是 22。
登录服务器 输入服务器密码后登录。
进入 /root/ 目录 找到 wg0-client-xxx.conf 文件。
下载并导入 下载到电脑后,用 WireGuard 客户端导入。
WinSCP 登录信息示例
协议:SFTP
主机名:你的服务器 IP
用户名:root
密码:你的服务器密码
端口:22

十三、如何给多个设备添加节点?

如果你已经安装完成,以后想给第二台手机、电脑、平板添加节点,不需要重新安装系统,只需要重新运行脚本。

打开 WireGuard 管理菜单
./wireguard-install-cn.sh

你会看到类似菜单:

管理菜单
请选择操作:
  1) 添加新客户端
  2) 查看客户端列表
  3) 删除客户端
  4) 卸载 WireGuard
  5) 退出
建议每个设备单独创建一个客户端配置,不要多个设备共用同一个配置。比如 iPhone 用 iphone,MacBook 用 macbook。

十四、最常见问题:显示已连接,但无法上网

这是新手最常见的问题。很多人安装完成后,手机 WireGuard 显示已经连接,但是打不开网页,或者 WireGuard App 里面的 Rx 接收数据一直是 0 B。

重点:这种情况大概率不是脚本问题,而是 VPS 服务商的安全组或防火墙没有放行 WireGuard 的 UDP 端口。

正确的入站规则

项目 设置
类型 自定义
协议 UDP
端口 安装时显示的 WireGuard 端口,例如 51413
来源 0.0.0.0/0
防火墙规则示例
UDP 51413 0.0.0.0/0
千万不要选成 TCP。WireGuard 使用的是 UDP。如果你只放行 TCP,手机可能显示连接,但实际无法正常上网。

十五、如何判断是不是防火墙问题?

打开 WireGuard App,看流量数据。

典型现象
Tx 有数据
Rx 一直是 0 B

这通常说明手机发出了请求,但是服务器没有返回数据。常见原因包括:

  • VPS 安全组没有放行 UDP 端口
  • VPS 系统防火墙拦截了 UDP
  • WireGuard 端口填错
  • 服务器 IP 填错
  • VPS 服务商屏蔽 UDP

优先检查 VPS 后台的安全组或防火墙。

十六、服务器端常用检查命令

如果连接不上,可以 SSH 登录服务器,执行下面的命令检查 WireGuard 状态。

查看 WireGuard 服务状态
systemctl status wg-quick@wg0
查看 WireGuard 当前连接状态
wg
重启 WireGuard 服务
systemctl restart wg-quick@wg0

十七、配置文件保存在哪里?

文件 路径
服务端配置 /etc/wireguard/wg0.conf
客户端配置 /root/wg0-client-客户端名称.conf
参数文件 /etc/wireguard/params
不建议随意删除 /etc/wireguard 目录,否则 WireGuard 配置会丢失。

十八、如何卸载 WireGuard?

如果你不想继续使用,可以重新运行脚本,进入管理菜单后选择卸载。

打开管理菜单
./wireguard-install-cn.sh

然后选择:

卸载选项
4) 卸载 WireGuard
卸载会删除 WireGuard 配置文件和所有客户端信息。如果你想保留配置,请先备份 /etc/wireguard 目录。

十九、安全说明

  • 脚本组件从系统官方软件源安装
  • 脚本不收集、不上传用户数据
  • WireGuard 密钥在服务器本地生成
  • 客户端配置文件保存在服务器本机
  • 配置文件权限设置为 root 可读
不要把服务器密码、客户端配置文件、WireGuard 私钥发给陌生人。一旦客户端配置泄露,别人就可能使用你的 VPN 节点。

二十、完整流程总结

购买 VPS 建议选择支持 UDP 的海外 KVM VPS。
选择系统 新手推荐 Debian 12 或 Ubuntu 22.04。
SSH 登录服务器 使用 root 用户登录 VPS。
执行安装命令 运行 WireGuard 中文一键脚本。
放行 UDP 端口 在 VPS 后台安全组中放行安装时显示的 UDP 端口。
扫码或导入配置 手机扫码,电脑导入 .conf 文件。

二十一、一键安装命令汇总

SSH 登录服务器后,执行:

完整安装命令
wget https://raw.githubusercontent.com/iwantruncom/WireGuard-install-cn/main/wireguard-install-cn.sh
chmod +x wireguard-install-cn.sh
./wireguard-install-cn.sh

安装完成后,如果需要管理客户端,执行:

管理客户端
./wireguard-install-cn.sh


了解 自由档案馆 的更多信息

订阅后即可通过电子邮件收到最新文章。