常见问题
约 968 字大约 3 分钟
2026-04-18
部署相关
Q: 支持哪些系统部署？
A: ResourceTool 通过 Docker 部署，支持所有运行 Docker 的系统：
- Linux（Ubuntu、Debian、CentOS 等）
- NAS 设备（群晖、威联通等）
- macOS
- Windows（通过 Docker Desktop 或 WSL2）
Q: 端口被占用怎么办？
A: 检查端口占用：
ss -tlnp | grep 29999如需更改端口，可以修改 docker-compose.yml 中的环境变量 RESOURCE_WEB_PORT。
Q: 容器无法启动？
A: 查看容器日志排查原因：
docker logs resource-tool常见原因：
- 授权码未配置或已过期
- 端口被占用
- 数据目录权限不足
Q: 如何查看当前版本？
A: 有以下几种方式：
- 管理面板中查看版本号
- Telegram Bot 发送
/version - 查看容器内
/VERSION文件
115 网盘相关
Q: Cookie 多久过期？
A: 115 Cookie 没有可靠的固定有效期，退出登录、改密或平台风控都可能让它提前失效。发现转存或播放异常时，先到 概览 → 插件库 → 115 健康检查 检测；失效后重新扫码登录。
Q: 115 出现 405 风控怎么办？
A: 405 是 115 的接口限流机制，通常原因：
- 短时间内请求过多
- Cookie 异常
处理方式：
- 系统会自动触发熔断器，暂停请求
- 等待一段时间后自动恢复
- 如果持续出现，检查 Cookie 是否正常
- 考虑配置多个 115 账号分流
Q: 转存失败常见原因？
A:
- Cookie 过期 — 更新 Cookie
- 目标目录不存在 — 检查转存目录配置
- 分享链接已失效 — 资源被取消分享
- 存储空间不足 — 检查 115 网盘空间
Telegram 相关
Q: Bot 无法接收消息？
A: 检查以下事项：
- Bot Token 是否正确
- 是否配置了代理（Telegram 需要科学上网）
- 查看日志是否有连接错误
Q: Session 登录失败？
A: 常见原因：
- 网络不通（需要代理）
- 二步验证密码错误
- Telegram 账号被限制
Q: 频道监控不生效？
A: 检查：
- Session 是否在线
- 监控规则是否已启用
- 源频道是否已加入（使用 Session 的账号需要是频道成员）
- 关键词过滤是否设置正确
Emby 302 相关
Q: 播放时转圈/缓冲？
A: 可能原因：
- 115 直链获取慢 — 开启预缓存
- 115 CDN 速度慢 — 检查网络
- 风控触发 — 查看日志是否有 405 错误
- CD2 降级中 — 检查 CD2 连接状态
Q: 路径映射不匹配？
A: 检查：
- STRM 文件中的路径格式
- 路径映射规则是否与 STRM 路径前缀一致
- Cloud STRM 中
False后面是否有两个斜杠//
Q: 秒传失败？
A: 可能原因：
- 目标 115 账号 Cookie 过期
- 目标目录不存在
- 文件已存在于目标账号
用户管理相关
Q: 忘记管理员密码？
A: 首次安装的默认密码是 admin。修改后如果忘记，不建议直接手改 SQLite；先保留数据目录备份，再联系管理员按当前版本的账号恢复流程处理。
Q: 自备 Cookie 用户如何绑定？
A:
- 管理员在实例的权限模板或 Emby 用户 页面允许“自备网盘”模式
- 用户登录 ResourceTool 自助面板，进入 账号设置
- 使用 115 App 扫码登录，或填写自己的 Cookie 和回收站密码
用户的 Cookie 应由用户自己维护，不要添加成管理员的内置 115 账号。
Q: 用户到期后如何续期？
A: 管理员可在 开服 → Emby 用户 中调整到期时间；用户也可以用邀请码续期。签到模式还可配置积分兑换续期和到期自动续费。