Files
server/scripts/deploy/README-PORT-CONFIG.md
T
2026-01-16 15:49:34 +08:00

80 lines
2.1 KiB
Markdown

# 端口配置说明
## 📍 统一配置端口
所有端口配置现在统一在 **`scripts/deploy/deploy-config.sh`** 文件中管理。
## 🔧 修改端口
只需修改 `scripts/deploy/deploy-config.sh` 文件中的端口配置:
```bash
# 编辑配置文件
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,通常不需要修改)
## 🔄 使用环境变量覆盖
也可以通过环境变量临时覆盖配置(无需修改文件):
```bash
# 临时使用其他端口
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
```bash
# 编辑配置文件
vim scripts/deploy/deploy-config.sh
# 修改为:
export BLUE_PORT="${BLUE_PORT:-4000}"
export GREEN_PORT="${GREEN_PORT:-4001}"
```
### 检查端口是否被占用
```bash
# 检查端口是否被占用
netstat -tlnp | grep 4000
netstat -tlnp | grep 4001
# 或使用 ss 命令
ss -tlnp | grep 4000
ss -tlnp | grep 4001
```