环境要求

在安装 Crest 前，先把服务器和运行环境准备好。准备不充分会导致安装脚本失败、服务启动后无法访问、数据源连接异常或后续升级困难。

本页是部署前准备清单，建议在执行安装脚本前完成确认。生产环境应提前确认服务器规格、访问域名、数据库方案、密码密钥和备份策略。

部署准备最终要落到一个可访问的系统入口。下面的登录页用于说明上线后用户看到的第一个页面，因此域名、HTTPS、Logo、系统名称和登录方式都要在部署前规划好。

如果登录页使用 IP、临时端口或测试名称，后续再切换到正式域名时，SSO 回调、分享链接、Cookie 和反向代理配置都可能需要一起调整。

服务器建议配置

磁盘空间需要覆盖应用镜像、MySQL 数据、上传文件、导出文件、日志和备份。演示环境可以较小，生产环境不要按最低配置规划。

生产环境规划时，至少按三类容量估算磁盘：数据库增长、上传和导出文件增长、备份保留。仅按安装包大小预留磁盘，后续容易在导出任务、日志和数据库增长时出现容量风险。

容量估算示例：

网络和端口

如果使用反向代理，用户只访问代理地址，Crest 端口可以只对代理服务器开放。数据库端口不建议暴露给普通办公网段。

网络规划建议按“用户访问”和“系统访问”分别确认。用户只需要访问 Crest 的 Web 地址；Crest 服务本身还需要访问元数据库、业务数据源、SSO 身份平台、镜像仓库或企业代理。部署失败的常见原因不是 Web 端口未开放，而是只放通了用户访问链路，未放通系统依赖链路。

部署前建议在目标服务器上确认端口：

ss -lntp | grep 8100 || true
ss -lntp | grep 3306 || true

如果端口已被占用，先确认占用进程，再决定是释放端口还是修改 Crest 配置。不要安装完成后再临时换端口，SSO 回调、分享地址和反向代理都可能要跟着改。

域名和 HTTPS

生产环境建议提前准备：

1. 固定域名，例如 https://bi.example.com。
2. 有效 HTTPS 证书。
3. 反向代理或 Ingress。
4. Crest 的允许来源配置。
5. SSO 回调地址。

如果后续才切换域名，分享链接、SSO 回调和浏览器缓存都可能需要重新检查。

如果项目计划对外公开访问，域名和 HTTPS 不要留到最后处理。SSO、分享链接、反向代理、Cookie 和允许来源都依赖最终访问地址。测试阶段可以用 IP，正式交付时应固定到域名。

数据库要求

Crest 单机安装默认内置 MySQL。生产环境也可以接入外部 MySQL。

外部 MySQL 建议：

• MySQL 8.0 或兼容版本。
• 使用 utf8mb4 字符集。
• 提前创建数据库。
• 使用专用账号，不复用 DBA 账号。
• 纳入数据库备份和监控。
• 如启用 MySQL 数据集缓存，预留缓存表容量和同步任务执行窗口。

创建数据库示例：

CREATE DATABASE crest
  DEFAULT CHARACTER SET utf8mb4
  COLLATE utf8mb4_0900_ai_ci;

数据库账号建议只授予 Crest 所需权限。不应使用 root 账号，也不应复用其他系统账号。数据库密码、连接地址和备份策略应由数据库负责人纳入统一管理。

密码和密钥要求

部署前请明确以下值如何生成、保存和备份：

国密模式说明

Crest 支持两种加密模式：

启用国密模式不会改变业务用户的操作方式。用户仍按相同路径创建数据源、数据集、仪表盘、大屏、分享和导出；管理员仍在系统管理中配置账号、角色、权限、SSO 和审计。需要变化的是部署前必须明确 CREST_CRYPTO_MODE=sm-suite，并安全保存 CREST_SM4_KEY。

安装前检查命令

docker version
docker compose version
df -h
free -h
ss -lntp | grep 8100 || true

如果 8100 已被占用，请在安装前修改端口配置。

检查命令执行后，应记录结果：

这些记录可纳入部署验收表，便于后续排查安装失败和环境差异。

准备完成的判断标准

安装前可按以下标准判断是否准备到位：

满足这些条件后再安装，后续变更成本会更低。尤其是加密模式、AES Key、AES IV、SM4 Key、域名和数据库方案，部署后再调整成本较高。