自动部署完整教程

需要准备什么

本教程适用于控制台提供“自动部署新服务器”的安装流程。实际可安装版本、最低 Agent 版本和适用环境，以控制台显示和对应版本说明为准。已有商城升级继续保留原账号、数据和装修；不要把新安装当成更新使用。

Windows、ARM、没有 systemd 的容器不在本流程支持范围。MySQL 5.6 不能用于本版商城的新建数据库。不要为部署直接升级已有业务数据库或清空原数据目录；遇到冲突，先核对并保留备份。

无需安装 Go 编译器，也无需在官网填写数据库管理密码。自动补齐环境有严格的路径、文件归属和已有服务检查，不能用修改路径或关闭验证绕过失败。实际支持范围以正式版本说明为准。

新客户按上述系统准备服务器、域名和可用的 root 密码登录后，即可从安装页面开始；无需提前手工安装宝塔、Nginx 或 MySQL。Ubuntu 24.04、CentOS 等未列出的空机系统不能按本教程直接套用，应先确认平台是否提供相应方案。已经承载其他业务的服务器须先核对原服务和备份，不要直接重装或格式化。

确认服务器资料

从云服务器控制台取得服务器公网 IP、SSH 端口和 root 密码，随后在安装页面填写。正常安装流程由系统连接和认证，不要求你先学会 SSH、执行数据库命令或安装编译工具。宝塔面板密码与服务器 root 密码不能混用。

先确认云服务器选择的是哪种登录方式。 腾讯云 Ubuntu 镜像的默认登录账号是 ubuntu，默认禁止 root 通过密码远程登录；仅设置或重置密码不一定会改变这项登录策略。请先按云厂商说明准备可用的 root 密码登录，再填写安装页面。云控制台能免密打开终端，不表示安装页面可以使用 root 密码连接。当前安装入口只接收 root 密码，尚不支持直接提交 SSH 私钥或通过 ubuntu + sudo 安装。腾讯云登录说明及Ubuntu 使用 root 登录说明。

如果创建服务器时选择了密钥登录，请先由云服务商或技术支持按该镜像的官方说明准备可用的 root 密码登录，再填写安装页面。仅重置密码，不一定会开启 SSH 的密码认证；两项都应核对。云控制台显示的密钥对编号和以 ssh-rsa … 等格式显示的公钥，都不能填入“root 密码”。创建密钥时下载的私钥文件用于密钥登录，应留在自己的安全目录，不把正文发到聊天、截图或工单。腾讯云密钥说明

看到“SSH 认证失败”时，按以下顺序处理：

1. 确认填写的是当前服务器公网 IP 和实际 SSH 端口。
2. 确认账号确实为 root，密码是该账号的服务器密码。
3. 若前两项正确，请核对云镜像是否启用了 root 密码认证，是否仅允许密钥登录。完成核对后沿原安装任务处理，保留原任务编号。

只有页面提示认证失败、需要进一步排查时，才在技术支持协助下核对密码登录。熟悉终端的用户可在自己的电脑执行以下命令，替换示例 IP 和实际端口：

ssh -o PubkeyAuthentication=no -o PreferredAuthentications=password root@服务器公网IP -p 22

使用上述排查命令输入密码时，终端不显示字符，这是正常现象。Permission denied 表示认证被拒绝；通过云控制台核对或重置服务器 root 密码，再按原任务的处理提示继续。宝塔面板能登录、云控制台免密终端能打开、部署进度到了 5%，都不能证明密码认证成功。不要把密码发到聊天、截图或工单。

安装前放行端口

先进入准备安装商城的那台云服务器，核对公网 IP，再添加以下规则。下表中的方向均相对于这台商城服务器；“入站”是外部访问它，“出站”是它访问外部服务。网站规则的协议选择 TCP，策略选择 允许。

商城数据库使用本机连接，不需要向公网开放 MySQL 3306。Agent 主动连接平台，普通客户不需要额外开放一个“Agent 入站端口”。不要选择“所有协议、全部端口”来代替上述规则。

如果 SSH 改成了其他端口，云端规则、服务器实际监听和安装页面都应填写同一个端口；只放行 22 不会让另一个 SSH 端口连通。已有 SSH 规则先保留，确认新规则可连接后再调整。

腾讯云轻量应用服务器操作： 登录云控制台，进入对应实例详情 →“防火墙”→“添加规则”。网站两条规则可分别填写“自定义 / 来源 0.0.0.0/0 / TCP / 端口 80 或 443 / 允许”，备注填写“商城 HTTP”与“商城 HTTPS”，然后保存。SSH 和宝塔按上表分别填写实际端口、允许的来源 IP。默认镜像规则不一定包含 443，应检查规则列表。腾讯云轻量防火墙说明

腾讯云云服务器 CVM 操作： 找到当前实例实际绑定的安全组，进入“修改规则”→“入站规则”→“添加规则”，按上表填写来源、协议端口和允许策略。若该安全组限制出站，再核对“出站规则”。确认操作的是这台实例绑定的安全组，并检查是否存在优先级更高的拒绝规则。腾讯云安全组说明

云端防火墙与服务器系统防火墙是两层设置。只在宝塔“安全”中开放端口，不能替代云控制台的放行；云控制台已放行时，仍要检查系统启用的 UFW/firewalld/iptables 规则。请按同一张端口表核对，不需要为了安装关闭全部防火墙。安装流程不会替你修改云厂商账号内的规则。

保存后怎样确认： SSH 由安装任务实际完成连接和认证；部署到网站服务、证书就绪阶段后，用自己电脑浏览器访问 http://你的商城域名/ 和 https://你的商城域名/，确认 HTTP 能转到 HTTPS、HTTPS 没有证书错误且前后台可打开。空机尚未安装网站服务时，浏览器打不开不能单独证明规则错误；“服务器内部健康检查成功”也不能代替公网验证。失败时保留域名、实际端口、任务编号和时间，由支持人员区分 DNS、端口、服务监听和证书问题。

使用 IPv6 时，还需核对实际地址、AAAA 解析和对应 IPv6 防火墙规则；是否支持该安装环境以正式版本说明为准。

提交新商城部署

1. 登录官网客户控制台，进入“交易与交付 → 安装任务”。
2. 选择本次系统授权，填写商城域名；同一域名的全部 A/AAAA 记录应正确，并按上节在云端与系统防火墙放行实际 SSH 端口和 TCP 80、443，确保源站能直接接受证书验证。
3. 在“自动部署新服务器”填写公网 IP、SSH 端口、root 密码、网站名称和 SSH 资料保留时间。密码输入范围为 6～256 个字符；通过格式校验不表示服务器已接受密码。
4. 勾选授权执行固定部署流程，点击“开始自动部署”。提交后可关闭页面，重新打开原任务查看。
5. 如果请求结果不明，页面按原请求编号核对结果；不要连续创建新任务。

已经接入且 Agent 在线的服务器，使用同页“在已有服务器上安装”，沿用原服务器记录。若 Agent 版本低于安装包要求，先完成受信任的 Agent 升级。没有商城的服务器需要按平台提供的签名升级步骤处理，不能靠反复点击安装解决版本不足。

SSH 凭据加密保存，用于固定部署流程及本人主动发起的宝塔资料只读补领。可以选择页面提供的 1 天或 3 天保留时间，并主动删除；删除凭据不会卸载已经接入的 Agent，也不会删除商城。服务器接入、安装实例和域名额度分别计算。

平台自动生成的宝塔初始资料会单独加密交付，供服务器所有者领取；它不随安装用 SSH 凭据的 1 天或 3 天保留时间失效。普通部署列表、任务过程和通知不会显示宝塔密码。

跟随原任务完成交付

任务会依次检查服务器环境、安装缺少的受支持组件、验证 Agent、检查域名并申请 HTTPS 证书、安装商城和套餐插件，再等待所有者设置管理员并核验交付。环境安装可能需要较长时间，可关闭页面后返回原任务查看；不要同时在宝塔或终端安装同一组件。

不能只看进度条判断成功。显示失败时，应保留任务编号、错误码和时间。只在页面明确提供且原因已修复时使用原任务的重试入口。

系统依赖准备因软件源或网络问题失败时，恢复网络后可在原任务点击“重新尝试”。系统会先核对已安装的软件和此前执行状态；无法确认安全继续时会停下来提示人工核对。不要自行删除安装记录、软件包锁或另建重复任务。

证书申请提示“达到签发限额”时，按提示的恢复时间等待后重试；标注 UTC 的时间换算为北京时间需加 8 小时。保留已有证书，不要反复重装服务器或删除证书。如果提示域名验证失败，核对全部 A/AAAA 解析和公网 TCP 80，修正后回原任务重试。

设置首位商城管理员

“等待设置管理员”阶段，从官网当前授权账户打开一次性初始化入口，在自己的商城填写管理员账号、名称和密码。链接有时效，必须与当前实例和原请求相符；未经授权的访客不能直接抢先初始化。

平台没有通用默认管理员密码，也不会保存你填写的商城管理员明文密码。提交结果不明时，先核对原请求；重复提交同一请求不会再创建一个管理员。已经运营的商城更新后继续使用原账号。

若显示“管理员已创建、结果待核对”，请保留原初始化页面并使用其结果核对功能。不要换账号、换请求编号或重新安装；控制中心超时不等于管理员没有创建。只有原结果确认提交完成、部署状态达到“已完成 / 可运营”，才视为交付完成。入口到期或持续核对失败时，保留任务编号与时间交支持处理。

完成后，官网“我的商城”提供前台和后台入口。通常前台为 https://你的域名/，后台为 https://你的域名/admin/；修改过后台入口的，以商城当前配置为准。

开始运营与日常维护

领取自己的宝塔资料

1. 登录官网原部署账户，进入“交易与交付 → 安装任务”，在对应部署记录中点击“领取宝塔资料”。安装仍在准备环境时，请等待该任务推进后再领取。
2. 输入官网当前登录密码验证本人身份；这里不是商城后台密码，也不是服务器 root 密码。
3. 领取窗口显示完整的宝塔登录地址（包含实际端口和安全入口）、宝塔账号、初始密码及面板 TCP 端口。密码默认隐藏，可显示或分别复制。妥善保存后关闭窗口；窗口会在 3 分钟后、关闭或切换页面时清除资料。
4. 将完整登录地址粘贴到浏览器。如果无法访问，在云厂商防火墙或安全组放行页面显示的实际宝塔 TCP 端口，来源建议仅允许自己的管理 IP。不要把 SSH 端口或商城 80 / 443 当作宝塔端口，也不要按固定的 8888 猜测。系统防火墙若有入站限制，也须允许同一实际端口。
5. 自动安装的宝塔可能使用独立的自签名 HTTPS 证书。浏览器提示证书不受信任时，先核对服务器 IP 和领取资料中的证书 SHA-256 指纹；指纹不一致时停止登录并核对，不关闭浏览器或下载工具的证书校验。商城域名的 HTTPS 证书与宝塔面板证书相互独立。
6. 首次进入宝塔后，由你本人确认宝塔用户协议、按需绑定宝塔账号，并修改初始密码。你的服务器、宝塔和网站维护权限保持由你掌握。

领取的是安装时的初始资料。 如果你后来在宝塔里修改了账号、密码、安全入口或端口，请使用修改后的资料；官网不会自动同步这些修改，也不会覆盖或重置你的宝塔设置。证书更换后，原交付资料中的指纹也不代表新证书。

较早安装的任务可能尚未交付资料。点击领取会先尝试使用尚在保留期内的 SSH 凭据只读补领；若已过期或被删除，按窗口提示重新填写官网登录密码和服务器 root 密码。此次 root 密码只用于读取，不保存，不会重新安装或修改服务器。领取成功后，宝塔初始资料单独加密保存，之后领取不再依赖该 root 密码。

如果宝塔原本由你自行安装，或初始资料文件已被删除，平台无法找回其现有密码。继续使用自己的原宝塔账号；忘记时可进入云厂商服务器控制台，用服务器上的 bt 管理工具查看面板入口或按需自行重置。不要为获取密码重新安装商城。官网只向已验证的服务器所属账户交付资料；其他客户和平台后台角色均没有这个领取入口。

配置业务与保留备份

部署交付成功后，仍需配置商品、支付渠道、通知和业务规则，分别验证实际支付与交付。插件“已安装”不等于第三方服务或自动收款已经配置完成。

第一次开店按以下顺序核对。表中的名称对应商城现有后台入口；它是一份操作清单，不代表系统已自动替你开通支付商户或完成这些业务验收。

服务器和程序安装可以自动完成；支付、短信、邮件、上游货源等第三方账户仍须由商家本人申请并配置。平台不能自动生成这些账户的资质和密钥。没有完成收款与交付核对时，先完成业务配置，不要把“部署已完成”理解为所有经营条件都已就绪。

保留独立数据库与文件备份，确认域名证书持续续签。授权到期后，新业务及后台运营操作停止；续费并取得新的有效运行许可后恢复。已付款订单的必要结算按原有规则处理。

其他问题见自动部署错误原因与处理及安装交付与商城更新说明。