​
部署方式

当前项目常见方式是 Node 服务部署：
  1. 服务器安装 Node.js 与依赖
  2. 执行构建
  3. 使用 systemd 常驻运行
  4. 通过 Nginx 反向代理

​
标准部署步骤

1

拉取代码并安装依赖

执行 npm install。
2

配置生产环境变量

至少包含 DATABASE_URL、ADMIN_PASSWORD、ADMIN_SESSION_TTL_HOURS。
3

执行数据库迁移

生产环境使用 prisma migrate deploy，不要使用 prisma migrate dev。
4

构建与启动

执行 npm run build 和 npm run start，再接入进程守护。
5

接入 Nginx 与 HTTPS

配置 proxy_pass 指向 127.0.0.1:3000，并配置证书。

​
数据库迁移要点

  • 初始化开发环境可以用 npm run db:migrate
  • 生产部署请使用：
npx prisma generate
npx prisma migrate deploy

​
部署后验证清单

  • / 是否可访问
  • /blog、/reading、/travel、/projects 是否正常
  • /admin/login 是否可登录
  • 同步接口是否可用（登录后触发）

​
回滚建议

最小回滚策略：
  1. 保留数据库备份
  2. 保留旧容器或旧版本服务
  3. 新版本异常时快速切回旧版本

​
常见线上问题

​
数据库连接失败

检查 DATABASE_URL、端口映射、数据库用户密码。

​
后台无法登录

检查 ADMIN_PASSWORD 是否注入到运行环境。

​
页面有内容但后台无数据

可能命中了文件回退读取。请确认数据库可用并执行过 content:sync。