123 助手

123 助手用于管理 123 云盘账号和 Token。123 STRM、123 API、123 秒传播放、123 转存离线都会读取这里的配置。

适合做什么

能力	说明
账号管理	保存多个 123 账号配置
Token 获取	通过账号密码获取并持久化 Token
Token 重置	账号密码变更或 Token 失效后重新获取
缓存时间	控制 123 直链缓存 TTL
Token 检测	定时检测 Token 是否可用
秒传配置	给 123 秒传播放和转存任务提供账号基础

配置字段

字段	说明
名称	配置唯一名称，其他页面通过名称引用
账号	123 账号，通常是手机号
密码	123 账号密码
Token	保存后由 NanShare 获取或重置
缓存时间	单位秒，影响 123 API 和播放直链缓存
Token 检测表达式	5 位 Cron，例如 0 * * * *

使用流程

1. 进入 NanShare Web -> 工具箱 -> 123 助手。
2. 添加配置，填写名称、账号、密码。
3. 设置缓存时间，例如 600。
4. 保存配置。
5. 如果 Token 没有自动生成，点击重置 Token。
6. 在 123 STRM、123 API、123 秒传或 123 转存离线页面选择该配置。

多账号示例

123播放号
123转存号
123测试号

如果 123 STRM 和 123 转存任务很多，可以把播放和转存拆成不同账号。这样某个账号 Token 失效时，也更容易定位影响范围。

和 123 STRM 的关系

123 STRM 生成时需要选择网盘路径，直链解析时需要 123 助手提供有效 Token。Token 失效时，STRM 文件本身不会自动坏掉，但播放解析会失败，需要回到 123 助手重置 Token。

和秒传播放的关系

123 秒传播放需要源账号和目标账号配合。123 助手提供账号登录和 Token，秒传播放页面再按 Emby 用户、目标目录和播放策略进行分配。

常见问题

保存时没有 Token 怎么办

先确认账号和密码正确，再点击重置 Token。如果仍失败，查看日志中的 123 登录返回信息。

Token 检测要不要开

长期使用 123 STRM 或 123 API 建议开启。检测周期不用太频繁，通常每小时或每天一次即可。

缓存时间越长越好吗

不一定。缓存太短会频繁请求直链，缓存太长可能在链接失效后仍命中旧缓存。建议从 600 秒开始，再按播放稳定性调整。