API 用途

自建 Telegram Bot API Server:为什么需要 api_id 和 api_hash

了解官方 Telegram Bot API Server 自建的适用场景、应用凭证要求、机器人迁移和文件路径处理,规划服务隔离与上线验证。

GetTGAPI 编辑团队更新于

快速解答: 官方开源 Telegram Bot API Server 可以部署在自己的服务器上,服务进程需要自有 api_id、api_hash,机器人业务请求仍使用 Bot Token。自建改变的是 Bot API 服务部署方式,不会把机器人变成用户账号。

普通菜单、通知和客服通常可直接使用 Telegram 托管 Bot API。只有文件处理、内部网络集成或运维控制等具体要求值得自建时,再增加这一层服务。

自建前先确认收益和成本

你希望解决的问题 评估重点
文件处理能力不满足需求 核对 local 模式能力与自己的磁盘、带宽
Bot 业务服务与附件存储分离 明确文件路径如何映射、谁有读取权限
需要控制服务发布和日志 承担升级、监控、备份与故障处理
只是菜单或消息慢 先定位更新接收、业务队列和网络延迟

自建不保证所有延迟下降,也不免除 Telegram 的权限和调用限制。不要把云端、应用逻辑或排队故障全部归因于托管 Bot API。

两层凭证不能混用

服务程序配置自己的应用 ID 和 Hash;业务程序用具体机器人的 Token 调用该服务。不要把应用 Hash 填进 Token,也不要让所有业务随意读取整个服务配置。

完整凭证不宜放在公开仓库、演示命令或监控输出中。运维人员查看启动错误时,应看到字段是否配置和错误阶段,而不是秘密值。

建议的部署顺序

  1. 从官方仓库选择并记录版本,按目标系统的构建说明安装。
  2. 设置专用数据目录、运行用户、容量告警与日志保留规则。
  3. 将服务绑定在受控网络,远程访问通过受保护的 HTTPS 入口;不要直接把内部文件目录公开。
  4. 用独立测试 Bot 验证接收、回复、上传、下载和重启恢复。
  5. 制定已有 Bot 的迁移步骤,确认旧端停止接收后再切换业务请求。

官方服务自身接收 HTTP,远程 HTTPS 需要相应 TLS 入口。这里给出部署顺序,不提供含真实密钥的一键命令,实际参数应按所用版本核对。

迁移时怎样避免漏消息?

从 Telegram 托管服务迁移,应遵循官方 logOut 等迁移步骤,而不是同时启动两套服务抢同一 Bot 的更新。不同本地服务之间迁移也有自己的关闭和状态转移要求。

业务端需要能处理迁移期间的重复事件和暂时中断。回退同样要按官方规则执行,不能假定随时改回地址就一定恢复。正式切换前,先用测试 Bot 演练完整路径。

local 模式的文件路径如何处理?

local 模式可能返回服务主机上的绝对文件路径。若业务在另一个容器或另一台机器,那个路径不一定可直接读取。需要设计受限共享目录或经过鉴权的文件传输,禁止把任意主机路径当作客户下载链接。

清理任务还要避开正在传输的文件。验收时应检查大文件、磁盘不足、取消下载和清理后的引用失效,而不只验证一条文字回复。

从哪里获取自建需要的 API 资料?

可按 Telegram 官方申请教程 获得自己的 ID 与 Hash。如果开发者门户 ERROR 或无法完成创建,联系 gettgapi.com/help#contact 的 GetTGAPI 客服;已有授权码可进入 申请页。

GetTGAPI 协助申请应用资料,自建服务的硬件、发布、监控与 Bot Token 管理由部署者负责。

官方依据