server/scripts/deploy/README-PORT-CONFIG.md

端口配置说明

📍 统一配置端口

所有端口配置现在统一在 scripts/deploy/deploy-config.sh 文件中管理。

🔧 修改端口

只需修改 scripts/deploy/deploy-config.sh 文件中的端口配置：

# 编辑配置文件
vim scripts/deploy/deploy-config.sh

# 修改这些变量：
export BLUE_PORT="${BLUE_PORT:-3000}"      # 蓝环境端口（宿主机端口）
export GREEN_PORT="${GREEN_PORT:-3001}"    # 绿环境端口（宿主机端口）
export CONTAINER_PORT="${CONTAINER_PORT:-3000}"  # 容器内部端口（应用监听端口）

📝 配置说明

• BLUE_PORT: 蓝环境在宿主机上映射的端口（默认 3000）
• GREEN_PORT: 绿环境在宿主机上映射的端口（默认 3001）
• CONTAINER_PORT: 容器内部应用监听的端口（默认 3000，通常不需要修改）

🔄 使用环境变量覆盖

也可以通过环境变量临时覆盖配置（无需修改文件）：

# 临时使用其他端口
export BLUE_PORT=4000
export GREEN_PORT=4001
./scripts/deploy/docker-blue-green.sh

📋 自动应用范围

修改配置后，以下文件会自动使用新端口：

• ✅ docker-compose.blue.yml - 蓝环境配置
• ✅ docker-compose.green.yml - 绿环境配置
• ✅ scripts/deploy/docker-blue-green.sh - 部署脚本
• ✅ scripts/deploy/rollback.sh - 回滚脚本
• ✅ Nginx 配置更新（如果配置了）

⚠️ 注意事项

1. 容器内部端口 (CONTAINER_PORT) 通常不需要修改，除非应用配置了其他端口
2. 宿主机端口 (BLUE_PORT, GREEN_PORT) 需要确保端口未被占用
3. 修改端口后，如果使用 Nginx，需要更新 Nginx 配置中的 upstream
4. 修改端口后需要重新构建镜像和启动容器

💡 示例

修改为 4000 和 4001

# 编辑配置文件
vim scripts/deploy/deploy-config.sh

# 修改为：
export BLUE_PORT="${BLUE_PORT:-4000}"
export GREEN_PORT="${GREEN_PORT:-4001}"

检查端口是否被占用

# 检查端口是否被占用
netstat -tlnp | grep 4000
netstat -tlnp | grep 4001

# 或使用 ss 命令
ss -tlnp | grep 4000
ss -tlnp | grep 4001