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

58 lines
1.6 KiB
Markdown

# 部署文档
本目录包含摄影作品集项目的部署相关文档。
## 目录结构
- `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`
## 环境变量
确保在部署环境中配置以下环境变量:
```bash
NEXT_PUBLIC_API_URL=your-api-url
```
## 当前部署方案
### Caddy + Static Files
- **前端**: 静态文件部署到 `~/www/photography/`
- **Web 服务器**: Caddy (自动 HTTPS)
- **域名**: https://photography.iriver.top
- **CI/CD**: Gitea Actions 自动部署
### 快速部署命令
```bash
# 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 (计划中)