Files
xujiang 87c34179fa refactor: 清理根目录结构,重组部署文件
移动文件:
- Caddyfile → docs/deployment/Caddyfile
- fix-caddy-permissions.sh → docs/deployment/fix-caddy-permissions.sh

删除无用文件:
- 根目录 package.json (空项目文件)
- 根目录 bun.lock (无用锁定文件)
- 根目录 node_modules/ (无用依赖目录)

保留文件:
- lint-staged.config.js (项目级 pre-commit 配置)

更新引用:
- 更新 caddy-setup.md 中的文件路径
- 更新 deployment/README.md 文档结构

现在根目录更干净,部署相关文件统一在 docs/deployment/ 目录下
2025-07-09 10:44:42 +08:00

1.6 KiB

部署文档

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

目录结构

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