server-ops/CHANGELOG.md

CHANGELOG - 服务器运维日志

v1.0.0 (2026-06-14)

Added

• 初始化仓库：README、CHANGELOG、DECISION_LOG
• 每日运维总结机制确立
• 首份总结：2026-06-14 服务器功能变动总结

v1.1.0 (2026-06-15)

Added

• — Cookie session auth proxy 完整源码和 systemd 服务文件
• — Python HTTPServer，bcrypt 密码验证，HMAC-SHA256 token 签名
• — systemd 服务，port 9002，开机自启

Changed

• 安全认证升级：Caddy basicauth → auth_proxy Cookie session
  • 所有保护服务（gitea/dashboard/books/nav/brief/todo）改为走 auth_proxy:9002
  • 新增 auth.xybkwd.top 子域作为登录入口
  • Session cookie: 7天过期，HttpOnly，SameSite=Lax，Domain=.xybkwd.top
  • 密码验证不变（bcrypt），token 签名防篡改（HMAC-SHA256）
• — 去掉所有 basicauth，改为 reverse_proxy localhost:9002
• 服务清单更新：books (Calibre-Web) 状态同步

Fixed

• 移动端重复登录问题：basicauth 每 ~1 小时要求重新输入密码
• Cookie 跨子域失效：缺 Domain=.xybkwd.top 导致各子域不共享 cookie
• Set-Cookie 值带多余引号：浏览器拒绝该 cookie

Security

• 认证安全性不变：bcrypt + HMAC-SHA256，无明文密码传输
• 公开服务（blog/vaultwarden/memos）不经过 auth_proxy，不受影响

v1.1.0 (2026-06-15)

Added

• — Cookie session auth proxy 完整源码和 systemd 服务文件
• — Python HTTPServer，bcrypt 密码验证，HMAC-SHA256 token 签名
• — systemd 服务，port 9002，开机自启

Changed

• 安全认证升级：Caddy basicauth → auth_proxy Cookie session
  • 所有保护服务（gitea/dashboard/books/nav/brief/todo）改为走 auth_proxy:9002
  • 新增 auth.xybkwd.top 子域作为登录入口
  • Session cookie: 7天过期，HttpOnly，SameSite=Lax，Domain=.xybkwd.top
  • 密码验证不变（bcrypt），token 签名防篡改（HMAC-SHA256）
• — 去掉所有 basicauth，改为 reverse_proxy localhost:9002
• 服务清单更新：books (Calibre-Web) 状态同步

Fixed

• 移动端重复登录问题：basicauth 每 ~1 小时要求重新输入密码
• Cookie 跨子域失效：缺 Domain=.xybkwd.top 导致各子域不共享 cookie
• Set-Cookie 值带多余引号：浏览器拒绝该 cookie

Security

• 认证安全性不变：bcrypt + HMAC-SHA256，无明文密码传输
• 公开服务（blog/vaultwarden/memos）不经过 auth_proxy，不受影响

v1.2.0 (2026-06-15) — rollback

Removed

• auth_proxy 对主服务的拦截：恢复 Caddy 直接反向代理到后端
  • gitea → localhost:3000, dashboard → localhost:9000, books → localhost:8083
  • nav/brief → file_server（静态文件），nav/api/* → todo 9001
  • auth.xybkwd.top 仍保留 auth_proxy:9002 作为登录门户（不影响其他服务）

Added

• 认证方案待修复：Caddy v2.11 basic_auth bcrypt hash 格式需要重新调试

Lesson Learned (Critical)

• 🔴 铁律：所有配置变更必须先 commit 到 git，再部署到生产环境
• 本次事故的根因：直接修改 /etc/caddy/Caddyfile 后未及时 git commit， 导致回滚时需要从 git 历史中找回正确版本（commit 6c35f31）
• git 历史在此次事故中挽救了服务：回滚前险些无法恢复