From 0fe621a0f4d6e98437f9694526b02ea57a81088c Mon Sep 17 00:00:00 2001 From: kicer Date: Tue, 15 Sep 2026 19:17:53 +0800 Subject: [PATCH] =?UTF-8?q?=E9=83=A8=E7=BD=B2=EF=BC=9Amy-app-network=20?= =?UTF-8?q?=E6=94=B9=E4=B8=BA=20agent=20=E4=BE=A7=E8=87=AA=E5=BB=BA?= =?UTF-8?q?=EF=BC=9B=E5=AF=B9=E5=A4=96=E7=AB=AF=E5=8F=A3=E9=BB=98=E8=AE=A4?= =?UTF-8?q?=208090?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docker-compose: my-app-network 由本仓库创建(固定 name + bridge,非 external),mcp 侧 external 直接加入 去掉手动 docker network create;代价是全新机器要【先起 agent 再起 mcp】 - docker-compose / .env.example: 对外端口默认 8080 → 8090(容器内仍监听 8080) - docs/DEPLOY.md: 重写「网络」章节(顺序 + 反向 down 的注意事项);访问地址改 8090 - README.md / docs/ARCHITECTURE.md: 同步网络定义与对外端口 --- .env.example | 4 ++-- README.md | 7 ++++--- docker-compose.yml | 10 ++++++---- docs/ARCHITECTURE.md | 2 +- docs/DEPLOY.md | 24 ++++++++++++++++-------- 5 files changed, 29 insertions(+), 18 deletions(-) diff --git a/.env.example b/.env.example index 549f90f..487284f 100644 --- a/.env.example +++ b/.env.example @@ -2,5 +2,5 @@ # 生成 token:openssl rand -hex 32 EXECUTOR_TOKEN=change-me-openssl-rand-hex-32 -# 选填:agent-core 在宿主机上的端口(默认 8080),改这里就不用改 docker-compose.yml。 -# AGENT_PORT=8080 +# 选填:agent-core 在宿主机上的端口(默认 8090),改这里就不用改 docker-compose.yml。 +# AGENT_PORT=8090 diff --git a/README.md b/README.md index 9cfa55f..7251978 100644 --- a/README.md +++ b/README.md @@ -782,7 +782,7 @@ services: build: ./app restart: unless-stopped ports: - - "${AGENT_PORT:-8080}:8080" # 直接映射宿主机端口,IP:端口 访问 + - "${AGENT_PORT:-8090}:8080" # 直接映射宿主机端口,IP:端口 访问 volumes: - ./tasks:/workspace/tasks # 持久化:任务目录 - ./data:/workspace/data # 持久化:数据目录 + SQLite @@ -795,12 +795,13 @@ services: networks: my-app-network: - external: true + name: my-app-network # 由本仓库创建(固定名字);mcp 侧 external 加入 + driver: bridge ``` ### 13.2 对外暴露(IP:端口) -无域名/反代时,compose 直接把容器 8080 映射到宿主机端口,浏览器访问 `http://<服务器IP>:8080`(端口可用 `.env` 的 `AGENT_PORT` 改)。外部网络 `my-app-network` 与 `mcp` 仓库的服务共用,需先创建一次(`docker network create my-app-network`):agent 按容器名访问 MCP,如 `http://mcp_web_search:3000/`。认证用应用内置的多用户登录(`config.yml` 的 `auth.users`,登录页 `/login`),多用户共享同一任务库,不做任务隔离。 +无域名/反代时,compose 直接把容器 8080 映射到宿主机 8090,浏览器访问 `http://<服务器IP>:8090`(端口可用 `.env` 的 `AGENT_PORT` 改)。外部网络 `my-app-network` 与 `mcp` 仓库的服务共用、由本仓库创建(无需手动 `docker network create`,但因此要**先起 agent 再起 mcp**):agent 按容器名访问 MCP,如 `http://mcp_web_search:3000/`。认证用应用内置的多用户登录(`config.yml` 的 `auth.users`,登录页 `/login`),多用户共享同一任务库,不做任务隔离。 HTTP 直连时浏览器不认为这是“安全上下文”:PWA/Service Worker 不注册、`navigator.clipboard` 降级(前端已有回退),登录 cookie 无 `Secure` 标志可正常工作。日后若加 HTTPS 反代,**SSE 需关代理缓冲**(`proxy_buffering off`),详见 `docs/DEPLOY.md`。 diff --git a/docker-compose.yml b/docker-compose.yml index bf0c30a..0a00d8c 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -5,8 +5,8 @@ services: restart: unless-stopped ports: # 无 nginx-proxy:直接把容器 8080 映射到宿主机端口,用 http://<服务器IP>: 访问。 - # 改端口:在仓库顶层 .env 里设 AGENT_PORT(默认 8080)。 - - "${AGENT_PORT:-8080}:8080" + # 改端口:在仓库顶层 .env 里设 AGENT_PORT(默认 8090)。 + - "${AGENT_PORT:-8090}:8080" volumes: - ./tasks:/workspace/tasks # 持久化:任务目录 - ./skills:/workspace/skills # 技能目录:所有任务/会话共享同一份技能 @@ -122,8 +122,10 @@ services: networks: # 与 mcp 仓库共用:agent-core 按容器名访问 MCP 服务(如 http://mcp_web_search:3000/)。 - # 只需创建一次:docker network create my-app-network + # 网络由本仓库创建(固定名字,避免被加上 compose 项目名前缀);mcp 侧声明为 external 直接加入, + # 所以全新机器上要【先起 agent,再起 mcp】。 my-app-network: - external: true + name: my-app-network + driver: bridge agent-internal: driver: bridge diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 6402d73..0c0d346 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -84,7 +84,7 @@ agent/ ```mermaid graph LR Browser((移动端浏览器
WebView/APK)) - Core[agent-core
宿主机 8080] + Core[agent-core
宿主机 8090] Exec[agent-executor
:9000 内网] MCP[MCP 服务
my-app-network] LLM[LLM 池
OpenAI 兼容] diff --git a/docs/DEPLOY.md b/docs/DEPLOY.md index 1e2b45b..6a22abe 100644 --- a/docs/DEPLOY.md +++ b/docs/DEPLOY.md @@ -4,7 +4,7 @@ | 宿主机路径 | 容器内路径 | 说明 | |---|---|---| -| `./docker-compose.yml` | — | 编排(构建 `./app`,把容器 8080 映射到宿主机端口) | +| `./docker-compose.yml` | — | 编排(构建 `./app`,把容器 8080 映射到宿主机 8090) | | `./config.yml` | `/app/config.yml` | 运行配置(AGENT_CONFIG 指向它;含密钥,已被 .gitignore 忽略) | | `./tasks/` | `/workspace/tasks` | 任务目录:AI 的文件工作区(与 executor 必须同路径) | | `./data/` | `/workspace/data` | 数据目录 + SQLite(`.agent.db`) | @@ -13,16 +13,24 @@ > 本仓库不含 `config.yml` 与 `.env`,需自行创建(见第 2 步)。 -## 1. 创建外部网络(只需一次) +## 1. 网络(自动创建,无需手动) -`agent-core` 与 `mcp` 仓库的服务共用外部网络 `my-app-network`:agent 按容器名访问 MCP -(如 `http://mcp_web_search:3000/`)。两个 compose 都声明为 `external`,所以必须先建: +`agent-core` 与 `mcp` 仓库的服务共用网络 `my-app-network`:agent 按容器名访问 MCP +(如 `http://mcp_web_search:3000/`)。该网络由**本仓库的 compose 创建**(固定名字,不带项目名前缀), +`mcp` 侧声明为 `external` 直接加入。 + +所以全新机器上有**先后顺序**:先起 agent(创建网络),再起 mcp(mcp 单独先起会因为网络不存在而报错)。 ```bash -docker network create my-app-network +# 1) 先 agent,创建网络 +docker compose up -d --build + +# 2) 再 mcp +cd ../mcp && docker compose up -d --build ``` -`docker network ls` 可确认是否已存在(这台机器上跑过 nginx-proxy 的话可能已经存在,跳过即可)。 +> 拆的时候反着来:先 `down` mcp,再 `down` agent。否则 agent 侧会报 +> `network my-app-network has active endpoints`(容器照删、网络留下,重新 up 就恢复,不损数据)。 ## 2. 准备配置 @@ -69,7 +77,7 @@ docker compose logs -f agent-core # 看到 "Agent server listening on 8080" ## 4. 访问 -浏览器打开 **`http://<服务器IP>:8080`**(端口可用 `.env` 里的 `AGENT_PORT` 改)。 +浏览器打开 **`http://<服务器IP>:8090`**(端口可用 `.env` 里的 `AGENT_PORT` 改)。 登录用第 2 步 `auth.users` 里配的账号。 对外只需放行这一个端口:`agent-executor`(9000)只在 `agent-internal` 内网,没有映射到宿主机。 @@ -86,7 +94,7 @@ HTTP 直连时浏览器不认为这是"安全上下文",以下能力自动降 ``` location / { - proxy_pass http://agent-core:8080; # 或宿主机 IP:8080 + proxy_pass http://agent-core:8080; # 或宿主机 IP:8090 proxy_http_version 1.1; proxy_buffering off; # SSE 关键 proxy_read_timeout 3600s;