常见问题
约 839 字大约 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 的有效期不固定，通常在 7-30 天之间。系统会自动检测并提醒。建议定期更新 Cookie。
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。如果修改后忘记，需要通过数据库工具重置。
Q: 自备 Cookie 用户如何绑定？
A:
- 管理员在 115 配置中添加用户的 Cookie
- 在用户管理中将用户模式设为
self_pan - 关联对应的 115 配置
Q: 用户到期后如何续期？
A: 在用户管理中编辑用户，修改到期时间即可。也可以通过激活码让用户自助续期。