Telegram Bot

Bot 提供管理员私聊操作与独立的定时日报。两者共享 Token，但开关、权限和接收目标相互独立。

配置管理功能

1. 向 @BotFather 创建 Bot，取得 Token。
2. 打开“全局设置 → Telegram Bot”，填写 Token。
3. 在管理员 ID 中填写正整数 Telegram 用户 ID，多个用逗号分隔，最多 10 个。
4. 填写真实面板外部地址，例如 https://panel.example.com:8443。
5. 打开 Bot 管理开关并保存，然后向 Bot 私聊发送 /start。

面板外部地址不能包含基础路径、查询参数、账号信息或片段。它用于生成站点入口，应包含浏览器实际使用的非默认端口，不填写反向代理的内部监听端口。

管理员 ID 不是 Telegram 用户名，也不是群组 Chat ID。可用 Bot 的 /id 查看自己的 ID。

Token 加密保存；再次打开设置时不显示原文，留空可保留已有 Token。正式部署要有持久的 JWT_SECRET 与独立 MERIDIAN_SECRET_KEY。

命令与按钮

命令	用途
/start	打开新的管理菜单。
/menu	返回当前面板主菜单。
/sites	管理站点。
/add	分步添加站点。
/address	查看站点访问地址。
/traffic	查看流量。
/report	获取即时日报。
/status	查看运行概览。
/cancel	取消当前填写或确认操作。
/help	查看帮助。
/id	查看自己的 Telegram ID。

启用管理后，Meridian 会配置相应命令菜单。常用操作也可用消息中的按钮完成。

上图依据实际菜单绘制，站点、数据与会话是模拟内容。

添加与编辑站点

私聊菜单可添加站点，或编辑名称、主地址、入口、播放模式、配额、限速、缓存、备用线路和客户端标识，也可启停、删除与检测连接。

填写流程按步骤进行。输入后会更新当前操作消息；切换菜单与返回通常复用原消息，不持续发送新菜单。

提交修改前显示确认摘要。确认按钮有效期为 10 分钟，只能执行一次。如果其他管理员或面板已经修改配置，旧确认不能覆盖新的配置，需要重新选择并确认。

定时日报

填写“接收 Chat ID”，选择每天或每周、发送日和发送时间。时间按 全局时区 解释。

• 可以向个人、群组或频道发送日报；Bot 必须具备发送权限。
• 只启用日报，不会自动启用私聊管理。
• 接收日报的群组或个人不会自动成为管理员。
• “立即发送日报”用于验证 Token、Chat ID 与发送权限。

管理员与日报接收人的区别：

配置	用途
管理员用户 ID	允许指定用户在私聊中管理 Meridian。
接收 Chat ID	指定定时日报投递目标，不授予管理权限。

连接方式

Bot 使用长轮询，无需开放 Webhook 端口。同一个 Token 只能交给一个接收程序；不要同时运行其他长轮询 Bot 程序或遗留 Webhook 接收配置。

常见问题

现象	检查
/start 没有管理菜单	管理开关、保存状态、管理员用户 ID、是否私聊。
能收到日报却不能管理	日报 Chat ID 不代表管理权限，单独配置管理员用户 ID。
Token 留空后无法开启	尚未保存过有效 Token，先填写并保存。
连接显示冲突	是否有另一个接收程序使用同一 Token，或上游 Webhook 尚在使用。
地址端口错误	“面板外部地址”是否保留真实非默认公开端口。
日报时间不对	全局时区、每天 / 每周频率、发送日与时间。
按钮过期或提示配置变化	重新打开菜单，检查最新配置并重新确认。

不要公开 Token、管理员真实 ID 或包含播放凭据的消息。泄露 Token 后到 BotFather 撤销并更新配置。