下载目录和媒体库目录出现跨盘/跨存储空间/单独映射路径的情况，导致无法实施硬链接，参考 安装指引 中关于映射目录的说明。
同时v1.9.4以前版本为了兼容极空间处理，会出现跨盘硬链接时自动变成复制的情况，v1.9.4版本更正了该问题，详情参考 发行说明 。
该问题一般常见于容器启动时自动更新到一半，人为手动重启，更新进程被打断导致容器内依赖未安装完全。
解决方法：
PROXY_HOST或者全局接入代理网络，加速自动更新的下载速度，避免超时引起的更新失败。inotify相关的错误时，在宿主机上（不是docker容器里）执行以下命令，并重启宿主机：echo fs.inotify.max_user_watches=5242880 | sudo tee -a /etc/sysctl.conf
echo fs.inotify.max_user_instances=5242880 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
2、挂载网盘、Windows向Linux的SMB共享、NFS共享等不支持事件触发的目录实时监控，打开目录监控的兼容模式可解决问题，但兼容模式下性能较低，可能会频繁读取磁盘。
3、设定 -> 连接 -> 下载器 中开启下载文件自动整理，通过监控下载器完成文件自动整理，不使用目录监控。
v2.6.8+出现无法搜索、无法添加站点问题的，检查认证资源版本是否为2.4.1+，站点资源版本是否为2.0.7+，如果不是且重启不会自动更新，请更新docker镜像。
登录后点击用户名像-》弹出菜单中选择附加样式，把自定义CSS删除，刷新浏览器。
📖 浏览器清理缓存文件（保留 Cookie）教程
❓ 为什么只清理缓存，不清理 Cookie？
• 缓存文件：浏览器为了加快访问速度，会保存图片、脚本、网页副本。但时间久了或者版本更新了可能导致MoviePilot页面显示异常。
• Cookie：保存网站登录状态和个性化设置。如果一并清理，可能需要重新登录账号。
👉 所以解决MoviePilot升级后界面异常问题，我们只清理缓存文件，而保留 Cookie。
⸻
🌐 Chrome（谷歌浏览器）
⸻
🌐 Edge（微软浏览器）
⸻
🌐 Firefox（火狐浏览器）
⸻
🌐 Safari
💻 Mac
📱 iPhone / iPad
⚠️ Safari（iOS）无法单独清理缓存，清理时会连 Cookie 一起清除。
👉 PWA模式下杀掉后台重新进入会刷新缓存，建议添加图标到主屏幕使用，也可以使用 Chrome 或 Firefox iOS 版。
⸻
💡 小技巧
• 快捷键：
• Chrome / Edge / Firefox → Ctrl + Shift + Del（Mac: ⌘ + Shift + Delete）
• 强制刷新页面 → Ctrl + F5（Mac: ⌘ + Shift + R）
• 也可以安装插件（如 Clear Cache for Chrome），一键清理缓存，保留 Cookie。
更多问题解决方法，请访问Telegram 的 MoviePilot Wiki频道 或 MoviePilot交流群获取。问前请附带日志截图、配置截图等关键信息，便于快速解决您的问题；尽量不要试图仅通过文字描述进行提问，以获取问题答案。