发布之前最容易被省略的问题是:如果新版本不工作,怎样恢复?对于有数据库的个人博客,回滚不只是把上一份代码复制回来,还需要考虑构建文件、依赖、配置和数据结构的兼容关系。
回滚准备文章中的命令示例,保留可复制的正文代码。 本站截图,2026 年 10 月 11 日。
先知道正在运行什么
本站后端由 systemd 管理,便于重启、查看状态和读取日志。发布后进程显示 active,说明进程正在运行,不说明每个业务接口都成功。因此还需要访问本机接口和公开域名,验证请求是否走完整条链路。
服务日志适合检查启动错误和应用异常;浏览器网络面板适合检查资源加载和接口响应。两个位置看到的现象不同,可以互相补充,不能只看其中一个就宣布整个网站正常。
发布备份至少包含哪些东西
- 后端入口、变更文件和依赖描述。
- 前台与管理后台的构建产物及相关源码。
- 数据库备份,尤其是涉及结构迁移时。
- 需要修改的代理配置,以及变更说明。
本站的功能发布先建立对应备份目录,再替换文件和执行必要迁移。备份不应放进公开网站根目录,数据库内容也不应成为可直接下载的静态文件。
为什么不急着删除旧哈希资源
访客可能还开着旧页面,或者正在加载旧页面引用的文件。如果发布时立即清空所有旧脚本和样式,这些页面会突然出现资源404。保留旧哈希资源可以减少这种中断,再依据实际空间和版本策略整理。
这不意味着永久保存每个历史文件。关键是发布替换和资源清理不要被当成同一个动作,先保证新旧页面的过渡,再安排可控的清理。
数据库回滚要避免覆盖发布后的新内容
如果用户在发布后新增了文章或随记,直接恢复整份旧数据库会丢失这些记录。应先判断故障是否能通过兼容修复解决;确需恢复时,也要保存新数据并制定具体恢复步骤。
一份实用的发布记录应写清验证结果和已知限制。把“构建通过”“接口通过”“浏览器通过”分开写,会比一句“部署成功”更有助于下一次排查。
站点规模小并不意味着可以省略回滚准备。越是由一个人维护,越需要让恢复步骤不依赖当天的记忆。
发布前先生成独立备份目录
下面是说明检查方法或实现思路的示例。路径、参数和环境需要核对后再使用。
备份代码和资源 → 备份数据库 → 核对后再发布# 备份示例:需数据库备份权限和足够磁盘空间
set -euo pipefail
umask 077
backup_dir="/root/blog-backups/$(date +%Y%m%d-%H%M%S)"
mkdir -p "$backup_dir"
# 数据库名请替换;凭据放在受保护的客户端配置中
mysqldump --single-transaction --no-tablespaces blog \
> "$backup_dir/database.sql"
tar -czf "$backup_dir/public.tar.gz" -C /srv/blog/public .
tar -czf "$backup_dir/backend.tar.gz" -C /opt/blog/backend .
test -s "$backup_dir/database.sql"
# 恢复数据库会覆盖数据,应先确认恢复范围和停写安排
继续阅读