自动部署完整教程

适用对象与完成目标

本文适合已经取得系统授权、准备在一台新服务器上安装商城的用户。无需自行上传商城程序或填写数据库密码，但需要先准备服务器、宝塔环境和域名解析。

完成后，你应当能通过自己的域名打开商城、创建首位商城管理员，并在官网控制台看到系统及所需插件的安装结果。

先分清三个入口：

自动部署记录达到 100% 不代表商城已经安装成功。 还要看记录状态、安装实例中的系统任务和插件任务。失败记录也可能显示 100%。

开始前准备

当前自动建库流程不适用于 MySQL 5.6。新服务器可优先准备宝塔 MySQL 8.0，并确认与所选商城安装包的数据库要求一致；已有数据库不要为了部署直接原地升级。仅仅有一个可连接的远程数据库，也不能替代本流程要求的宝塔本机 MySQL 环境。

Windows、ARM、Apache、没有 systemd 的精简容器，不属于本教程的自动部署环境。不要看到“64 位”就默认符合要求，还需要确认是 x86_64/amd64。

域名是否需要备案，按服务器所在地和接入商要求办理。磁盘容量应容纳商城、数据库、上传文件及备份，不能把 Agent 检查的 100 MB 当成整个商城的容量要求。

第一步：确认授权和服务器环境

1. 登录官网客户控制台，进入“授权管理 → 系统授权”。确认安装的是正确授权，并核对期限、域名额度和安装实例额度。官网购买或后台人工开通的授权，都应先在这里确认。
2. 打开云服务商的服务器详情，记录真实公网 IP 和 SSH 端口。不要复制内网 IP、宝塔网址，或把 IP 和端口填在同一格。
3. 登录宝塔，进入“软件商店”，确认 Nginx 和 MySQL 均为运行状态。不要为同一个安装域名另建一个空网站，自动部署会生成商城站点配置；已存在同名网站时应先由管理员核对用途。
4. 确认宝塔数据库管理可用。自动部署会为商城实例创建数据库和专用账户，不需要你把数据库 root 密码填入官网表单。
5. 确认 root SSH 密码可用。官网密码框要求 8 至 256 个字符；这是服务器登录密码，与宝塔、官网账户、数据库密码不同。

主站域名额度、分站额度和安装实例额度各自独立。“域名无限”不表示可以无限创建安装实例。

插件以这份授权实际记录的权益和安装任务为准，可能来自套餐包含、额外购买或管理员授予。不要仅凭“基础、专业、旗舰”的名称猜测插件数量，也不要把“已授权”当成“已安装”。

第二步：放行网络并设置域名解析

在云安全组以及服务器防火墙中，核对以下规则：

SSH 建议按部署服务出口地址和你的管理地址放行。已有严格白名单时，先向支持确认部署来源，不需要关闭整台服务器的防火墙。宝塔面板和数据库端口不需要因此向全网开放。

在域名服务商的 DNS 管理中，以 shop.example.com 为说明：

1. 使用 IPv4 时添加 A 记录，主机记录填 shop，记录值填你服务器的真实公网 IPv4。
2. 使用 IPv6 时添加对应的 AAAA 记录，并确认服务器的 IPv6 网站访问也可用。
3. 核对该主机名下的全部 A/AAAA 记录，避免一部分仍指向旧服务器。第一次部署建议暂停 CDN 代理，让解析直接指向源站。
4. 等待解析生效，再提交部署。shop.example.com 只是文档示例，必须换成你自己的域名。

在 Windows 电脑上，可用下面的只读命令辅助检查；运行前替换示例域名：

nslookup shop.example.com

平台会从自己的网络检查 DNS，因此你电脑上刚查到新地址，不代表各处都已生效。DNS 结果中包含目标 IP 只是部署检查的一项条件，错误的其他解析记录仍可能影响访问和证书申请。

第三步：提交自动部署

打开官网客户控制台“交易与交付 → 安装任务”，找到“自动部署新服务器”。

确认域名解析正确、自己有服务器管理权限后，勾选授权确认，点击“开始自动部署”。提交成功后可以关闭页面，后台会继续处理。

同一账户最多接入 10 台未撤销的服务器，最多同时处理 2 个自动部署任务。同一账户已接入的同一个 IP，应使用原服务器记录，不要重复提交。

SSH 资料加密保存，到期后由后台清理，也可主动删除。密码只填写在可信官网的 HTTPS 表单中，不要放进网站名称、备注、聊天或工单。

第四步：分别查看接入与安装结果

在同一页的“自动部署记录”点击“查看过程”，观察服务器连接、Agent 接入、域名检查和安装任务创建。

Agent 是常驻在服务器上的部署程序。接入成功后，它通过自己的令牌领取任务，不再依赖平台保存的 SSH 密码。

插件任务需等待系统安装任务成功后才会领取。实例显示“正常”也不代表每个插件都成功，必须逐项检查。

自动部署中的部分临时故障，每轮最多执行 3 次，包含第一次执行。修复配置后，失败的自动部署记录可用“重新尝试”；首次系统安装失败的实例可用“重试安装”。这两个按钮处理的是不同阶段。

第五步：创建商城管理员并验收

1. 用浏览器访问 https://你的商城域名/。确认是自己的商城页面，证书有效，没有安全警告。
2. 访问同一域名下的 /admin/。全新商城会显示“创建超级管理员”。请及时完成，完成前不要开始对外营业。
3. 设置管理员账号、名称和密码。账号为 3 至 32 位小写字母、数字或下划线；名称至少 2 个字符；密码为 10 至 72 位并同时含字母和数字。不要与服务器 root 密码共用。
4. 点击“创建并继续”，再用刚创建的账号登录商城后台。官网账户不会自动成为商城管理员。如果本应全新的商城已经出现登录页，先核对域名和部署记录，不要反复重装或索要“默认密码”。
5. 回官网“安装任务”，检查系统任务及所需插件任务均成功；再在自己的商城后台“插件中心”核对实际插件状态。

满足以下条件，才可视为本次部署完成：

• 官网“服务器”显示就绪且在线。
• “授权域名”显示本次域名已绑定。
• 系统安装任务成功，所需插件各自成功。
• 公网 HTTPS 首页能打开，商城管理员能正常登录。
• 没有待处理的失败或人工介入提示。

首页能打开仅证明基础访问正常。支付、通知、商品和业务参数仍需在商城后台按对应功能文档配置，并另行验证。

第六步：收尾与日常维护

部署完成后，可在自动部署记录点击“删除 SSH 资料”。它只删除平台保存的 SSH 凭据，不会卸载 Agent、删除商城，也不会取消已创建的安装任务。之后按自己的安全要求管理或轮换 root 密码。

建立独立的数据库和文件备份，并安排证书到期监测。首次安装和后续系统更新会检查证书、在需要时通过宝塔申请，但这不等于 Agent 提供持续的定时续签保证。长期不更新的站点也要由管理员确认续签机制正常。

“服务器 → 撤销”会让该服务器的接入令牌失效，影响后续管理。它不是清除 SSH 资料的替代按钮，也不是释放安装实例额度的快捷方式。

不提供 SSH 密码时：命令接入

此方式适合尚未接入的新服务器，且你能通过自己的 SSH 客户端或宝塔终端取得 root 权限。Linux、宝塔 Nginx、MySQL 等准备要求不变。

1. 在官网“交易与交付 → 服务器”填写名称，点击“生成备用命令”。
2. 复制页面给出的整条命令，在目标服务器的 root 终端执行。命令只显示一次，并有有效期；不要截图分享，它含有一次性接入令牌。
3. 等待官网服务器记录显示就绪且在线。执行命令只完成 Agent 接入，不会直接完成商城安装。
4. 到官网“授权管理 → 授权域名”，选中授权，使用“绑定域名”添加准备好的域名。
5. 回“安装任务 → 在已有服务器上安装”，选择授权、在线服务器和已绑定域名，点击“创建安装实例”。
6. 按前面的任务检查和管理员创建步骤完成验收。

已经存在失败接入记录、令牌过期或服务器提示已接入时，先请支持核对原记录。不要通过不断生成新命令、删除 Token 或撤销正在运行的服务器来碰运气。

常见失败先看这里

详细处理见自动部署错误原因与处理。商城上线后的程序升级问题见商城更新失败排查。

技术说明：供服务器管理员核对

• 固定接入脚本检查宝塔 Nginx 路径、MySQL 客户端、mysqldump、/tmp/mysql.sock、宝塔 Python 及 www 用户。自定义目录或精简环境可能无法直接使用。
• 当前自动建库使用 CREATE USER IF NOT EXISTS 和 ALTER USER，不能把商城其他环节的 MySQL 5.6 兼容测试当成自动建库支持证明。
• 新的分版本安装包使用 format: 2 和 layout: versioned。平台负责下发安装包、实例身份和运行配置；用户不需要手工导入 SQL 或编辑环境文件。商城启动还会应用自身内嵌的未执行迁移。
• 系统激活时检查或申请证书、校验 Nginx、启动服务，并做本机 HTTPS 及 Socket 健康检查。本机检查通过仍不能代替外网访问验收。
• 首次安装失败可能撤销本次服务和链接，但没有“恢复到安装前完整数据库”的保证；后续更新有另一套备份和回滚流程。二者均不能替代独立备份。

需要协助时，提供任务编号、失败时间、错误码、域名和脱敏日志即可。不要提供 root 密码、Agent Token、接入命令、数据库连接串、证书私钥或完整环境文件。