Skip to main content

🚀 部署快速参考

Docker Compose 部署（推荐）⭐⭐⭐⭐⭐​

快速开始​

# 一键部署
./deploy-docker.sh start

# 访问应用
http://localhost

常用命令​

./deploy-docker.sh start      # 启动服务
./deploy-docker.sh stop       # 停止服务  
./deploy-docker.sh restart    # 重启服务
./deploy-docker.sh logs       # 查看日志
./deploy-docker.sh status     # 查看状态
./deploy-docker.sh update     # 更新部署

Docker Compose 原生命令​

docker compose up -d          # 启动（后台）
docker compose down           # 停止并删除
docker compose ps             # 查看状态
docker compose logs -f        # 实时日志
docker compose build          # 重新构建
docker compose restart        # 重启服务

故障排查​

# 查看日志
docker compose logs frontend
docker compose logs nginx

# 进入容器
docker compose exec frontend sh
docker compose exec nginx sh

# 检查端口
lsof -i :80
lsof -i :3000

Nginx 直接部署​

快速开始​

# 1. 安装依赖
npm install

# 2. 构建项目  
npm run build

# 3. 启动 PM2
pm2 start ecosystem.config.js

# 4. 配置 Nginx（见 NGINX_DEPLOYMENT_GUIDE.md）

PM2 命令​

pm2 start ecosystem.config.js # 启动
pm2 stop pay-unify-frontend  # 停止
pm2 restart pay-unify-frontend # 重启
pm2 reload pay-unify-frontend  # 重载（零停机）
pm2 logs pay-unify-frontend   # 日志
pm2 status                     # 状态
pm2 monit                      # 监控

Nginx 命令​

sudo nginx -t              # 测试配置
sudo nginx -s reload       # 重载配置
sudo systemctl restart nginx  # 重启
sudo systemctl status nginx   # 状态

更新部署​

git pull
npm install
npm run build
pm2 reload pay-unify-frontend

文档导航​

文档说明
NGINX_DEPLOYMENT_GUIDE.md🔧 Nginx 详细指南
VERCEL_DEPLOY_GUIDE.md🚀 Vercel 部署指南
NEXTJS_ENV_GUIDE.md⚙️ 环境变量配置
SIMPLE_ENV_GUIDE.md📝 简易环境配置

推荐流程​

新手入门
   ↓
看 DEPLOYMENT_COMPARISON.md (10分钟) - 了解方案优劣
   ↓
选择 Docker Compose（推荐90%用户）
   ↓
看 DOCKER_DEPLOYMENT_GUIDE.md 快速开始部分 (15分钟)
   ↓
运行 ./deploy-docker.sh start
   ↓
成功部署！🎉

环境变量​

在 docker-compose.yml 中配置：

services:
  frontend:
    environment:
      - NODE_ENV=production
      - NEXT_PUBLIC_API_URL=http://124.222.202.16:8080

或创建 .env.production 文件。

端口说明​

端口服务说明
80NginxHTTP 入口
443NginxHTTPS 入口（如配置）
3000Next.js应用端口（内部）

健康检查​

# 检查 Nginx
curl http://localhost/health

# 检查 Next.js（Docker）
docker compose exec frontend wget -O- http://localhost:3000

# 检查 Next.js（Nginx部署）
curl http://localhost:3000

常见问题速查​

问题解决方案
无法访问检查容器状态: docker compose ps
502 错误检查 Next.js 是否运行: docker compose logs frontend
构建失败清理缓存: docker builder prune -a
端口占用检查占用: lsof -i :80
内存不足查看资源: docker stats

详细故障排查见各自的部署指南。

快速对比​

特性DockerNginx
部署时间5分钟20分钟
学习难度中低
环境一致性⭐⭐⭐⭐⭐⭐⭐⭐
可移植性⭐⭐⭐⭐⭐⭐⭐
性能⭐⭐⭐⭐⭐⭐⭐⭐⭐
推荐度⭐⭐⭐⭐⭐⭐⭐⭐

一句话总结​

  • Docker: 环境一致、部署简单、推荐 90% 用户 ✅
  • Nginx: 性能最优、资源占用少、适合资源受限场景

建议: 如无特殊限制，直接用 Docker！

💡 提示: 将此文件加入书签，方便随时查阅命令！