重建会在您现有的服务器上从头重新安装操作系统,这会彻底清空磁盘,并为您提供一台使用相同 IP 地址的全新机器。
它适合少数几种任务,而对其他任何情况都是非常糟糕的工具。本指南介绍重建何时才是真正的解决办法、它会破坏什么、一个常常让人措手不及的特定后果,以及在点击之前如何做好充分准备。
何时适合重建
在以下情况下进行重建:
- 您想更换操作系统,例如从 Ubuntu 换成 Debian,或从一个 Ubuntu 版本换成另一个版本。
- 操作系统无法启动,或损坏严重到修复它比重新开始还要耗时。
- 您要把服务器改作完全不同的用途,不想保留任何旧配置。
- 您确实希望磁盘上的所有内容都消失。
不要为了撤销刚做的更改而重建。那是 快照 的用途,回滚更快,而且能保留您的数据。也不要为了释放磁盘空间、修复运行缓慢的应用程序,或因为某些配置错误而重建:这些都不需要更换操作系统。
重建前请阅读
重建会永久销毁服务器上的所有内容:每个网站、邮箱、数据库、上传的文件、已安装的软件包、证书、cron 任务和配置文件。它无法撤销,而且在最后一步之后没有任何确认步骤。确认对话框写得很清楚:"这将重新安装操作系统,并永久销毁服务器上的所有内容。此操作无法撤销。"
重建会清除服务器首次开通时安装在磁盘上的 KapsuleHost 工具,而面板正是通过这些工具进入机器进行操作的。我们会自动为您重新安装,并进行检查。 您现有的备份数据单独保存在加密的异地存储中,不会受到重建的影响。
在此期间,恢复、立即备份、实时防火墙与补丁应用以及浏览器控制台都无法使用,因为它们都依赖磁盘上的工具。通常需要几分钟。整个过程中服务器会一直标记为重建中:在从机器上逐一读回并确认所有这些组件都存在之前,它不会显示为就绪,因此面板绝不会向您显示一台它实际上无法管理的绿色服务器。
如果我们无法恢复,会通知您。 服务器会停留在重建中而不会变绿,同时我们的运维团队会收到告警。您无需自行检查。
您的 IPv4 和 IPv6 地址不会改变。改变的只有磁盘上的内容。
准备重建
开始之前请逐项完成此清单。如果服务器上有任何您在意的内容,其中每一项都不是可选的。
- 创建快照。 快照是磁盘的完整副本。它是您改变主意后找回当前机器的唯一途径。请参阅 云服务器快照。
- 导出您想继续使用的任何内容。 将数据库、上传的文件和配置复制到服务器之外的地方:您自己的电脑、另一台服务器或对象存储。现有的备份在重建后依然存在,重建完成后面板可以从中恢复,但您自己保存的副本是恢复可用网站更快的途径。
- 记下已安装的内容。 重建之后,您需要手动重新搭建整个技术栈。一份软件包、服务、虚拟主机和 cron 任务的清单可以节省数小时。
- 检查您的 DNS。 如果有任何内容指向这台服务器,在重建和重新部署期间,它指向的将是一台空机器。
- 确认您能重新登录。 现在就决定如何连接到新安装的操作系统,并参阅 使用 SSH 连接到您的云服务器。
在重建完成到工具恢复之间的几分钟内,浏览器控制台不可用,因此不要把它当作唯一的访问方式。请准备好 SSH。
如何重建
- 登录 KPanel。
- 点击左侧边栏中的 云服务器,然后点击该服务器。
- 点击页面顶部操作按钮中的 重建 OS。
- 重建 OS 对话框会打开,显示 "此服务器上的所有数据将丢失。选择要安装的 OS:" 以及一个下拉菜单。
- 选择您想要的操作系统:
- Ubuntu 24.04 LTS,当前的长期支持版本。
- Ubuntu 22.04 LTS,上一个长期支持版本。
- Debian 12 (Bookworm),占用资源少的稳定版 Debian。
- 点击 重建服务器。
- 会出现最后一次确认,标题为 "重建" 和您的服务器名称。阅读后点击 重建服务器。

只有当服务器处于 运行中 或 已关机 状态时,才能使用 重建 OS。仍在开通中或已在重建中的服务器无法重建。
接下来会发生什么
- 服务器状态变为 重建中,并出现一个横幅:"重建进行中:页面将自动更新。"
- 磁盘上的所有内容都会被清除,所选的操作系统镜像会写入其中。
- 服务器重启进入新安装的系统。
- 页面会自动刷新,状态恢复为 运行中。
在此期间服务器处于离线状态。重建通常很快,但请把它视为一次停机而不是后台任务,并选在用户不会察觉的时间进行。
重建之后
现在您只有一个空白的操作系统。之前安装的任何东西都不存在了。
- 连接到服务器并确认可以获得 shell。请参阅 使用 SSH 连接到您的云服务器。
- 重新应用防火墙规则。重建删除了旧规则。请参阅 云服务器防火墙和安全管理。
- 重新安装您的技术栈:Web 服务器、运行时、数据库以及所有应用依赖。
- 恢复您自己导出的数据。
- 重新签发 SSL 证书。之前的证书在被清除的磁盘上。
不要以为每日备份会自动重新接管服务器。如果服务器端的备份工具被重建删除了,备份不会自行恢复。重建后请查看 备份 卡片,如果它显示未配置备份,请联系我们。请参阅 云服务器备份。
值得先考虑的替代方案
| 您想要的 | 比重建更好的工具 |
|---|---|
| 撤销刚做的更改 | 回滚 快照 |
| 找回已删除的文件或损坏的数据库 | 从 备份 恢复 |
| 更多 CPU、内存或磁盘 | 调整服务器规格 |
| 不同的处理器系列或区域 | 订购新服务器;请参阅 在 ARM、Standard 和 Dedicated vCPU 之间选择 |
| 一个干净的测试环境 | 另外开通一台小服务器,保持这一台不变 |
故障排除
重建 OS 按钮显示为灰色。 服务器当前的状态不允许重建。请等待开通或正在进行的重建完成。
状态一直停留在重建中。 页面每隔几秒轮询一次并自动更新。如果十五分钟后仍未变化,请附上服务器名称联系支持团队。
重建后我无法连接。 您连接的是一个带有新主机密钥的全新操作系统,因此 SSH 客户端会拒绝旧的指纹。请删除该 IP 地址对应的过期主机密钥条目,然后重新连接。如果是身份验证本身失败,请联系我们。
我误操作了重建。 如果您事先创建了快照,请回滚。如果没有,数据就已经丢失了。这正是确认文字如此措辞的原因。
如果您不确定是否真的需要重建,请在开始之前发送邮件至 support@kapsulehost.com,说明您想达到的目的。重建是平台上为数不多无法挽回的操作之一。