部署概览

研值云图（程序名 apexpm）以单一可执行文件交付，前端页面已内置，不需要另装 Web 服务器、运行时或数据库（默认用内置 SQLite）。部署要做的只有三件事：放好文件、写好 config.yaml、把进程托管起来。

交付包

按服务器的操作系统和 CPU 架构领对应的包，拿错的包启动不了。

包	适用	可执行文件	附带脚本	Docker 文件
`linux-amd64.zip`	Linux x86_64（含 x86 版麒麟、统信 UOS）	`apexpm`	`start.sh` `stop.sh` `deploy.sh`	`Dockerfile` `docker-compose.yml`
`windows-amd64.zip`	Windows 10 / Server 2016 及以上，x64	`apexpm.exe`	无	无
`darwin-arm64.zip`	macOS，Apple 芯片（M 系列）	`apexpm`	`start.sh` `stop.sh`	无
`darwin-amd64.zip`	macOS，Intel 芯片	`apexpm`	`start.sh` `stop.sh`	无

ARM 架构的 Linux 服务器

鲲鹏、飞腾等 ARM64 服务器目前没有现成的交付包，需要联系我方单独构建。linux-amd64 的包放到 ARM 机器上会报 cannot execute binary file: Exec format error。

解压后的目录（以 Linux 包为例）：

apexpm-vX.Y.Z/
  apexpm                可执行文件（前端已内置）
  config.example.yaml   配置模板，逐项带注释
  config.yaml           已由我方配好；没有就从模板复制一份
  data/
    license.lic         授权文件，与服务器 IP 绑定
  start.sh / stop.sh    在服务器上启停
  deploy.sh             从你的电脑把整包推到服务器并启动
  Dockerfile            仅 Linux 包
  docker-compose.yml    仅 Linux 包
  changelog/            各版本更新说明

选择部署方式

场景	推荐方式	文档
Linux 服务器，长期运行	systemd 托管	Linux
Linux 服务器已装 Docker	docker compose	Docker
包在你的电脑上，要推到远程 Linux	deploy.sh	Linux
Windows 服务器	Windows 服务（WinSW / NSSM）	Windows
演示、内部验证	macOS + launchd	macOS

环境要求

项	要求
CPU / 内存	2 核 / 4 GB 起步
磁盘	50 GB 以上，主要被附件与在线文档占用
端口	默认 `9000`，在 `config.yaml` 的 `server.port` 修改
网络	不需要公网。授权校验离线完成，不访问任何外部服务
数据库	默认内置 SQLite，无需安装；也可接 PostgreSQL / MySQL / 人大金仓，见数据库

几条所有平台通用的规则

读每个平台的部署页之前，先记住这几条，大部分启动失败都来自这里。

必须在部署目录里启动。 程序在当前工作目录查找 config.yaml（找不到再看上一级），并在当前工作目录下创建 data/、data/uploads/。用服务管理器托管时，一定要把工作目录设成部署目录，否则会读不到配置、在别处建出一个空的 data/。
授权绑定服务器网卡 IP。 校验的是服务器本机网卡上的 IP，不是访问者的 IP。换服务器、换 IP、Docker 使用 bridge 网络都会导致「IP 未授权」。
config.yaml 和 data/ 属于你。 升级只换可执行文件，这两样一律保留。
首次启动自动建表。 空库首次启动会自动建表并创建管理员 admin / admin123，登录后立即修改密码。

首启验证

不管用哪种方式部署，起来之后都用这两条命令确认：

bash

curl -fsS http://127.0.0.1:9000/health
curl -fsS http://127.0.0.1:9000/api/v1/license/status

/health 返回 200 说明进程正常，返回内容里的 version 是当前运行的版本号。/api/v1/license/status 返回的 status 字段含义如下：

status	含义
`valid`	授权有效
`grace`	已过期，处于 7 天宽限期，系统仍可用
`blocked`	未授权或宽限期已过，业务接口不可用；原因看 `reason` 字段

这个接口在系统被停用时也能访问，排查授权问题先看它，详见故障排查。

然后用浏览器打开 http://<服务器IP>:9000/ 登录。

部署概览 ​

交付包 ​

选择部署方式 ​

环境要求 ​

几条所有平台通用的规则 ​

首启验证 ​

部署概览

交付包

选择部署方式

环境要求

几条所有平台通用的规则

首启验证