Sailing - SD-WAN | 更加可靠的互联网接入方案返回首页

Hiddify Manager 安装教程：Ubuntu VPS、域名与订阅配置

更新于 2026-10-24 · sailingnet.shop

简答：Hiddify Manager 应安装在全新的 Ubuntu 22.04、24.04 或 26.04 独立服务器上，并通过 SSH 执行官方安装命令。安装完成后，还要完成域名绑定、管理员密码设置、用户创建和订阅导入，才算真正配置完成。最近核验于 2026年10月24日。本文仅介绍授权服务器和正常网络管理场景。

定义：Hiddify Manager 是安装在自有服务器上的管理面板，用于创建连接配置、管理用户并生成供客户端导入的链接；它不是手机或电脑上的客户端软件。

先看结论：安装前必须满足什么条件

最快的判断方法是：如果你有一台全新、独占的 Ubuntu 服务器，并能通过 SSH 以 root 权限登录，就可以按官方一键方式安装；如果服务器上已经运行网站、其他面板或占用 80/443 端口的服务，不建议直接执行安装命令。

检查项目官方要求或建议不满足时的处理
操作系统Ubuntu 22.04、24.04 或 26.04Ubuntu 20.04、Debian、CentOS 等不在当前快速安装支持范围内
CPU 架构amd64（x86_64）或 arm64先在云主机控制台确认架构
服务器用途建议使用全新、独立服务器已有网站、面板或其他网络服务时先迁移或另开服务器
登录方式能够通过 SSH 登录并取得 root 权限准备 root 登录方式，或登录后执行 sudo -i
端口安装会使用 80 和 443 端口检查安全组、防火墙和已有服务是否占用端口

官方页面还说明，Docker 安装目前属于实验性方式；第一次部署优先选择官方一键安装，不要把实验性 Docker 流程与普通安装混用。官方安装指南和官方 Manager 总览均列出了这些前置条件。hiddify.com

第 1 步：准备 VPS、域名和云安全组

  1. 确认系统镜像。在云主机控制台选择 Ubuntu 22.04、24.04 或 26.04，并确认 CPU 是 amd64 或 arm64。不要把 Ubuntu 20.04 或其他发行版直接当作兼容环境。
  2. 确认服务器独占。如果服务器已经运行 Nginx、Apache、其他管理面板、网站或其他网络服务，先检查 80、443 端口。官方提示 Hiddify Manager 会修改服务器设置并使用这两个端口，可能影响已有服务。
  3. 放行必要流量。在云厂商安全组中检查 SSH 端口，以及面板和连接所需的 80、443 端口；本地防火墙也要同步检查。不要为了省事直接关闭所有防火墙。
  4. 准备域名或子域名。例如使用 panel.example.com，将其 A 记录指向 VPS 公网 IPv4。若使用 IPv6，还要确认 AAAA 记录和客户端网络均能正常访问。
  5. 等待 DNS 生效。在本地执行 nslookup panel.example.com 或 dig panel.example.com，确认返回地址与服务器公网地址一致。解析未生效时先不要急着申请证书。

官方首次配置流程是先准备指向服务器的域名或子域名，再打开管理员面板，最后在面板中完成域名设置和连接链接生成。官方域名与首次配置指南对此有明确说明。hiddify.com

第 2 步：通过 SSH 执行官方安装命令

使用 SSH 登录 VPS。若当前登录用户不是 root，先切换到 root：

sudo -i

然后在服务器终端执行官方当前安装命令：

bash <(curl https://i.hiddify.com/release)

  1. 等待安装器完成，过程可能需要几分钟。
  2. 安装结束后，终端会显示管理员链接。
  3. 立即复制并保存在密码管理器或离线安全位置。
  4. 不要把管理员链接发到公开群组、工单或截图中，因为持有该链接的人可能可以管理面板。

官方总览页面显示，当前核验版本为 v14.0.5，页面标注日期为 2026年10月20日；官方安装页最近更新于 2026年10月23日。版本和页面内容可能继续变化，因此执行前应重新打开官方安装页核对命令。官方 Manager 总览。hiddify.com

如果安装失败，先记录终端中的错误代码，再查看服务器上的 /opt/hiddify-manager/data/log/ 日志目录。官方建议在重复执行前先确认系统版本、root 权限、端口占用和服务器是否为独立环境。官方安装指南。hiddify.com

第 3 步：打开面板并完成域名、密码设置

  1. 打开管理员链接。优先使用带域名和 HTTPS 的 Secure 链接；如果 DNS 或证书尚未准备好，临时 IP 链接可能只能用于初步访问。
  2. 设置管理员密码。首次进入快速设置向导时，设置独立、足够复杂的管理员密码，不要与云主机密码重复。
  3. 填写域名。在域名字段填入已经解析到 VPS 的完整域名，例如 panel.example.com。
  4. 应用变更。保存后，如果页面提示需要 Apply Changes，点击应用并等待服务完成。
  5. 检查 HTTPS。重新用域名访问，确认浏览器地址栏中的域名、证书和访问结果一致。

如果管理员链接丢失，可以重新 SSH 登录服务器并执行：

hiddify admin

如果忘记管理员密码，官方首次配置页面列出的找回方式是执行：

hiddify reset-password

这些命令只应在你拥有并授权管理的服务器上执行。官方首次配置指南。hiddify.com

第 4 步：创建用户、生成订阅并导入客户端

只打开面板并不等于客户端已经可用，还需要创建用户并取得连接信息。

  1. 进入面板中的 Users 区域，创建一个用户。
  2. 根据实际需要设置流量限制、有效期或其他管理字段；不确定时先使用较小范围进行测试。
  3. 打开该用户详情页，查看可用的连接配置、二维码和链接。
  4. 在客户端中选择添加订阅、扫描二维码或粘贴链接。
  5. 导入后先测试一个明确可访问的目标，再观察延迟、丢包和 DNS 是否正常。

官方首次配置指南说明，用户详情页会显示可使用的应用和连接信息，二维码或链接可以用于导入客户端；官方页面推荐使用 Hiddify App，也列出了 Android、iOS、Windows、macOS 和 Linux 的客户端入口。官方连接链接说明。hiddify.com

如果你需要让客户端通过一个订阅地址获取更新后的配置，可以在 Settings 的 Domains 中创建订阅专用域名，并将已有连接域名关联到该订阅域名。这个步骤属于进阶配置，第一次安装可以先使用用户页面直接生成的链接完成验证。官方订阅链接指南。hiddify.com

协议和客户端怎么选：先按排查目标做最小配置

场景建议做法排查重点
第一次安装先创建一个用户，只导入一个配置确认域名、证书、端口和客户端基础连接
多个设备使用优先使用订阅或二维码导入检查订阅地址是否可访问、客户端是否成功更新
移动网络与固定网络表现不同分别测试 DNS、延迟和丢包不要仅凭单次测速判断线路质量
已有服务占用端口不要直接覆盖原服务先迁移到独立服务器，或按官方文档确认端口和架构方案
想使用 Docker仅在了解实验性流程后尝试确认数据卷、端口映射、备份和升级方式

官方当前总览列出了多种连接协议和多平台客户端，但“支持”不等于每种协议都适合所有网络。安装排查时应先保持变量最少：一个域名、一个用户、一个客户端、一次基础连接测试，确认链路后再增加协议或订阅域名。官方功能与协议总览。hiddify.com

常见故障排查：按现象定位，不要反复重装

  • 面板打不开：先检查 VPS 是否运行、SSH 是否可登录，再检查 DNS 是否指向正确地址、云安全组是否放行 80/443，以及本机是否存在代理或 DNS 缓存影响。
  • 安装中断或提示版本不支持：核对是否为 Ubuntu 22.04、24.04 或 26.04，以及 CPU 是否为 amd64 或 arm64；Ubuntu 20.04 和其他发行版不要直接重复执行安装脚本。
  • 证书申请失败：确认域名已经解析到当前 VPS，80/443 没有被其他服务占用，云安全组和本机防火墙允许访问。DNS 未生效时，继续点击申请通常不会解决问题。
  • 安装后网站或其他服务异常：检查是否与 Hiddify Manager 共用同一台服务器。官方明确建议使用独立服务器，因为安装会修改设置并使用 80、443 端口。
  • 订阅为空或客户端无法更新：先在浏览器或命令行确认订阅地址能否访问，再检查用户是否已创建连接配置、订阅域名是否正确关联，以及客户端是否缓存旧订阅。
  • 连接时延迟高或丢包：先区分本地网络、DNS、服务器资源和跨境线路问题。国内站点正常、仅境外站点慢或丢包时，才更接近线路问题；不要把单次测速结果当作长期可用性保证。

官方安装页建议保留失败日志，日志位置为 /opt/hiddify-manager/data/log/。联系云厂商或运营商前，至少准备系统版本、CPU 架构、服务器公网地址、故障发生时间、端口检查结果和相关日志摘要，但不要公开管理员链接。官方安装与日志说明。hiddify.com

安装完成后的安全与维护清单

  1. 删除公开保存的管理员链接副本，只保留在受控密码管理器中。
  2. 为面板设置独立管理员密码，并避免与 SSH、云厂商账号复用。
  3. 记录域名、DNS 记录、服务器系统版本、端口和备份位置。
  4. 升级前先备份，尤其是从较旧版本升级时。
  5. 定期检查用户、订阅链接、流量限制和有效期，删除不再使用的配置。
  6. 出现连接问题时，先做 DNS、端口、证书、客户端和线路的分层排查，不要连续更换多个变量。

Hiddify Manager 的官方总览页提供了备份、更新、恢复和故障排查等后续主题入口。部署完成后，建议把这些维护动作纳入自己的服务器记录，而不是只依赖一次安装成功。官方 Manager 指南目录。hiddify.com

常见问题

Hiddify Manager 可以安装在 Debian 或 Ubuntu 20.04 上吗？

当前官方快速安装页明确列出的系统是 Ubuntu 22.04、24.04 和 26.04，Ubuntu 20.04 已不再支持，Debian 等其他发行版也不在该流程的支持范围内。建议更换为全新的受支持系统。

安装 Hiddify Manager 一定需要域名吗？

安装命令本身可以先执行，但完成首次配置、证书和稳定访问时通常需要准备解析到 VPS 的域名或子域名。若域名尚未生效，面板可能无法正常完成 HTTPS 或后续连接配置。

为什么官方要求使用独立服务器？

官方说明安装过程会修改服务器设置并使用 80、443 端口，因此可能影响网站、其他面板或已有网络服务。为了减少端口冲突和配置覆盖，第一次部署应使用全新、独立的 VPS。

管理员链接丢了，是否必须重新安装？

不需要重新安装。通过 SSH 登录服务器后执行 <code>hiddify admin</code> 可以重新显示管理员链接；如果是管理员密码遗忘，可按官方首次配置指南使用 <code>hiddify reset-password</code> 进行处理。

安装成功但客户端无法连接，应该先查什么？

先按顺序检查域名解析、云安全组、80/443 端口、证书状态、用户是否已经创建连接配置，以及客户端导入的链接是否完整。不要一开始同时更换协议、域名和客户端，否则很难判断真正原因。

订阅链接和单个连接链接有什么区别？

单个连接链接通常对应一个配置，适合首次验证；订阅链接用于让客户端集中获取和更新多个配置。官方文档建议在 Domains 中创建订阅专用域名，并把已有连接域名关联进去，属于安装完成后的进阶设置。

相关阅读

参考资料

  1. Hiddify Manager 官方总览、版本、系统与客户端说明
  2. Hiddify Manager 官方 Ubuntu 安装指南
  3. Hiddify Manager 官方域名、首次配置与连接链接指南
  4. Hiddify Manager 官方订阅链接配置指南