From 2ce94bd86a33777016994816e8da616805170736 Mon Sep 17 00:00:00 2001 From: root Date: Tue, 15 Sep 2026 22:27:36 +0800 Subject: [PATCH] =?UTF-8?q?core=20=E7=AB=AF=E5=8F=A3=E7=BB=9F=E4=B8=80?= =?UTF-8?q?=E4=B8=BA=208090=EF=BC=88=E5=AE=B9=E5=99=A8=E5=86=85=E9=BB=98?= =?UTF-8?q?=E8=AE=A4=208080=20=E2=86=92=208090=EF=BC=8C=E4=B8=8E=E5=AE=BF?= =?UTF-8?q?=E4=B8=BB=E6=9C=BA=E9=BB=98=E8=AE=A4=E4=B8=80=E8=87=B4=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - app/server/config.js:DEFAULTS.port 8080 → 8090 - app/Dockerfile:EXPOSE 8090 - docker-compose.yml:PORT=8090;ports 映射改为 "${AGENT_PORT:-8090}:8090" - 文档同步(README / docs/DEPLOY / docs/ARCHITECTURE / app/README) public-link 的内网签发端口 8081、executor 9000 均未动。 --- README.md | 6 +++--- app/Dockerfile | 2 +- app/README.md | 2 +- app/server/config.js | 2 +- docker-compose.yml | 6 +++--- docs/ARCHITECTURE.md | 4 ++-- docs/DEPLOY.md | 6 +++--- 7 files changed, 14 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index dfa7de6..2bcd784 100644 --- a/README.md +++ b/README.md @@ -782,13 +782,13 @@ services: build: ./app restart: unless-stopped ports: - - "${AGENT_PORT:-8090}:8080" # 直接映射宿主机端口,IP:端口 访问 + - "${AGENT_PORT:-8090}:8090" # 直接映射宿主机端口,IP:端口 访问 volumes: - ./tasks:/workspace/tasks # 持久化:任务目录 - ./data:/workspace/data # 持久化:数据目录 + SQLite - ./config.yml:/app/config.yml environment: - - PORT=8080 + - PORT=8090 - AGENT_CONFIG=/app/config.yml networks: - agent-mcp-net @@ -801,7 +801,7 @@ networks: ### 13.2 对外暴露(IP:端口) -无域名/反代时,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`),多用户共享同一任务库,不做任务隔离。 +无域名/反代时,compose 直接把容器 8090 映射到宿主机 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/Dockerfile b/app/Dockerfile index f1bee0d..d71ad9e 100644 --- a/app/Dockerfile +++ b/app/Dockerfile @@ -15,7 +15,7 @@ RUN npm config set registry "$NPM_REGISTRY" \ COPY server ./server COPY config.example.yml ./ -EXPOSE 8080 +EXPOSE 8090 ENV AGENT_CONFIG=/app/config.yml CMD ["node", "server/server.js"] diff --git a/app/README.md b/app/README.md index c48c9a2..befd927 100644 --- a/app/README.md +++ b/app/README.md @@ -34,7 +34,7 @@ app/ cd app npm install cp config.example.yml config.yml # 修改 models(每个模型独立 url/api_key) -npm start # http://localhost:8080 +npm start # http://localhost:8090 ``` ## 测试 diff --git a/app/server/config.js b/app/server/config.js index de225fb..0bab7bb 100644 --- a/app/server/config.js +++ b/app/server/config.js @@ -5,7 +5,7 @@ const YAML = require('yaml'); const log = require('./log'); const DEFAULTS = { - port: 8080, + port: 8090, // 数据根目录:db、prompt dump 等运行时产物默认放这里(容器内挂 ./data → /workspace/data)。 data_root: './data', workspace_root: './data/tasks', diff --git a/docker-compose.yml b/docker-compose.yml index 690f1c2..cc7c12a 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -4,9 +4,9 @@ services: container_name: agent-core restart: unless-stopped ports: - # 无 nginx-proxy:直接把容器 8080 映射到宿主机端口,用 http://<服务器IP>: 访问。 + # 无 nginx-proxy:直接把容器 8090 映射到宿主机端口,用 http://<服务器IP>: 访问。 # 改端口:在仓库顶层 .env 里设 AGENT_PORT(默认 8090)。 - - "${AGENT_PORT:-8090}:8080" + - "${AGENT_PORT:-8090}:8090" volumes: - ./tasks:/workspace/tasks # 持久化:任务目录 - ./skills:/workspace/skills # 技能目录:所有任务/会话共享同一份技能 @@ -14,7 +14,7 @@ services: - ./config.yml:/app/config.yml # 允许设置页写配置(写前服务端会校验) - ./app/server:/app/server environment: - - PORT=8080 + - PORT=8090 - AGENT_CONFIG=/app/config.yml # 加入executor独立服务 - EXECUTOR_URL=http://agent-executor:9000 diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index a941ab5..555cfb4 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -124,7 +124,7 @@ graph LR - 全部容器同一个网络 `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 该端口。 +- **`routes/public-link.js` 只挂在【不映射宿主机】的内网端口上**(`PUBLIC_LINK_PORT`,默认 8081):它不需要凭据(沙箱里的 AI 带不了凭据),所以安全性完全依赖“外部连不上这个端口”。**绝不要**把它挂到对外的 8090 上,也不要 publish 该端口。 - `GET /p/` 是 Core 上唯一的匿名读取入口:安全性 = 22 字符随机 ID + 服务端过期(`public-files.js` 的内存表)。它**必须挂在 `auth.middleware` 之前**,未命中/过期一律 404。签发侧仍要做路径校验(`workspace_root` 前缀 + 会话表 + realpath 复核,挡 `ln -s` 外泄);未配 `public_link.base_url` 则不启动签发端口。 - nginx-proxy 前置时**必须 `proxy_buffering off`**,否则 SSE 流被缓冲。详见 `docs/DEPLOY.md`。 - Core 通过环境变量 `EXECUTOR_URL` / `EXECUTOR_TOKEN` 注入 executor 端点(也可用 `config.yml` 的 `executor` 段覆盖)。**token 从 `.env` 读取**(compose 变量替换 `${EXECUTOR_TOKEN:?...}`,未设置直接报错,杜绝静默无鉴权);`.env` 已 gitignore,模板见 `.env.example`,生成:`openssl rand -hex 32`。 @@ -323,7 +323,7 @@ stateDiagram-v2 - 加载:`loadConfig(AGENT_CONFIG)` 读文件 → `parseAndValidate`。 - 兼容:旧版 `models[]`(扁平)自动迁移到 `platforms[]` 层级;旧版 `web_search.*` 迁移到 `mcp_servers[]`(log.info 提示)。 - 规范化:`normalizePlatforms` 校验 `name/url/type`,key 层 `concurrency`,model 层 `{id, display_name, vision, enable, extra_params, thinking_params}`;同平台内 model id 必须唯一(内部唯一键 = 平台名/模型id)。 -- 默认值(`DEFAULTS`):port=8080、log_level=info、terminal default 30s/10K、agent temperature=1.0、max_tool_iterations=20、max_retries=2、model_hold 3min/30min/10s、上传 1.5MB 阈值/2000px/0.85。 +- 默认值(`DEFAULTS`):port=8090、log_level=info、terminal default 30s/10K、agent temperature=1.0、max_tool_iterations=20、max_retries=2、model_hold 3min/30min/10s、上传 1.5MB 阈值/2000px/0.85。 - 读写:`readConfigText` / `writeConfigText`(先校验后写,无原子 rename,因 bind mount 上 rename 会 EBUSY);`applyEditsToText` 用 `YAML.Document` 保留注释。 - `getConfig` 是浅引用,路由层拿到的就是运行中实例,**改完 in-memory 不影响**(要重启)。 diff --git a/docs/DEPLOY.md b/docs/DEPLOY.md index 382b364..176102d 100644 --- a/docs/DEPLOY.md +++ b/docs/DEPLOY.md @@ -4,7 +4,7 @@ | 宿主机路径 | 容器内路径 | 说明 | |---|---|---| -| `./docker-compose.yml` | — | 编排(构建 `./app`,把容器 8080 映射到宿主机 8090) | +| `./docker-compose.yml` | — | 编排(构建 `./app`,把容器 8090 映射到宿主机 8090) | | `./config.yml` | `/app/config.yml` | 运行配置(AGENT_CONFIG 指向它;含密钥,已被 .gitignore 忽略) | | `./tasks/` | `/workspace/tasks` | 任务目录:AI 的文件工作区(与 executor 必须同路径) | | `./data/` | `/workspace/data` | 数据目录 + SQLite(`.agent.db`) | @@ -108,7 +108,7 @@ mcp_servers: # 无域名时按容器名访问(模板 ```bash # 在仓库顶层(含 docker-compose.yml 的位置)执行 docker compose up -d --build -docker compose logs -f agent-core # 看到 "Agent server listening on 8080" 即成功 +docker compose logs -f agent-core # 看到 "Agent server listening on 8090" 即成功 ``` 首次启动会先跑一次 `agent-executor-init`(把技能依赖落到宿主机 `./skills`),跑完自动退出, @@ -172,7 +172,7 @@ HTTP 直连时浏览器不认为这是"安全上下文",以下能力自动降 ``` location / { - proxy_pass http://agent-core:8080; # 或宿主机 IP:8090 + proxy_pass http://agent-core:8090; # 或宿主机 IP:8090 proxy_http_version 1.1; proxy_buffering off; # SSE 关键 proxy_read_timeout 3600s;