feat: 完成容器化系统和用户文档开发
本次提交包含3个重要功能的完成： 1. 📖 用户使用文档完成 - 创建完整的用户使用手册 (docs/USER_MANUAL.md) - 管理后台使用指南 (登录、照片管理、分类管理) - 前端网站使用说明 (浏览、搜索、移动端) - 部署运维指南 (环境准备、监控维护) - 故障排查指南 (错误处理、性能优化) - 技术支持体系和问题反馈渠道 2. 🐳 后端Docker容器化完成 - 多阶段构建Dockerfile (golang:1.23-alpine → scratch) - Docker Compose开发环境 (PostgreSQL + Redis + API) - 优化的构建配置和安全用户设置 - 健康检查和环境变量管理 - 更新Makefile添加Docker命令 3. 🏗️ 前端Docker容器化完成 - 多阶段构建Dockerfile (node:20-alpine → nginx:1.25-alpine) - 集成bun包管理器优化构建速度 - 优化的Nginx配置 (缓存、压缩、安全头部) - Docker Compose多模式支持 (开发/生产/代理) - 更新Makefile添加Docker命令 4. 📋 完整的Docker编排系统 - 项目根目录完整的docker-compose.yml - 支持数据库、缓存、API、前端、管理后台的统一部署 - 自动化Docker设置脚本 (docker-setup.sh) - 生产环境监控和日志收集配置 技术成果: - 项目完成率从65.0%提升至72.5% - 中优先级任务完成率达90% - 低优先级任务开始推进(18%) - 容器化部署体系完全就绪 - 用户文档体系建立完成 下一步: 继续推进容器化扩展和性能优化任务
This commit is contained in:
xujiang
@ -6,15 +6,15 @@
|
||||
## 📊 总体进度概览
|
||||
|
||||
- **总任务数**: 40 (细化拆分后)
|
||||
- **已完成**: 26 ✅
|
||||
- **已完成**: 29 ✅
|
||||
- **进行中**: 0 🔄
|
||||
- **待开始**: 14 ⏳
|
||||
- **完成率**: 65.0%
|
||||
- **待开始**: 11 ⏳
|
||||
- **完成率**: 72.5%
|
||||
|
||||
### 📈 任务分布
|
||||
- **高优先级**: 9/9 (100% 完成) ✅
|
||||
- **中优先级**: 17/20 (85% 完成) 📈
|
||||
- **低优先级**: 0/11 (等待开始) ⏳
|
||||
- **中优先级**: 18/20 (90% 完成) 📈
|
||||
- **低优先级**: 2/11 (18% 完成) ⏳
|
||||
|
||||
---
|
||||
|
||||
@ -512,25 +512,52 @@
|
||||
- Kubernetes部署示例
|
||||
- 监控和日志收集
|
||||
|
||||
#### 29. 编写用户使用文档
|
||||
**优先级**: 中 🔥
|
||||
**预估工作量**: 0.5天
|
||||
**具体任务**: 管理后台使用说明、部署文档、故障排查
|
||||
#### 29. ✅ 编写用户使用文档
|
||||
**状态**: 已完成 ✅
|
||||
**完成时间**: 2025-07-11
|
||||
**完成内容**:
|
||||
- 创建完整的用户使用手册 (`docs/USER_MANUAL.md`)
|
||||
- 详细的管理后台使用指南 (登录、照片管理、分类管理等)
|
||||
- 前端网站使用说明 (浏览、搜索、移动端使用)
|
||||
- 完整的部署运维指南 (环境准备、部署步骤、监控维护)
|
||||
- 故障排查指南 (常见错误、性能优化、监控命令)
|
||||
- 技术支持体系 (联系方式、问题反馈渠道)
|
||||
- 常见问题解答 (登录、上传、性能等问题)
|
||||
- 更新日志和版本管理说明
|
||||
|
||||
---
|
||||
|
||||
## 📌 低优先级任务 (11/29) - 细化拆分
|
||||
|
||||
### 🐳 容器化和部署扩展 (4项)
|
||||
#### 30. 后端Docker容器化
|
||||
**优先级**: 低 ⚡
|
||||
**预估工作量**: 0.5天
|
||||
**具体任务**: Dockerfile编写、多阶段构建、镜像优化
|
||||
#### 30. ✅ 后端Docker容器化
|
||||
**状态**: 已完成 ✅
|
||||
**完成时间**: 2025-07-11
|
||||
**完成内容**:
|
||||
- 创建多阶段构建Dockerfile (`backend/Dockerfile`)
|
||||
- 使用golang:1.23-alpine作为构建镜像，scratch作为运行镜像
|
||||
- 支持静态链接编译，最小化镜像大小
|
||||
- 包含健康检查机制和安全用户配置
|
||||
- 创建Docker Compose配置 (`backend/docker-compose.yml`)
|
||||
- 集成PostgreSQL、Redis、API服务的完整开发环境
|
||||
- 添加.dockerignore文件优化构建上下文
|
||||
- 更新Makefile添加Docker相关命令
|
||||
- 支持开发和生产环境的不同配置
|
||||
|
||||
#### 31. 前端Docker容器化
|
||||
**优先级**: 低 ⚡
|
||||
**预估工作量**: 0.5天
|
||||
**具体任务**: 静态文件容器、Nginx配置、Docker compose
|
||||
#### 31. ✅ 前端Docker容器化
|
||||
**状态**: 已完成 ✅
|
||||
**完成时间**: 2025-07-11
|
||||
**完成内容**:
|
||||
- 创建多阶段构建Dockerfile (`frontend/Dockerfile`)
|
||||
- 使用node:20-alpine构建，nginx:1.25-alpine服务静态文件
|
||||
- 集成bun包管理器，优化构建速度
|
||||
- 创建优化的Nginx配置 (`nginx.conf`, `default.conf`)
|
||||
- 配置缓存策略、压缩、安全头部设置
|
||||
- 创建Docker Compose配置 (`frontend/docker-compose.yml`)
|
||||
- 支持开发、生产、代理多种模式
|
||||
- 添加.dockerignore文件减少镜像大小
|
||||
- 更新Makefile添加Docker相关命令
|
||||
- 配置健康检查和环境变量管理
|
||||
|
||||
#### 32. 数据库Docker配置
|
||||
**优先级**: 低 ⚡
|
||||
|
||||
75
backend/.dockerignore
Normal file
75
backend/.dockerignore
Normal file
@ -0,0 +1,75 @@
|
||||
# Photography Portfolio Backend .dockerignore
|
||||
# 优化Docker构建上下文，减少镜像大小
|
||||
|
||||
# Git相关
|
||||
.git/
|
||||
.gitignore
|
||||
.gitattributes
|
||||
|
||||
# 文档
|
||||
*.md
|
||||
docs/
|
||||
README*
|
||||
CHANGELOG*
|
||||
|
||||
# 开发工具
|
||||
.vscode/
|
||||
.idea/
|
||||
*.swp
|
||||
*.swo
|
||||
|
||||
# 测试文件
|
||||
*_test.go
|
||||
test/
|
||||
tests/
|
||||
coverage.*
|
||||
*.test
|
||||
|
||||
# 构建产物
|
||||
photography-api
|
||||
migrate
|
||||
*.exe
|
||||
*.dll
|
||||
*.so
|
||||
*.dylib
|
||||
|
||||
# 临时文件
|
||||
tmp/
|
||||
temp/
|
||||
.tmp/
|
||||
logs/
|
||||
*.log
|
||||
*.out
|
||||
|
||||
# 依赖
|
||||
vendor/
|
||||
|
||||
# 环境文件
|
||||
.env
|
||||
.env.local
|
||||
.env.development
|
||||
.env.test
|
||||
.env.production
|
||||
|
||||
# 上传文件
|
||||
uploads/
|
||||
static/images/
|
||||
|
||||
# 备份文件
|
||||
*.backup
|
||||
*.bak
|
||||
*.sql
|
||||
|
||||
# OS文件
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
.directory
|
||||
|
||||
# IDE文件
|
||||
*.sublime-*
|
||||
.editorconfig
|
||||
|
||||
# 其他
|
||||
node_modules/
|
||||
.npm
|
||||
.cache/
|
||||
64
backend/Dockerfile
Normal file
64
backend/Dockerfile
Normal file
@ -0,0 +1,64 @@
|
||||
# Photography Portfolio Backend Dockerfile
|
||||
# 多阶段构建，优化镜像大小和安全性
|
||||
|
||||
# Stage 1: 构建阶段
|
||||
FROM golang:1.23-alpine AS builder
|
||||
|
||||
# 设置工作目录
|
||||
WORKDIR /app
|
||||
|
||||
# 安装构建依赖
|
||||
RUN apk add --no-cache git ca-certificates tzdata
|
||||
|
||||
# 复制 go mod 文件并下载依赖
|
||||
COPY go.mod go.sum ./
|
||||
RUN go mod download
|
||||
|
||||
# 复制源代码
|
||||
COPY . .
|
||||
|
||||
# 构建应用程序
|
||||
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
|
||||
-ldflags='-w -s -extldflags "-static"' \
|
||||
-a -installsuffix cgo \
|
||||
-o photography-api \
|
||||
./cmd/api/main.go
|
||||
|
||||
# 构建迁移工具
|
||||
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
|
||||
-ldflags='-w -s -extldflags "-static"' \
|
||||
-a -installsuffix cgo \
|
||||
-o migrate \
|
||||
./cmd/migrate/main.go
|
||||
|
||||
# Stage 2: 运行阶段
|
||||
FROM scratch
|
||||
|
||||
# 从builder阶段复制时区数据和CA证书
|
||||
COPY --from=builder /usr/share/zoneinfo /usr/share/zoneinfo
|
||||
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
|
||||
|
||||
# 复制编译好的二进制文件
|
||||
COPY --from=builder /app/photography-api /photography-api
|
||||
COPY --from=builder /app/migrate /migrate
|
||||
|
||||
# 复制配置文件和脚本
|
||||
COPY --from=builder /app/configs /configs
|
||||
COPY --from=builder /app/scripts /scripts
|
||||
COPY --from=builder /app/pkg/migration/migrations /pkg/migration/migrations
|
||||
|
||||
# 设置时区
|
||||
ENV TZ=Asia/Shanghai
|
||||
|
||||
# 创建非root用户 (在scratch镜像中需要手动创建)
|
||||
USER 65534:65534
|
||||
|
||||
# 暴露端口
|
||||
EXPOSE 8080
|
||||
|
||||
# 健康检查
|
||||
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
|
||||
CMD ["/photography-api", "--health-check"]
|
||||
|
||||
# 启动应用
|
||||
ENTRYPOINT ["/photography-api"]
|
||||
@ -213,6 +213,57 @@ db-restore:
|
||||
deploy-prep: clean install lint test build
|
||||
@echo "Deployment preparation complete."
|
||||
|
||||
# Docker 相关命令
|
||||
docker-build:
|
||||
@echo "Building Docker image..."
|
||||
@docker build -t photography-api:latest .
|
||||
|
||||
docker-run:
|
||||
@echo "Running Docker container..."
|
||||
@docker run -d -p 8080:8080 --name photography-api photography-api:latest
|
||||
|
||||
docker-stop:
|
||||
@echo "Stopping Docker container..."
|
||||
@docker stop photography-api || true
|
||||
@docker rm photography-api || true
|
||||
|
||||
docker-logs:
|
||||
@echo "Viewing Docker logs..."
|
||||
@docker logs -f photography-api
|
||||
|
||||
docker-dev:
|
||||
@echo "Starting development environment with Docker Compose..."
|
||||
@docker-compose up -d
|
||||
|
||||
docker-dev-logs:
|
||||
@echo "Viewing development environment logs..."
|
||||
@docker-compose logs -f
|
||||
|
||||
docker-dev-stop:
|
||||
@echo "Stopping development environment..."
|
||||
@docker-compose down
|
||||
|
||||
docker-clean:
|
||||
@echo "Cleaning Docker resources..."
|
||||
@docker system prune -f
|
||||
|
||||
# 生产环境 Docker 命令
|
||||
docker-prod-build:
|
||||
@echo "Building production Docker image..."
|
||||
@docker build -t photography-api:prod -f Dockerfile.prod .
|
||||
|
||||
docker-prod-deploy:
|
||||
@echo "Deploying to production..."
|
||||
@docker-compose -f docker-compose.prod.yml up -d
|
||||
|
||||
docker-prod-logs:
|
||||
@echo "Viewing production logs..."
|
||||
@docker-compose -f docker-compose.prod.yml logs -f
|
||||
|
||||
docker-prod-stop:
|
||||
@echo "Stopping production environment..."
|
||||
@docker-compose -f docker-compose.prod.yml down
|
||||
|
||||
# 显示帮助
|
||||
help:
|
||||
@echo "Available commands:"
|
||||
|
||||
145
backend/docker-compose.yml
Normal file
145
backend/docker-compose.yml
Normal file
@ -0,0 +1,145 @@
|
||||
# Photography Portfolio Backend - Docker Compose
|
||||
# 本地开发和测试环境配置
|
||||
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
# PostgreSQL 数据库
|
||||
db:
|
||||
image: postgres:16-alpine
|
||||
container_name: photography-db
|
||||
environment:
|
||||
POSTGRES_DB: photography
|
||||
POSTGRES_USER: postgres
|
||||
POSTGRES_PASSWORD: postgres123
|
||||
POSTGRES_INITDB_ARGS: "--encoding=UTF-8 --lc-collate=C --lc-ctype=C"
|
||||
ports:
|
||||
- "5432:5432"
|
||||
volumes:
|
||||
- postgres_data:/var/lib/postgresql/data
|
||||
- ./configs/init-db.sql:/docker-entrypoint-initdb.d/init-db.sql:ro
|
||||
networks:
|
||||
- photography-network
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "pg_isready -U postgres -d photography"]
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
|
||||
# Redis 缓存
|
||||
redis:
|
||||
image: redis:7-alpine
|
||||
container_name: photography-redis
|
||||
ports:
|
||||
- "6379:6379"
|
||||
volumes:
|
||||
- redis_data:/data
|
||||
- ./configs/redis.conf:/usr/local/etc/redis/redis.conf:ro
|
||||
command: redis-server /usr/local/etc/redis/redis.conf
|
||||
networks:
|
||||
- photography-network
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
test: ["CMD", "redis-cli", "ping"]
|
||||
interval: 10s
|
||||
timeout: 3s
|
||||
retries: 5
|
||||
|
||||
# 后端API服务
|
||||
api:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile
|
||||
container_name: photography-api
|
||||
environment:
|
||||
# 数据库配置
|
||||
DB_HOST: db
|
||||
DB_PORT: 5432
|
||||
DB_NAME: photography
|
||||
DB_USER: postgres
|
||||
DB_PASSWORD: postgres123
|
||||
DB_SSL_MODE: disable
|
||||
|
||||
# Redis配置
|
||||
REDIS_HOST: redis
|
||||
REDIS_PORT: 6379
|
||||
REDIS_PASSWORD: ""
|
||||
REDIS_DB: 0
|
||||
|
||||
# JWT配置
|
||||
JWT_SECRET: your-super-secret-jwt-key-change-in-production
|
||||
JWT_EXPIRE: 24h
|
||||
|
||||
# 服务配置
|
||||
APP_ENV: development
|
||||
APP_PORT: 8080
|
||||
APP_HOST: 0.0.0.0
|
||||
|
||||
# CORS配置
|
||||
CORS_ORIGINS: "http://localhost:3000,http://localhost:3001,http://localhost:5173"
|
||||
|
||||
# 文件上传配置
|
||||
UPLOAD_PATH: /app/uploads
|
||||
UPLOAD_MAX_SIZE: 10485760 # 10MB
|
||||
|
||||
# 日志配置
|
||||
LOG_LEVEL: info
|
||||
LOG_FORMAT: json
|
||||
ports:
|
||||
- "8080:8080"
|
||||
volumes:
|
||||
- uploads_data:/app/uploads
|
||||
- logs_data:/app/logs
|
||||
networks:
|
||||
- photography-network
|
||||
depends_on:
|
||||
db:
|
||||
condition: service_healthy
|
||||
redis:
|
||||
condition: service_healthy
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
test: ["CMD", "/photography-api", "--health-check"]
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
start_period: 10s
|
||||
|
||||
# 数据库迁移服务 (一次性运行)
|
||||
migrate:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile
|
||||
container_name: photography-migrate
|
||||
environment:
|
||||
DB_HOST: db
|
||||
DB_PORT: 5432
|
||||
DB_NAME: photography
|
||||
DB_USER: postgres
|
||||
DB_PASSWORD: postgres123
|
||||
DB_SSL_MODE: disable
|
||||
networks:
|
||||
- photography-network
|
||||
depends_on:
|
||||
db:
|
||||
condition: service_healthy
|
||||
entrypoint: ["/migrate", "up"]
|
||||
restart: "no"
|
||||
|
||||
volumes:
|
||||
postgres_data:
|
||||
driver: local
|
||||
redis_data:
|
||||
driver: local
|
||||
uploads_data:
|
||||
driver: local
|
||||
logs_data:
|
||||
driver: local
|
||||
|
||||
networks:
|
||||
photography-network:
|
||||
driver: bridge
|
||||
ipam:
|
||||
config:
|
||||
- subnet: 172.20.0.0/16
|
||||
297
docker-compose.yml
Normal file
297
docker-compose.yml
Normal file
@ -0,0 +1,297 @@
|
||||
# Photography Portfolio - Complete Docker Compose
|
||||
# 完整的生产环境容器编排配置
|
||||
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
# PostgreSQL 数据库
|
||||
db:
|
||||
image: postgres:16-alpine
|
||||
container_name: photography-db
|
||||
environment:
|
||||
POSTGRES_DB: photography
|
||||
POSTGRES_USER: postgres
|
||||
POSTGRES_PASSWORD: ${DB_PASSWORD:-postgres123}
|
||||
POSTGRES_INITDB_ARGS: "--encoding=UTF-8"
|
||||
ports:
|
||||
- "5432:5432"
|
||||
volumes:
|
||||
- postgres_data:/var/lib/postgresql/data
|
||||
- ./backend/configs/init-db.sql:/docker-entrypoint-initdb.d/init-db.sql:ro
|
||||
networks:
|
||||
- photography-network
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "pg_isready -U postgres -d photography"]
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 5
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
cpus: '1.0'
|
||||
memory: 1G
|
||||
reservations:
|
||||
cpus: '0.5'
|
||||
memory: 512M
|
||||
|
||||
# Redis 缓存
|
||||
redis:
|
||||
image: redis:7-alpine
|
||||
container_name: photography-redis
|
||||
ports:
|
||||
- "6379:6379"
|
||||
volumes:
|
||||
- redis_data:/data
|
||||
command: redis-server --requirepass ${REDIS_PASSWORD:-redis123} --maxmemory 256mb --maxmemory-policy allkeys-lru
|
||||
networks:
|
||||
- photography-network
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
test: ["CMD", "redis-cli", "auth", "${REDIS_PASSWORD:-redis123}", "ping"]
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
|
||||
# 后端API服务
|
||||
api:
|
||||
build:
|
||||
context: ./backend
|
||||
dockerfile: Dockerfile
|
||||
container_name: photography-api
|
||||
environment:
|
||||
# 数据库配置
|
||||
DB_HOST: db
|
||||
DB_PORT: 5432
|
||||
DB_NAME: photography
|
||||
DB_USER: postgres
|
||||
DB_PASSWORD: ${DB_PASSWORD:-postgres123}
|
||||
DB_SSL_MODE: disable
|
||||
DB_MAX_CONNECTIONS: 100
|
||||
DB_MAX_IDLE_CONNECTIONS: 10
|
||||
|
||||
# Redis配置
|
||||
REDIS_HOST: redis
|
||||
REDIS_PORT: 6379
|
||||
REDIS_PASSWORD: ${REDIS_PASSWORD:-redis123}
|
||||
REDIS_DB: 0
|
||||
|
||||
# JWT配置
|
||||
JWT_SECRET: ${JWT_SECRET:-your-super-secret-jwt-key-change-in-production}
|
||||
JWT_EXPIRE: 24h
|
||||
|
||||
# 服务配置
|
||||
APP_ENV: ${APP_ENV:-production}
|
||||
APP_PORT: 8080
|
||||
APP_HOST: 0.0.0.0
|
||||
APP_VERSION: 1.0.0
|
||||
|
||||
# CORS配置
|
||||
CORS_ORIGINS: ${CORS_ORIGINS:-https://photography.iriver.top,https://admin.photography.iriver.top}
|
||||
|
||||
# 文件上传配置
|
||||
UPLOAD_PATH: /app/uploads
|
||||
UPLOAD_MAX_SIZE: 10485760 # 10MB
|
||||
UPLOAD_ALLOWED_TYPES: "image/jpeg,image/png,image/gif,image/webp"
|
||||
|
||||
# 日志配置
|
||||
LOG_LEVEL: ${LOG_LEVEL:-info}
|
||||
LOG_FORMAT: json
|
||||
LOG_FILE: /app/logs/api.log
|
||||
|
||||
# 监控配置
|
||||
ENABLE_METRICS: true
|
||||
METRICS_PORT: 9090
|
||||
ports:
|
||||
- "8080:8080"
|
||||
- "9090:9090" # 监控端口
|
||||
volumes:
|
||||
- uploads_data:/app/uploads
|
||||
- logs_data:/app/logs
|
||||
networks:
|
||||
- photography-network
|
||||
depends_on:
|
||||
db:
|
||||
condition: service_healthy
|
||||
redis:
|
||||
condition: service_healthy
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
test: ["CMD", "/photography-api", "--health-check"]
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
start_period: 30s
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
cpus: '2.0'
|
||||
memory: 2G
|
||||
reservations:
|
||||
cpus: '1.0'
|
||||
memory: 1G
|
||||
|
||||
# 前端展示网站
|
||||
frontend:
|
||||
build:
|
||||
context: ./frontend
|
||||
dockerfile: Dockerfile
|
||||
container_name: photography-frontend
|
||||
environment:
|
||||
NEXT_PUBLIC_API_URL: ${NEXT_PUBLIC_API_URL:-https://api.photography.iriver.top}
|
||||
NEXT_PUBLIC_APP_NAME: "Photography Portfolio"
|
||||
NEXT_PUBLIC_APP_VERSION: "1.0.0"
|
||||
NEXT_PUBLIC_ENABLE_ANALYTICS: ${NEXT_PUBLIC_ENABLE_ANALYTICS:-false}
|
||||
NEXT_PUBLIC_MAX_FILE_SIZE: 10485760
|
||||
ports:
|
||||
- "3000:80"
|
||||
networks:
|
||||
- photography-network
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
test: ["CMD", "curl", "-f", "http://localhost/health"]
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
cpus: '0.5'
|
||||
memory: 512M
|
||||
reservations:
|
||||
cpus: '0.25'
|
||||
memory: 256M
|
||||
|
||||
# 管理后台
|
||||
admin:
|
||||
build:
|
||||
context: ./admin
|
||||
dockerfile: Dockerfile
|
||||
container_name: photography-admin
|
||||
environment:
|
||||
REACT_APP_API_URL: ${REACT_APP_API_URL:-https://api.photography.iriver.top}
|
||||
REACT_APP_APP_NAME: "Photography Admin"
|
||||
REACT_APP_VERSION: "1.0.0"
|
||||
ports:
|
||||
- "3001:80"
|
||||
networks:
|
||||
- photography-network
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
test: ["CMD", "curl", "-f", "http://localhost/health"]
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
cpus: '0.5'
|
||||
memory: 512M
|
||||
reservations:
|
||||
cpus: '0.25'
|
||||
memory: 256M
|
||||
|
||||
# 数据库迁移 (一次性服务)
|
||||
migrate:
|
||||
build:
|
||||
context: ./backend
|
||||
dockerfile: Dockerfile
|
||||
container_name: photography-migrate
|
||||
environment:
|
||||
DB_HOST: db
|
||||
DB_PORT: 5432
|
||||
DB_NAME: photography
|
||||
DB_USER: postgres
|
||||
DB_PASSWORD: ${DB_PASSWORD:-postgres123}
|
||||
DB_SSL_MODE: disable
|
||||
networks:
|
||||
- photography-network
|
||||
depends_on:
|
||||
db:
|
||||
condition: service_healthy
|
||||
entrypoint: ["/migrate", "up"]
|
||||
restart: "no"
|
||||
|
||||
# 监控服务 (可选)
|
||||
prometheus:
|
||||
image: prom/prometheus:latest
|
||||
container_name: photography-prometheus
|
||||
ports:
|
||||
- "9091:9090"
|
||||
volumes:
|
||||
- ./configs/prometheus.yml:/etc/prometheus/prometheus.yml:ro
|
||||
- prometheus_data:/prometheus
|
||||
networks:
|
||||
- photography-network
|
||||
restart: unless-stopped
|
||||
profiles:
|
||||
- monitoring
|
||||
|
||||
# 日志收集 (可选)
|
||||
grafana:
|
||||
image: grafana/grafana:latest
|
||||
container_name: photography-grafana
|
||||
ports:
|
||||
- "3002:3000"
|
||||
environment:
|
||||
- GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_PASSWORD:-admin}
|
||||
volumes:
|
||||
- grafana_data:/var/lib/grafana
|
||||
networks:
|
||||
- photography-network
|
||||
restart: unless-stopped
|
||||
profiles:
|
||||
- monitoring
|
||||
|
||||
# 反向代理 (可选，推荐使用Caddy)
|
||||
nginx:
|
||||
image: nginx:1.25-alpine
|
||||
container_name: photography-nginx
|
||||
ports:
|
||||
- "80:80"
|
||||
- "443:443"
|
||||
volumes:
|
||||
- ./configs/nginx.conf:/etc/nginx/nginx.conf:ro
|
||||
- ./configs/sites-enabled:/etc/nginx/sites-enabled:ro
|
||||
- ssl_certs:/etc/nginx/ssl:ro
|
||||
networks:
|
||||
- photography-network
|
||||
depends_on:
|
||||
- frontend
|
||||
- admin
|
||||
- api
|
||||
restart: unless-stopped
|
||||
profiles:
|
||||
- proxy
|
||||
|
||||
volumes:
|
||||
postgres_data:
|
||||
driver: local
|
||||
redis_data:
|
||||
driver: local
|
||||
uploads_data:
|
||||
driver: local
|
||||
logs_data:
|
||||
driver: local
|
||||
prometheus_data:
|
||||
driver: local
|
||||
grafana_data:
|
||||
driver: local
|
||||
ssl_certs:
|
||||
driver: local
|
||||
|
||||
networks:
|
||||
photography-network:
|
||||
driver: bridge
|
||||
ipam:
|
||||
config:
|
||||
- subnet: 172.20.0.0/16
|
||||
labels:
|
||||
- "com.photography.network=main"
|
||||
|
||||
# 健康检查配置
|
||||
x-healthcheck-defaults: &healthcheck-defaults
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
start_period: 30s
|
||||
355
docker-setup.sh
Executable file
355
docker-setup.sh
Executable file
@ -0,0 +1,355 @@
|
||||
#!/bin/bash
|
||||
|
||||
# Photography Portfolio Docker Setup Script
|
||||
# 自动化Docker环境设置和部署
|
||||
|
||||
set -e
|
||||
|
||||
# 颜色定义
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
NC='\033[0m' # No Color
|
||||
|
||||
# 日志函数
|
||||
log_info() {
|
||||
echo -e "${BLUE}[INFO]${NC} $1"
|
||||
}
|
||||
|
||||
log_success() {
|
||||
echo -e "${GREEN}[SUCCESS]${NC} $1"
|
||||
}
|
||||
|
||||
log_warning() {
|
||||
echo -e "${YELLOW}[WARNING]${NC} $1"
|
||||
}
|
||||
|
||||
log_error() {
|
||||
echo -e "${RED}[ERROR]${NC} $1"
|
||||
}
|
||||
|
||||
# 检查依赖
|
||||
check_dependencies() {
|
||||
log_info "检查系统依赖..."
|
||||
|
||||
if ! command -v docker &> /dev/null; then
|
||||
log_error "Docker 未安装，请先安装Docker"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if ! command -v docker-compose &> /dev/null; then
|
||||
log_error "Docker Compose 未安装，请先安装Docker Compose"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
log_success "系统依赖检查完成"
|
||||
}
|
||||
|
||||
# 创建环境文件
|
||||
create_env_file() {
|
||||
log_info "创建环境配置文件..."
|
||||
|
||||
if [ ! -f .env ]; then
|
||||
cat > .env << EOF
|
||||
# Photography Portfolio Environment Configuration
|
||||
|
||||
# 数据库配置
|
||||
DB_PASSWORD=photography_db_2024
|
||||
POSTGRES_PASSWORD=photography_db_2024
|
||||
|
||||
# Redis配置
|
||||
REDIS_PASSWORD=photography_redis_2024
|
||||
|
||||
# JWT配置
|
||||
JWT_SECRET=photography_jwt_secret_super_secure_key_2024
|
||||
|
||||
# 应用配置
|
||||
APP_ENV=production
|
||||
LOG_LEVEL=info
|
||||
|
||||
# 前端配置
|
||||
NEXT_PUBLIC_API_URL=https://api.photography.iriver.top
|
||||
REACT_APP_API_URL=https://api.photography.iriver.top
|
||||
|
||||
# CORS配置
|
||||
CORS_ORIGINS=https://photography.iriver.top,https://admin.photography.iriver.top
|
||||
|
||||
# 监控配置
|
||||
GRAFANA_PASSWORD=photography_grafana_2024
|
||||
|
||||
# 功能开关
|
||||
NEXT_PUBLIC_ENABLE_ANALYTICS=false
|
||||
NEXT_PUBLIC_ENABLE_PWA=true
|
||||
EOF
|
||||
log_success "环境配置文件已创建 (.env)"
|
||||
else
|
||||
log_warning "环境配置文件已存在，跳过创建"
|
||||
fi
|
||||
}
|
||||
|
||||
# 创建目录结构
|
||||
create_directories() {
|
||||
log_info "创建必要的目录结构..."
|
||||
|
||||
mkdir -p {configs,logs,data,backups,scripts}
|
||||
mkdir -p configs/{nginx,prometheus,grafana}
|
||||
mkdir -p data/{postgres,redis,uploads}
|
||||
|
||||
log_success "目录结构创建完成"
|
||||
}
|
||||
|
||||
# 构建镜像
|
||||
build_images() {
|
||||
log_info "构建Docker镜像..."
|
||||
|
||||
# 构建后端镜像
|
||||
log_info "构建后端API镜像..."
|
||||
docker-compose build api
|
||||
|
||||
# 构建前端镜像
|
||||
log_info "构建前端镜像..."
|
||||
docker-compose build frontend
|
||||
|
||||
# 构建管理后台镜像
|
||||
if [ -d "admin" ]; then
|
||||
log_info "构建管理后台镜像..."
|
||||
docker-compose build admin
|
||||
fi
|
||||
|
||||
log_success "Docker镜像构建完成"
|
||||
}
|
||||
|
||||
# 初始化数据库
|
||||
init_database() {
|
||||
log_info "初始化数据库..."
|
||||
|
||||
# 启动数据库服务
|
||||
docker-compose up -d db redis
|
||||
|
||||
# 等待数据库启动
|
||||
log_info "等待数据库启动..."
|
||||
sleep 30
|
||||
|
||||
# 运行数据库迁移
|
||||
log_info "执行数据库迁移..."
|
||||
docker-compose run --rm migrate
|
||||
|
||||
log_success "数据库初始化完成"
|
||||
}
|
||||
|
||||
# 启动服务
|
||||
start_services() {
|
||||
log_info "启动所有服务..."
|
||||
|
||||
# 启动核心服务
|
||||
docker-compose up -d db redis api frontend
|
||||
|
||||
# 启动管理后台
|
||||
if [ -d "admin" ]; then
|
||||
docker-compose up -d admin
|
||||
fi
|
||||
|
||||
log_success "服务启动完成"
|
||||
}
|
||||
|
||||
# 健康检查
|
||||
health_check() {
|
||||
log_info "执行健康检查..."
|
||||
|
||||
# 等待服务启动
|
||||
sleep 10
|
||||
|
||||
# 检查数据库
|
||||
if docker-compose exec db pg_isready -U postgres -d photography; then
|
||||
log_success "数据库连接正常"
|
||||
else
|
||||
log_error "数据库连接失败"
|
||||
return 1
|
||||
fi
|
||||
|
||||
# 检查Redis
|
||||
if docker-compose exec redis redis-cli ping; then
|
||||
log_success "Redis连接正常"
|
||||
else
|
||||
log_error "Redis连接失败"
|
||||
return 1
|
||||
fi
|
||||
|
||||
# 检查API服务
|
||||
if curl -f http://localhost:8080/health; then
|
||||
log_success "API服务正常"
|
||||
else
|
||||
log_error "API服务异常"
|
||||
return 1
|
||||
fi
|
||||
|
||||
# 检查前端服务
|
||||
if curl -f http://localhost:3000/health; then
|
||||
log_success "前端服务正常"
|
||||
else
|
||||
log_error "前端服务异常"
|
||||
return 1
|
||||
fi
|
||||
|
||||
log_success "所有服务健康检查通过"
|
||||
}
|
||||
|
||||
# 显示服务状态
|
||||
show_status() {
|
||||
log_info "服务状态信息:"
|
||||
echo ""
|
||||
docker-compose ps
|
||||
echo ""
|
||||
|
||||
log_info "访问地址:"
|
||||
echo "前端网站: http://localhost:3000"
|
||||
echo "管理后台: http://localhost:3001"
|
||||
echo "API接口: http://localhost:8080"
|
||||
echo "API文档: http://localhost:8080/docs"
|
||||
echo ""
|
||||
|
||||
log_info "数据库连接信息:"
|
||||
echo "主机: localhost:5432"
|
||||
echo "数据库: photography"
|
||||
echo "用户名: postgres"
|
||||
echo ""
|
||||
}
|
||||
|
||||
# 清理函数
|
||||
cleanup() {
|
||||
log_info "清理Docker资源..."
|
||||
|
||||
# 停止所有服务
|
||||
docker-compose down
|
||||
|
||||
# 清理无用的镜像和容器
|
||||
docker system prune -f
|
||||
|
||||
log_success "清理完成"
|
||||
}
|
||||
|
||||
# 备份数据
|
||||
backup_data() {
|
||||
log_info "备份数据..."
|
||||
|
||||
# 创建备份目录
|
||||
BACKUP_DIR="backups/$(date +%Y%m%d_%H%M%S)"
|
||||
mkdir -p "$BACKUP_DIR"
|
||||
|
||||
# 备份数据库
|
||||
docker-compose exec db pg_dump -U postgres photography > "$BACKUP_DIR/database.sql"
|
||||
|
||||
# 备份上传文件
|
||||
docker run --rm -v photography_uploads_data:/data -v "$(pwd)/$BACKUP_DIR":/backup alpine tar czf /backup/uploads.tar.gz -C /data .
|
||||
|
||||
log_success "数据备份完成: $BACKUP_DIR"
|
||||
}
|
||||
|
||||
# 恢复数据
|
||||
restore_data() {
|
||||
if [ -z "$1" ]; then
|
||||
log_error "请指定备份目录: ./docker-setup.sh restore /path/to/backup"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
BACKUP_DIR="$1"
|
||||
|
||||
if [ ! -d "$BACKUP_DIR" ]; then
|
||||
log_error "备份目录不存在: $BACKUP_DIR"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
log_info "恢复数据从: $BACKUP_DIR"
|
||||
|
||||
# 恢复数据库
|
||||
if [ -f "$BACKUP_DIR/database.sql" ]; then
|
||||
docker-compose exec -T db psql -U postgres photography < "$BACKUP_DIR/database.sql"
|
||||
log_success "数据库恢复完成"
|
||||
fi
|
||||
|
||||
# 恢复上传文件
|
||||
if [ -f "$BACKUP_DIR/uploads.tar.gz" ]; then
|
||||
docker run --rm -v photography_uploads_data:/data -v "$(pwd)/$BACKUP_DIR":/backup alpine tar xzf /backup/uploads.tar.gz -C /data
|
||||
log_success "上传文件恢复完成"
|
||||
fi
|
||||
}
|
||||
|
||||
# 主函数
|
||||
main() {
|
||||
case "${1:-setup}" in
|
||||
"setup")
|
||||
log_info "开始Photography Portfolio Docker环境设置..."
|
||||
check_dependencies
|
||||
create_env_file
|
||||
create_directories
|
||||
build_images
|
||||
init_database
|
||||
start_services
|
||||
health_check
|
||||
show_status
|
||||
log_success "Docker环境设置完成!"
|
||||
;;
|
||||
"start")
|
||||
log_info "启动服务..."
|
||||
docker-compose up -d
|
||||
health_check
|
||||
show_status
|
||||
;;
|
||||
"stop")
|
||||
log_info "停止服务..."
|
||||
docker-compose down
|
||||
log_success "服务已停止"
|
||||
;;
|
||||
"restart")
|
||||
log_info "重启服务..."
|
||||
docker-compose restart
|
||||
health_check
|
||||
show_status
|
||||
;;
|
||||
"build")
|
||||
log_info "重新构建镜像..."
|
||||
build_images
|
||||
;;
|
||||
"logs")
|
||||
log_info "查看服务日志..."
|
||||
docker-compose logs -f
|
||||
;;
|
||||
"status")
|
||||
show_status
|
||||
;;
|
||||
"clean")
|
||||
cleanup
|
||||
;;
|
||||
"backup")
|
||||
backup_data
|
||||
;;
|
||||
"restore")
|
||||
restore_data "$2"
|
||||
;;
|
||||
"help")
|
||||
echo "Usage: $0 {setup|start|stop|restart|build|logs|status|clean|backup|restore}"
|
||||
echo ""
|
||||
echo "Commands:"
|
||||
echo " setup - 完整的环境设置和初始化"
|
||||
echo " start - 启动所有服务"
|
||||
echo " stop - 停止所有服务"
|
||||
echo " restart - 重启所有服务"
|
||||
echo " build - 重新构建Docker镜像"
|
||||
echo " logs - 查看服务日志"
|
||||
echo " status - 显示服务状态"
|
||||
echo " clean - 清理Docker资源"
|
||||
echo " backup - 备份数据"
|
||||
echo " restore - 恢复数据"
|
||||
echo " help - 显示帮助信息"
|
||||
;;
|
||||
*)
|
||||
log_error "未知命令: $1"
|
||||
echo "使用 '$0 help' 查看可用命令"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
# 执行主函数
|
||||
main "$@"
|
||||
578
docs/USER_MANUAL.md
Normal file
578
docs/USER_MANUAL.md
Normal file
@ -0,0 +1,578 @@
|
||||
# Photography Portfolio 用户使用手册
|
||||
|
||||
> 版本: v1.0.0
|
||||
> 更新日期: 2025-07-11
|
||||
> 适用范围: 管理员和最终用户
|
||||
|
||||
## 📋 目录
|
||||
|
||||
1. [系统概述](#系统概述)
|
||||
2. [快速开始](#快速开始)
|
||||
3. [管理后台使用指南](#管理后台使用指南)
|
||||
4. [前端网站使用指南](#前端网站使用指南)
|
||||
5. [部署运维指南](#部署运维指南)
|
||||
6. [常见问题解答](#常见问题解答)
|
||||
7. [故障排查](#故障排查)
|
||||
8. [联系支持](#联系支持)
|
||||
|
||||
---
|
||||
|
||||
## 🎯 系统概述
|
||||
|
||||
Photography Portfolio 是一个现代化的摄影作品集管理系统，包含以下核心功能：
|
||||
|
||||
### 主要特性
|
||||
- 🔐 **安全认证系统**: JWT认证，多级权限控制
|
||||
- 📸 **照片管理**: 上传、编辑、分类、标签管理
|
||||
- 🎨 **响应式设计**: 支持桌面端和移动端
|
||||
- 🌙 **主题切换**: 深色/浅色模式
|
||||
- 📊 **统计分析**: 完整的数据统计和分析功能
|
||||
|
||||
### 系统架构
|
||||
```
|
||||
前端展示网站 (photography.iriver.top)
|
||||
↓
|
||||
管理后台 (admin.photography.iriver.top)
|
||||
↓
|
||||
后端API (api.photography.iriver.top)
|
||||
↓
|
||||
数据库 (PostgreSQL)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 系统要求
|
||||
- **浏览器**: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
|
||||
- **分辨率**: 最低 1024x768 (推荐 1920x1080)
|
||||
- **网络**: 宽带连接 (上传照片需要)
|
||||
|
||||
### 访问地址
|
||||
- **前端网站**: https://photography.iriver.top
|
||||
- **管理后台**: https://admin.photography.iriver.top
|
||||
- **API文档**: https://api.photography.iriver.top/docs
|
||||
|
||||
### 默认账户
|
||||
```
|
||||
管理员账户:
|
||||
用户名: admin
|
||||
密码: admin123
|
||||
邮箱: admin@photography.com
|
||||
|
||||
演示账户:
|
||||
用户名: demo
|
||||
密码: demo123
|
||||
邮箱: demo@photography.com
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎛️ 管理后台使用指南
|
||||
|
||||
### 登录系统
|
||||
|
||||
1. 访问 https://admin.photography.iriver.top
|
||||
2. 输入用户名和密码
|
||||
3. 点击"登录"按钮
|
||||
4. 登录成功后自动跳转到仪表板
|
||||
|
||||
### 仪表板概览
|
||||
|
||||
仪表板显示系统的核心统计信息：
|
||||
- 📸 **照片总数**: 系统中的照片总量
|
||||
- 📁 **分类数量**: 当前分类总数
|
||||
- 🏷️ **标签数量**: 系统标签总数
|
||||
- 👥 **用户数量**: 注册用户总数
|
||||
- 📊 **月度统计**: 近期上传趋势
|
||||
|
||||
### 照片管理
|
||||
|
||||
#### 上传照片
|
||||
1. 点击左侧菜单"照片管理"
|
||||
2. 点击"上传照片"按钮
|
||||
3. 选择上传方式：
|
||||
- **拖拽上传**: 直接将图片拖拽到指定区域
|
||||
- **点击上传**: 点击选择文件按钮
|
||||
4. 填写照片信息：
|
||||
- 标题 (必填)
|
||||
- 描述 (可选)
|
||||
- 分类 (必填)
|
||||
- 标签 (可选，多选)
|
||||
5. 点击"开始上传"
|
||||
6. 等待上传完成
|
||||
|
||||
**支持的文件格式**: JPG, PNG, GIF, WebP
|
||||
**文件大小限制**: 单张照片最大 10MB
|
||||
**批量上传**: 最多同时上传 20 张照片
|
||||
|
||||
#### 管理照片
|
||||
1. 在照片列表中查看所有照片
|
||||
2. 使用搜索框查找特定照片
|
||||
3. 切换视图模式：
|
||||
- 🔲 **网格视图**: 缩略图展示
|
||||
- 📋 **列表视图**: 详细信息展示
|
||||
4. 照片操作：
|
||||
- **查看**: 点击照片查看详情
|
||||
- **编辑**: 点击操作菜单选择编辑
|
||||
- **删除**: 点击操作菜单选择删除
|
||||
|
||||
#### 批量操作
|
||||
1. 选择多张照片 (勾选复选框)
|
||||
2. 点击"批量操作"按钮
|
||||
3. 选择操作类型：
|
||||
- **批量删除**: 删除选中的照片
|
||||
- **批量更新状态**: 更改照片状态
|
||||
- **批量分类**: 更改照片分类
|
||||
|
||||
#### 照片编辑
|
||||
1. 在照片操作菜单中选择"编辑"
|
||||
2. 修改照片信息：
|
||||
- 标题
|
||||
- 描述
|
||||
- 分类
|
||||
- 标签
|
||||
- 状态 (已发布/草稿)
|
||||
3. 点击"保存"确认修改
|
||||
|
||||
### 分类管理
|
||||
|
||||
#### 创建分类
|
||||
1. 点击左侧菜单"分类管理"
|
||||
2. 点击"创建分类"按钮
|
||||
3. 填写分类信息：
|
||||
- 分类名称 (必填)
|
||||
- 分类描述 (可选)
|
||||
- 父级分类 (可选，用于创建子分类)
|
||||
4. 点击"创建"保存
|
||||
|
||||
#### 管理分类
|
||||
- **树形结构**: 分类以树形结构展示层级关系
|
||||
- **展开/收起**: 点击箭头图标展开或收起子分类
|
||||
- **编辑分类**: 点击操作菜单选择编辑
|
||||
- **删除分类**: 点击操作菜单选择删除 (注意：删除分类前需要先移除该分类下的照片)
|
||||
|
||||
#### 分类统计
|
||||
- 每个分类显示包含的照片数量
|
||||
- 分类状态指示器 (启用/禁用)
|
||||
- 最后更新时间
|
||||
|
||||
### 用户管理
|
||||
|
||||
#### 查看用户
|
||||
1. 点击左侧菜单"用户管理"
|
||||
2. 查看用户列表和详细信息
|
||||
3. 使用搜索功能查找特定用户
|
||||
|
||||
#### 用户操作
|
||||
- **查看详情**: 点击用户名查看详细信息
|
||||
- **编辑用户**: 修改用户信息和权限
|
||||
- **启用/禁用**: 控制用户账户状态
|
||||
- **重置密码**: 为用户重置密码
|
||||
|
||||
### 系统设置
|
||||
|
||||
#### 个人设置
|
||||
1. 点击右上角用户头像
|
||||
2. 选择"个人设置"
|
||||
3. 修改个人信息：
|
||||
- 头像上传
|
||||
- 昵称修改
|
||||
- 邮箱更新
|
||||
- 密码修改
|
||||
|
||||
#### 主题设置
|
||||
- 点击右上角的主题切换按钮
|
||||
- 选择浅色模式或深色模式
|
||||
- 设置会自动保存
|
||||
|
||||
---
|
||||
|
||||
## 🌐 前端网站使用指南
|
||||
|
||||
### 浏览照片
|
||||
|
||||
#### 主页浏览
|
||||
1. 访问 https://photography.iriver.top
|
||||
2. 首页展示最新上传的照片
|
||||
3. 滚动查看更多照片
|
||||
4. 点击照片查看大图
|
||||
|
||||
#### 搜索功能
|
||||
1. 使用顶部搜索栏
|
||||
2. 输入关键词搜索照片
|
||||
3. 支持搜索：
|
||||
- 照片标题
|
||||
- 照片描述
|
||||
- 分类名称
|
||||
- 标签名称
|
||||
|
||||
#### 过滤功能
|
||||
1. 点击"过滤"按钮
|
||||
2. 选择过滤条件：
|
||||
- **分类**: 选择特定分类
|
||||
- **标签**: 选择一个或多个标签
|
||||
- **排序**: 选择排序方式
|
||||
3. 点击"应用过滤"
|
||||
|
||||
#### 视图模式
|
||||
- **网格视图**: 照片以网格形式展示
|
||||
- **瀑布流**: 照片以瀑布流形式展示
|
||||
- **列表视图**: 照片以列表形式展示
|
||||
|
||||
### 照片查看
|
||||
|
||||
#### 全屏查看
|
||||
1. 点击任意照片打开全屏模式
|
||||
2. 使用键盘控制：
|
||||
- **左右箭头**: 切换照片
|
||||
- **ESC**: 退出全屏
|
||||
- **空格**: 暂停/继续幻灯片
|
||||
3. 移动端支持手势操作：
|
||||
- **左右滑动**: 切换照片
|
||||
- **双击**: 缩放照片
|
||||
- **捏合**: 缩放控制
|
||||
|
||||
#### 照片信息
|
||||
- 照片标题和描述
|
||||
- 拍摄日期和上传时间
|
||||
- 分类和标签信息
|
||||
- 照片统计信息
|
||||
|
||||
### 分类浏览
|
||||
|
||||
#### 分类页面
|
||||
1. 点击导航栏"分类"
|
||||
2. 查看所有分类列表
|
||||
3. 点击分类名称查看该分类下的照片
|
||||
4. 查看分类统计信息
|
||||
|
||||
#### 标签云
|
||||
1. 点击导航栏"标签"
|
||||
2. 查看标签云展示
|
||||
3. 标签大小表示使用频率
|
||||
4. 点击标签查看相关照片
|
||||
|
||||
### 移动端使用
|
||||
|
||||
#### 触摸操作
|
||||
- **单击**: 选择照片
|
||||
- **双击**: 全屏查看
|
||||
- **左右滑动**: 切换照片
|
||||
- **上下滑动**: 浏览列表
|
||||
- **捏合**: 缩放照片
|
||||
|
||||
#### 响应式设计
|
||||
- 自动适配不同屏幕尺寸
|
||||
- 优化的移动端界面
|
||||
- 触摸友好的按钮设计
|
||||
|
||||
---
|
||||
|
||||
## 🚀 部署运维指南
|
||||
|
||||
### 环境要求
|
||||
|
||||
#### 服务器配置
|
||||
- **操作系统**: Ubuntu 20.04+ / CentOS 8+
|
||||
- **CPU**: 2核心以上
|
||||
- **内存**: 4GB以上
|
||||
- **存储**: 50GB以上
|
||||
- **网络**: 公网IP，备案域名
|
||||
|
||||
#### 软件依赖
|
||||
- **Docker**: 20.10+
|
||||
- **Docker Compose**: 2.0+
|
||||
- **Nginx**: 1.18+ (或使用Caddy)
|
||||
- **PostgreSQL**: 13+
|
||||
- **Redis**: 6.0+
|
||||
|
||||
### 部署步骤
|
||||
|
||||
#### 1. 服务器准备
|
||||
```bash
|
||||
# 更新系统
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
|
||||
# 安装Docker
|
||||
curl -fsSL https://get.docker.com -o get-docker.sh
|
||||
sudo sh get-docker.sh
|
||||
sudo usermod -aG docker $USER
|
||||
|
||||
# 安装Docker Compose
|
||||
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
|
||||
sudo chmod +x /usr/local/bin/docker-compose
|
||||
```
|
||||
|
||||
#### 2. 项目部署
|
||||
```bash
|
||||
# 克隆项目
|
||||
git clone https://git.iriver.top/iriver/photography.git
|
||||
cd photography
|
||||
|
||||
# 配置环境变量
|
||||
cp .env.example .env
|
||||
# 编辑 .env 文件配置数据库等信息
|
||||
|
||||
# 启动服务
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
#### 3. 数据库初始化
|
||||
```bash
|
||||
# 执行数据库迁移
|
||||
docker-compose exec backend ./migrate up
|
||||
|
||||
# 导入种子数据
|
||||
docker-compose exec backend ./scripts/seed_data.sh
|
||||
```
|
||||
|
||||
#### 4. 域名配置
|
||||
```bash
|
||||
# 配置Caddy反向代理
|
||||
sudo cp docs/deployment/Caddyfile /etc/caddy/
|
||||
sudo systemctl reload caddy
|
||||
```
|
||||
|
||||
### 监控和维护
|
||||
|
||||
#### 日志查看
|
||||
```bash
|
||||
# 查看所有服务日志
|
||||
docker-compose logs -f
|
||||
|
||||
# 查看特定服务日志
|
||||
docker-compose logs -f backend
|
||||
docker-compose logs -f frontend
|
||||
```
|
||||
|
||||
#### 性能监控
|
||||
```bash
|
||||
# 查看资源使用情况
|
||||
docker stats
|
||||
|
||||
# 查看磁盘使用情况
|
||||
df -h
|
||||
|
||||
# 查看数据库状态
|
||||
docker-compose exec db psql -U postgres -d photography -c "SELECT * FROM pg_stat_activity;"
|
||||
```
|
||||
|
||||
#### 备份策略
|
||||
```bash
|
||||
# 数据库备份
|
||||
docker-compose exec db pg_dump -U postgres photography > backup_$(date +%Y%m%d).sql
|
||||
|
||||
# 文件备份
|
||||
tar -czf uploads_backup_$(date +%Y%m%d).tar.gz uploads/
|
||||
```
|
||||
|
||||
### 更新部署
|
||||
|
||||
#### 应用程序更新
|
||||
```bash
|
||||
# 拉取最新代码
|
||||
git pull origin main
|
||||
|
||||
# 重新构建镜像
|
||||
docker-compose build
|
||||
|
||||
# 重启服务
|
||||
docker-compose down
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
#### 数据库迁移
|
||||
```bash
|
||||
# 执行新的迁移
|
||||
docker-compose exec backend ./migrate up
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ❓ 常见问题解答
|
||||
|
||||
### 登录相关
|
||||
|
||||
**Q: 忘记密码怎么办？**
|
||||
A: 请联系管理员重置密码，或使用密码找回功能。
|
||||
|
||||
**Q: 登录时提示"用户名或密码错误"？**
|
||||
A: 请检查用户名和密码是否正确，注意大小写。如果多次失败，账户可能被锁定。
|
||||
|
||||
**Q: 登录后自动退出？**
|
||||
A: 可能是会话过期，请重新登录。如果频繁出现，请联系管理员。
|
||||
|
||||
### 照片上传
|
||||
|
||||
**Q: 支持哪些图片格式？**
|
||||
A: 支持 JPG, PNG, GIF, WebP 格式，推荐使用 JPG 格式。
|
||||
|
||||
**Q: 照片上传失败怎么办？**
|
||||
A: 请检查：
|
||||
1. 文件格式是否支持
|
||||
2. 文件大小是否超过限制 (10MB)
|
||||
3. 网络连接是否稳定
|
||||
4. 浏览器是否支持
|
||||
|
||||
**Q: 批量上传照片时部分失败？**
|
||||
A: 系统会显示失败的照片列表，您可以单独重新上传失败的照片。
|
||||
|
||||
### 性能相关
|
||||
|
||||
**Q: 照片加载很慢？**
|
||||
A: 可能的原因：
|
||||
1. 网络连接较慢
|
||||
2. 照片文件过大
|
||||
3. 服务器负载较高
|
||||
建议: 使用压缩后的照片，优化网络环境。
|
||||
|
||||
**Q: 网站打开缓慢？**
|
||||
A: 请检查网络连接，清除浏览器缓存，或稍后再试。
|
||||
|
||||
### 功能使用
|
||||
|
||||
**Q: 如何创建照片分类？**
|
||||
A: 在管理后台的"分类管理"中点击"创建分类"按钮。
|
||||
|
||||
**Q: 如何批量管理照片？**
|
||||
A: 在照片列表中勾选多张照片，然后使用"批量操作"功能。
|
||||
|
||||
**Q: 如何搜索照片？**
|
||||
A: 使用搜索框输入关键词，支持搜索标题、描述、分类和标签。
|
||||
|
||||
---
|
||||
|
||||
## 🔧 故障排查
|
||||
|
||||
### 常见错误
|
||||
|
||||
#### 1. 500 服务器内部错误
|
||||
**症状**: 访问网站时显示"500 Internal Server Error"
|
||||
**排查步骤**:
|
||||
1. 检查服务器日志: `sudo tail -f /var/log/photography/error.log`
|
||||
2. 检查数据库连接: `docker-compose exec backend ./health-check`
|
||||
3. 检查磁盘空间: `df -h`
|
||||
4. 重启服务: `docker-compose restart`
|
||||
|
||||
#### 2. 无法连接数据库
|
||||
**症状**: 登录失败，提示数据库连接错误
|
||||
**排查步骤**:
|
||||
1. 检查数据库服务状态: `docker-compose ps`
|
||||
2. 检查数据库日志: `docker-compose logs db`
|
||||
3. 验证数据库配置: 检查 `.env` 文件中的数据库配置
|
||||
4. 重启数据库: `docker-compose restart db`
|
||||
|
||||
#### 3. 照片上传失败
|
||||
**症状**: 上传照片时提示失败或超时
|
||||
**排查步骤**:
|
||||
1. 检查上传目录权限: `ls -la uploads/`
|
||||
2. 检查磁盘空间: `df -h`
|
||||
3. 检查文件大小限制: 确认文件不超过10MB
|
||||
4. 检查网络连接: 确认网络稳定
|
||||
|
||||
#### 4. 静态资源无法访问
|
||||
**症状**: 照片或样式文件无法加载
|
||||
**排查步骤**:
|
||||
1. 检查Nginx/Caddy配置: `sudo nginx -t` 或 `caddy validate`
|
||||
2. 检查文件权限: `ls -la /var/www/photography/`
|
||||
3. 检查防火墙设置: `sudo ufw status`
|
||||
4. 重启Web服务器: `sudo systemctl restart nginx`
|
||||
|
||||
### 性能优化
|
||||
|
||||
#### 1. 数据库优化
|
||||
```sql
|
||||
-- 检查数据库性能
|
||||
SELECT * FROM pg_stat_activity WHERE state = 'active';
|
||||
|
||||
-- 重建索引
|
||||
REINDEX DATABASE photography;
|
||||
|
||||
-- 更新统计信息
|
||||
ANALYZE;
|
||||
```
|
||||
|
||||
#### 2. 缓存优化
|
||||
```bash
|
||||
# 清除Redis缓存
|
||||
docker-compose exec redis redis-cli FLUSHALL
|
||||
|
||||
# 重启Redis
|
||||
docker-compose restart redis
|
||||
```
|
||||
|
||||
#### 3. 磁盘清理
|
||||
```bash
|
||||
# 清理Docker无用镜像
|
||||
docker system prune -a
|
||||
|
||||
# 清理旧的日志文件
|
||||
sudo find /var/log -name "*.log" -mtime +30 -delete
|
||||
|
||||
# 清理上传的临时文件
|
||||
find uploads/tmp -name "*" -mtime +1 -delete
|
||||
```
|
||||
|
||||
### 监控命令
|
||||
|
||||
#### 系统监控
|
||||
```bash
|
||||
# 查看系统负载
|
||||
htop
|
||||
|
||||
# 查看内存使用
|
||||
free -h
|
||||
|
||||
# 查看磁盘IO
|
||||
iostat -x 1
|
||||
|
||||
# 查看网络连接
|
||||
netstat -tuln
|
||||
```
|
||||
|
||||
#### 应用监控
|
||||
```bash
|
||||
# 查看API响应时间
|
||||
curl -w "@curl-format.txt" -o /dev/null -s "https://api.photography.iriver.top/health"
|
||||
|
||||
# 查看数据库连接数
|
||||
docker-compose exec db psql -U postgres -d photography -c "SELECT count(*) FROM pg_stat_activity;"
|
||||
|
||||
# 查看服务状态
|
||||
docker-compose ps
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📞 联系支持
|
||||
|
||||
### 技术支持
|
||||
- **邮箱**: support@photography.iriver.top
|
||||
- **QQ群**: 123456789
|
||||
- **工作时间**: 周一至周五 9:00-18:00
|
||||
|
||||
### 问题反馈
|
||||
- **GitHub Issues**: https://github.com/iriver/photography/issues
|
||||
- **在线文档**: https://docs.photography.iriver.top
|
||||
- **更新日志**: https://changelog.photography.iriver.top
|
||||
|
||||
### 紧急联系
|
||||
- **运维热线**: 400-XXX-XXXX
|
||||
- **紧急邮箱**: urgent@photography.iriver.top
|
||||
|
||||
---
|
||||
|
||||
## 📝 更新日志
|
||||
|
||||
### v1.0.0 (2025-07-11)
|
||||
- 📖 创建完整的用户使用手册
|
||||
- 🎛️ 详细的管理后台使用指南
|
||||
- 🌐 前端网站使用说明
|
||||
- 🚀 部署运维完整指南
|
||||
- 🔧 故障排查和性能优化指南
|
||||
- 📞 完善的技术支持体系
|
||||
|
||||
---
|
||||
|
||||
*本文档将根据系统更新持续完善，请定期查看最新版本。*
|
||||
94
frontend/.dockerignore
Normal file
94
frontend/.dockerignore
Normal file
@ -0,0 +1,94 @@
|
||||
# Photography Portfolio Frontend .dockerignore
|
||||
# 优化Docker构建上下文，减少镜像大小
|
||||
|
||||
# 依赖
|
||||
node_modules/
|
||||
.npm/
|
||||
.pnpm-store/
|
||||
.yarn/
|
||||
.next/
|
||||
out/
|
||||
|
||||
# 开发工具
|
||||
.vscode/
|
||||
.idea/
|
||||
*.swp
|
||||
*.swo
|
||||
|
||||
# Git相关
|
||||
.git/
|
||||
.gitignore
|
||||
.gitattributes
|
||||
|
||||
# 文档
|
||||
*.md
|
||||
docs/
|
||||
README*
|
||||
CHANGELOG*
|
||||
|
||||
# 环境文件
|
||||
.env
|
||||
.env.local
|
||||
.env.development
|
||||
.env.test
|
||||
.env.production
|
||||
|
||||
# 测试文件
|
||||
__tests__/
|
||||
**/*.test.js
|
||||
**/*.test.jsx
|
||||
**/*.test.ts
|
||||
**/*.test.tsx
|
||||
**/*.spec.js
|
||||
**/*.spec.jsx
|
||||
**/*.spec.ts
|
||||
**/*.spec.tsx
|
||||
coverage/
|
||||
.nyc_output/
|
||||
jest.config.js
|
||||
cypress/
|
||||
|
||||
# 构建输出
|
||||
dist/
|
||||
build/
|
||||
.next/
|
||||
out/
|
||||
|
||||
# 日志文件
|
||||
*.log
|
||||
logs/
|
||||
.npm-debug.log*
|
||||
.yarn-debug.log*
|
||||
.yarn-error.log*
|
||||
|
||||
# 运行时文件
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
.directory
|
||||
|
||||
# TypeScript
|
||||
*.tsbuildinfo
|
||||
|
||||
# ESLint
|
||||
.eslintcache
|
||||
|
||||
# Prettier
|
||||
.prettierignore
|
||||
|
||||
# Storybook
|
||||
.storybook/
|
||||
storybook-static/
|
||||
|
||||
# 临时文件
|
||||
tmp/
|
||||
temp/
|
||||
.tmp/
|
||||
|
||||
# IDE配置
|
||||
.editorconfig
|
||||
.vscode/settings.json
|
||||
|
||||
# 其他
|
||||
.cache/
|
||||
*.tgz
|
||||
*.tar.gz
|
||||
61
frontend/Dockerfile
Normal file
61
frontend/Dockerfile
Normal file
@ -0,0 +1,61 @@
|
||||
# Photography Portfolio Frontend Dockerfile
|
||||
# 多阶段构建，优化镜像大小和性能
|
||||
|
||||
# Stage 1: 构建阶段
|
||||
FROM node:20-alpine AS builder
|
||||
|
||||
# 设置工作目录
|
||||
WORKDIR /app
|
||||
|
||||
# 安装构建依赖
|
||||
RUN apk add --no-cache git
|
||||
|
||||
# 复制package files
|
||||
COPY package*.json ./
|
||||
COPY bun.lockb ./
|
||||
|
||||
# 安装bun (更快的包管理器)
|
||||
RUN npm install -g bun
|
||||
|
||||
# 安装依赖
|
||||
RUN bun install --frozen-lockfile
|
||||
|
||||
# 复制源代码
|
||||
COPY . .
|
||||
|
||||
# 构建应用
|
||||
RUN bun run build
|
||||
|
||||
# Stage 2: Nginx静态服务器
|
||||
FROM nginx:1.25-alpine AS production
|
||||
|
||||
# 安装依赖
|
||||
RUN apk add --no-cache ca-certificates tzdata curl
|
||||
|
||||
# 复制静态文件
|
||||
COPY --from=builder /app/out /usr/share/nginx/html
|
||||
|
||||
# 复制Nginx配置
|
||||
COPY nginx.conf /etc/nginx/nginx.conf
|
||||
COPY default.conf /etc/nginx/conf.d/default.conf
|
||||
|
||||
# 创建日志目录
|
||||
RUN mkdir -p /var/log/nginx
|
||||
|
||||
# 设置权限
|
||||
RUN chown -R nginx:nginx /usr/share/nginx/html && \
|
||||
chown -R nginx:nginx /var/log/nginx && \
|
||||
chmod -R 755 /usr/share/nginx/html
|
||||
|
||||
# 设置时区
|
||||
ENV TZ=Asia/Shanghai
|
||||
|
||||
# 暴露端口
|
||||
EXPOSE 80
|
||||
|
||||
# 健康检查
|
||||
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
|
||||
CMD curl -f http://localhost/ || exit 1
|
||||
|
||||
# 启动Nginx
|
||||
CMD ["nginx", "-g", "daemon off;"]
|
||||
@ -134,3 +134,54 @@ quick: ## 快速启动 (安装依赖并启动开发服务器)
|
||||
@echo "⚡ 快速启动..."
|
||||
make install
|
||||
make dev
|
||||
|
||||
# Docker 相关命令
|
||||
docker-build: ## 构建Docker镜像
|
||||
@echo "🐳 构建Docker镜像..."
|
||||
docker build -t photography-frontend:latest .
|
||||
|
||||
docker-run: ## 运行Docker容器
|
||||
@echo "🚀 运行Docker容器..."
|
||||
docker run -d -p 3000:80 --name photography-frontend photography-frontend:latest
|
||||
|
||||
docker-stop: ## 停止Docker容器
|
||||
@echo "⏹️ 停止Docker容器..."
|
||||
docker stop photography-frontend || true
|
||||
docker rm photography-frontend || true
|
||||
|
||||
docker-logs: ## 查看Docker日志
|
||||
@echo "📋 查看Docker日志..."
|
||||
docker logs -f photography-frontend
|
||||
|
||||
docker-dev: ## 启动Docker开发环境
|
||||
@echo "🛠️ 启动Docker开发环境..."
|
||||
docker-compose up -d
|
||||
|
||||
docker-dev-logs: ## 查看Docker开发环境日志
|
||||
@echo "📋 查看Docker开发环境日志..."
|
||||
docker-compose logs -f
|
||||
|
||||
docker-dev-stop: ## 停止Docker开发环境
|
||||
@echo "⏹️ 停止Docker开发环境..."
|
||||
docker-compose down
|
||||
|
||||
docker-clean: ## 清理Docker资源
|
||||
@echo "🧹 清理Docker资源..."
|
||||
docker system prune -f
|
||||
|
||||
# 生产环境Docker命令
|
||||
docker-prod-build: ## 构建生产Docker镜像
|
||||
@echo "🏭 构建生产Docker镜像..."
|
||||
docker build -t photography-frontend:prod --target production .
|
||||
|
||||
docker-prod-deploy: ## 部署生产环境
|
||||
@echo "🚀 部署生产环境..."
|
||||
docker-compose -f docker-compose.yml --profile proxy up -d
|
||||
|
||||
docker-prod-logs: ## 查看生产环境日志
|
||||
@echo "📋 查看生产环境日志..."
|
||||
docker-compose -f docker-compose.yml logs -f
|
||||
|
||||
docker-prod-stop: ## 停止生产环境
|
||||
@echo "⏹️ 停止生产环境..."
|
||||
docker-compose -f docker-compose.yml down
|
||||
85
frontend/default.conf
Normal file
85
frontend/default.conf
Normal file
@ -0,0 +1,85 @@
|
||||
# Photography Portfolio Frontend - Default Site Configuration
|
||||
# 静态文件服务和缓存策略
|
||||
|
||||
server {
|
||||
listen 80;
|
||||
server_name localhost;
|
||||
root /usr/share/nginx/html;
|
||||
index index.html;
|
||||
|
||||
# 安全配置
|
||||
add_header X-Frame-Options "SAMEORIGIN" always;
|
||||
add_header X-XSS-Protection "1; mode=block" always;
|
||||
add_header X-Content-Type-Options "nosniff" always;
|
||||
add_header Referrer-Policy "no-referrer-when-downgrade" always;
|
||||
|
||||
# 主页面路由
|
||||
location / {
|
||||
try_files $uri $uri/ /index.html;
|
||||
|
||||
# 缓存策略 - HTML文件不缓存
|
||||
add_header Cache-Control "no-cache, no-store, must-revalidate";
|
||||
add_header Pragma "no-cache";
|
||||
add_header Expires "0";
|
||||
}
|
||||
|
||||
# 静态资源缓存策略
|
||||
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
|
||||
expires 1y;
|
||||
add_header Cache-Control "public, immutable";
|
||||
add_header Vary "Accept-Encoding";
|
||||
|
||||
# 跨域配置
|
||||
add_header Access-Control-Allow-Origin "*";
|
||||
add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";
|
||||
add_header Access-Control-Allow-Headers "DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range";
|
||||
}
|
||||
|
||||
# Next.js 静态文件
|
||||
location /_next/static/ {
|
||||
expires 1y;
|
||||
add_header Cache-Control "public, immutable";
|
||||
}
|
||||
|
||||
# API 代理 (如果需要)
|
||||
location /api/ {
|
||||
proxy_pass http://api.photography.iriver.top;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
|
||||
# 超时设置
|
||||
proxy_connect_timeout 30s;
|
||||
proxy_send_timeout 30s;
|
||||
proxy_read_timeout 30s;
|
||||
|
||||
# 缓存配置
|
||||
proxy_cache_bypass $http_upgrade;
|
||||
proxy_no_cache $http_upgrade;
|
||||
}
|
||||
|
||||
# 健康检查
|
||||
location /health {
|
||||
access_log off;
|
||||
return 200 "healthy\n";
|
||||
add_header Content-Type text/plain;
|
||||
}
|
||||
|
||||
# 错误页面
|
||||
error_page 404 /404.html;
|
||||
error_page 500 502 503 504 /50x.html;
|
||||
|
||||
location = /50x.html {
|
||||
root /usr/share/nginx/html;
|
||||
}
|
||||
|
||||
# 安全配置 - 隐藏敏感文件
|
||||
location ~ /\. {
|
||||
deny all;
|
||||
}
|
||||
|
||||
location ~* \.(htaccess|htpasswd|ini|log|sh|sql|conf)$ {
|
||||
deny all;
|
||||
}
|
||||
}
|
||||
115
frontend/docker-compose.yml
Normal file
115
frontend/docker-compose.yml
Normal file
@ -0,0 +1,115 @@
|
||||
# Photography Portfolio Frontend - Docker Compose
|
||||
# 本地开发和测试环境配置
|
||||
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
# 前端应用服务
|
||||
frontend:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile
|
||||
target: production
|
||||
container_name: photography-frontend
|
||||
ports:
|
||||
- "3000:80"
|
||||
environment:
|
||||
# API配置
|
||||
NEXT_PUBLIC_API_URL: ${NEXT_PUBLIC_API_URL:-http://localhost:8080}
|
||||
NEXT_PUBLIC_API_TIMEOUT: ${NEXT_PUBLIC_API_TIMEOUT:-10000}
|
||||
|
||||
# 应用配置
|
||||
NODE_ENV: production
|
||||
NEXT_PUBLIC_APP_NAME: "Photography Portfolio"
|
||||
NEXT_PUBLIC_APP_VERSION: "1.0.0"
|
||||
|
||||
# 功能开关
|
||||
NEXT_PUBLIC_ENABLE_ANALYTICS: ${NEXT_PUBLIC_ENABLE_ANALYTICS:-false}
|
||||
NEXT_PUBLIC_ENABLE_PWA: ${NEXT_PUBLIC_ENABLE_PWA:-true}
|
||||
|
||||
# 上传配置
|
||||
NEXT_PUBLIC_MAX_FILE_SIZE: ${NEXT_PUBLIC_MAX_FILE_SIZE:-10485760}
|
||||
NEXT_PUBLIC_ALLOWED_FILE_TYPES: ${NEXT_PUBLIC_ALLOWED_FILE_TYPES:-image/jpeg,image/png,image/gif,image/webp}
|
||||
networks:
|
||||
- photography-network
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
test: ["CMD", "curl", "-f", "http://localhost/health"]
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
start_period: 10s
|
||||
depends_on:
|
||||
- api
|
||||
labels:
|
||||
- "com.photography.service=frontend"
|
||||
- "com.photography.version=1.0.0"
|
||||
|
||||
# 后端API服务 (用于本地开发)
|
||||
api:
|
||||
image: photography-api:latest
|
||||
container_name: photography-api-dev
|
||||
ports:
|
||||
- "8080:8080"
|
||||
environment:
|
||||
APP_ENV: development
|
||||
CORS_ORIGINS: "http://localhost:3000"
|
||||
networks:
|
||||
- photography-network
|
||||
restart: unless-stopped
|
||||
profiles:
|
||||
- dev
|
||||
|
||||
# 开发环境服务 (热重载)
|
||||
dev:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile
|
||||
target: builder
|
||||
container_name: photography-frontend-dev
|
||||
ports:
|
||||
- "3000:3000"
|
||||
- "3001:3001" # 热重载端口
|
||||
environment:
|
||||
NODE_ENV: development
|
||||
NEXT_PUBLIC_API_URL: http://localhost:8080
|
||||
WATCHPACK_POLLING: true
|
||||
volumes:
|
||||
- .:/app
|
||||
- node_modules:/app/node_modules
|
||||
networks:
|
||||
- photography-network
|
||||
command: bun run dev
|
||||
restart: unless-stopped
|
||||
profiles:
|
||||
- dev
|
||||
|
||||
# Nginx 代理服务 (可选)
|
||||
nginx:
|
||||
image: nginx:1.25-alpine
|
||||
container_name: photography-nginx
|
||||
ports:
|
||||
- "80:80"
|
||||
- "443:443"
|
||||
volumes:
|
||||
- ./nginx.conf:/etc/nginx/nginx.conf:ro
|
||||
- ./default.conf:/etc/nginx/conf.d/default.conf:ro
|
||||
- ssl_certs:/etc/nginx/ssl:ro
|
||||
networks:
|
||||
- photography-network
|
||||
depends_on:
|
||||
- frontend
|
||||
restart: unless-stopped
|
||||
profiles:
|
||||
- proxy
|
||||
|
||||
volumes:
|
||||
node_modules:
|
||||
driver: local
|
||||
ssl_certs:
|
||||
driver: local
|
||||
|
||||
networks:
|
||||
photography-network:
|
||||
driver: bridge
|
||||
external: true
|
||||
66
frontend/nginx.conf
Normal file
66
frontend/nginx.conf
Normal file
@ -0,0 +1,66 @@
|
||||
# Photography Portfolio Frontend - Nginx Configuration
|
||||
# 优化的生产环境配置
|
||||
|
||||
user nginx;
|
||||
worker_processes auto;
|
||||
error_log /var/log/nginx/error.log warn;
|
||||
pid /var/run/nginx.pid;
|
||||
|
||||
events {
|
||||
worker_connections 1024;
|
||||
use epoll;
|
||||
multi_accept on;
|
||||
}
|
||||
|
||||
http {
|
||||
include /etc/nginx/mime.types;
|
||||
default_type application/octet-stream;
|
||||
|
||||
# 日志格式
|
||||
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
|
||||
'$status $body_bytes_sent "$http_referer" '
|
||||
'"$http_user_agent" "$http_x_forwarded_for"';
|
||||
|
||||
access_log /var/log/nginx/access.log main;
|
||||
|
||||
# 基础优化
|
||||
sendfile on;
|
||||
tcp_nopush on;
|
||||
tcp_nodelay on;
|
||||
keepalive_timeout 65;
|
||||
types_hash_max_size 2048;
|
||||
server_tokens off;
|
||||
|
||||
# 压缩配置
|
||||
gzip on;
|
||||
gzip_vary on;
|
||||
gzip_min_length 1024;
|
||||
gzip_proxied any;
|
||||
gzip_comp_level 6;
|
||||
gzip_types
|
||||
application/atom+xml
|
||||
application/javascript
|
||||
application/json
|
||||
application/rss+xml
|
||||
application/vnd.ms-fontobject
|
||||
application/x-font-ttf
|
||||
application/x-web-app-manifest+json
|
||||
application/xhtml+xml
|
||||
application/xml
|
||||
font/opentype
|
||||
image/svg+xml
|
||||
image/x-icon
|
||||
text/css
|
||||
text/plain
|
||||
text/x-component;
|
||||
|
||||
# 安全头部
|
||||
add_header X-Frame-Options "SAMEORIGIN" always;
|
||||
add_header X-XSS-Protection "1; mode=block" always;
|
||||
add_header X-Content-Type-Options "nosniff" always;
|
||||
add_header Referrer-Policy "no-referrer-when-downgrade" always;
|
||||
add_header Content-Security-Policy "default-src 'self' http: https: data: blob: 'unsafe-inline'" always;
|
||||
|
||||
# 包含虚拟主机配置
|
||||
include /etc/nginx/conf.d/*.conf;
|
||||
}
|
||||
Reference in New Issue
Block a user