部署:my-app-network 改为 agent 侧自建;对外端口默认 8090

- 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: 同步网络定义与对外端口
This commit is contained in:
2026-09-15 19:17:53 +08:00
parent 906e502b62
commit 0fe621a0f4
5 changed files with 29 additions and 18 deletions
+2 -2
View File
@@ -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
+4 -3
View File
@@ -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`。
+6 -4
View File
@@ -5,8 +5,8 @@ services:
restart: unless-stopped
ports:
# 无 nginx-proxy:直接把容器 8080 映射到宿主机端口,用 http://<服务器IP>:<AGENT_PORT> 访问。
# 改端口:在仓库顶层 .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
+1 -1
View File
@@ -84,7 +84,7 @@ agent/
```mermaid
graph LR
Browser((移动端浏览器<br/>WebView/APK))
Core[agent-core<br/>宿主机 8080]
Core[agent-core<br/>宿主机 8090]
Exec[agent-executor<br/>:9000 内网]
MCP[MCP 服务<br/>my-app-network]
LLM[LLM 池<br/>OpenAI 兼容]
+16 -8
View File
@@ -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;