59 lines
2.8 KiB
Markdown
59 lines
2.8 KiB
Markdown
# Hermes Glass UI · 个人版
|
||
|
||
## 启动
|
||
- `待补充`
|
||
|
||
## 部署事实
|
||
- 平台：Hetzner VPS `76.13.31.179` + Coolify Traefik + Incus LXC `hermes-personal` + Docker `hermes-agent`
|
||
- 发布状态：已部署
|
||
- 主站 / 前端：https://hermes.kang-kang.com
|
||
- API / 后端：同域 `/api/v1` 转发到 LXC `hermes-personal` 内的 `hermes-agent:8642`
|
||
- 飞书桥接：已部署 systemd `hermes-feishu-bridge.service`，宿主 `127.0.0.1:8787`
|
||
- 飞书事件回调：https://hermes.kang-kang.com/feishu/events
|
||
- 飞书事件回调（`cli_a97764e101b95be9`）：https://hermes.kang-kang.com/feishu/events/cli_a97764e101b95be9
|
||
- 飞书主动通知：https://hermes.kang-kang.com/feishu/notify
|
||
- 文档 / 解析：https://styles.kang-kang.com
|
||
- 管理后台：待定
|
||
- 代码仓：https://git.kang-kang.com/kangwan/hermes-glass-ui-personal
|
||
|
||
## 快捷登录
|
||
- 登录地址：https://hermes.kang-kang.com
|
||
- 用户名：kang
|
||
- 密码：elErZOoJ35ywNlq222UTQnm3IbN9pv24
|
||
- 说明：这里只写项目专属网页登录；数据库密码、API Key、服务器 root 密码不要写这里
|
||
|
||
## 元数据回写清单
|
||
- 新增或变更公网地址后，必须同步更新 `.project.json.urls`
|
||
- 如果有网页后台登录：
|
||
- 可直接入库：写 `.project.json.quick_login`
|
||
- 不应入库：写 `.project.json.credentials` 引用
|
||
- 部署完成后，`RULES.md` 和 `.project.json` 必须同一次任务一起更新
|
||
|
||
## 环境变量
|
||
- 飞书桥接服务：
|
||
- `FEISHU_APP_ID`
|
||
- `FEISHU_APP_SECRET`（敏感，不入库）
|
||
- `FEISHU_APP_ID_2`
|
||
- `FEISHU_APP_SECRET_2`（敏感，不入库）
|
||
- `FEISHU_VERIFICATION_TOKEN`（可选，建议配置）
|
||
- `FEISHU_VERIFICATION_TOKEN_2`（可选，建议配置）
|
||
- `FEISHU_DEFAULT_RECEIVE_ID` / `FEISHU_DEFAULT_RECEIVE_ID_TYPE`（主动通知默认目标）
|
||
- `FEISHU_DEFAULT_RECEIVE_ID_2` / `FEISHU_DEFAULT_RECEIVE_ID_TYPE_2`（第二应用主动通知默认目标）
|
||
- `FEISHU_DEFAULT_APP_ID`
|
||
- `FEISHU_NOTIFY_TOKEN`（主动通知内部鉴权，敏感，不入库）
|
||
- `HERMES_API_BASE`
|
||
- `HERMES_API_KEY`（敏感，不入库）
|
||
- `HERMES_MODEL`
|
||
|
||
## 规则
|
||
- 不允许编造不存在的部署域名、账号、密码
|
||
- 没有公网地址时，`.project.json.urls` 保持空数组
|
||
- 任何部署或域名变化，都要先改元数据，再视为任务完成
|
||
|
||
## 注意事项
|
||
- 飞书 App Secret、Hermes API key、主动通知 token 只能放部署环境或忽略的 secrets 文件，不允许写入跟踪文件
|
||
- 线上飞书桥接环境：`/etc/hermes-feishu-bridge.env`，mode 600
|
||
- 飞书后台配置所需回调 URL、verification token、notify token 备份：`/root/hermes-feishu-bridge.tokens`，mode 600
|
||
- 当前飞书桥接版本按明文事件回调处理；如果飞书后台开启事件加密，需要先补充解密支持
|
||
- 主站有 cookie 门禁；nginx 已对 `/feishu/` 单独放行并反代到飞书桥接服务
|