59 lines
2.6 KiB
Markdown
59 lines
2.6 KiB
Markdown
# 部署说明(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. 准备配置
|
||
|
||
```bash
|
||
cp app/config.example.yml config.yml
|
||
vi config.yml # 至少改 models(每个模型独立 url/api_key)
|
||
```
|
||
|
||
> 容器内运行时 `workspace_root` 写 `/workspace/tasks`(docker-compose.yml 已把 `./data` 挂到这里)。
|
||
> 本仓库 git 只跟踪示例 `app/config.example.yml`,真正的 `config.yml` 在顶层且被忽略,密钥不会进库。
|
||
|
||
## 2. 构建并启动
|
||
|
||
```bash
|
||
# 在仓库顶层(含 docker-compose.yml 的位置)执行
|
||
docker compose up -d --build
|
||
docker compose logs -f # 看到 "Agent server listening on 8080" 即成功
|
||
```
|
||
|
||
## 3. nginx-proxy 对外暴露(agent.ai.foresh.com)
|
||
|
||
compose 已通过 `VIRTUAL_HOST` / `VIRTUAL_PORT` / `CERT_NAME` 接入 nginx-proxy:
|
||
|
||
- 前置的 nginx-proxy 容器必须与业务容器共用同一个外部网络 `my-app-network`(compose 声明为 external),并监听 80/443。
|
||
- 域名 `agent.ai.foresh.com` 的 DNS 指向 nginx-proxy 所在宿主机。
|
||
- 若你的 nginx-proxy 未默认关闭代理缓冲,需额外配置 `proxy_buffering off`——**SSE 必须关缓冲**,否则流式输出会被攒住不发。可给 nginx-proxy 挂一个自定义 conf:
|
||
```
|
||
server {
|
||
listen 80;
|
||
server_name agent.ai.foresh.com;
|
||
location / {
|
||
proxy_pass http://agent:8080;
|
||
proxy_http_version 1.1;
|
||
proxy_buffering off; # SSE 关键
|
||
proxy_read_timeout 3600s;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
}
|
||
}
|
||
```
|
||
- 认证建议直接在 `config.yml` 配置多用户登录(`auth.users`,见 config.example.yml 注释):登录页 `/login`,会话 token 走 HttpOnly cookie。不建议再用 nginx-proxy 的 htpasswd basic auth:手机浏览器原生下载不会携带 Basic 认证头,会导致下载失败;cookie 则会自动携带。若迁移到内置登录,记得去掉 nginx 上对应的 htpasswd 配置。
|
||
|
||
## 4. 升级流程
|
||
|
||
```bash
|
||
git pull
|
||
docker compose up -d --build # 仓库顶层执行
|
||
```
|
||
|
||
数据库与任务目录都在 volume 内,升级不丢数据。进程重启时,原 active 会话会自动退回排队队列,待模型空闲后继续。 |