Files
photography/docs/deployment
xujiang c8b9049a9b feat: 完成部署和运维系统完善
- 完善后端CI/CD部署流程,支持systemd服务管理
- 配置Caddy多域名反向代理 (前端/API/管理后台)
- 创建完整的生产环境监控系统
- 添加自动化运维脚本和定时监控
- 优化安全配置和错误处理机制
- 标准化备份、回滚、健康检查流程

🎯 里程碑: 部署和运维体系完善,生产环境就绪
📊 进度: 65.0% (26/40任务完成)
2025-07-11 14:19:13 +08:00
..

部署文档

本目录包含摄影作品集项目的部署相关文档。

目录结构

  • caddy-setup.md - Caddy Web 服务器配置指南
  • Caddyfile - Caddy 配置文件
  • fix-caddy-permissions.sh - Caddy 权限修复脚本
  • environments.md - 环境配置说明(计划中)
  • vercel-deployment.md - Vercel 部署指南(计划中)
  • docker-deployment.md - Docker 部署指南(计划中)
  • ci-cd.md - CI/CD 配置说明(计划中)
  • monitoring.md - 监控和日志配置(计划中)
  • backup.md - 备份策略(计划中)

部署准备

在部署前,请确保完成以下步骤:

  1. 代码检查: make lint
  2. 类型检查: make type-check
  3. 构建测试: make build
  4. 完整部署准备: make deploy-prep

环境变量

确保在部署环境中配置以下环境变量:

NEXT_PUBLIC_API_URL=your-api-url

当前部署方案

Caddy + Static Files

  • 前端: 静态文件部署到 ~/www/photography/
  • Web 服务器: Caddy (自动 HTTPS)
  • 域名: https://photography.iriver.top
  • CI/CD: Gitea Actions 自动部署

快速部署命令

# 1. 推送代码触发自动部署
git push origin main

# 2. 配置 Web 服务器(仅首次)
scp docs/deployment/Caddyfile user@server:/etc/caddy/Caddyfile
scp docs/deployment/fix-caddy-permissions.sh user@server:~/
ssh user@server './fix-caddy-permissions.sh && sudo systemctl reload caddy'

支持的部署平台

  • Caddy + Static Files (当前使用)
  • 📋 Vercel (计划中)
  • 📋 Netlify (计划中)
  • 📋 Docker (计划中)