91Writing/DOCKER_DEPLOY.md

Docker 部署指南

本项目支持使用 Docker 进行快速部署，包含开发环境和生产环境的配置。

前置要求

• Docker >= 20.10
• Docker Compose >= 2.0

快速开始

开发环境部署

# 启动开发环境
docker-compose --profile dev up -d

# 查看日志
docker-compose --profile dev logs -f app-dev

# 停止开发环境
docker-compose --profile dev down

开发环境将在 http://localhost:3000 运行，支持热重载。

生产环境部署

# 构建并启动生产环境
docker-compose --profile prod up -d

# 查看日志
docker-compose --profile prod logs -f app-prod

# 停止生产环境
docker-compose --profile prod down

生产环境将在 http://localhost (端口80) 运行。

详细配置

单独使用 Dockerfile

开发环境

# 构建开发镜像
docker build --target development -t 91writing:dev .

# 运行开发容器
docker run -d -p 3000:3000 -v $(pwd):/app -v /app/node_modules --name 91writing-dev 91writing:dev

生产环境

# 构建生产镜像
docker build --target production -t 91writing:prod .

# 运行生产容器
docker run -d -p 80:80 --name 91writing-prod 91writing:prod

故障排查

快速诊断工具

# Windows
scripts\debug.bat

# Linux/Mac
chmod +x scripts/debug.sh
./scripts/debug.sh

查看错误日志

# 查看构建过程错误
docker-compose build --no-cache

# 查看容器启动日志
docker-compose logs

# 实时跟踪日志
docker-compose logs -f

# 前台启动查看详细输出
docker-compose --profile dev up

常见问题

1. 端口被占用

   # 检查端口占用
   netstat -tulpn | grep :3000
   # 修改 docker-compose.yml 中的端口映射
   

2. 构建失败

   # 清理构建缓存
   docker builder prune
   # 重新构建
   docker-compose build --no-cache
   

3. 容器无法启动

   # 查看详细错误信息
   docker-compose logs
   # 检查容器状态
   docker-compose ps
   

4. 权限问题（Linux）

   # 将用户添加到docker组
   sudo usermod -aG docker $USER
   newgrp docker