docs: 新增统一端口分配清单文档 (#798) #841

Merged

xiaoxia merged 1 commits from docs/ci-port-inventory into develop 2026-07-24 21:29:32 +08:00

Conversation 2 Commits 1 Files Changed 1

+140

xiaoxia commented 2026-07-24 20:24:06 +08:00

Owner

Copy Link

Copy Source

背景

#798 - 建立统一端口分配清单文档（P2）

内容

梳理代码中所有服务/容器使用的端口，形成统一文档。

涵盖范围

• 应用服务端口：API(8000) / Web(80) / Worker(无端口)
• 基础设施端口：PostgreSQL / Redis / Registry
• CI/DevOps端口：ChatOps Webhook(8090) / Staging SSH(22222) / Preview环境
• 开发环境默认端口：.env.example 中全部端口变量
• CI Workflow 中的端口变量：ci-pipeline.yml + ci_env.sh
• 命名规范：推荐统一 {服务}_PORT 格式，列出待统一项
• 相关配置文件路径索引

关键数据

服务	容器内	Staging宿主机	Production宿主机
API	8000	8000	8001
Web	80	3001	3002
PG	5432	5434	5433
Redis	6379	6381	6380

变更

• 新增 docs/PORTS.md - 端口分配清单文档

验证

• ✅ 纯文档新增，不影响业务代码
• ✅ 不涉及 CI 流程变更

## 背景 #798 - 建立统一端口分配清单文档（P2） ## 内容 梳理代码中所有服务/容器使用的端口，形成统一文档。 ### 涵盖范围 - **应用服务端口**：API(8000) / Web(80) / Worker(无端口) - **基础设施端口**：PostgreSQL / Redis / Registry - **CI/DevOps端口**：ChatOps Webhook(8090) / Staging SSH(22222) / Preview环境 - **开发环境默认端口**：.env.example 中全部端口变量 - **CI Workflow 中的端口变量**：ci-pipeline.yml + ci_env.sh - **命名规范**：推荐统一 `{服务}_PORT` 格式，列出待统一项 - **相关配置文件路径索引** ### 关键数据 | 服务 | 容器内 | Staging宿主机 | Production宿主机 | |------|--------|--------------|-----------------| | API | 8000 | 8000 | 8001 | | Web | 80 | 3001 | 3002 | | PG | 5432 | 5434 | 5433 | | Redis | 6379 | 6381 | 6380 | ## 变更 - 新增 `docs/PORTS.md` - 端口分配清单文档 ## 验证 - ✅ 纯文档新增，不影响业务代码 - ✅ 不涉及 CI 流程变更

xiaoxia self-assigned this 2026-07-24 20:24:06 +08:00

xiaoxia added 1 commit 2026-07-24 20:24:06 +08:00

docs: 新增统一端口分配清单文档 (#798) ... edc9c50268

梳理所有服务/容器/CI环境的端口分配，形成统一参考文档。
涵盖API/Web/PG/Redis/Registry/ChatOps等全部端口。

auto-approve-bot commented 2026-07-24 20:31:57 +08:00

Collaborator

Copy Link

Copy Source

代码审查结果 - PR #841

⚠️ 问题（2个需要修改）

1. docs/PORTS.md 第6行：文档更新时间显示为 2026-07-24，属于未来时间。这通常是年份笔误，会导致文档时效性信息混乱。
2. docs/PORTS.md 第56行：硬编码了具体的内网 IP 地址 172.30.18.198。如果该仓库为公开或半公开状态，直接暴露内网架构细节属于信息泄露风险。建议使用占位符（如 ${GITEA_INTERNAL_IP} 或 gitea-registry.internal）代替。

💡 建议（0个可选）

---

✅ 格式检查通过 | ❌ 逻辑审查需修改 | ✅ 建议关注性能

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-07-24 12:31:57 | 模型:}

## 代码审查结果 - PR #841 ### ⚠️ 问题（2个需要修改） 1. **docs/PORTS.md 第6行**：文档更新时间显示为 `2026-07-24`，属于未来时间。这通常是年份笔误，会导致文档时效性信息混乱。 2. **docs/PORTS.md 第56行**：硬编码了具体的内网 IP 地址 `172.30.18.198`。如果该仓库为公开或半公开状态，直接暴露内网架构细节属于信息泄露风险。建议使用占位符（如 `${GITEA_INTERNAL_IP}` 或 `gitea-registry.internal`）代替。 ### 💡 建议（0个可选） --- ✅ 格式检查通过 | ❌ 逻辑审查需修改 | ✅ 建议关注性能 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-07-24 12:31:57 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia merged commit c9c7da0c74 into develop 2026-07-24 21:29:32 +08:00

xiaoxia deleted branch docs/ci-port-inventory 2026-07-24 21:29:32 +08:00

gitea-actions bot commented 2026-07-24 21:31:49 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #841 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #841 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

xiaoxia referenced this pull request 2026-07-24 22:02:33 +08:00

chore(ci): P2端口收尾同步到main分支 (#798 #799) #853

xiaoxia referenced this issue from a commit 2026-07-24 22:02:34 +08:00

docs: 新增统一端口分配清单文档 (#798) (#841)

xiaoxia referenced this pull request 2026-07-24 23:54:53 +08:00

[CI] 稳定性全面根治：DooD改造 + 常驻PG + 重试机制 + 非核心降级 #619

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees xiaoxia

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#841