报错排查手册

SSH 连接失败

现象:点「检测服务器环境」提示 SSH 连接失败 / 超时。

1. SSH 地址填的是公网 IP吗?(控制台里显示的那串数字,不是内网 IP)
2. SSH 密码是买服务器时设置的 root 密码吗?(不是宝塔密码、不是网站密码)
3. 安全组放行 22 端口了吗?见第 1 步。
4. 服务器处于「运行中」状态吗?重启服务器后再试。
5. 重装过系统吗?重装后 root 密码会重置为最新设置的密码。

提示「不是全新环境」

现象:检测提示已装宝塔 / 已有 Web 环境 / 已有网站目录。

1. 不放心:云控制台重装纯净系统,再重新检测(推荐);
2. 想继续:勾选风险确认后部署,工具会自动跳过已装组件,从缺失步骤开始。

提示域名已存在网站

现象:检测提示「已存在域名 XXX 的网站,无法在同一域名上重复安装」。

处理:换一个未使用过的域名,或换一台全新服务器部署。该服务器上已有同域名网站时,工具会直接阻止,不会覆盖你的旧站。

部署失败 / 卡住不动

1. 看页面显示的失败阶段和错误信息;
2. 点 「重试」:已完成步骤自动跳过,从失败处继续,放心点;
3. 反复在同一阶段失败:检查服务器配置是否过低(建议 2G 内存以上)、网络是否稳定;
4. 卡住超过 20 分钟:点「终止任务」,再重新创建任务或重试;
5. 还不行:重装纯净系统,从头部署一次。

网站打不开

1. 部署真的成功了吗?(还在进度条中就不算)
2. 安全组放行 80 / 443 了吗?
3. 国内服务器 + 域名:ICP 备案完成了吗?未备案会被拦截,见备案专题。
4. 域名刚解析?等几分钟到几小时生效,或先用 IP 访问排除域名问题。
5. 地址前带 http:// 试试(没装 SSL 时直接输域名可能跳转失败)。

宝塔面板打不开

1. 安全组放行 8888 了吗?
2. 地址要用结果页给的完整地址(含端口和安全入口路径);
3. 忘了安全入口:登录云厂商控制台 → 用 VNC 连接服务器 → 执行 bt 14 查看面板信息(或按宝塔官方指引找回)。

SSL 证书申请失败

SSL 失败不影响部署成功,只是网站暂时没有小锁。常见原因与处理:

1. 域名还没解析到服务器 → 等解析生效后再申请;
2. 国内服务器未备案 → 先备案(见备案专题);
3. 到宝塔面板「网站 → SSL」手动申请一次,步骤见第 5 步。

网站打开是 404 / 内页打不开

1. WordPress 后台「设置 → 固定链接」重新保存一次(伪静态);
2. 宝塔「网站 → 设置 → 伪静态」选择 WordPress 模板并保存;
3. 清空浏览器缓存后重试。

结果信息没保存,找不回了

结果只展示一次、24 小时后清理。补救:

• 宝塔面板密码:服务器上执行 bt 5 修改(宝塔官方有图文教程);
• WordPress 管理员密码:网站后台登录页点「忘记密码」,或宝塔数据库管理器里重置;
• 都不顺手:换台全新服务器重新部署,十几分钟的事。