diff --git a/README.md b/README.md index a2c6615..dfa7de6 100644 --- a/README.md +++ b/README.md @@ -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/`——由 AI 在内网 `curl http://agent-core:8081/public-link?path=…` 现签(签发端口不映射宿主机,所以不需要凭据),见 `docs/DEPLOY.md` 第 4.1 节。 diff --git a/app/config.example.yml b/app/config.example.yml index 2f2e4e1..7ec707c 100644 --- a/app/config.example.yml +++ b/app/config.example.yml @@ -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 # 选填,缺省取主机名首段 diff --git a/docker-compose.yml b/docker-compose.yml index ab5bb5c..690f1c2 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -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 diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 136d8a0..a941ab5 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -93,7 +93,7 @@ graph LR Browser((移动端浏览器
WebView/APK)) Core[agent-core
宿主机 8090] Exec[agent-executor
:9000 内网] - MCP[MCP 服务
my-app-network] + MCP[MCP 服务
agent-mcp-net] Zhipu[智谱服务器] LLM[LLM 池
OpenAI 兼容] Tasks[./tasks
任务目录 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/`(匿名,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。前者需要在 URL 末段带文件名(给安卓下载器猜名),后者刻意不带文件名/会话名。 - **`routes/public-link.js` 只挂在【不映射宿主机】的内网端口上**(`PUBLIC_LINK_PORT`,默认 8081):它不需要凭据(沙箱里的 AI 带不了凭据),所以安全性完全依赖“外部连不上这个端口”。**绝不要**把它挂到对外的 8080 上,也不要 publish 该端口。 diff --git a/docs/DEPLOY.md b/docs/DEPLOY.md index bd1e53d..382b364 100644 --- a/docs/DEPLOY.md +++ b/docs/DEPLOY.md @@ -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` 两行取消注释)。 diff --git a/scripts/init.sh b/scripts/init.sh index 18f31c7..9395f1e 100755 --- a/scripts/init.sh +++ b/scripts/init.sh @@ -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