- 将所有环境变量前缀从NANO_改为BEAVER_ - 更新README.md文档内容,包括项目介绍、组件说明和快速开始指南 - 修改.gitignore文件,添加auth-portal运行时路径排除规则 - 更新app-instance镜像标签从nano/app-instance改为beaver/app-instance - 增强技能安全检查器,支持工具前缀白名单功能 - 添加技能草稿重新检查安全性API端点 - 扩展证据选择器,收集工具调用名称用于技能学习 - 改进技能合成器,基于实际调用的工具生成工具提示 - 优化路由超时处理机制,增加重试逻辑 - 更新后端架构文档,添加可视化入口和基础概念说明 - 实现在WebSocket消息中传递工具迭代次数信息
2.9 KiB
2.9 KiB
deploy-control
部署机接口:
- 给
auth-portal提供实例创建和实例解析 API - 调用
app-instance/create-instance.sh - 在实例创建后刷新
router-proxy
接口
GET /healthzPOST /api/instances/registerPOST /api/instances/resolvePOST /api/instances/configure-providerDELETE /api/instances/{instance_id}
关键环境变量
DEPLOY_CONTROL_API_TOKENDEFAULT_AUTHZ_BASE_URLDEFAULT_AUTHZ_OUTLOOK_MCP_URLDEFAULT_OUTLOOK_MCP_SERVER_IDDEPLOY_PUBLIC_BASE_DOMAINDEPLOY_PUBLIC_PORTDEPLOY_PUBLIC_SCHEMEAPP_INSTANCE_NETWORK_NAME
建议直接参考:
默认实例 URL 形如:
http://<instance-slug>.127.0.0.1.nip.io:8088
实例容器本身的 20000-29999 端口默认只绑定到部署机 127.0.0.1,外部入口应走 router-proxy。
如果你希望所有新实例默认带 Outlook MCP HTTP 工具,可以设置:
DEFAULT_AUTHZ_OUTLOOK_MCP_URL=http://10.6.80.29:8000/mcp
DEFAULT_OUTLOOK_MCP_SERVER_ID=outlook_mcp
这样 deploy-control 创建的新实例会自动写入一条默认 MCP server 配置,并默认使用 oauth_backend_token + mcp:<server_id> 的 audience。
本机启动
cd /home/ivan/xuan/beaver_project/deploy-control
uv run server.py
Docker 启动
如果要容器化运行,需要挂载:
- Docker socket:
/var/run/docker.sock /home/ivan/xuan/beaver_project/app-instance/home/ivan/xuan/beaver_project/router-proxy
并传入对应环境变量,让容器内脚本路径仍能访问这两个目录。
关键点:
- 宿主机路径要原样挂进容器,不要改挂载目标路径
- 同时显式传
APP_INSTANCE_DIR和ROUTER_PROXY_DIR
示例:
docker run -d \
--name beaver-deploy-control \
--restart unless-stopped \
--network beaver-instance-edge \
-p 8090:8090 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /home/ivan/xuan/beaver_project/app-instance:/home/ivan/xuan/beaver_project/app-instance \
-v /home/ivan/xuan/beaver_project/router-proxy:/home/ivan/xuan/beaver_project/router-proxy \
-e APP_INSTANCE_DIR=/home/ivan/xuan/beaver_project/app-instance \
-e ROUTER_PROXY_DIR=/home/ivan/xuan/beaver_project/router-proxy \
-e DEPLOY_CONTROL_API_TOKEN=change-me \
-e APP_INSTANCE_IMAGE=beaver/app-instance:latest \
-e APP_INSTANCE_NETWORK_NAME=beaver-instance-edge \
beaver/deploy-control:latest
如果这里错把宿主机目录映射成容器内的另一个短路径,例如 /app-instance,那么 deploy-control 通过 Docker socket 创建实例时会把错误路径传给 Docker,最终导致实例容器拿不到 config.json 并持续重启。
新实例注册时不会写入模型 provider/API key。注册后由 auth-portal 引导页调用 POST /api/instances/configure-provider,在用户确认后写入该实例配置并重启实例容器。