安装与首次配置：从安装包走到第一路画面

这一组文档把“程序能启动”推进到“用户可以稳定使用”。部署的结果不是生成一个进程，而是数据库、MediaServer、存储、网络、宿主守护和安全边界全部闭环。

flowchart LR
    A[规划机器、网络和存储] --> B[选择安装方式]
    B --> C[完成首次配置]
    C --> D[接入一条真实视频]
    D --> E[安全加固与生产验收]

按阶段阅读

1. 部署前准备：决定单机/多节点、数据库、录像盘和网络。
2. 选择安装包，对照包结构核对系统与 CPU 架构。
3. 按系统安装：Linux、Windows、macOS 或 Docker。
4. 跟着首次配置真实截图填写数据库、媒体服务、端口、存储和管理员。
5. 按网络与 HTTPS从目标终端核对可达性，再接入第一路视频。
6. 准备正式上线时完成安全与生产验收。以后再看管理命令、日志和在线升级。

第一次安装的最短路径

如果只是先在测试服务器上跑通，请依次完成：校验发布包 → 解压到固定目录 → 运行对应平台 install → 运行 status → 浏览器打开 5800 端口 → 完成首次配置 → 接入一路视频。每一步都有可观察的完成标志，不需要先读完全部运维文档。

正式安装使用与目标系统、CPU 对应的完整发布包或容器镜像。若缺少运行文件、部署脚本或版本清单，重新获取完整交付物，不要手工拼接不同版本的程序。

最常见的错误顺序

• 先装程序，之后才发现录像盘、数据库或 UDP 端口不满足要求。
• 把 API 的 5800 端口和 MediaServer 的媒体端口当成同一个入口。
• 只验证本机 localhost，没有从摄像机网段与用户浏览器网段验证。
• 直接运行二进制，没有安装 systemd、Windows SCM 或 launchd 守护。
• 在 x64 服务器上使用 ARM64 包，或只复制主服务而遗漏 NodeAgent、WebUI 静态文件和版本文件。
• 首次向导完成后只看页面登录，没有验证 MediaServer、录像写入和故障恢复。

最小生产组成

典型单机部署包括 AKStream.Next、NodeAgent、MediaServer、MySQL 和录像存储。Linux 主服务由独立 NodeAgent 按本地期望状态恢复，主 unit 保持 Restart=no；其他平台按当前发布清单核对唯一恢复所有者。

MediaServer 或数据库可以放在远端，但网络延迟、故障域、备份职责和媒体对外地址必须明确。多节点从设计开始就应给每个节点稳定 ID、可达地址、持久化目录和监控标签。

完成标准

只有 生产上线验收 全部通过，部署才算结束。如果验收失败，不要反复重装；先用 问题定位器 判断失败位于宿主、控制面、协议、媒体、存储还是浏览器。