photography/docs/operations/deployment/README.md

部署文档

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

目录结构

• 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 (计划中)