AKStream.Next · 文档中心

选择安装方式

选择安装方式

先按服务器操作系统和 CPU 架构选择对应的正式包。安装完成的标志不是“脚本没有报错”,而是服务健康、首次配置页能打开。

先确认系统和架构

服务器 下载包中的标识 安装方式
Linux Intel/AMD linux-x64 systemd 原生服务
Linux ARM linux-arm64 systemd 原生服务
Windows Intel/AMD win-x64 Windows 系统服务
Windows ARM win-arm64 Windows 系统服务
macOS Intel osx-x64 launchd LaunchDaemon
macOS Apple Silicon osx-arm64 launchd LaunchDaemon
Docker x64/ARM64 docker-linux-* Docker Compose

拿错架构时不要继续尝试修改权限或安装运行库,重新下载正确的包。

安装路线

flowchart LR
    A["下载对应平台正式包"] --> B["核对版本和 SHA-256"]
    B --> C["解压到临时目录"]
    C --> D["运行包内安装脚本"]
    D --> E["运行 status"]
    E --> F["浏览器打开首次配置页"]
你的环境 继续阅读
Linux Linux 从解压到首次登录
Windows Windows 从解压到首次登录
macOS macOS 从解压到首次登录
Docker Docker 安装与日常管理

安装前准备

  • 一个固定安装目录;不要长期从下载目录运行。
  • 一个不会被升级覆盖的 Config/Data 目录。
  • 可用的数据库;Docker 包可以使用随 Compose 创建的独立 MySQL。
  • 录像磁盘和目录规划。只体验实时视频时也要明确以后录像放在哪里。
  • 防火墙修改权限,以及浏览器能访问服务器 5800 端口的网络。

安装时做什么

  1. 核对 VERSION、目标架构和 SHA-256。
  2. 使用系统管理员权限运行包内 Deploy/<platform> 安装脚本。
  3. 第一次使用优先选择单机 All-in-One,不要先搭多节点。
  4. 选择随包媒体服务或已存在的外部 MediaServer。
  5. 安装完成后运行 status,查看主服务、NodeAgent、数据库和健康地址。
  6. 浏览器打开脚本输出的地址,进入 首次配置。

安装脚本负责系统服务、目录和容器;首次配置页负责数据库业务配置、模块、端口、录像目录和管理员。两步都完成才能登录使用。

成功标准

  • 管理脚本 status 显示主服务和 NodeAgent 正常。
  • http://服务器地址:5800/health 有响应。
  • 浏览器能打开首次配置页,并要求输入当前安装码。
  • Config 和 Data 位于固定、持久化目录。
  • 服务重启后仍能自动启动。

常见问题

现象 先检查
程序无法执行 下载包架构是否匹配,文件是否完整
5800 端口打不开 服务状态、监听地址、主机防火墙和云安全组
服务运行但页面空白 WebUI 文件是否随完整包安装,浏览器控制台是否有静态资源 404
Docker 一直等待 MySQL MySQL 容器健康状态、数据目录权限和磁盘空间
安装后没有首次配置页 是否误用了旧 Config,或安装锁已经存在

不要用 uninstall --purge 处理普通故障;它可能删除持久化数据。先看状态和日志。

下一步

页面能打开后,进入 跟着向导完成首次配置。