WireGuard 一键安装脚本

技术 秋水逸冰 274040浏览 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.com/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. 按照教程全部搞定,vps默认防火墙关闭的。客户端连接上,但是没有网络。用 systemctl start firewalld.service 开启防火墙,则vps貌似所有端口都被隔断,连22端口都连不上。
    hi5年前(2019-09-30)回复
    • 我也是,不知是否是系统问题,你用的是哪个?
      Administration4年前(2019-12-21)回复
  2. [root@vultr ~]# /opt/wireguard.sh -s -bash: /opt/wireguard.sh: No such file or directory 这个是什么情况啊
    小白5年前(2019-09-30)回复
    • 这是没下载成功导致的。Vultr 一般默认的情况下是没有安装 wget 命令的,需要你自己先安装一下。
      秋水逸冰5年前(2019-09-30)回复
  3. 现在 发这个不会被和谐吗
    ?5年前(2019-09-30)回复
    • 难道你没发现,本站已经被和谐了么?
      秋水逸冰5年前(2019-09-30)回复
      • 秋水 问下 shadowsocks-libev 服务器装好后 这个手机端 和电脑端 什么软件连接啊
        cc5年前(2019-09-30)回复
      • 秋水哥,现在扶墙的最佳方式是v2还是brook呢,过GFW的
        J4年前(2019-10-24)回复
        • 方式无所谓,能用就行。如果一定我要说的话,最佳的方式是肉翻……祝好。
          秋水逸冰4年前(2019-10-26)回复
  4. 建议加上一些安装环境的检查,比如您所说的内核,内核源码包,内核头文件必须存在且这三者版本要一致,如何看是否一致,小白不会看啊
    gugefan5年前(2019-09-29)回复
    • 如果安装失败了,那就是不一致。 否则就是 OK 的。 再强调一遍吧,WireGuard 不适合翻墙。它只是单纯的 VPN 软件。
      秋水逸冰5年前(2019-09-30)回复
  5. https://github.com/trojan-gfw/trojan/wiki/Binary-&-Package-Distributions 秋水逸冰搞个trojan一键呗,谢谢。
    山里人5年前(2019-09-29)回复
  6. 如果机器不开防火墙会有什么问题吗
    eyrewww5年前(2019-09-29)回复
    • 不开防火墙,应该是可以连接但没法上外网,也就是说只能连接内网…… 防火墙的作用之一就是实现 NAT 转发
      秋水逸冰5年前(2019-09-29)回复
  7. 不支持debian 10.
    zcluo5年前(2019-09-28)回复
    • 说到底还是内核的问题。 wireguard 的安装有硬性条件: gcc 版本大于等于4.7,内核版本大于等于3.10,内核源码存在于系统中。
      秋水逸冰5年前(2019-09-29)回复
    • 用dkms来编译管理吧,我5.3.0的内核照样加载进去,现在就用着,其他版本有go版,rust版,衍生版有boringtun,都不错。
      宅男浩志4年前(2019-11-04)回复
  8. 大佬折腾我来玩~~
    Moe_Nya5年前(2019-09-28)回复
  9. 板凳必须是我的!
    主机测评5年前(2019-09-28)回复
  10. 竟然安装成功了,但是什么也不懂。
    C5年前(2019-09-28)回复
  11. 秋水是大陆之光!
    秋水粉丝5年前(2019-09-28)回复
  12. 您好,博主,怎样查看“并生成客户端配置对应的二维码 png 图片”呢?我复制了putty里的链接到浏览器里,找不到也打不开,怎样找到“导出或生成的二维码”呢,谢谢
    Michael5年前(2019-09-28)回复
    • 如果你已经成功安装,最后会生成一张 png 图片,该图片的路径是 /etc/wireguard/wg0_client.png,你需要先把该图片下载回来,然后用看图软件打开,用你的手机客户端扫描该图片的二维码,添加即可。
      秋水逸冰5年前(2019-09-28)回复
      • 怎样找到这个图片的路径,从putty?还是浏览器?
        Michael5年前(2019-09-28)回复
        • 可用 Winscp 连接后下载回本地
          秋水逸冰5年前(2019-09-29)回复
          • 已经安装成功了,但是就是没法搞出那张PNG的图片,方法试过很多种,现在连PUTTY和Winscp都链接不上GCP 的VM ,不知道要怎么办了,大佬能教一下吗?或者直接生成能在浏览器上显示的图片。
            sean5年前(2019-10-12)回复
            • qrencode -t ansiutf8 < /etc/wireguard/wg0_client.conf 这个命令可以在终端里生成二维码,
              李贝4年前(2020-02-04)回复
        • SSHSecureShellClient 这个软件命令行和文件传输在一起的 可以试用下 请教下shadowsocks-libev 这个客户端 手机和电脑要用什么软件连接server 谢谢了
          cc5年前(2019-09-29)回复
  13. 赶上车位,关门,开车!
    Unknow~5年前(2019-09-28)回复
  14. WG官网的文档实在是语焉不详,之前试着折腾,未果;这次就再借teddysun大佬的东风,看看这玩意究竟几斤几两
    活性很低的病毒5年前(2019-09-28)回复
  15. 抢占先机,乡下人前来资瓷
    乡下人5年前(2019-09-28)回复