部署文档
本目录包含摄影作品集项目的部署相关文档。
目录结构
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- 备份策略（计划中）
部署准备
在部署前，请确保完成以下步骤：
- 代码检查:
make lint - 类型检查:
make type-check - 构建测试:
make build - 完整部署准备:
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 (计划中)