安装: Linux 与容器部署
按目标架构选择安装包，并确认数据目录、网络入口和运行服务。
Linux 原生安装
使用匹配 x86_64 或 aarch64 的 Linux 安装包。
- 核对安装包及 SHA-256 文件，解压后在包目录执行 sudo bash install.sh。
- 使用 --profile 和 --install-root 指定部署角色与目录，默认 full 和 /opt/hqcontrol；按安装说明准备 Python 解释器，安装器检查脚本环境并部署离线依赖。
- 脚本运行需要安装器检查通过的 bubblewrap、prlimit、runuser 和用户命名空间；缺少依赖时按报告补齐后重新安装。
- 安装后执行 sudo hqcontrolctl status 和 sudo hqcontrolctl health，确认服务与就绪状态。
服务检查与维护命令
原生 Linux 由 systemd 分别监控运行服务。
- 使用 sudo hqcontrolctl logs app、logs io、logs alarm、logs trend 或 logs script 查看对应日志；ports 查看监听端口。
- 使用安装包的管理命令；整单元 restart 会重启运行与数据服务，须安排维护时间。
- 服务启动后核对 Portal、Screen、授权、设备质量及归档恢复，再恢复操作。
容器部署与持久数据
使用发布包提供的容器定义与版本匹配的镜像。
- Linux/macOS 在发布包目录执行 ./hqcontrol.sh install，安装后执行 ./hqcontrol.sh status；Windows 使用对应的 hqcontrol.ps1。离线包已包含所需镜像。
- 按发布包说明准备环境配置、证书和持久卷；将配置、用户画面、脚本及数据库数据保存在持久目录中。
- 暴露实际配置的 Portal 和 Screen HTTPS 入口，不把容器内部数据服务端口当作客户端地址。
- 容器启动后从系统状态确认各服务就绪，再检查设备连接、采集质量和画面。更新镜像前备份持久数据，并按发布包说明保留原有卷。
