跳到主要内容

快速安装

建议搭建前先了解 单机部署模式 ，然后先花几分钟观看 安装视频教程，视频中的部分内容因录制时的版本较早，和实际会有略微差异，但整体流程基本一致。

云市场安装​

从云市场安装默认已初始化完成基础环境，可直接通过浏览器访问 http://{服务器IP}:38881 完成后续步骤（管理器默认存放路径：/usr/local/MDPrivateDeployment/）。

手动安装​

提示

如缺乏相关经验，可参考 手动安装部署示例

  1. 准备一台 Linux 服务器，最低配置要求：8核、32G内存、40G数据盘（系统盘除外），确保 8880、38880、38881 端口不被占用，且服务器与客户端之间的端口连通性正常（正式环境使用建议通过安全策略对 38880、38881 端口进行访问控制，此访问地址对应部分运维管理功能）；

  2. 环境参数检查，参考 参数说明

  3. 安装 Docker，可参考官方对不同 Linux 版本的 安装说明；

    注意

    自 Docker v29 (及 containerd v2.1.5 ) 起，容器默认继承 systemd 的 LimitNOFILE 配置。这一变更使得容器内的最大文件打开数 (ulimit -n) 从原先的 1048576 骤降至 1024。

    这会导致 HAP 内部数据库、中间件等服务因无法打开足够的文件句柄，出现启动失败或运行中途崩溃。请务必将此限制调整至 102400 或以上。

    👉 参考方法：调整 LimitNOFILE 限制

    1. 定位并编辑服务文件​

    由于系统版本差异，请先通过以下命令确认配置文件路径：

    # 查看 Docker 服务文件路径
    systemctl status docker | grep "Loaded:"

    # 查看 Containerd 服务文件路径
    systemctl status containerd | grep "Loaded:"

    使用 vi 或 vim 编辑输出结果中的 .service 文件路径。

    2. 修改配置参数​

    在两个文件的 [Service] 区块内添加如下行：

    LimitNOFILE=102400
    3. 加载配置并重启​

    执行以下命令使修改立即生效：

    # 重新加载 systemd 管理器配置
    systemctl daemon-reload

    # 重启相关服务
    systemctl restart docker containerd
    4. 结果验证​

    若 Max open files 的 Soft/Hard Limit 显示为 102400 则表示配置成功：

    # 验证 Docker 进程
    head -n 1 /proc/$(pidof dockerd)/limits && cat /proc/$(pidof dockerd)/limits | grep "Max open files"

    # 验证 Containerd 进程
    head -n 1 /proc/$(pidof containerd)/limits && cat /proc/$(pidof containerd)/limits | grep "Max open files"

  4. 下载 HAP 私有部署版镜像（离线包下载）

    docker pull nocoly/hap:7.1.0
    docker pull nocoly/sc:3.2.0
    docker pull nocoly/command:node2011-python312
    docker pull nocoly/doc:2.0.0

  5. 下载管理器

    wget https://pdpublic.nocoly.com/7.1.0/hap_captain_linux_amd64.tar.gz

  6. 解压管理器

    tar -zxvf hap_captain_linux_amd64.tar.gz

  7. root 权限启动管理器 bash ./service.sh start（请确保管理器一直处于运行状态）；

  8. 启动成功后在浏览器中通过 http://{服务器IP}:38881 进行访问，接着完成 HAP 系统访问地址设置及初始化（初始化过程持续约 3~5 分钟）；

  9. 初始化完成后，在当前页面中申请并绑定密钥，然后创建管理员账户即可进入 HAP 工作台 👏 👏 。

SaaS 版体验​

HAP 私有部署版整体功能与 SaaS 版基本一致，可通过 注册 HAP SaaS 版账号先进行功能体验。