core 端口统一为 8090(容器内默认 8080 → 8090,与宿主机默认一致)

- 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 均未动。
This commit is contained in:
root
2026-09-15 22:27:36 +08:00
parent 28d5e7080f
commit 2ce94bd86a
7 changed files with 14 additions and 14 deletions
+3 -3
View File
@@ -782,13 +782,13 @@ services:
build: ./app build: ./app
restart: unless-stopped restart: unless-stopped
ports: ports:
- "${AGENT_PORT:-8090}:8080" # 直接映射宿主机端口,IP:端口 访问 - "${AGENT_PORT:-8090}:8090" # 直接映射宿主机端口,IP:端口 访问
volumes: volumes:
- ./tasks:/workspace/tasks # 持久化:任务目录 - ./tasks:/workspace/tasks # 持久化:任务目录
- ./data:/workspace/data # 持久化:数据目录 + SQLite - ./data:/workspace/data # 持久化:数据目录 + SQLite
- ./config.yml:/app/config.yml - ./config.yml:/app/config.yml
environment: environment:
- PORT=8080 - PORT=8090
- AGENT_CONFIG=/app/config.yml - AGENT_CONFIG=/app/config.yml
networks: networks:
- agent-mcp-net - agent-mcp-net
@@ -801,7 +801,7 @@ networks:
### 13.2 对外暴露(IP:端口) ### 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/<id>`——由 AI 在内网 `curl http://agent-core:8081/public-link?path=…` 现签(签发端口不映射宿主机,所以不需要凭据),见 `docs/DEPLOY.md` 第 4.1 节。 **对外只开这一个端口**(executor 与 mcp 服务都不映射宿主机)。其中一条是反向入站:外部服务(如智谱)生成视频前要拉参考图,走的是 core 的匿名短链 `GET /p/<id>`——由 AI 在内网 `curl http://agent-core:8081/public-link?path=…` 现签(签发端口不映射宿主机,所以不需要凭据),见 `docs/DEPLOY.md` 第 4.1 节。
+1 -1
View File
@@ -15,7 +15,7 @@ RUN npm config set registry "$NPM_REGISTRY" \
COPY server ./server COPY server ./server
COPY config.example.yml ./ COPY config.example.yml ./
EXPOSE 8080 EXPOSE 8090
ENV AGENT_CONFIG=/app/config.yml ENV AGENT_CONFIG=/app/config.yml
CMD ["node", "server/server.js"] CMD ["node", "server/server.js"]
+1 -1
View File
@@ -34,7 +34,7 @@ app/
cd app cd app
npm install npm install
cp config.example.yml config.yml # 修改 models(每个模型独立 url/api_key) cp config.example.yml config.yml # 修改 models(每个模型独立 url/api_key)
npm start # http://localhost:8080 npm start # http://localhost:8090
``` ```
## 测试 ## 测试
+1 -1
View File
@@ -5,7 +5,7 @@ const YAML = require('yaml');
const log = require('./log'); const log = require('./log');
const DEFAULTS = { const DEFAULTS = {
port: 8080, port: 8090,
// 数据根目录:db、prompt dump 等运行时产物默认放这里(容器内挂 ./data → /workspace/data)。 // 数据根目录:db、prompt dump 等运行时产物默认放这里(容器内挂 ./data → /workspace/data)。
data_root: './data', data_root: './data',
workspace_root: './data/tasks', workspace_root: './data/tasks',
+3 -3
View File
@@ -4,9 +4,9 @@ services:
container_name: agent-core container_name: agent-core
restart: unless-stopped restart: unless-stopped
ports: ports:
# 无 nginx-proxy:直接把容器 8080 映射到宿主机端口,用 http://<服务器IP>:<AGENT_PORT> 访问。 # 无 nginx-proxy:直接把容器 8090 映射到宿主机端口,用 http://<服务器IP>:<AGENT_PORT> 访问。
# 改端口:在仓库顶层 .env 里设 AGENT_PORT(默认 8090)。 # 改端口:在仓库顶层 .env 里设 AGENT_PORT(默认 8090)。
- "${AGENT_PORT:-8090}:8080" - "${AGENT_PORT:-8090}:8090"
volumes: volumes:
- ./tasks:/workspace/tasks # 持久化:任务目录 - ./tasks:/workspace/tasks # 持久化:任务目录
- ./skills:/workspace/skills # 技能目录:所有任务/会话共享同一份技能 - ./skills:/workspace/skills # 技能目录:所有任务/会话共享同一份技能
@@ -14,7 +14,7 @@ services:
- ./config.yml:/app/config.yml # 允许设置页写配置(写前服务端会校验) - ./config.yml:/app/config.yml # 允许设置页写配置(写前服务端会校验)
- ./app/server:/app/server - ./app/server:/app/server
environment: environment:
- PORT=8080 - PORT=8090
- AGENT_CONFIG=/app/config.yml - AGENT_CONFIG=/app/config.yml
# 加入executor独立服务 # 加入executor独立服务
- EXECUTOR_URL=http://agent-executor:9000 - EXECUTOR_URL=http://agent-executor:9000
+2 -2
View File
@@ -124,7 +124,7 @@ graph LR
- 全部容器同一个网络 `agent-mcp-net`(由本仓库 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 本地直接读、命令在远端写,二者能"看到"彼此产物的根本约定。 - `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 末段带文件名(给安卓下载器猜名),后者刻意不带文件名/会话名。 - **两条公网文件路径分工别搞混**:浏览器原生下载走 `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 该端口。 - **`routes/public-link.js` 只挂在【不映射宿主机】的内网端口上**(`PUBLIC_LINK_PORT`,默认 8081):它不需要凭据(沙箱里的 AI 带不了凭据),所以安全性完全依赖“外部连不上这个端口”。**绝不要**把它挂到对外的 8090 上,也不要 publish 该端口。
- `GET /p/<id>` 是 Core 上唯一的匿名读取入口:安全性 = 22 字符随机 ID + 服务端过期(`public-files.js` 的内存表)。它**必须挂在 `auth.middleware` 之前**,未命中/过期一律 404。签发侧仍要做路径校验(`workspace_root` 前缀 + 会话表 + realpath 复核,挡 `ln -s` 外泄);未配 `public_link.base_url` 则不启动签发端口。 - `GET /p/<id>` 是 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`。 - 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`。 - 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`。 - 加载:`loadConfig(AGENT_CONFIG)` 读文件 → `parseAndValidate`。
- 兼容:旧版 `models[]`(扁平)自动迁移到 `platforms[]` 层级;旧版 `web_search.*` 迁移到 `mcp_servers[]`(log.info 提示)。 - 兼容:旧版 `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)。 - 规范化:`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` 保留注释。 - 读写:`readConfigText` / `writeConfigText`(先校验后写,无原子 rename,因 bind mount 上 rename 会 EBUSY);`applyEditsToText` 用 `YAML.Document` 保留注释。
- `getConfig` 是浅引用,路由层拿到的就是运行中实例,**改完 in-memory 不影响**(要重启)。 - `getConfig` 是浅引用,路由层拿到的就是运行中实例,**改完 in-memory 不影响**(要重启)。
+3 -3
View File
@@ -4,7 +4,7 @@
| 宿主机路径 | 容器内路径 | 说明 | | 宿主机路径 | 容器内路径 | 说明 |
|---|---|---| |---|---|---|
| `./docker-compose.yml` | — | 编排(构建 `./app`,把容器 8080 映射到宿主机 8090) | | `./docker-compose.yml` | — | 编排(构建 `./app`,把容器 8090 映射到宿主机 8090) |
| `./config.yml` | `/app/config.yml` | 运行配置(AGENT_CONFIG 指向它;含密钥,已被 .gitignore 忽略) | | `./config.yml` | `/app/config.yml` | 运行配置(AGENT_CONFIG 指向它;含密钥,已被 .gitignore 忽略) |
| `./tasks/` | `/workspace/tasks` | 任务目录:AI 的文件工作区(与 executor 必须同路径) | | `./tasks/` | `/workspace/tasks` | 任务目录:AI 的文件工作区(与 executor 必须同路径) |
| `./data/` | `/workspace/data` | 数据目录 + SQLite(`.agent.db`) | | `./data/` | `/workspace/data` | 数据目录 + SQLite(`.agent.db`) |
@@ -108,7 +108,7 @@ mcp_servers: # 无域名时按容器名访问(模板
```bash ```bash
# 在仓库顶层(含 docker-compose.yml 的位置)执行 # 在仓库顶层(含 docker-compose.yml 的位置)执行
docker compose up -d --build 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`),跑完自动退出, 首次启动会先跑一次 `agent-executor-init`(把技能依赖落到宿主机 `./skills`),跑完自动退出,
@@ -172,7 +172,7 @@ HTTP 直连时浏览器不认为这是"安全上下文",以下能力自动降
``` ```
location / { location / {
proxy_pass http://agent-core:8080; # 或宿主机 IP:8090 proxy_pass http://agent-core:8090; # 或宿主机 IP:8090
proxy_http_version 1.1; proxy_http_version 1.1;
proxy_buffering off; # SSE 关键 proxy_buffering off; # SSE 关键
proxy_read_timeout 3600s; proxy_read_timeout 3600s;