服务器与运行要求

推荐环境

项目	最低要求	推荐配置
操作系统	64 位 Linux	Ubuntu 22.04 或 24.04 LTS
CPU	2 核	4 核及以上
内存	4 GB	8 GB 及以上
磁盘	能容纳数据库、索引、上传和备份	SSD，并为备份保留独立余量
容器环境	Docker、Docker Compose v2	使用仍受支持的稳定版本

矩阵盘正式服务器只运行 Go 二进制及 MySQL、Elasticsearch、Redis 等依赖，不需要 Node.js、pnpm 或独立前端容器。

安装前准备

准备与服务器 CPU 架构一致的官方 juzhenpan_docker_linux_*.zip。
确认 Docker 可用：
终端窗口
```
docker version
docker compose version
```
如使用域名，先将域名解析到服务器公网 IP。
对公网开放 80 和 443；SSH 只允许受控来源。
不要向公网开放 MySQL 3306、Redis 6379 或 Elasticsearch 9200/9300。
确认磁盘有空间同时保存当前数据、一次完整备份和升级临时文件。

不要选择带未知软件的应用镜像

预装面板、数据库或代理服务可能占用端口并改变防火墙。无法确认镜像内容时，优先使用纯净系统镜像；需要宝塔时，先确认它没有重复安装或公开暴露同一套中间件。

域名和 HTTPS

只有 IP 也能先通过 http://服务器IP:8080 检查安装结果。正式对外服务建议配置域名和 HTTPS，再将请求反向代理到矩阵盘监听端口。

域名上线前确认：

A/AAAA 记录指向正确服务器；
80/443 没有被其他程序错误占用；
反向代理传递 Host、协议和客户端 IP 请求头；
站点地址和第三方回调地址使用最终 HTTPS 域名。

具体示例见域名、HTTPS 与反向代理。

许可证准备

商业发行首次启动后会生成固定实例 ID。许可证应在当前实例中激活，不要把已经使用的 runtime/ 目录复制给另一套客户部署。有关网络中断、解绑和迁机边界，请看软件授权。

安装包核对

只使用正式渠道提供的原始压缩包。下载后保留发布说明和 SHA-256 清单；不要运行来源不明、被二次打包或要求关闭签名校验的程序。