本地部署:顶层 docker-compose/config,域名 agent.ai.foresh.com(nginx-proxy VIRTUAL_HOST + external my-app-network,仅内网 expose 8080,config 只读挂载);配置后缀统一 .yaml→.yml(文件与全部引用,含 Dockerfile/AGENT_CONFIG/config.js/smoke)。smoke 25/25 通过

This commit is contained in:
2026-08-31 08:42:16 +08:00
parent cef9f815f7
commit b816efc23f
12 changed files with 92 additions and 86 deletions
+2 -1
View File
@@ -2,7 +2,8 @@
/zed_agent/ /zed_agent/
node_modules/ node_modules/
app/test/tmp/ app/test/tmp/
app/config.yaml app/config.yml
/config.yml
app/data/ app/data/
data/ data/
*.log *.log
+22 -12
View File
@@ -20,7 +20,7 @@
### 2.1 模型池配置 ### 2.1 模型池配置
配置文件(如 `config.yaml`)中定义模型列表: 配置文件(如 `config.yml`)中定义模型列表:
```yaml ```yaml
models: models:
@@ -954,25 +954,35 @@ function runAgent(session):
## 十三、Docker 部署 ## 十三、Docker 部署
### 13.1 Docker Compose 示例 ### 13.1 Docker Compose(顶层 `docker-compose.yml`)
```yaml ```yaml
services: services:
agent: agent:
build: . build: ./app
ports:
- "8080:8080"
volumes:
- ./data:/workspace/tasks
- ./config.yaml:/app/config.yaml
environment:
- AGENT_CONFIG=/app/config.yaml
restart: unless-stopped restart: unless-stopped
expose:
- "8080" # 仅内网暴露,由 nginx-proxy 对外
volumes:
- ./data:/workspace/tasks # 持久化:任务目录 + SQLite
- ./config.yml:/app/config.yml:ro
environment:
- PORT=8080
- AGENT_CONFIG=/app/config.yml
- VIRTUAL_HOST=agent.ai.foresh.com
- VIRTUAL_PORT=8080
- CERT_NAME=default
networks:
- my-app-network
networks:
my-app-network:
external: true
``` ```
### 13.2 nginx-proxy basic auth ### 13.2 nginx-proxy 对外暴露
前置 nginx-proxy,配置 basic auth,多个用户共享同一认证,不做任务隔离。 前置的 nginx-proxy 需与业务容器共用外部网络 `my-app-network`。compose 通过 `VIRTUAL_HOST`/`VIRTUAL_PORT`/`CERT_NAME` 接入;域名 `agent.ai.foresh.com` 的 DNS 指向 nginx-proxy 所在宿主机。多个用户共享同一认证,不做任务隔离;SSE 需关代理缓冲(`proxy_buffering off`),见 `docs/DEPLOY.md`。
--- ---
+2 -2
View File
@@ -11,9 +11,9 @@ COPY package.json package-lock.json ./
RUN npm install --omit=dev --no-audit --no-fund RUN npm install --omit=dev --no-audit --no-fund
COPY server ./server COPY server ./server
COPY config.example.yaml ./ COPY config.example.yml ./
EXPOSE 8080 EXPOSE 8080
ENV AGENT_CONFIG=/app/config.yaml ENV AGENT_CONFIG=/app/config.yml
CMD ["node", "server/server.js"] CMD ["node", "server/server.js"]
+3 -3
View File
@@ -8,7 +8,7 @@
app/ app/
├── server/ ├── server/
│ ├── server.js # 入口:装配配置/DB/总线/路由/静态资源 │ ├── server.js # 入口:装配配置/DB/总线/路由/静态资源
│ ├── config.js # config.yaml 加载与校验 │ ├── config.js # config.yml 加载与校验
│ ├── db.js # SQLite(better-sqlite3,WAL) │ ├── db.js # SQLite(better-sqlite3,WAL)
│ ├── engine.js # 会话管理 + 模型池 FIFO 调度 + Agent 主循环 │ ├── engine.js # 会话管理 + 模型池 FIFO 调度 + Agent 主循环
│ ├── llm.js # OpenAI 兼容上游流式调用(SSE 解析/工具分片合并) │ ├── llm.js # OpenAI 兼容上游流式调用(SSE 解析/工具分片合并)
@@ -24,7 +24,7 @@ app/
│ └── public/ # H5 前端(Vanilla JS + SSE) │ └── public/ # H5 前端(Vanilla JS + SSE)
├── test/ # mock 上游 + 端到端冒烟测试 ├── test/ # mock 上游 + 端到端冒烟测试
├── scripts(在上层仓库根目录)gen-from-readme.js # README → 提示词/工具 schema ├── scripts(在上层仓库根目录)gen-from-readme.js # README → 提示词/工具 schema
├── config.example.yaml ├── config.example.yml
├── Dockerfile / docker-compose.yml ├── Dockerfile / docker-compose.yml
``` ```
@@ -33,7 +33,7 @@ app/
```bash ```bash
cd app cd app
npm install npm install
cp config.example.yaml config.yaml # 修改 upstream_url / models cp config.example.yml config.yml # 修改 upstream_url / models
npm start # http://localhost:8080 npm start # http://localhost:8080
``` ```
@@ -1,5 +1,5 @@
# 自用通用 Agent 系统配置示例 # 自用通用 Agent 系统配置示例
# 复制为 config.yaml 后按需修改;容器内通过 AGENT_CONFIG 指定路径。 # 复制为 config.yml 后按需修改;容器内通过 AGENT_CONFIG 指定路径。
# 模型池:多个 ID 共用同一个上游 URL(cli-proxy-api 按 ID 路由到不同账号)。 # 模型池:多个 ID 共用同一个上游 URL(cli-proxy-api 按 ID 路由到不同账号)。
# 同时活跃会话数上限 = 模型数量。 # 同时活跃会话数上限 = 模型数量。
-11
View File
@@ -1,11 +0,0 @@
services:
agent:
build: .
ports:
- "8080:8080"
volumes:
- ./data:/workspace/tasks
- ./config.yaml:/app/config.yaml:ro
environment:
- AGENT_CONFIG=/app/config.yaml
restart: unless-stopped
+2 -2
View File
@@ -1,4 +1,4 @@
// 配置加载:AGENT_CONFIG 指向 config.yaml(见 config.example.yaml) // 配置加载:AGENT_CONFIG 指向 config.yml(见 config.example.yml)
const fs = require('fs'); const fs = require('fs');
const path = require('path'); const path = require('path');
const YAML = require('yaml'); const YAML = require('yaml');
@@ -33,7 +33,7 @@ function deepMerge(base, extra) {
} }
function loadConfig(configPath) { function loadConfig(configPath) {
const p = configPath || process.env.AGENT_CONFIG || path.join(__dirname, '..', 'config.yaml'); const p = configPath || process.env.AGENT_CONFIG || path.join(__dirname, '..', 'config.yml');
let raw = {}; let raw = {};
if (fs.existsSync(p)) { if (fs.existsSync(p)) {
raw = YAML.parse(fs.readFileSync(p, 'utf8')) || {}; raw = YAML.parse(fs.readFileSync(p, 'utf8')) || {};
+1 -1
View File
@@ -619,7 +619,7 @@ function strip(s) { return s.replace(/<[^>]+>/g, ''); }
// web_search:调用内网 MCP 服务(JSON-RPC over HTTP,无状态,响应为 SSE 帧包裹的 JSON)。 // web_search:调用内网 MCP 服务(JSON-RPC over HTTP,无状态,响应为 SSE 帧包裹的 JSON)。
async function toolWebSearch(ctx, args) { async function toolWebSearch(ctx, args) {
const ws = ctx.cfg.web_search || {}; const ws = ctx.cfg.web_search || {};
if (!ws.url) return 'web_search 未配置:请在 config.yaml 的 web_search.url 中填写 MCP 服务地址'; if (!ws.url) return 'web_search 未配置:请在 config.yml 的 web_search.url 中填写 MCP 服务地址';
const query = args.query; const query = args.query;
if (!query) return 'web_search 缺少参数 query'; if (!query) return 'web_search 缺少参数 query';
const callId = Date.now(); const callId = Date.now();
+1 -1
View File
@@ -46,7 +46,7 @@ async function main() {
const mock = spawn('node', [path.join(ROOT, 'test/mock-upstream.js')], { stdio: 'inherit' }); const mock = spawn('node', [path.join(ROOT, 'test/mock-upstream.js')], { stdio: 'inherit' });
const server = spawn('node', [path.join(ROOT, 'server/server.js')], { const server = spawn('node', [path.join(ROOT, 'server/server.js')], {
cwd: ROOT, cwd: ROOT,
env: Object.assign({}, process.env, { AGENT_CONFIG: path.join(ROOT, 'test/config.test.yaml') }), env: Object.assign({}, process.env, { AGENT_CONFIG: path.join(ROOT, 'test/config.test.yml') }),
stdio: ['ignore', 'pipe', 'pipe'], stdio: ['ignore', 'pipe', 'pipe'],
}); });
let serverLog = ''; let serverLog = '';
+21
View File
@@ -0,0 +1,21 @@
services:
agent:
build: ./app
restart: unless-stopped
expose:
- "8080" # 仅内网暴露,由 nginx-proxy 对外
volumes:
- ./data:/workspace/tasks # 持久化:任务目录 + SQLite(.agent.db 在此目录内)
- ./config.yml:/app/config.yml:ro
environment:
- PORT=8080
- AGENT_CONFIG=/app/config.yml
- VIRTUAL_HOST=agent.ai.foresh.com
- VIRTUAL_PORT=8080
- CERT_NAME=default
networks:
- my-app-network
networks:
my-app-network:
external: true
+25 -40
View File
@@ -1,74 +1,59 @@
# 部署说明(Docker + nginx-proxy basic auth) # 部署说明(Docker + nginx-proxy,域名 agent.ai.foresh.com)
配置与编排文件都放在**仓库顶层**,方便直接调整:
| 宿主机路径 | 容器内路径 | 说明 |
|---|---|---|
| `./docker-compose.yml` | — | 编排(构建 `./app`,仅内网 expose 8080) |
| `./config.yml` | `/app/config.yml` | 运行配置(AGENT_CONFIG 指向它;含密钥,已被 .gitignore 忽略) |
| `./data/` | `/workspace/tasks` | 任务目录 + SQLite(`.agent.db` 在此目录内) |
## 1. 准备配置 ## 1. 准备配置
```bash ```bash
cd app cp app/config.example.yml config.yml
cp config.example.yaml config.yaml vi config.yml # 至少改 upstream_url 与 models
vi config.yaml # 至少改 upstream_url 与 models
``` ```
容器内运行时约定(docker-compose.yml 已按此挂载): > 容器内运行时 `workspace_root` 写 `/workspace/tasks`(docker-compose.yml 已把 `./data` 挂到这里)。
> 本仓库 git 只跟踪示例 `app/config.example.yml`,真正的 `config.yml` 在顶层且被忽略,密钥不会进库。
| 宿主机路径 | 容器内路径 | 说明 |
|---|---|---|
| `./config.yaml` | `/app/config.yaml` | 运行配置(AGENT_CONFIG 指向它) |
| `./data/` | `/workspace/tasks` | 任务目录 + SQLite(`.agent.db` 在此目录内) |
> 注意:容器内运行时 `workspace_root` 请写 `/workspace/tasks`(宿主机直接运行则用默认 `./data/tasks` 即可)。
## 2. 构建并启动 ## 2. 构建并启动
```bash ```bash
cd app # 在仓库顶层(含 docker-compose.yml 的位置)执行
docker compose up -d --build docker compose up -d --build
docker compose logs -f # 看到 "Agent server listening on 8080" 即成功 docker compose logs -f # 看到 "Agent server listening on 8080" 即成功
``` ```
## 3. nginx-proxy + basic auth ## 3. nginx-proxy 对外暴露(agent.ai.foresh.com)
多用户共享一套认证,不做任务隔离(见 README 8.1)。 compose 已通过 `VIRTUAL_HOST` / `VIRTUAL_PORT` / `CERT_NAME` 接入 nginx-proxy:
生成密码文件(需 apache2-utils 提供的 htpasswd): - 前置的 nginx-proxy 容器必须与业务容器共用同一个外部网络 `my-app-network`(compose 声明为 external),并监听 80/443。
- 域名 `agent.ai.foresh.com` 的 DNS 指向 nginx-proxy 所在宿主机。
```bash - 若你的 nginx-proxy 未默认关闭代理缓冲,需额外配置 `proxy_buffering off`——**SSE 必须关缓冲**,否则流式输出会被攒住不发。可给 nginx-proxy 挂一个自定义 conf:
apt-get install apache2-utils # 或任何能生成 htpasswd 的方式
htpasswd -c ./deploy/.htpasswd admin
htpasswd ./deploy/.htpasswd user2
``` ```
nginx 站点配置:
```nginx
server { server {
listen 80; listen 80;
server_name agent.example.com; server_name agent.ai.foresh.com;
location / { location / {
auth_basic "Agent";
auth_basic_user_file /etc/nginx/.htpasswd;
proxy_pass http://agent:8080; proxy_pass http://agent:8080;
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;
proxy_set_header Host $host; proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Real-IP $remote_addr;
} }
} }
``` ```
- 认证交给 nginx-proxy(htpasswd)或在此 config 里启用内置 `auth`(见 config.example.yml 注释),二选一即可。
> SSE 关键点:`proxy_buffering off`,否则流式输出会被 nginx 攒着不发。
若不想用 nginx,也可直接启用内置认证:在 `config.yaml` 里配置
`auth: {user: admin, password: ...}`(仅适合纯内网测试;上游仍建议 nginx TLS)。
## 4. 升级流程 ## 4. 升级流程
```bash ```bash
git pull git pull
cd app && docker compose up -d --build docker compose up -d --build # 仓库顶层执行
``` ```
数据库与任务目录都在 volume 内,升级不丢数据。进程重启时,原 active 会话 数据库与任务目录都在 volume 内,升级不丢数据。进程重启时,原 active 会话会自动退回排队队列,待模型空闲后继续。
会自动退回排队队列,待模型空闲后继续。