TG 助手

TG 助手用于管理 Telegram API 配置、登录状态和代理。TG 频道搜索、TG 转发、订阅资源搜索、HDHive / 转存动作 Bot、通知推送等功能都会依赖 Telegram 相关配置。

适合做什么

场景	说明
TG 频道搜索	使用 Telethon 客户端 API 搜索频道或群组消息
TG 转发	监控源频道消息并按规则转发
订阅追更	作为资源搜索来源之一
动作 Bot	接收转存、解析、分享 STRM 等交互动作
多账号隔离	搜索号、转发号、通知号分开维护

配置字段

字段	说明
名称	配置唯一名称
API ID	Telegram API ID，纯数字
API Hash	Telegram API Hash
代理	按需配置独立代理
登录方式	支持二维码登录、手机号验证码登录
二步验证密码	Telegram 开启二步验证时填写

登录流程

二维码登录

1. 进入 NanShare Web -> 工具箱 -> TG 助手。
2. 添加配置并填写 API ID、API Hash。
3. 点击二维码登录。
4. 使用 Telegram 手机端扫码确认。
5. 如果账号开启二步验证，按提示输入二步验证密码。
6. 登录成功后保存配置。

手机号验证码登录

1. 填写 API ID、API Hash。
2. 输入手机号并发送验证码。
3. 填写 Telegram 收到的验证码。
4. 如需二步验证，继续输入密码。
5. 登录成功后保存配置。

多账号建议

TG搜索号
TG转发号
TG通知号
TG交互号

资源搜索和转发任务如果很重，建议拆开账号。这样其中一个账号需要重新登录时，不会影响所有 TG 能力。

代理建议

• TG 连接不稳定时，为 TG 助手单独配置代理。
• 代理地址需要 NanShare 容器能访问。
• 如果同一账号同时用于搜索和转发，代理配置会影响它的客户端连接。

常见问题

TG 频道搜索没有结果

确认 TG 账号已经登录、账号能看到目标频道或群组、频道 ID 或用户名正确，并且搜索关键词不要过窄。

转发任务提示客户端未登录

回到 TG 助手检查对应账号登录状态。必要时重新扫码或重新输入验证码。

一个账号能不能跑多个转发

可以。同一 TG 账号的多个转发配置会共享客户端连接，但规则和运行状态可以独立管理。