所属产品: Mingcedar CONTROL

Linux 与容器部署 | Mingcedar

使用匹配 x86_64 或 aarch64 的 Linux 安装包。

首次发布 2026-10-25T12:48:42.55327109Z 最近更新 2026-10-25T12:48:42.553270338Z

<div class="manual-doc-article manual-doc-article-section"><h2 id="linux-install">安装: Linux 与容器部署</h2>

按目标架构选择安装包，并确认数据目录、网络入口和运行服务。

<h3 id="linux-install-item-1">Linux 原生安装</h3>

<p>使用匹配 x86_64 或 aarch64 的 Linux 安装包。</p>

<ol>

<li>核对安装包及 SHA-256 文件，解压后在包目录执行 sudo bash install.sh。</li>

<li>使用 --profile 和 --install-root 指定部署角色与目录，默认 full 和 /opt/hqcontrol；按安装说明准备 Python 解释器，安装器检查脚本环境并部署离线依赖。</li>

<li>脚本运行需要安装器检查通过的 bubblewrap、prlimit、runuser 和用户命名空间；缺少依赖时按报告补齐后重新安装。</li>

<li>安装后执行 sudo hqcontrolctl status 和 sudo hqcontrolctl health，确认服务与就绪状态。</li>

</ol>

</article>

<h3 id="linux-install-item-2">服务检查与维护命令</h3>

<p>原生 Linux 由 systemd 分别监控运行服务。</p>

<ol>

<li>使用 sudo hqcontrolctl logs app、logs io、logs alarm、logs trend 或 logs script 查看对应日志；ports 查看监听端口。</li>

<li>使用安装包的管理命令；整单元 restart 会重启运行与数据服务，须安排维护时间。</li>

<li>服务启动后核对 Portal、Screen、授权、设备质量及归档恢复，再恢复操作。</li>

</ol>

</article>

<h3 id="linux-install-item-3">容器部署与持久数据</h3>

<p>使用发布包提供的容器定义与版本匹配的镜像。</p>

<ol>

<li>Linux/macOS 在发布包目录执行 ./hqcontrol.sh install，安装后执行 ./hqcontrol.sh status；Windows 使用对应的 hqcontrol.ps1。离线包已包含所需镜像。</li>

<li>按发布包说明准备环境配置、证书和持久卷；将配置、用户画面、脚本及数据库数据保存在持久目录中。</li>

<li>暴露实际配置的 Portal 和 Screen HTTPS 入口，不把容器内部数据服务端口当作客户端地址。</li>

<li>容器启动后从系统状态确认各服务就绪，再检查设备连接、采集质量和画面。更新镜像前备份持久数据，并按发布包说明保留原有卷。</li>

</ol>

</article>

</div>