系统安装与服务器迁移 #
准备首次部署时，先按源码部署清单确认账号、域名和维护分工，再进行以下配置。
前言 #
此篇主要用于新服务器安装。服务器迁移也可以参考本页，但需要先备份旧服务器数据。
新服务器优先选择 Debian 12。Ubuntu 22.04 LTS、Ubuntu 24.04 LTS、OpenCloudOS 9、Alibaba Cloud Linux 3 需先由部署人员确认宝塔、Docker 及所用 BOOLCMS 版本兼容，再选择安装。不要将此列表理解为后续所有系统版本均兼容。
CentOS Linux 7、CentOS Linux 8 已结束维护，不建议用于新装。系统名称与支持范围可参考宝塔安装页 (opens new window)、OpenCloudOS 文档 (opens new window)、Alibaba Cloud Linux 文档 (opens new window)及CentOS 维护状态 (opens new window)。
服务器迁移请先从原服务器下载
/boolcms文件夹和数据库备份，再上传到新服务器对应位置。没有把握时，先在售后群确认备份是否完整，不要直接操作旧服务器。
安全组 #
安全组可以理解为服务器的“门禁”。端口没有放行时，系统可能安装好了也打不开。
请严格按照 售后钉盘 > 内部教程 > 入站规则 设置安全组。设置完成后，建议截图发到售后群确认。
| 端口 | 用途 | 放行要求 |
|---|---|---|
TCP 2376 | Docker 远程管理 | 仅在交付方案需要时开放，并仅允许指定运维来源 IP 访问；确认 TLS 和客户端证书认证配置，不得无认证向公网开放。 |
TCP 1883 | MQTT 设备接入 | 按实际设备接入需求和来源范围放行，确认设备认证及访问权限；不能照搬 Docker 管理端口的来源规则。该端口通常为明文连接，如需加密，由部署人员确认 TLS 接入方案。 |
这两个端口不是网站访问端口。网站、SSH 和宝塔面板端口按实际配置分别设置规则；数据库端口不向整个公网开放。规则应同时核对云安全组、主机防火墙与 Docker 端口映射。Docker 管理连接要求见官方说明 (opens new window)。
宝塔 #
1 打开宝塔在线安装 (opens new window) #
2 输入服务器信息 #
3 选择套件 #
按需安装，不必勾选整套 LNMP
BOOLCMS 服务通过 Docker 部署，不依赖宝塔的 PHP 运行环境。使用云 MySQL 时，本步骤只需安装 Nginx，不必在本机重复安装 MySQL；后续仍需安装 Docker。
只有需要通过 phpMyAdmin 管理数据库时，才安装 PHP 和 phpMyAdmin；使用云数据库控制台或其他数据库客户端时，可不安装这两项。
以下为新服务器的版本选择建议（核对日期：2026-10-22）。同一分支应选包含最新安全修复的补丁版本，不要只看主版本号。
| 组件 | 何时安装 | 建议版本与注意事项 |
|---|---|---|
| Nginx | 本教程的反向代理与 HTTPS 服务需要 | 1.30.x 稳定分支的最新补丁版；核对时为 1.30.6。 |
| MySQL | 数据库部署在本机时 | 新装优先评估 8.4 LTS 最新补丁版，部署前确认所用 BOOLCMS 版本、账号认证及备份恢复工具兼容。使用云 MySQL 时不在本机安装。 |
| PHP | 仅在使用 phpMyAdmin 等 PHP 工具时 | 配合下述 phpMyAdmin，选择 8.3.x 最新安全补丁版；不是 BOOLCMS 必装组件。 |
| phpMyAdmin | 需要浏览器数据库管理工具时 | 5.2.3 或 5.2 系列后续稳定修订版，搭配 PHP 8.3；不要选择开发快照。 |
若宝塔列表未提供上述维护版本，先更新面板及软件列表，或由部署人员确认安装方案，不要为凑齐套件而随意选择旧版。
旧服务器迁移不等于数据库跨版本升级。 MySQL 8.0 已于 2026 年 4 月结束官方维护，不再作为新装默认推荐；已有 8.0 数据库应先备份并验证恢复，再安排升级。MySQL 8.4 默认不启用旧的 mysql_native_password 认证，升级前要检查应用、账号和管理工具，不能直接复用旧数据目录启动新版本。8.4 的选型建议不代表所有历史 BOOLCMS 版本均已通过兼容测试。
依据：Nginx 稳定版本 (opens new window)、PHP 支持周期 (opens new window)、phpMyAdmin 版本要求 (opens new window)、MySQL 8.0 维护状态 (opens new window)、MySQL 8.4 认证变化 (opens new window)。PHP 7.4、phpMyAdmin 5.0 已不在上述推荐组合内，不再使用“任意版本”的说法。
下图为套件选择说明图，并非宝塔界面截图；实际可选版本以面板软件列表为准。
4 等待安装完毕 保存宝塔信息 并登录宝塔 #
5 安装Docker #
6 域名配置 #
需解析三个子域名：API，管理端，移动端
安装时需要登录终端，并提供平台名称以及超级管理员手机号。该手机号会作为初始登录账号和密码使用。首次登录后立即修改为独立的高强度密码，再交付使用。
安全组需按照钉盘文档内进行安全端口的新增并截图到群确认
例如：
api.boolc.cn（API）
admin.boolc.cn（管理端）
wm.boolc.cn（移动端）
7 终端 登录 #
其它配置 #
1 SSL证书配置 #
2 证书有效期与续签 #
提示
免费证书的额度、有效期和申请条件以各云平台当前规则为准。例如腾讯云免费证书有效期为 90 天，华为云免费测试证书为 3 个月，不能再按“免费 365 天”准备部署。参考腾讯云免费证书说明 (opens new window)、华为云证书说明 (opens new window)。
截至 2026-10-22，按 CA/Browser Forum 标准 (opens new window)，2026-03-15 至 2027-03-15 前新签发的公网受信任 TLS 证书，单张最长有效期为 200 天，通配符证书也适用。
服务期限与单张证书有效期分别计算。 一年期证书服务可能需要在服务期内多次签发和部署证书，不能理解为单张证书有效 365 天。签发后以证书实际到期时间为准，提前安排续签、替换与验证。
如需通配符证书服务，可在独立售后群确认服务期限、证书覆盖的域名及续签部署安排。
温馨提示：
下载确认为Nginx场景的证书使用
3 将配置好的证书设置启用即可 #
续签得到的新证书也需要部署到对应站点并使 Nginx 配置生效，再检查实际访问返回的证书及到期时间；仅完成续费或签发不代表站点证书已经更新。
常见问题与说明 #
为什么不使用90天证书、自动续证书 #
一般比较老款收银台不受信90天的证书，另外支付宝部分回调服务器也同样不支持
自动续证书是续90天的证书，根据上述也同样不建议使用