VpnHood!

在 Linux 上安装 VpnHood! SERVER

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

  1. 您的服务器

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

  2. 访问密钥

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

  3. 您的设备

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

准备工作

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

安装独立服务器

运行此命令。它会自动检测机器架构（x64 或 arm64），并将服务器安装到 /opt/VpnHoodServer。 

sudo bash -c 'u=https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer-linux.sh; bash <(wget -qO- $u 2>/dev/null || curl -fsSL $u)'

如需在脚本中免交互自动安装，请参阅安装程序选项。

创建您的首个访问密钥

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

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。安装程序会保留您的选择和配置，服务器将保持当前版本，直到您手动更新。

建议尽量保持自动更新。部分版本会修复安全问题。更新后的应用仍可连接旧版服务器，但连接 v9.0.859 之前的服务器时无法使用 UDP，而且应用对早于 VpnHood 9.1 的服务器的支持仅持续到 2027 年 4 月。

卸载

如需移除服务器，请运行卸载程序。它会停止服务器并删除相关服务与文件，但会在 /opt/VpnHoodServer/storage 中保留配置、访问密钥和证书，方便日后重新安装。 

sudo /opt/VpnHoodServer/vhuninstall

同时彻底删除配置与密钥：持有旧密钥的设备将无法再连接，即使重新安装也无法恢复 

sudo /opt/VpnHoodServer/vhuninstall -purge

后续步骤

下载 升级高级版 登录