网络改名:my-app-network → agent-mcp-net(纯改名,其余不变)

This commit is contained in:
root
2026-09-15 22:23:39 +08:00
parent 295756b798
commit 28d5e7080f
6 changed files with 18 additions and 18 deletions
+4 -4
View File
@@ -791,17 +791,17 @@ services:
- PORT=8080
- AGENT_CONFIG=/app/config.yml
networks:
- my-app-network
- agent-mcp-net
networks:
my-app-network:
name: my-app-network # 由本仓库创建(固定名字);mcp 侧 external 加入
agent-mcp-net:
name: agent-mcp-net # 由本仓库创建(固定名字);mcp 侧 external 加入
driver: bridge
```
### 13.2 对外暴露(IP:端口)
无域名/反代时,compose 直接把容器 8080 映射到宿主机 8090,浏览器访问 `http://<服务器IP>:8090`(端口可用 `.env` 的 `AGENT_PORT` 改)。网络 `my-app-network` 与 `mcp` 仓库的服务共用、由本仓库创建(无需手动 `docker network create`,但因此要**先起 agent 再起 mcp**):core 与 executor 都靠它按容器名访问 MCP。认证用应用内置的多用户登录(`config.yml` 的 `auth.users`,登录页 `/login`),多用户共享同一任务库,不做任务隔离。
无域名/反代时,compose 直接把容器 8080 映射到宿主机 8090,浏览器访问 `http://<服务器IP>:8090`(端口可用 `.env` 的 `AGENT_PORT` 改)。网络 `agent-mcp-net` 与 `mcp` 仓库的服务共用、由本仓库创建(无需手动 `docker network create`,但因此要**先起 agent 再起 mcp**):core 与 executor 都靠它按容器名访问 MCP。认证用应用内置的多用户登录(`config.yml` 的 `auth.users`,登录页 `/login`),多用户共享同一任务库,不做任务隔离。
**对外只开这一个端口**(executor 与 mcp 服务都不映射宿主机)。其中一条是反向入站:外部服务(如智谱)生成视频前要拉参考图,走的是 core 的匿名短链 `GET /p/<id>`——由 AI 在内网 `curl http://agent-core:8081/public-link?path=…` 现签(签发端口不映射宿主机,所以不需要凭据),见 `docs/DEPLOY.md` 第 4.1 节。
+1 -1
View File
@@ -129,7 +129,7 @@ model_hold:
# enable 选填、默认 true;设为 false 时启动不加载该服务的工具(配置保留,改回 true 重启即恢复)。
# 服务不可用时只在启动日志告警,不影响其他服务与内置工具。
#
# 无域名部署:agent-core 与 mcp 仓库的容器共用 my-app-network,这里直接写【容器名:容器内端口】,
# 无域名部署:agent-core 与 mcp 仓库的容器共用 agent-mcp-net,这里直接写【容器名:容器内端口】,
# 别写宿主机映射端口。日后改回域名/反代时,换成对应 https 地址即可。
mcp_servers:
- name: web-search # 选填,缺省取主机名首段
+5 -5
View File
@@ -22,7 +22,7 @@ services:
# 未设置则 compose 直接报错,避免静默无鉴权。生成:openssl rand -hex 32
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example}
networks:
- my-app-network
- agent-mcp-net
# 技能准备(一次性,跑完退出):把各技能的“运行期可变”依赖落到宿主 ./skills——
# requirements.txt → pip --target 共享 deps 目录;install.sh → 技能资产(如字体提取)。
@@ -48,7 +48,7 @@ services:
- PYTHONDONTWRITEBYTECODE=1
- TZ=Asia/Shanghai
networks:
- my-app-network
- agent-mcp-net
agent-executor:
# M' = M + 技能系统层依赖(executor/Dockerfile 的 skills 阶段)。
@@ -117,7 +117,7 @@ services:
- /run
networks:
- my-app-network
- agent-mcp-net
networks:
# 全部服务共用一个网络;由本仓库创建(固定名字,避免被加上 compose 项目名前缀),mcp 侧声明为
@@ -125,6 +125,6 @@ networks:
# - core 与 executor 靠它按容器名访问 MCP 服务(如 http://mcp_web_search:3000/)
# - executor 靠它 curl core 的内网签发入口(http://agent-core:8081/public-link),
# 把本地图片换成一个短命的公网链接给外部服务用(不经过公网、不搬字节)
my-app-network:
name: my-app-network
agent-mcp-net:
name: agent-mcp-net
driver: bridge
+3 -3
View File
@@ -93,7 +93,7 @@ graph LR
Browser((移动端浏览器<br/>WebView/APK))
Core[agent-core<br/>宿主机 8090]
Exec[agent-executor<br/>:9000 内网]
MCP[MCP 服务<br/>my-app-network]
MCP[MCP 服务<br/>agent-mcp-net]
Zhipu[智谱服务器]
LLM[LLM 池<br/>OpenAI 兼容]
Tasks[./tasks<br/>任务目录 bind mount]
@@ -114,14 +114,14 @@ graph LR
Core --> DB
```
所有容器都在同一个 `my-app-network` 上(core 与 executor 同时靠它访问 MCP);外网只暴露 Core
所有容器都在同一个 `agent-mcp-net` 上(core 与 executor 同时靠它访问 MCP);外网只暴露 Core
(宿主机端口映射)。注意其中一条**反向**的入站链路:外部服务(如智谱)来拉文件时,走的是 Core 的
`GET /p/<id>`(匿名,22 字符随机 ID + 服务端过期,见 `routes/public-files.js`);这个 id 由内网
签发入口 `GET /public-link` 现签,所以链接里既没有会话名也没有文件名。
**关键约束**(改 compose 时务必保持):
- 全部容器同一个网络 `my-app-network`(由本仓库 compose 创建,mcp 侧 external 加入)——core 与 executor 都靠它按容器名访问 MCP 服务(executor 还要靠它 curl core 的签发入口)。
- 全部容器同一个网络 `agent-mcp-net`(由本仓库 compose 创建,mcp 侧 external 加入)——core 与 executor 都靠它按容器名访问 MCP 服务(executor 还要靠它 curl core 的签发入口)。
- `agent-core` 与 `agent-executor` 须把**同一份宿主机 `./tasks`、`./skills`**挂到相同的容器路径(默认 `/workspace/tasks`、`/workspace/skills`)。这是文件工具在 Core 本地直接读、命令在远端写,二者能"看到"彼此产物的根本约定。
- **两条公网文件路径分工别搞混**:浏览器原生下载走 `download-token.js` 的签名链接(前端用 `download-token` 接口换 URL,`auth.js` 的 `isSignedDownload` 放行 `?t=`);外部服务取文件走 `GET /p/<id>` 短 ID。前者需要在 URL 末段带文件名(给安卓下载器猜名),后者刻意不带文件名/会话名。
- **`routes/public-link.js` 只挂在【不映射宿主机】的内网端口上**(`PUBLIC_LINK_PORT`,默认 8081):它不需要凭据(沙箱里的 AI 带不了凭据),所以安全性完全依赖“外部连不上这个端口”。**绝不要**把它挂到对外的 8080 上,也不要 publish 该端口。
+3 -3
View File
@@ -50,7 +50,7 @@ MCP_DIR=/path/to/mcp ./scripts/init.sh
## 1. 网络(自动创建,无需手动)
`agent-core` 与 `mcp` 仓库的服务共用网络 `my-app-network`:agent 按容器名访问 MCP
`agent-core` 与 `mcp` 仓库的服务共用网络 `agent-mcp-net`:agent 按容器名访问 MCP
(如 `http://mcp_web_search:3000/`)。该网络由**本仓库的 compose 创建**(固定名字,不带项目名前缀),
`mcp` 侧声明为 `external` 直接加入。
@@ -65,7 +65,7 @@ cd ../mcp && docker compose up -d --build
```
> 拆的时候反着来:先 `down` mcp,再 `down` agent。否则 agent 侧会报
> `network my-app-network has active endpoints`(容器照删、网络留下,重新 up 就恢复,不损数据)。
> `network agent-mcp-net has active endpoints`(容器照删、网络留下,重新 up 就恢复,不损数据)。
## 2. 准备配置(手动方式)
@@ -123,7 +123,7 @@ docker compose logs -f agent-core # 看到 "Agent server listening on 8080"
浏览器打开 **`http://<服务器IP>:8090`**(端口可用 `.env` 里的 `AGENT_PORT` 改)。
登录用第 2 步 `auth.users` 里配的账号。
**对外只需要放行这一个端口**:`agent-executor`(9000)和 mcp 的三个服务都只在 `my-app-network`
**对外只需要放行这一个端口**:`agent-executor`(9000)和 mcp 的三个服务都只在 `agent-mcp-net`
内网,没有映射到宿主机(需要从宿主机 curl 调试时,去 mcp 仓库的 `docker-compose.yml` 里临时
把对应服务的 `ports` 两行取消注释)。
+2 -2
View File
@@ -248,7 +248,7 @@ info "配置来源: $CONFIG_SOURCE"
info "平台: ${enabled_plats[*]:-无};智谱 MCP: $([ -n "$ZHIPU_KEY" ] && echo 启用 || echo 未配置)"
# ============================================================
# 3. 起服务(顺序:agent 先起,它创建 my-app-network)
# 3. 起服务(顺序:agent 先起,它创建 agent-mcp-net)
# ============================================================
if [ "$UP" != "1" ]; then
log "UP=$UP:只生成配置,不起服务"
@@ -261,7 +261,7 @@ else
( cd "$MCP_DIR" && docker compose up -d --build )
# MCP 工具只在 agent-core【启动时】发现一次(app/server/mcp.js 的 init,不重试),
# 而 agent 必须先起(它创建 my-app-network),所以这里重启一次让 agent 发现已就绪的 mcp 服务。
# 而 agent 必须先起(它创建 agent-mcp-net),所以这里重启一次让 agent 发现已就绪的 mcp 服务。
info "重启 agent-core 以发现 MCP 工具……"
docker compose restart agent-core >/dev/null
sleep 3