mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-22 03:42:02 +00:00
README 与部署说明:应用(怎么生成、能做哪几类、视图与印章、流程与待办、写外部系统、入站钩子、按新口径补算、升级安全)、身份与权限(三种登录方式、会话、找回、角色与授权、使用者的问数据、遮罩的边界)、能力登记与端点、助手按需查看;默认不开登录的说法、核心能力表、数据目录与遮罩、节点类型、安全边界、检查项(33 项另加 check-auth)、从旧版本升级;部署配置模板加登录一节
This commit is contained in:
+11
-3
@@ -88,6 +88,10 @@ cp ../agentlab-<旧版本>-linux-__AGENTLAB_ARCH__/agentlab.env . # 沿用原
|
||||
新容器没通过健康检查时,原来的容器会保留为 `agentlab-previous`,屏幕上会打印回退命令。
|
||||
旧镜像也留着,确认新版本没问题后可以 `docker rmi agentlab:<旧版本>` 删掉。
|
||||
|
||||
从没有「应用」的版本升上来时,新版本第一次启动会自动整理一遍(都只做一次,重复启动不改东西):存量的待审批补建成
|
||||
待办;自定义工具的请求头、MCP 的环境变量里的明文加密;记级别之前发布过、有正式运行凭据的老版本补记为已发布;
|
||||
指向本机或内网的 http MCP 服务自动登记成开了内网访问的端点并绑定。升级前照常备份数据目录。
|
||||
|
||||
## 查看状态和日志
|
||||
|
||||
```bash
|
||||
@@ -115,11 +119,15 @@ cp ../agentlab-<旧版本>-linux-__AGENTLAB_ARCH__/agentlab.env . # 沿用原
|
||||
|
||||
## 安全提示
|
||||
|
||||
- **AgentLab 没有登录。** 同一网络里打得开页面的人都能用它:跑工作流、花你配的模型额度、
|
||||
读你接入的数据源、在沙箱里执行代码。只在信得过的网络里开。
|
||||
- **默认不开登录。** 不开登录时,同一网络里打得开页面的人都能用它:跑工作流、花你配的模型额度、
|
||||
读你接入的数据源、在沙箱里执行代码,审批记的是各自填的署名、未经核实。只在信得过的网络里这样用。
|
||||
多人使用请开登录:`agentlab.env` 里设 `AGENTLAB_AUTH_MODE=local`(账号密码)或 `oidc`(单点登录),
|
||||
`./deploy.sh install` 生效,第一次打开登录页时建第一个管理员。角色、权限和遮罩的边界见仓库 README 的「身份与权限」。
|
||||
- 忘了管理员密码:`docker exec -it agentlab python -m app.auth reset-admin`(不给 `--password` 时随机生成并打印一次)。
|
||||
- 用防火墙限制能访问端口的来源。注意 Docker 发布的端口会绕过 ufw 的默认规则,要么把 `BIND_ADDR`
|
||||
设成具体网卡的地址或 `127.0.0.1`,要么在 `DOCKER-USER` 链里加规则。
|
||||
- 需要多人使用时,把 `BIND_ADDR` 改成 `127.0.0.1`,前面另配一个带登录的反向代理。
|
||||
- 放在反向代理后面时,设 `AGENTLAB_PUBLIC_URL` 为对外地址(OIDC 回调和来源核对按它认);代理终结了 https 的,
|
||||
设 `AGENTLAB_AUTH_COOKIE_SECURE=true`。
|
||||
- API Key 加密存在数据目录里,密钥也在数据目录里:数据目录的备份要和 Key 一样保管好。
|
||||
|
||||
## 代码沙箱
|
||||
|
||||
+16
-3
@@ -13,11 +13,24 @@
|
||||
HOST_PORT=8000
|
||||
# 监听哪个地址。0.0.0.0 表示所有网卡,同一网络里的电脑、手机都能打开。
|
||||
#
|
||||
# 注意:AgentLab 没有登录。同一网络里打得开页面的人都能用它——跑工作流、花你配的模型额度、
|
||||
# 读你接入的数据源、在沙箱里执行代码。只在信得过的网络里开,并用防火墙限制来源。
|
||||
# 只给本机用(比如另配反向代理做登录),改成 127.0.0.1。
|
||||
# 注意:默认不开登录(见下面的「登录」一节)。不开登录时,同一网络里打得开页面的人都能用它——跑工作流、
|
||||
# 花你配的模型额度、读你接入的数据源、在沙箱里执行代码,审批记的是各自填的署名、未经核实。
|
||||
# 这种情况下只在信得过的网络里开,并用防火墙限制来源;多人使用请开登录。只给本机用,改成 127.0.0.1。
|
||||
BIND_ADDR=0.0.0.0
|
||||
|
||||
# ---- 登录(可选)----
|
||||
# off(默认,不开登录)| local(账号密码)| oidc(通用 OIDC 单点登录)。设了这一项就以它为准,界面上「设置 → 身份」
|
||||
# 不能再改登录方式。local:第一次打开登录页时建第一个管理员(只在还没有管理员时可用);oidc 的身份提供方地址、
|
||||
# 客户端、管理员映射在「设置 → 身份」里配。忘了密码:docker exec -it agentlab python -m app.auth reset-admin
|
||||
# AGENTLAB_AUTH_MODE=local
|
||||
# 对外的地址(在反向代理后面时填):OIDC 的回调地址按它拼,非 GET 请求的 Origin 核对也认它
|
||||
# AGENTLAB_PUBLIC_URL=https://agentlab.example.internal
|
||||
# 会话:闲置多少小时、最长多少天过期
|
||||
# AGENTLAB_AUTH_SESSION_IDLE_HOURS=12
|
||||
# AGENTLAB_AUTH_SESSION_MAX_DAYS=7
|
||||
# 会话 cookie 是否带 Secure:留空按请求是不是 https 决定;反向代理终结了 https 时填 true
|
||||
# AGENTLAB_AUTH_COOKIE_SECURE=
|
||||
|
||||
# ---- 数据 ----
|
||||
# 数据目录:数据库、执行断点、上传的文件、沙箱工作区,还有加密密钥 .secret_key 都在这里。
|
||||
# 要备份的就是这个目录(丢了 .secret_key,存进去的 API Key 就解不开了)。
|
||||
|
||||
Reference in New Issue
Block a user