Support · Knowledge Base
有问题，先在这里找到答案
从部署、STRM 到挂载与跨盘，把最常见的疑问整理成一条清晰的排查路径。
登录与账号
登录安全、镜像选择，以及反代环境下最常见的来源校验问题。
忘记后台密码怎么办？
登录页点 「忘记密码？」 → 确认重置，系统会生成随机新密码，可在容器日志中查看：
docker logs litepan为什么登录后强制修改密码？
仍在使用默认密码、旧式明文密码，或刚完成随机重置时，必须先改密，才能继续使用其他后台功能。WebDAV 也使用同一套管理员账号密码。
反代或 DDNS 访问时提示「请求来源不受信任」怎么办？
这通常是浏览器访问地址与反代传给 LitePan 的 Origin / Referer、协议、域名或端口不一致。
请先修正反代请求头；如果有多个合法入口，可设置白名单：
LITEPAN_CORS_ORIGINS: "https://pan.example.com,http://192.168.1.10:5211"地址必须包含协议和实际端口，多个地址用逗号分隔，修改后重启容器。
STRM 与播放
生成模式、访问地址、媒体 Key 与反代入口的选择。
「补缺 / 更新 / 全量」该怎么选？
- 补缺：只补本地还没有的
.strm，少用。 - 更新：日常推荐；会同步新增并清理多余项。
- 全量：大改结构或基址、Token 变更后使用一次。
STRM 生成了，媒体端却播不了？
先检查 STRM 设置中的 对外基址 是否是媒体端能够访问的地址；再确认是否换过 Token，但旧 .strm 尚未更新。Docker 非 host 网络时，还需检查端口映射与反代入口。
更换 STRM 媒体访问 Key 后，旧链接还能用吗？
不能。旧 .strm 仍携带旧 Key，会导致播放失败。更换时可勾选应用到已有文件，或事后通过「一键替换基址 / 重新生成」处理。
STRM 执行计划改不回「全天 / 时间段」？
多半是被 自动联动 中的「STRM 任务」动作接管。仅停用联动不会解锁，需要从相关联动中移除该动作或删除规则，再自行修改定时。
删除规则不会自动恢复原先的时间段。
播放器该连 WebDAV 还是反代？
WebDAV：需要把 LitePan 当作网盘源浏览或播放时，使用「文件共享 → WebDAV」。
反代：媒体库中使用 .strm 时，Infuse / 飞牛客户端应连接「辅助工具 → 增强工具」中的反代入口，不要填写 Emby / 飞牛原地址。
反代启用了，为什么还没有可复制的入口？
需要填写 反代端口 并成功保存。状态变为「运行中」后才会生成入口，Emby 与飞牛两套反代端口不能相同。
缓存、整理与任务
任务启用条件、整理预览与 TMDB 连通性。
缓存任务最多能建多少个？
最多 6 个。优先覆盖高频入口目录，扫描层级建议选择单层至 5 层，不要直接绑定网盘根目录。
缓存任务提示无法生效 / 太快了？
任务必须先 启用。账号若关闭目录缓存（TTL=0），缓存任务无法生效；刚执行完成时可能处于冷却期，稍后再试即可。
目录整理必须先预览吗？自动联动也要吗？
管理页强制执行「预览 → 确认执行」。自动联动中的目录整理会直接生成计划并执行，没有人工预览，因此上线前请先在目录整理页手工预览并跑通。
TMDB 不通，刮削 / 整理怎么办？
在整理设置或 STRM 刮削设置中填写 Key、配置代理，或按页面提示为 Docker 添加 TMDB 域名映射。两处共用同一套 TMDB 与代理配置。
文件共享与跨盘
分清 WebDAV 的两个方向，并确认 FUSE 与跨盘秒传的使用条件。
「添加存储的 WebDAV」和「文件共享的 WebDAV」有什么区别？
添加存储：将其他 WebDAV 服务接入 LitePan。
文件共享：将 LitePan 对外暴露为 .../dav，供 Infuse 等客户端使用；账号密码与后台管理员一致。
本地挂载看不到目录 / 提示不支持 FUSE？
需要使用带 FUSE 的镜像，映射 /dev/fuse 与 /app/mounts（建议使用 :shared），并在「文件共享 → 本地挂载」启用服务后点击「挂载」。详见 快速部署。
跨盘秒传为什么没有我想要的网盘组合？
只有文件指纹能够对应的线路才会显示；同一种网盘的两个账号之间也不能通过此页面秒传。夸克等当前属于「规划中」，并非故障。
建议先执行「试探秒传」再开始传输；启用兜底后，可在文件页的「跨盘任务」面板查看进度。
存储与驱动
被下架的实验性驱动如何解锁，以及使用前需要了解的风险。
如何进入开发者模式，解锁被下架的驱动？
部分逆向驱动（移动云盘、天翼云盘）默认已从驱动列表中移除，需要解锁「开发者模式」后才会重新出现。
解锁步骤：
- 登录后台，点开右上角账号菜单。
- 对着「关于 LitePan」那一行左侧的小图标（圆圈里一个 i）连续点 5 次，1.8 秒内点完。
- 弹出「解锁开发模式」窗口后，输入解锁码
litepan666，点「解锁」。
解锁后驱动列表里就会出现这些实验性驱动。解锁状态保存在服务端，刷新页面仍然有效，重启 LitePan 后需要重新解锁。
⚠️ 这些驱动属于逆向实现，存在风险且不再维护，仅供开发人员学习研究使用，所产生的法律风险自行承担。