Telegram Bot 远程管理
v2.1.0 起，TG 机器人开放给所有用户：每个账号配置自己的 Bot，机器人只能操作该账号自己的隧道、DNS 与域名绑定，用户之间完全隔离。管理员旧版全局 Bot 会在服务启动时自动迁移为管理员的个人 Bot，无需重新配置。
开始使用
- 在 Telegram 与 @BotFather 对话，发送
/newbot创建自己的 Bot，拿到 Token - 与 @userinfobot 对话获取自己的数字 TG ID
- 打开面板左侧「TG 机器人」页面，填写 Bot Token 与「授权 TG ID」（允许向该 Bot 发送指令的 TG 账号，可多个，逗号分隔）并启用
发送 /help 可查看全部指令。
运行模式
每个账号的 Bot 可选两种运行模式：
- 长轮询（默认）：Bot 主动向 Telegram 拉取消息，无需公网回调地址，适合没有公网入口的面板。
- Webhook：Telegram 把消息实时推送到面板，响应更快，但要求面板有可公网访问的 HTTPS 地址。
选择 Webhook 后，在「TG 机器人」页面填写面板公网 HTTPS 基础地址（例如 https://panel.example.com），系统会自动追加每用户回执路径 /api/telegram/webhook/{userID} 并完成注册。Webhook 验签密钥由系统自动生成并仅保存在后端，页面不会展示，也无法修改；切换模式或修改地址 / 密钥后 Bot 会自动重启。若面板无法从公网访问，请保持长轮询模式。
API 端点（管理员）
面板级设置，位于「TG 机器人」页面：所有用户的远程控制 Bot 与通知发送统一走该端点。默认为官方 api.telegram.org；国内网络无法直连时，建议配置自建反向代理地址。
隧道与域名命令
| 命令 | 说明 |
|---|---|
/直连域名 [主域名] | 使用简化模式直接绑定到当前 Tunnel |
/优选绑定 [主域名] [辅助域名] [可选优选CNAME] | 执行完整优选绑定；旧命令 /绑定域名 继续兼容 |
区域与隧道选择
| 命令 | 说明 |
|---|---|
/列出区域 | 列出可用 Zone（仅显示域名，无需复制 Zone ID） |
/选择区域 [域名或ZoneID] | 选定 DNS 区域，后续 DNS 命令可省略区域参数 |
类似地可以选定当前隧道，后续绑定命令可省略隧道参数。
DNS 命令
| 命令 | 说明 |
|---|---|
/DNS列表 [域名或ZoneID] [可选类型] [可选名称] | 简洁列表（每行一条记录，长内容自动截断） |
/DNS详情 [完整主机名] | 查看单条记录完整信息（记录 ID、TTL、代理状态、MX 优先级），如 /DNS详情 bbs.kukie.cn；也支持 /DNS详情 [区域] [记录名] |
/DNS添加 [区域可选] [类型] [名称] [内容] [TTL可选] [代理可选] [MX优先级] | 管理 A、AAAA、CNAME、TXT、MX；TTL 缺省 auto，代理缺省 on（TXT/MX 自动关闭代理） |
/DNS修改 [区域可选] [记录名或ID] [类型] [新内容] [TTL可选] [代理可选] | 按记录名直接修改（如 /DNS修改 bbs CNAME saas.com），也兼容按 RecordID 的旧格式 |
/DNS删除 [区域可选] [记录名或RecordID] | 生成五分钟有效的一次性确认码 |
/确认删除 [确认码] | 凭确认码完成删除 |
其他说明
- DNS 删除操作需要二次确认，防止误删
- 群组中使用命令时支持
@botname后缀 - 通知中心可以另配一个 Bot 用于接收通知；某一侧未配置时，页面会提供「一键复用」按钮，直接把另一侧已配置的 Token 复制过来
- Bot Token 通过
APP_ENCRYPTION_KEY加密存储