7.8 KiB
7.8 KiB
项目与端口注册表
本地运行的项目与端口绑定。部署端口（Docker/生产）与 开发端口（pnpm dev / next dev）分离登记，避免多项目开发时都挤在 3000 冲突。 维护：火炬（本地项目启动 Skill）；更新后同步 SKILL 内说明。玩值AI 与卡若AI 共用本表；端口冲突时见下「端口冲突处理」。 本机全部端口统一登记（防 Docker/其他服务重复）：见
运营中枢/工作台/端口登记/SKILL.md（卡若AI 底下，不放在 Cursor）。部署前先查该 Skill。
强制约定：每次项目、端口、启动命令或部署流程有更新/变更时，须同步更新本表（含「注册项目列表」与「版本记录」），使本 doc 始终保持最新。
部署端口 vs 开发端口（隔离说明）
- 部署端口：Docker / 生产环境对外端口，固定不变；见「注册项目列表」部署端口列。
- 开发端口：本地
pnpm dev、next dev等开发时使用的端口；每个项目登记唯一开发端口，不要多个项目都用 3000，避免同时跑多个项目时冲突。 - 本地运行某项目时：优先用该项目的开发端口启动（如
next dev -p 3102、pnpm dev -- -p 3102）；若项目未写死端口，在启动命令里带-p 开发端口。
端口分配与冲突处理
- 原则：什么项目只占什么项目的端口；卡若AI / 玩值AI 登记的网站地址与端口以本表为准。
- 若登记端口被占用：先结束占用该端口的进程，再重新部署到该端口（不改为其他端口）。
- 示例（玩值电竞网站 3001 被占）：
lsof -i :3001查 PID →kill <PID>结束 → 再在神射手目录执行docker compose up -d。
- 示例（玩值电竞网站 3001 被占）：
注册项目列表
| 项目名 | 项目路径 | 部署端口 | 开发端口 | 启动命令 | 备注 |
|---|---|---|---|---|---|
| 玩值电竞App | /Users/karuo/Documents/开发/3、自营项目/玩值电竞App |
3001 | 3001 | pnpm dev |
本机开发 package.json 固定 3001；部署用 Docker |
| 玩值电竞App（Docker 网站） | 已并入 website 编排 | 3001 | — | 神射手目录 docker compose up -d --build |
web 为 website-wanzhi-web；唯一 MongoDB 见《唯一MongoDB约定.md》 |
| 卡若ai网站 | /Users/karuo/Documents/开发/3、自营项目/卡若ai网站/site |
3102 | 3102 | 开发：pnpm dev -- -p 3102；部署：项目根目录 docker compose up -d --build |
开发/部署端口隔离；数据一律用唯一 MongoDB 27017，库名 karuo_site，见唯一MongoDB约定、开发文档 7、数据库/全量MongoDB设计 |
| 神射手 | 开发/2、私域银行/神射手 |
3117 | 3117 | 开发按项目内脚本；部署：神射手目录 docker compose up -d |
与玩值电竞同编排 |
| 存客宝 Web | 开发/2、私域银行/cunkebao_v3 |
3100 | 3100 | 部署：cunkebao_v3 目录 docker compose up -d |
同编排含触客宝+后端+MySQL+Redis |
| 触客宝 Web | 同上 | 3101 | 3101 | 同上 | 同上 |
| 玩值大屏 | 开发/3、自营项目/玩值大屏 |
3034 | 3034 | 项目目录 docker compose up -d |
name: website |
| Soul 创业实验 | 开发/3、自营项目/一场soul的创业实验-react |
3000 | 3002 | 开发：pnpm dev -- -p 3002（避免与其它占 3000 的冲突）；部署：项目目录 docker compose up -d |
部署用 3000 时注意仅此项目；开发建议 3002 |
| OpenClaw 网关 | 已并入 website 编排 | 18789 / 18790 | — | 神射手目录 docker compose up -d（镜像需在 OpenClaw 项目内先 build：openclaw:local） |
容器名 website-openclaw-gateway；配置见 开发/8、小工具/Docker项目/OpenClaw/openclaw/.env |
| n8n | 已并入 website 编排 | 5678 | — | 神射手目录 docker compose up -d |
容器名 website-n8n；工作流自动化，访问 http://localhost:5678 |
| 艾叶 IM Bridge | 卡若AI/运营中枢/scripts/aiye_im_bridge |
18900 | 18900 | bash start.sh 或 python main.py |
多平台 IM 网关（微信/企业微信/飞书/WhatsApp/网页→卡若AI） |
| 卡若AI 网关 | 卡若AI/运营中枢/scripts/karuo_ai_gateway |
18080 | 18080 | bash start_local_gateway.sh |
卡若AI HTTP API 网关 |
使用方式
- 启动某项目：说「本地运行 玩值电竞App」「本地运行 卡若ai网站」等 → 走「本地项目启动」Skill，按上表开发端口与启动命令执行（避免都用 3000）。
- 新增/修改绑定：在本表增改一行，部署端口与开发端口都填；开发端口与其它项目错开，dev 脚本用
-p 开发端口（如 Next.js：next dev -p 3102），再在 Skill 中补一句说明即可。 - Docker 网站：玩值电竞 web、OpenClaw 网关已并入 website 编排（与神射手同组），容器名分别为
website-wanzhi-web、website-openclaw-gateway，端口 3001、18789/18790；唯一 MongoDB 为 datacenter_mongodb（27017），见工作台唯一MongoDB约定.md。所有归入 website 的 Docker 网站项目（神射手、玩值电竞、OpenClaw、卡若ai网站、玩值大屏、Soul 创业实验等）见website分组清单.md。 - Docker 部署时：须遵守「唯一 MongoDB」与「容器分组」约定，执行前见 本地项目启动 Skill 内「Docker 部署约定」一节。
- Docker 跑本地最新：每次本地更新代码/内容后，要让 Docker 内跑的是最新文件，须在对应编排目录执行
docker compose up -d --build（如 website 在神射手目录）。否则容器内仍是旧镜像。所有项目一律如此。 - 玩值电竞 部署/运行/访问：一律用 Docker 访问，不用 pnpm dev。访问用 http://localhost:3001，数据库用唯一 wanzhi_esports（datacenter_mongodb 27017）；启动、部署在神射手目录
docker compose up -d --build（更新后须带--build以同步本地最新）。回答此类问题时须用卡若复盘格式回复。 - 玩值电竞 专注清单与番茄钟：卡若AI 参与玩值电竞开发或文档管理时，须将本次工作时间以番茄钟形式记入本机专注清单（
/Applications/WebPomodoro.app，轻松清单）的「玩值电竞」任务下对应板块，并更新项目内 玩值开发文档/10、项目管理/玩值电竞_专注清单与番茄钟配置.md 的番茄钟汇总；任务结构见该文档。
版本记录
| 日期 | 变更 |
|---|---|
| 2026-02-26 | 初始版本；玩值电竞App 绑定 3001 |
| 2026-02-26 | 玩值电竞 专注清单与番茄钟约定：卡若AI 开发时把工作时间以番茄钟记入 WebPomodoro |
| 2026-02-26 | Docker 跑本地最新：更新后须 up -d --build；所有项目一致；注册表与 Skill 同步 |
| 2026-02-26 | 约定：每次项目/端口/启动或部署有变更时，须同步更新本表，保持本 doc 最新 |
| 2026-02-27 | Docker 网站项目统一归入 website 分组，全量清单见 website分组清单.md |
| 2026-03-01 | 部署端口与开发端口隔离：表头拆为部署端口/开发端口，各项目登记开发端口，避免多项目同用 3000 冲突；卡若ai网站/Soul 等开发用登记端口 |
| 2026-03-01 | 卡若ai网站：数据一律用唯一 MongoDB 27017、库名 karuo_site，不再单独起 27018；全量库设计见项目内 开发文档/7、数据库/全量MongoDB设计_官网与控制台.md |
| 2026-03-01 | OpenClaw 网关迁入 website 编排，容器名 website-openclaw-gateway，端口 18789/18790；启动同神射手目录 |
| 2026-03-04 | n8n 归入 website 编排，容器名 website-n8n，端口 5678；神射手目录启动 |
| 2026-03-13 | 新增 艾叶 IM Bridge（端口 18900）：多平台 IM 网关；卡若AI网关（端口 18080）补登记 |