WireGuard 一键安装脚本

技术 秋水逸冰 274003浏览 167评论

本脚本适用环境

系统支持:CentOS 7+,Debian 8+,Raspbian 10,Ubuntu 16+,Fedora 29+
内存要求:≥256M
日期  :2020 年 4 月 2 日

关于本脚本

1. 支持两种安装方式:从代码编译安装,从 repository 直接安装;
2. 脚本会创建默认的 wg0 设备,以及 wg0 的客户端配置,并生成客户端配置对应的二维码 png 图片;
3. 脚本会修改本机防火墙设置,如果未启用防火墙,则会出现警告提示,需要手动去设置;
4. 脚本会从 1024 到 20480 随机生成监听端口;
5. 脚本支持新增,删除,列出客户端功能;
6. 脚本支持查看已安装的 WireGuard 的版本号;
7. 脚本支持从代码编译安装的方式升级 WireGuard 到当前最新版本;

客户端下载

Windows, macOS, Android, iOS 客户端
https://www.wireguard.com/install/

脚本使用方法

使用 root 用户登录系统,运行以下命令下载脚本,赋予执行权限:

wget --no-check-certificate -O /opt/wireguard.sh https://raw.githubusercontent.com/teddysun/across/master/wireguard.sh
chmod 755 /opt/wireguard.sh

写在前面

WireGuard 的安装和使用条件是比较苛刻的。因此我不建议在生产系统里安装和使用 WireGuard,除非你知道自己在做什么。
它依赖于内核,也就是 kernel,在不同的系统中,内核,内核源码包,内核头文件必须存在且这三者版本要一致。
RedHat,CentOS,Fedora,Oracle Linux,Amazon Linux 等 rpm 系的名字是 kernel,kernel-devel,kernel-headers。
Debian,Ubuntu 等 deb 系的名字是 kernel,linux-headers。
如果这三者任一条件不满足的话,则不管是从代码编译安装还是从 repository 直接安装,也只是安装了 wireguard-tools 而已。
而 WireGuard 真正工作的部分,是 wireguard-dkms,也就是动态内核模块支持(DKMS),是它将 WireGuard 编译到系统内核中。
因此,在某些 VPS 商家,是需要你先自主更换系统内核,并事先将这三者安装好,才有可能不会出现编译或安装失败。

我在测试的时候,就经历过各种内核的问题导致的安装失败。如果你也遇到了同样的问题,建议先更换内核。
就我个人的体验而言,在 CentOS 7 下更换为 elrepo 的内核是最容易的。这里有个脚本,可以更换到最新版内核,且自动开启 BBR 网络传输算法。
一键安装最新内核并开启 BBR 脚本
此脚本运行后,最后会提示你重启系统,此时可以输入 n,暂不重启。手动安装 kernel-headers,运行如下命令:

yum -y install kernel-ml-headers

然后再重启之。运行如下命令:

reboot

重启后进入系统,运行下面的从代码编译安装 WireGuard,基本上就不会出现安装失败的问题了。
注意:自主更换内核后,我建议使用从代码编译安装 WireGuard。

更新日志

2020 年 4 月 2 日:
Linux 内核 5.6 正式发布了,内置了 wireguard module。
本次更新添加了检测系统内核版本,如果大于等于 5.6 则不安装 wireguard module,仅安装 wireguard tools,然后再生成默认配置。
当系统内核小于 5.6 时,则依然安装 wireguard module 和 tools,并生成默认配置。

2020 年 1 月 6 日:
一个好消息是 WireGuard 即将要合并到内核 5.6 里面了。
于是作者在近期把 repo 改名了,从而导致脚本无法获取到正确的版本号。
并且还把原来的 repo 一分为二了,分别改为 wireguard-linux-compat 和 wireguard-tools。前者是内核模块,后者是命令行工具。
此次更新就是修复了以上问题。

2019 年 11 月 16 日:
1、修正客户端配置文件创建时的各参数顺序,与 Windows 客户端的显示顺序一致。
2、新增 Windows 客户端配置示例说明。

2019 年 10 月 27 日:
1、新增卸载函数,使用方法请参考下面的卸载方法
2、支持在 CentOS8 下从 repository 安装,或者从代码编译安装。

从代码编译安装 WireGuard

/opt/wireguard.sh -s

从 repository 直接安装 WireGuard

/opt/wireguard.sh -r

安装完成后,脚本提示如下

WireGuard VPN Server installation completed
WireGuard VPN default client file is below:
/etc/wireguard/wg0_client
WireGuard VPN default client QR Code is below:
/etc/wireguard/wg0_client.png
Download and scan this QR Code with your phone
Welcome to visit: https://teddysun.net/554.html
Enjoy it

卸载方法

/opt/wireguard.sh -n

其他使用选项

查看已安装 WireGuard 版本号

/opt/wireguard.sh -v

编译升级 WireGuard 到当前最新版本

/opt/wireguard.sh -u

新增 WireGuard 客户端配置

/opt/wireguard.sh -a

删除 WireGuard 客户端配置
注意:默认客户端 wg0 不允许删除

/opt/wireguard.sh -d

列出 WireGuard 客户端配置

/opt/wireguard.sh -l

高级用法

如果你在安装时,需要自定义自己想要的端口,那么可以 export 变量 VPN_SERVER_WG_PORT 的值,这样脚本就会读取这个变量值来定义监听端口,而不会自己随机生成。
比如你想自定义端口为 1234,那么具体做法就是,在执行从代码编译安装 WireGuard 或者从 repository 直接安装 WireGuard 之前,运行如下命令:

export VPN_SERVER_WG_PORT=1234

下面是一份脚本里用到的变量列表名(共计 11 个),以及它们具体代表什么含义的说明。
VPN_SERVER_PUB_IPV4,定义服务器公网 IPv4,如果你的服务器端存在多个可用公网 IPv4,指定此变量的值。
VPN_SERVER_PUB_IPV6,定义服务器公网 IPv6,如果你的服务器端存在多个可用公网 IPv6,指定此变量的值。
VPN_SERVER_PUB_NIC,定义服务器默认网卡名称,如果你的服务器有多个可用网卡,指定此变量的值。
VPN_SERVER_WG_NIC,定义 WireGuard 网卡名,默认为 wg0,这里一般不推荐指定此变量的值。
VPN_SERVER_WG_IPV4,定义 WireGuard 服务端的内网 IPv4,默认为 10.88.88.1,这里一般不推荐指定此变量的值。
VPN_SERVER_WG_IPV6,定义 WireGuard 服务端的内网 IPv6,默认为 fd88:88:88::1,这里一般不推荐指定此变量的值。
VPN_SERVER_WG_PORT,定义器 WireGuard 服务端的监听端口,默认为从 1024 到 20480 随机生成,如果你想自定义端口,指定此变量的值。
VPN_CLIENT_WG_IPV4,定义 WireGuard 默认客户端的内网 IPv4,默认为 10.88.88.2,这里一般不推荐指定此变量的值。
VPN_CLIENT_WG_IPV6,定义 WireGuard 默认客户端的内网 IPv6,默认为 fd88:88:88::2,这里一般不推荐指定此变量的值。
VPN_CLIENT_DNS_1,定义 WireGuard 默认客户端的 DNS,默认为 1.1.1.1,如果你想自定义为别的 DNS,指定此变量的值。
VPN_CLIENT_DNS_2,定义 WireGuard 默认客户端的 DNS,默认为 8.8.8.8,如果你想自定义为别的 DNS,指定此变量的值。

Windows 客户端配置

下载,安装,打开客户端软件,点击 Add Tunnel -> Add empty tunnel…

此时出现一个可以编辑的界面,将脚本生成的客户端配置 /etc/wireguard/wg0_client 里的内容复制出来,粘贴,保存。

点击 Activate,就可以 VPN 连接了。

参考链接

https://www.wireguard.com
https://github.com/WireGuard/WireGuard
https://git.zx2c4.com/WireGuard
https://golb.hplar.ch/2019/07/wireguard-windows.html

转载请注明:秋水逸冰 » WireGuard 一键安装脚本

发表我的评论
取消评论

请输入正确答案后提交评论 *超出时限。 请再次填写验证码。

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

网友最新评论 (167)

  1. 好像需要安装 kernel-ml-headers 和 kernel-ml-devel
    way_try9个月前(06-30)回复
  2. Teddy大佬,似乎脚本里的linux-headers的版本过期了,不在apt默认的库里 Execution command (apt-get -y install linux-headers-4.19.0-6-amd64) failed, please check it and try again. 执行apt search只看到这些版本,麻烦大佬更新一下。 ``` sudo apt-cache search linux-headers aufs-dkms - DKMS files to build and install aufs linux-libc-dev-amd64-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-arm64-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-armel-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-armhf-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-i386-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mips-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mips64el-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mipsel-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-ppc64el-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-s390x-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mips64-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mips64r6-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mips64r6el-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mipsn32-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mipsn32el-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mipsn32r6-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mipsn32r6el-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mipsr6-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-mipsr6el-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-alpha-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-hppa-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-m68k-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-powerpc-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-powerpcspe-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-ppc64-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-riscv64-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-sh4-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-sparc64-cross - Linux Kernel Headers for development (for cross-compiling) linux-libc-dev-x32-cross - Linux Kernel Headers for development (for cross-compiling) linux-headers-4.19.0-20-all - All header files for Linux 4.19 (meta-package) linux-headers-4.19.0-20-all-amd64 - All header files for Linux 4.19 (meta-package) linux-headers-4.19.0-20-amd64 - Header files for Linux 4.19.0-20-amd64 linux-headers-4.19.0-20-cloud-amd64 - Header files for Linux 4.19.0-20-cloud-amd64 linux-headers-4.19.0-20-common - Common header files for Linux 4.19.0-20 linux-headers-4.19.0-20-common-rt - Common header files for Linux 4.19.0-20-rt linux-headers-4.19.0-20-rt-amd64 - Header files for Linux 4.19.0-20-rt-amd64 linux-headers-4.19.0-21-all - All header files for Linux 4.19 (meta-package) linux-headers-4.19.0-21-all-amd64 - All header files for Linux 4.19 (meta-package) linux-headers-4.19.0-21-amd64 - Header files for Linux 4.19.0-21-amd64 linux-headers-4.19.0-21-cloud-amd64 - Header files for Linux 4.19.0-21-cloud-amd64 linux-headers-4.19.0-21-common - Common header files for Linux 4.19.0-21 linux-headers-4.19.0-21-common-rt - Common header files for Linux 4.19.0-21-rt linux-headers-4.19.0-21-rt-amd64 - Header files for Linux 4.19.0-21-rt-amd64 linux-headers-amd64 - Header files for Linux amd64 configuration (meta-package) linux-headers-cloud-amd64 - Header files for Linux cloud-amd64 configuration (meta-package) linux-headers-rt-amd64 - Header files for Linux rt-amd64 configuration (meta-package) linux-headers-4.19.0-19-all - All header files for Linux 4.19 (meta-package) linux-headers-4.19.0-19-all-amd64 - All header files for Linux 4.19 (meta-package) linux-headers-4.19.0-19-amd64 - Header files for Linux 4.19.0-19-amd64 linux-headers-4.19.0-19-cloud-amd64 - Header files for Linux 4.19.0-19-cloud-amd64 linux-headers-4.19.0-19-common - Common header files for Linux 4.19.0-19 linux-headers-4.19.0-19-common-rt - Common header files for Linux 4.19.0-19-rt linux-headers-4.19.0-19-rt-amd64 - Header files for Linux 4.19.0-19-rt-amd64 linux-headers-4.19.0-22-all - All header files for Linux 4.19 (meta-package) linux-headers-4.19.0-22-all-amd64 - All header files for Linux 4.19 (meta-package) linux-headers-4.19.0-22-amd64 - Header files for Linux 4.19.0-22-amd64 linux-headers-4.19.0-22-cloud-amd64 - Header files for Linux 4.19.0-22-cloud-amd64 linux-headers-4.19.0-22-common - Common header files for Linux 4.19.0-22 linux-headers-4.19.0-22-common-rt - Common header files for Linux 4.19.0-22-rt linux-headers-4.19.0-22-rt-amd64 - Header files for Linux 4.19.0-22-rt-amd64 linux-headers-4.19.0-23-all - All header files for Linux 4.19 (meta-package) linux-headers-4.19.0-23-all-amd64 - All header files for Linux 4.19 (meta-package) linux-headers-4.19.0-23-amd64 - Header files for Linux 4.19.0-23-amd64 linux-headers-4.19.0-23-cloud-amd64 - Header files for Linux 4.19.0-23-cloud-amd64 linux-headers-4.19.0-23-common - Common header files for Linux 4.19.0-23 linux-headers-4.19.0-23-common-rt - Common header files for Linux 4.19.0-23-rt linux-headers-4.19.0-23-rt-amd64 - Header files for Linux 4.19.0-23-rt-amd64 linux-headers-5.10.0-0.deb10.17-amd64 - Header files for Linux 5.10.0-0.deb10.17-amd64 linux-headers-5.10.0-0.deb10.17-cloud-amd64 - Header files for Linux 5.10.0-0.deb10.17-cloud-amd64 linux-headers-5.10.0-0.deb10.17-common - Common header files for Linux 5.10.0-0.deb10.17 linux-headers-5.10.0-0.deb10.17-common-rt - Common header files for Linux 5.10.0-0.deb10.17-rt linux-headers-5.10.0-0.deb10.17-rt-amd64 - Header files for Linux 5.10.0-0.deb10.17-rt-amd64 linux-headers-5.10.0-0.deb10.19-amd64 - Header files for Linux 5.10.0-0.deb10.19-amd64 linux-headers-5.10.0-0.deb10.19-cloud-amd64 - Header files for Linux 5.10.0-0.deb10.19-cloud-amd64 linux-headers-5.10.0-0.deb10.19-common - Common header files for Linux 5.10.0-0.deb10.19 linux-headers-5.10.0-0.deb10.19-common-rt - Common header files for Linux 5.10.0-0.deb10.19-rt linux-headers-5.10.0-0.deb10.19-rt-amd64 - Header files for Linux 5.10.0-0.deb10.19-rt-amd64 linux-headers-5.10.0-0.deb10.20-amd64 - Header files for Linux 5.10.0-0.deb10.20-amd64 linux-headers-5.10.0-0.deb10.20-cloud-amd64 - Header files for Linux 5.10.0-0.deb10.20-cloud-amd64 linux-headers-5.10.0-0.deb10.20-common - Common header files for Linux 5.10.0-0.deb10.20 linux-headers-5.10.0-0.deb10.20-common-rt - Common header files for Linux 5.10.0-0.deb10.20-rt linux-headers-5.10.0-0.deb10.20-rt-amd64 - Header files for Linux 5.10.0-0.deb10.20-rt-amd64 linux-headers-5.10-amd64 - Header files for Linux amd64 configuration (meta-package) linux-headers-5.10-cloud-amd64 - Header files for Linux cloud-amd64 configuration (meta-package) linux-headers-5.10-rt-amd64 - Header files for Linux rt-amd64 configuration (meta-package) ```
    365cent1年前(2023-01-03)回复
    • 先手动升级一下 linux-headers 到最新版本,再重新运行脚本
      秋水逸冰1年前(2023-01-05)回复
  3. [root@VM-8-12-centos ~]# /opt/wireguard.sh -v wireguard-dkms version : 1.0.20210606 wireguard-tools version: 1.0.20210914 [root@VM-8-12-centos ~]# /opt/wireguard.sh -u [Wed Sep 28 05:36:06 CST 2022] wireguard-dkms version: 1.0.20210606 [Wed Sep 28 05:36:06 CST 2022] wireguard-dkms latest version: 1.0.20220627 [Wed Sep 28 05:36:06 CST 2022] Starting upgrade wireguard-dkms [Wed Sep 28 05:36:06 CST 2022] wget --no-check-certificate -qO wireguard-linux-compat-1.0.20220627.tar.gz https://github.com/WireGuard/wireguard-linux-compat/archive/v1.0.20220627.tar.gz [Wed Sep 28 05:36:08 CST 2022] tar zxf wireguard-linux-compat-1.0.20220627.tar.gz [Wed Sep 28 05:36:08 CST 2022] cd wireguard-linux-compat-1.0.20220627/src [Wed Sep 28 05:36:08 CST 2022] make /opt/wireguard-linux-compat-1.0.20220627/src/netlink.c: In function ‘wg_get_device_start’: /opt/wireguard-linux-compat-1.0.20220627/src/netlink.c:201:24: error: implicit declaration of function ‘genl_dumpit_info’; did you mean ‘get_pipe_info’? [-Werror=implicit-function-declaration] wg = lookup_interface(genl_dumpit_info(cb)->attrs, cb->skb); ^~~~~~~~~~~~~~~~ get_pipe_info /opt/wireguard-linux-compat-1.0.20220627/src/netlink.c:201:44: error: invalid type argument of ‘->’ (have ‘int’) wg = lookup_interface(genl_dumpit_info(cb)->attrs, cb->skb); ^~ cc1: some warnings being treated as errors make[2]: *** [scripts/Makefile.build:316: /opt/wireguard-linux-compat-1.0.20220627/src/netlink.o] Error 1 make[1]: *** [Makefile:1563: _module_/opt/wireguard-linux-compat-1.0.20220627/src] Error 2 make: *** [Makefile:26: module] Error 2 [Wed Sep 28 05:36:21 CST 2022] Execution command (make) failed, please check it and try again.
    Ire2年前(2022-09-28)回复
    • 这种情况一般升级系统内核到目前最新版就可以了(升级内核有一定的风险)
      秋水逸冰2年前(2022-09-29)回复
  4. 请问,端口被封了怎么换端口?
    被风吹过的男子2年前(2022-03-19)回复
    • 修改 /etc/wireguard/wg0.conf 里的 ListenPort 的值,改为新的端口。然后重启 wireguard。 systemctl restart wg-quick@wg0 然后记得改客户端里的 Endpoint = IP:端口号 的端口号。
      秋水逸冰2年前(2022-03-19)回复
      • 谢谢你的回复~修改后能ping通内网地址但是打开油管。
        Levy2年前(2022-03-21)回复
      • Ubuntu 20+系统
        Levy2年前(2022-03-21)回复
  5. wireguard+udpspeeder+udp2raw=地表最强游戏加速器。希望秋大有空写个rocky8版的教程。
    bug103年前(2021-08-14)回复
  6. 请问centos8支持不?
    BLUE3年前(2021-07-18)回复
    • 当然支持
      秋水逸冰3年前(2021-07-20)回复
      • 希望秋大能够添加对oracle linux 的支持!
        john3年前(2021-07-27)回复
  7. 不知道哪次重启后,iptables -A FORWARD -o wg0 -j ACCEPT这条语句失效了,每次都得手动执行一次才有效。只要放到postup里,都不行,哪怕是用.sh文件里执行,也不行。
    Larkin3年前(2021-06-28)回复