后端端口分配规范
规划原则
- 起始端口：
20000 起，远离系统端口和常见开发端口（3000、5000、8000、8080 等）
- 百位分段：每个服务域独占一个百位段（
20xxx），单域最多容纳 100 个端口
- 子段细分：每段内部再按功能分层，便于快速定位
全局分配表
| 端口段 |
用途 |
说明 |
20000-20099 |
基础设施 |
Nginx 网关、监控、日志、管理后台等 |
20100-20199 |
用户服务 |
user-service：账号/邮箱的登录、注册、用户管理 |
20200-20999 |
预留扩展 |
未来新增服务域 |
用户服务段（20100-20199）细分
| 子段 |
用途 |
已分配端口 |
20100-20109 |
数据层 |
20101 Postgres、20103 Redis |
20110-20149 |
认证/登录类 |
20111 账号登录、20113 邮箱登录 |
20150-20189 |
注册/管理类 |
20112 账号注册、20114 邮箱注册 |
20190-20199 |
预留/调试 |
预留 |
user-service 端口明细
| 服务名 |
宿主机端口 |
容器端口 |
说明 |
| user-postgres |
20101 |
5432 |
PostgreSQL |
| user-redis |
20103 |
6379 |
Redis 缓存 |
| user-login-account |
20111 |
8080 |
账号密码登录 |
| user-register-account |
20112 |
8080 |
账号注册 |
| user-login-email |
20113 |
8080 |
邮箱密码登录 |
| user-register-email |
20114 |
8080 |
邮箱注册 |
使用方式
- 新增服务前先查表：确认目标服务域的百位段是否还有空余子段
.env 覆盖：docker-compose.yml 中端口使用 ${VAR:-default} 语法，本地冲突时修改 .env，不动 compose 文件- 及时更新本文档：分配新端口后，同步修改上表并提交
示例 .env
