【免费下载链接】LitePanLitePan - 多网盘聚合挂载支持 WebDAV、STRM、媒体整理、本地挂载、串联任务项目地址https://gitcode.com/gh_mirrors/li/LitePan点击查看免费下载LitePan 是一款多网盘聚合挂载工具支持 WebDAV、STRM 播放、媒体整理、FUSE 本地挂载与串联任务。本文是一份 LitePan 故障排查清单汇总部署与网盘接入过程中 10 个高频问题帮你快速定位 LitePan 无法访问、网盘登录失败、挂载不上等故障原因并逐一解决。部署前30 秒看懂 LitePan 运行架构排查问题前先了解 LitePan 的运行方式能帮你快速缩小范围项目说明访问端口默认5211如http://服务器IP:5211Magnet 端口42069tcp/udp仅使用内置离线下载时需要数据目录./data→ 容器内/app/dataSQLite 数据库存于此STRM 目录./strm→ 容器内/app/strm挂载目录./mounts→ 容器内/app/mountsFUSE 挂载默认管理员用户名admin密码admin核心配置文件为 docker-compose.yml默认管理员账号定义见 internal/adminauth/service.go默认监听端口定义见 internal/config/config.go。 排查总原则先看容器是否在运行 → 再看日志报什么错 → 最后对照本文清单逐条核对。一、部署类问题1. 部署完成后打不开页面5211 端口无响应症状浏览器访问http://IP:5211一直转圈或提示连接被拒绝。排查步骤确认容器状态docker compose ps若容器处于Restarting或Exited执行docker compose logs -f litepan查看启动日志核对端口映射是否为5211:5211见 docker-compose.yml在服务器本机先访问http://127.0.0.1:5211/healthLitePan 健康检查接口正常时应返回{status:ok}实现见 internal/api/health.go本机可访问但外网不行 → 检查云服务器安全组 / 防火墙是否放行 5211 端口。2. 页面打开但不对劲用错了镜像标签LitePan 当前 Go 新版应使用beta标签如ponphil/litepan:beta不要使用latest——latest仍是 Python 旧版镜像功能与配置均不对应见 README.md 中的部署说明。处理把镜像标签改为beta或指定的v0.5.6-Beta然后执行docker compose pull docker compose up -d重建容器。3. 端口冲突5211 或 42069 被占用症状容器反复重启日志中出现bind: address already in use。排查步骤用docker compose ps或ss -lntp | grep 5211找出占用端口的进程修改宿主机映射端口如8080:5211访问地址同步改为http://IP:8080若使用内置 Magnet 离线下载42069的 tcp/udp 也需一并映射见 docker-compose.yml 注释容器内监听端口可通过环境变量LITEPAN_LISTEN调整环境变量说明见 internal/config/config.go 与 Dockerfile。4. 重启容器后账号、任务配置全丢了LitePan 的账号凭证、自动化任务、STRM 配置都保存在/app/data的 SQLite 数据库中。数据丢失通常是 volume 映射缺失导致容器重建后数据被清空。处理确认 docker-compose.yml 中./data、./strm、./mounts三个挂载齐全且宿主机./data目录下存在litepan.db。养成习惯重要配置定期通过后台备份恢复功能做备份相关实现见 internal/backuprestore/。5. 忘记管理员密码进不去后台默认账号为admin/admin定义于 internal/adminauth/service.go。若只是忘了改过的新密码尝试使用data目录的备份恢复功能找回若无备份且确认不再需要历史数据备份好旧data目录后重新初始化再重新添加网盘账号预防建议登录后第一时间在后台修改默认密码。二、网盘接入类问题LitePan 目前支持 115、123、139 云、189 云、百度网盘、光鸭、夸克、OneDrive、OpenList、WebDAV 等网盘驱动完整驱动清单见 drivers/all.go。6. 扫码登录失败二维码过期、登录状态不更新症状添加网盘账号时二维码一直等待或提示已过期。LitePan 的扫码登录有四个状态等待扫码waiting、成功success、失败failed、过期expired状态机见 internal/driver/qrlogin.go。排查步骤二维码有有效期通常几分钟过期后点击刷新重新生成并在有效期内完成扫码和 App 端确认不同网盘登录方式不同网盘类多为扫码或 CookieWebDAV、OpenList 则是地址 账号密码先确认自己选对了网盘类型若提示登录成功但立即报凭证失效多为手机 App 端会话冲突或 Cookie 复制不完整重新登录一次账号后续频繁令牌过期检查账号是否被多设备挤占必要时在账号页重新授权。7. 网盘接入成功但文件列表为空或报错症状账号状态正常进入网盘根目录却看不到文件或列表加载失败。排查步骤先在账号页执行连通性检测Ping检测逻辑见 internal/account/ping.go确认凭证真实可用打开后台错误日志查看接口返回的具体错误码常见为凭证过期、接口频率限制日志模块见 internal/logx/部分网盘需要先在网盘官方开放平台开通对应应用权限缺少授权时接口会返回空列表若使用 OpenList 等中间层网盘先单独验证其 API 是否可用再排查 LitePan 侧配置。8. 媒体整理 / STRM 刮削失败TMDB 无法访问症状目录整理、STRM 元数据刮削时报识别失败或长时间无结果。LitePan 的媒体识别依赖 TMDB 接口api.themoviedb.org、image.tmdb.org国内服务器经常解析不到。两种解决方式二选一在 docker-compose.yml 中用extra_hosts为api.themoviedb.org与image.tmdb.org配置可解析的 IP或在后台「目录整理 → TMDB 设置」中填写 TMDB 反代域名程序会自动补全/3与/t/p路径。配置后重新执行一次整理任务验证效果TMDB 客户端实现见 internal/mediaorganize/tmdb/。三、挂载与串联任务问题9. FUSE / WebDAV 挂载失败症状本地挂载目录为空、挂载报错或 WebDAV 客户端连不上。LitePan 的 FUSE 挂载对容器要求较高逐项核对 docker-compose.ymldevices: - /dev/fuse:/dev/fuse宿主机需存在/dev/fuse设备privileged: true与pid: hostFUSE 必需./mounts:/app/mounts:shared挂载传播参数:shared不能少否则容器内挂载对外不可见宿主机需安装fuse3相关依赖镜像内已内置见 Dockerfile。挂载服务的核心逻辑见 internal/fusemount/WebDAV 服务端实现见 internal/share/dav/。WebDAV 客户端连不上时重点检查客户端填写的地址端口、账号权限以及服务器防火墙。10. 串联任务自动化不执行、执行到一半停住症状设置了整理 → STRM → 刮削 → 刷库串联流程任务没有按计划跑。排查步骤在自动化任务页查看执行历史与停止原因区分没触发和触发了但失败未触发检查任务的调度周期、生效时间窗口设置以及依赖的账号是否处于暂停状态暂停原因管理见 internal/domain/pause_reason.go执行失败串联任务按顺序执行上游步骤如媒体整理失败会阻断下游先修复上游报错确认 STRM 输出目录./strm映射正确且挂载点如 NAS 媒体库路径写权限正常。自动化服务实现见 internal/automation/STRM 任务调度见 internal/strm/service_schedule.go。排查小结#问题关键定位点1打不开页面容器状态 → 端口映射 →/health→ 安全组2版本不对使用beta而非latest3端口冲突修改宿主机映射端口4数据丢失检查datavolume 映射5忘记密码改密码 / 备份恢复 / 重置6扫码失败二维码过期刷新、登录方式选对7列表为空Ping 检测 → 错误日志 → 开放平台授权8TMDB 失败extra_hosts 或反代域名9挂载失败/dev/fuse、privileged、:shared10串联任务停住执行历史 → 时间窗口 → 上游步骤遇到以上清单外的问题建议先收集docker compose logs litepan的日志和后台错误日志两者结合基本能定位所有 LitePan 故障。赞分享【免费下载链接】LitePanLitePan - 多网盘聚合挂载支持 WebDAV、STRM、媒体整理、本地挂载、串联任务项目地址https://gitcode.com/gh_mirrors/li/LitePan点击查看免费下载相关推荐OneFuzz故障排查10个常见问题及解决方案清单OneFuzz故障排查10个常见问题及解决方案清单 OneFuzz是一个自托管的模糊测试即服务Fuzzing As A Service平台帮助开发者轻松如何用RequireJS Plugins轻松加载异步资源async插件实战教程如何用RequireJS Plugins轻松加载异步资源async插件实战教程 RequireJS Plugins是一套实用的插件集合专为RequireJS前端如何生产级部署JonexGPU加速、HTTPS接入与安全加固检查清单附常见故障排查如何生产级部署JonexGPU加速、HTTPS接入与安全加固检查清单附常见故障排查 Jonex 是一个一站式多模态解析引擎 本体驱动的 AI 知识引擎创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考