-
Notifications
You must be signed in to change notification settings - Fork 0
Web Console
monkeycode-ai edited this page Jul 1, 2026
·
2 revisions
InboxBridge 启动后会先开放本地 Web 控制台。首次启动时日志会输出 setup token，打开 http://localhost:3000 后使用该 token 设置控制台密码，并在页面中填写 Telegram、保留策略、限流、投递重试和 AI 草稿配置。
默认端口：
WEB_CONSOLE_PORT=3000启动命令：
npm run dev生产环境可先构建再启动：
npm run build
node dist/src/runtime/main.js首次启动日志会包含 setupToken。该 token 只用于初始化控制台密码。设置密码后，后续登录使用控制台密码。
首页 / 展示：
- Bot 当前状态。
- 必填配置完成进度。
- 会话、失败投递、审计和消息搜索的关键指标。
- 配置仪表盘与运维仪表盘入口。
如果 Bot 配置未完成，首页仍可访问，并会提示需要补齐 Bot Token、管理群 ID 和管理员白名单。
配置入口：/config/security
配置按路径分组：
-
/config/security：控制台安全与敏感配置入口。 -
/config/telegram：Bot Token、管理群 ID、管理员 user_id、polling/webhook。 -
/config/runtime：消息内容保留和扫描间隔。 -
/config/retention：默认会话销毁策略和会话销毁扫描间隔。 -
/config/ratelimit：单用户消息限流窗口和数量。 -
/config/delivery：失败投递重试间隔。 -
/config/ai-drafts：OpenAI-compatible AI 草稿配置。
Shell 环境变量优先级高于控制台保存的配置。适合托管平台、PM2 或部署面板覆盖敏感值。
运维入口：/operations
运维页面包括：
-
/operations或/operations/overview：运行状态和关键统计。 -
/operations/conversations：会话列表，可按状态和负责人筛选。 -
/operations/deliveries：投递记录，失败投递可手动加入重试队列。 -
/operations/audit：管理员操作审计，可按管理员和 action 筛选。 -
/operations/search：全局消息搜索。
失败投递进入重试队列后，由投递重试 worker 按配置间隔处理。永久失败记录用于保留事实状态，不参与人工重试。
- Web 控制台默认面向自托管本地使用，公网暴露时请放在可信反向代理、访问控制或内网环境后面。
- 不要在 Wiki、Issue、日志截图中暴露 setup token、控制台密码、Telegram bot token 或 AI API key。
- 备份时重点保存
data/inboxbridge.sqlite，其中包含控制台配置和运行数据。
Workers 环境使用签名 cookie 保存控制台登录状态，不依赖单进程内存 session。部署 Workers 时必须配置：
wrangler secret put WEB_CONSOLE_SESSION_SECRET该 secret 只用于签名控制台 cookie，不应与 Telegram webhook secret、控制台密码或 AI API key 共用。