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:
@@ -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
@@ -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
@@ -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
|
||||||
```
|
```
|
||||||
|
|
||||||
## 测试
|
## 测试
|
||||||
|
|||||||
@@ -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
@@ -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
|
||||||
|
|||||||
@@ -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
@@ -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;
|
||||||
|
|||||||
Reference in New Issue
Block a user