4.3 故障恢复与面板自救

一句话判断：面板真正考验的不是“平时多好用”，而是“出事时你一个人在深夜的 SSH 终端里能不能救得回来”——两本“自救手册”的厚度，宝塔略胜一筹。

“自救能力”是怎么论的

面板打不开，是所有面板用户迟早会遇到的事。原因可能有一万种：磁盘满了、端口被防火墙封了、面板升级失败、SSL 配置出错、安全入口忘了、数据库崩了……

判断自救能力看三件事：

  1. 有没有命令行工具——Web 进不去时，SSH 是唯一的通道。
  2. 文档写没写清楚——凌晨三点没人问，文档就是你的队友。
  3. 有没有可恢复的备份——数据坏了，有备份和没备份是两个故事。

宝塔的两件自救工具：bt 命令与面板备份

bt 命令：一个菜单解决大部分问题

宝塔自带 bt 命令，输入 bt 回车就是一个交互式菜单。官方 FAQ 里点名提到了几个最常用的编号：

命令 作用 使用场景
bt 14 查看面板默认信息（地址、用户名、密码等） 装完面板忘了账号密码
bt 5 修改面板密码 升级后登录不上、怀疑密码被改
bt 16 修复面板 面板异常、打不开、升级失败
bt 18 开启/关闭面板备份 数据保障相关的开关
bt restart 重启面板 常规的“重启试试”

另外还有一条独立命令：

# 查看面板入口（安全入口地址）和账号密码
/etc/init.d/bt default

官方 FAQ 明确记载了它的用途：当你登录面板提示“请使用正确的入口登录”或 404 时，用这条命令查看随机生成的 8 位安全入口；实在找不到也可以删除 /www/server/panel/data/admin_path.pl 关闭安全入口（官方同时警告：这会让面板地址直接暴露在公网，不推荐）。

面板备份：SQLite 坏了也能恢复

这是宝塔文档里相当有含量的一页。前面 4.1 节提过：面板的网站/数据库列表存在 /www/server/panel/data/db 下的 site.db 和 database.db 两个 SQLite 文件。官方 FAQ 给出了完整的恢复流程：

# 1. 进入面板备份目录，找到最新备份
cd /www/backup/panel
ls

# 2. 解压某天的备份（日期以实际为准）
unzip ./2026-03-24.zip

# 3. 用备份里的 db 文件覆盖损坏的文件
cp -f ./2026-03-24/data/db/site.db /www/server/panel/data/db/
cp -f ./2026-03-24/data/db/database.db /www/server/panel/data/db/

# 4. 重启面板
bt restart

如果没有备份、站点又少，官方还给了兜底方案：在面板里重新创建网站（填原域名、选原目录，把信息写回数据库），再用“同步数据库”功能从服务器捞回现有数据库信息。

官方文档自己都忍不住多说了一句：“不建议关闭面板备份。网站列表、数据库列表等显示数据均依赖 db 文件，一旦数据丢失，只能通过备份文件恢复。”——这是一个被用户疼过之后写出来的忠告。

甚至“连不上官网”都有专门排查指南

宝塔官方 FAQ 里还有一篇《面板无法连接官网问题排查》，覆盖了：服务器网络不通、DNS 解析失败（给了改 /etc/resolv.conf 的具体命令）、/etc/hosts 错误绑定、代理配置干扰、面板离线模式。这类问题的典型症状是软件商店加载失败、插件装不上——虽然不影响已有网站，但很影响心情。

1Panel 的自救工具：1pctl

1Panel 的对应物是内置命令行工具 1pctl。官方命令清单如下：

./1pctl [COMMAND] [ARGS...]

Commands:
  status [core|agent]         检查 1Panel 服务状态
  start [core|agent|all]      启动 1Panel 服务
  stop [core|agent|all]       停止 1Panel 服务
  restart [core|agent|all]    重启 1Panel 服务
  uninstall                   卸载 1Panel 服务
  user-info                   获取 1Panel 用户信息
  listen-ip                   切换 1Panel 监听 IP
  version                     查看 1Panel 版本信息
  update                      修改 1Panel 系统信息
  reset                       重置 1Panel 系统信息
  restore                     恢复 1Panel 服务及数据

其中最值得展开的是 1pctl reset，它是一组“自救开关”：

子命令 作用
1pctl reset domain 取消访问域名绑定
1pctl reset entrance 取消安全入口
1pctl reset https 取消 HTTPS 登录方式
1pctl reset ips 取消授权 IP 限制
1pctl reset mfa 取消两步验证

另外一个很贴合实战的设计是 1pctl update username/password/port——改面板账号密码和端口不需要进面板，这在“面板能进去但怀疑被入侵”或“想紧急换端口”的时候直接救命。

对照着看，两边的自救命令覆盖范围惊人地一致：

自救场景 宝塔 1Panel
查看面板状态 bt 菜单 / bt 14 1pctl status / 1pctl user-info
重启面板 bt restart 1pctl restart
改密码 bt 5 1pctl update password
忘了安全入口 /etc/init.d/bt default 1pctl reset entrance
登录被 IP 限制挡住 （需查设置） 1pctl reset ips
两步验证被困住 （文档未直接覆盖） 1pctl reset mfa
面板修复 bt 16（官方修复命令） 重新安装/1pctl restore
面板数据恢复 面板备份 + SQLite 覆盖（官方详细教程） 1pctl restore

日志位置与排查路径

自救时另一件事是“看日志”。两边的关键日志位置：

排查对象 宝塔 1Panel
面板自身日志 /www/server/panel 下的日志目录 面板内“日志审计”模块（社区版即有，官方版本对比表所列）
网站访问/错误日志 /www/wwwlogs（官方手册建议排查磁盘问题时重点看这里） OpenResty 容器日志，面板内网站详情可查
面板登录记录 安全概览中直接查看（SSH 登录 + 面板登录两套） 日志审计模块
系统级排查 df -i、/var/log 等通用路径 相同，另可看容器概览页的 Docker 状态

一个细节差异：宝塔的日志排查路径更“文件化”（直接告诉你去哪个目录），1Panel 的更“面板化”（尽量在界面里给你看）。两种思路各有适合的人——老运维喜欢直接 tail 文件，新用户喜欢界面里点一下。

谁的“自救手册”更全

公允地总结：

维度 宝塔 1Panel
命令行工具 bt 交互菜单 + /etc/init.d/bt，上手零门槛 1pctl，结构更清晰、参数化更强
重置类操作 改密码、修复、查入口 密码/端口/域名/入口/IP/MFA 六类重置，粒度更细
官方故障文档 厚：FAQ 覆盖登录失败、列表不显示、连不上官网、inode 满等具体场景 较精：FAQ 覆盖安装与功能类问题，实战排障更多依赖社区
数据恢复 官方给了 SQLite 备份恢复的完整步骤 1pctl restore + 快照机制

结论是分场景的：论“一键修复”的傻瓜程度和官方故障文档的覆盖面，宝塔胜在十几年的用户踩坑沉淀；论命令设计本身，1pctl 的参数化（restart [core|agent|all]、六类 reset）更现代化、更适合写进自动化脚本。

两边的手册都值得读一遍，而不是出事才翻：《宝塔面板常见问题与技巧大全》汇总了实战排障经验，1Panel 侧可看《1Panel 官方文档：技能、API 与常见问题》。

本节要点

  • 面板自救能力 = 命令行工具 + 官障文档 + 可恢复备份。
  • 宝塔：bt 5 改密码、bt 16 修复面板、bt 18 管理面板备份，配合 /www/backup/panel 的 SQLite 备份可以完整恢复列表数据。
  • 1Panel：1pctl status/restart/restore 管服务生命周期，1pctl reset 六个开关专门处理“把自己锁在门外”的各种姿势。
  • 两家都给了 SSH 兜底通道；宝塔的官方故障文档更厚，1Panel 的命令设计更适合脚本化。

下一步：现在（对，就是现在）打开你服务器的 SSH，执行一次 bt 14 或 1pctl user-info，把面板信息记到密码管理器里。等真出事那天，你会感谢现在的自己。