VpnHood!

安装 VpnHood! SERVER

在任何拥有公网 IP 的 Linux 设备上搭建专属 VPN 服务器。您可以通过 VpnHood! MANAGER 自动化安装受管服务器，也可以使用单条命令一键部署独立服务器。

  1. 您的服务器

    VpnHood! SERVER 运行在由您掌控的设备上，例如 VPS。

  2. 访问密钥

    由 MANAGER 或服务器自动生成。持有密钥即可连接。

  3. 您的设备

    只需将密钥添加到手机或电脑上的 VpnHood! CLIENT 即可。

准备工作

  • 一台拥有公网 IP 地址的 Linux 服务器（支持 x64 或 arm64 架构）。
  • Root 权限。安装命令需要通过 sudo 运行，因此即使您以 root 身份登录，系统上也必须安装 sudo。
  • 开放 TCP 端口 443（需同时在服务器系统防火墙和服务商的安全组中放行）。该端口为服务器监听端口。

安装受管服务器

VpnHood! MANAGER 会自动为您配置服务器并分发访问密钥。在 MANAGER 中，打开 Servers，点击 Add，输入服务器名称并点击 Create。随后 MANAGER 将提供以下安装方式：

VpnHood! MANAGER 提供的多种新服务器安装方式
  • Install on Linux by UserName & Password 或 Install on Linux by UserName & SSH Key：输入服务器地址及拥有 root 权限的账户，MANAGER 即可通过 SSH 自动完成安装。请确保 MANAGER 能访问服务器的 SSH 端口（未更改时默认为 22）。使用密钥登录时，请点击 Upload SSH key 上传密钥文件。
  • Install on Linux manually by running a command：在服务器上运行 MANAGER 提供的命令。该命令基于下方的独立安装程序，并预设了连接 MANAGER 的配置，同样仅需确认两个设置。请妥善保管该命令，切勿外泄，其中包含服务器连接凭据。
  • Install Manually by configuring appsettings：适用于已安装的服务器。将 MANAGER 中显示的设置保存为 /opt/VpnHoodServer/storage/appsettings.json，然后使用 sudo systemctl restart VpnHoodServer 重启服务器。

服务器通过 HTTPS 连接到位于 access.vpnhood.com 的 MANAGER。连接成功后，其状态会从 NotInstalled 变为 Idle，有设备连接时则显示为 Active。如需重新查看安装选项，请打开该服务器并选择 Install，安装完成后则选择 Reinstall。

随后在 MANAGER 的 Access Tokens 下为您的设备创建访问密钥。

安装独立服务器

运行此命令。它会自动检测系统架构（x64 或 arm64），将服务器安装至 /opt/VpnHoodServer，并提示确认两项设置。 

sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer-linux.sh)"

出现 Start the server at boot (Y/n)? 和 Keep the server up to date by itself (Y/n)? 提示时，直接按回车确认。服务器将以系统服务运行：开机自启、崩溃自动恢复，并始终保持最新版本。

在脚本中实现免交互静默安装

sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer-linux.sh) -q"

创建您的首个访问密钥

独立服务器仅允许持有其所颁发密钥的设备连接。请在服务器上运行此命令以生成密钥。

sudo /opt/VpnHoodServer/vhserver gen

密钥显示在 --- AccessKey --- 下方，以 vh:// 开头；请复制整行内容。在其上方几行，HostEndPoints: 应显示服务器的公网 IP 地址。

如需为密钥设置限制，可在命令中添加以下任一选项。

选项作用说明
-name Phone自定义名称，用于区分不同的密钥。
-maxClient 5允许同时连接的设备数量上限。默认值：2。
-maxTraffic 50000流量限制（单位：MB）。默认值：无限制。
-maxSpeed 20上传与下载速度限制（单位：Mbps）。默认值：无限制。
-expire 2030/01/25密钥有效截止日期。默认值：永久有效。

示例：仅供单台手机使用且在 2030 年底到期的密钥

sudo /opt/VpnHoodServer/vhserver gen -name Phone -maxClient 1 -expire 2031/01/01

任何持有此密钥的人均可通过您的服务器连接。请像妥善保管密码一样共享它。

连接

在每台设备上安装 VpnHood! CLIENT，添加访问凭据（Key），即可连接。

启动与停止服务器

无论是由面板托管还是独立运行，服务器均作为 VpnHoodServer 服务运行。 

sudo systemctl status VpnHoodServer
sudo systemctl stop VpnHoodServer
sudo systemctl start VpnHoodServer

日志位于 /opt/VpnHoodServer/storage/logs/server.log。

如果未安装为系统服务，可手动运行 sudo /opt/VpnHoodServer/vhserver 启动。它将持续运行，直到你在另一个终端中使用 sudo /opt/VpnHoodServer/vhserver stop 停止它。

更新

除非在安装时已禁用，否则服务器会自动更新至最新版本：VpnHoodServerUpdater 服务会每 12 小时检查一次更新。

若要关闭自动更新，请重新运行独立安装命令，并在 Keep the server up to date by itself (Y/n)? 提示处输入 n。安装程序会保留你的选择和配置，服务器将保持当前版本，直至你手动更新。在脚本中，请添加 -noautoupdate 参数： 

sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer-linux.sh) -q -noautoupdate"

建议尽量保持自动更新。新版本不仅会修复安全漏洞，而且较新的客户端应用也可能会停止支持旧版服务器。

后续步骤

下载 升级高级版 登录