深色模式
天翼助手
天翼助手用于管理天翼云盘账号配置，并给 Emby 助手路径替换直链能力提供账号基础。它适合将天翼云盘中的资源通过 NanShare 统一接入播放链路。
适合做什么
| 场景 | 说明 |
|---|---|
| 路径替换直链 | Emby 助手按路径匹配到天翼资源后获取播放链接 |
| 多账号隔离 | 不同资源目录、不同用户使用不同配置 |
| 登录验证 | 保存新配置后可自动登录，也可手动验证或重新登录 |
| 缓存管理 | 控制直链缓存时间 |
配置字段
| 字段 | 说明 |
|---|---|
| 名称 | 配置唯一名称 |
| 账号 | 手机号或邮箱 |
| 密码 | 天翼云盘密码 |
| 缓存时间 | 单位秒，用于直链缓存 |
| 登录状态 | 展示已登录、未登录或新配置待登录 |
登录与验证
新配置保存时，如果填写了账号和密码，NanShare 会尝试自动登录获取凭证。已有配置可以使用：
| 操作 | 说明 |
|---|---|
| 验证账号 | 使用当前账号密码验证登录状态 |
| 重新登录 | 凭证过期或播放失败时重新获取凭证 |
WARNING
天翼账号如开启设备锁或额外验证，可能导致自动登录失败。遇到这种情况先处理账号安全验证，再回到 NanShare 重新登录。
使用流程
- 进入
NanShare Web -> 工具箱 -> 天翼助手。 - 添加配置。
- 填写名称、账号、密码。
- 设置缓存时间。
- 保存配置，等待自动登录。
- 必要时点击验证账号或重新登录。
- 在 Emby 助手路径替换配置中引用该天翼配置。
路径替换思路
天翼助手只负责账号和直链能力。真正决定资源如何匹配的是 Emby 助手里的路径替换配置。例如：
text
Emby 路径：/media/天翼电影
网盘路径：/电影
账号配置：天翼一号播放时 NanShare 根据 Emby 请求路径找到对应网盘路径，再用天翼助手配置获取链接。
缓存时间建议
| 场景 | 建议 |
|---|---|
| 内网播放稳定 | 可以适当延长缓存 |
| 经常提示链接失效 | 缩短缓存时间 |
| 多设备频繁播放 | 先观察缓存命中和日志，再调整 |
常见问题
登录失败怎么排查
检查账号密码是否正确、账号是否需要额外验证、容器网络是否能访问天翼接口。保存后可以结合日志查看具体错误。
已登录但播放失败
先点击重新登录，再清理对应缓存重新播放。若仍失败，检查 Emby 路径替换左侧路径是否和实际媒体路径完全一致。
可以配置多个天翼账号吗
可以。建议名称写清楚用途，例如 天翼电影号、天翼剧集号。
和 115 / 123 助手有什么区别
天翼助手主要服务路径替换直链。115 / 123 助手还会被 STRM、秒传、转存、签到等更多模块使用。