账号管理

支持的登录方式

TG-SignPulse 当前支持三种常用登录流程：

短信验证码登录
二维码登录
账号启用了 Telegram 2FA 时补交密码

所有登录流程都通过后端 accounts API 完成，登录状态会被保存到数据目录中。

账号字段建议

账号名称：建议使用稳定、易识别的名称，例如 main_cn、backup_01
手机号：短信登录时使用
代理：可选，适合账号需要单独走代理的场景
备注：用于在面板里区分账号用途

代理规则

系统同时支持“全局代理”和“账号级代理”。

优先级：

账号单独配置的代理
全局设置中的 global_proxy
未配置代理时直连

常见格式：

text

socks5://127.0.0.1:1080
socks5://user:pass@127.0.0.1:1080
http://127.0.0.1:7890

二维码登录流程

在面板发起二维码登录
用 Telegram 手机端扫描
如果 Telegram 返回 password_required，继续填写 2FA 密码
登录成功后会自动落盘会话

适合：

不方便接收短信验证码
批量维护已有账号

会话存储模式

通过环境变量 TG_SESSION_MODE 控制：

file：默认模式，使用会话文件
string：使用 session string 存储

file 模式

适合大多数场景。

会话更直观
与传统 Telegram 客户端管理方式一致
数据落在 sessions/ 目录

string 模式

适合容器化或你希望统一管理 session string 的场景。

账号信息保存在 sessions/accounts.json
对迁移和备份更友好

更新开关

环境变量：

text

TG_SESSION_NO_UPDATES=0

默认建议保持允许更新。因为关键词监听和某些需要实时等待消息变化的动作依赖 updates。除非你明确知道自己只做纯定时任务，否则不要关闭。

账号状态检测

面板支持检查账号状态，常见结果包括：

connected
invalid
needs_relogin

建议：

定期检查长期挂机账号
登录异常后尽快重登
如果任务失败集中出现在某个账号，先检查账号状态和代理

重新登录

当账号失效或 Telegram 要求重新验证时：

打开账号编辑
保留原账号名称
使用短信或二维码重登
成功后原任务会继续绑定该账号

自定义 Telegram API

如果你不想使用默认内置配置，可以在系统设置中填写自己的：

TG_API_ID
TG_API_HASH

也可以通过面板保存，这些值会写入 .telegram_api.json。

建议做法

一个账号只承担一类核心任务，便于排障
风险高的任务单独走代理
批量账号优先使用共享任务，而不是复制大量相同任务
长期运行时定期备份 sessions/ 与数据库

账号管理 ​

支持的登录方式 ​

账号字段建议 ​

代理规则 ​

二维码登录流程 ​

会话存储模式 ​

file 模式 ​

string 模式 ​

更新开关 ​

账号状态检测 ​

重新登录 ​

自定义 Telegram API ​

建议做法 ​