troubleshooting.md

title	description	published	date	tags	editor	dateCreated
故障排除	常见问题及解决方案	1	2024-11-12 15:00:56 UTC		markdown	2024-05-30 09:55:21 UTC

硬链接转移出现“-1”的报错

下载目录和媒体库目录出现跨盘/跨存储空间/单独映射路径的情况，导致无法实施硬链接，参考 安装指引 中关于映射目录的说明。

同时v1.9.4以前版本为了兼容极空间处理，会出现跨盘硬链接时自动变成复制的情况，v1.9.4版本更正了该问题，详情参考 发行说明 。

重启后日志输出 No module named 'app.helper.sites'

该问题一般常见于容器启动时自动更新到一半，人为手动重启，更新进程被打断导致容器内依赖未安装完全。

解决方法：

• 重置容器或者是重新创建一个新容器。
• 配置代理变量PROXY_HOST或者全局接入代理网络，加速自动更新的下载速度，避免超时引起的更新失败。

目录监控不自动整理文件

1. 启动日志报与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、设定 -> 连接 -> 下载器 中开启下载文件自动整理，通过监控下载器完成文件自动整理，不使用目录监控。

更多问题解决方法，请访问Telegram 的 MoviePilot Wiki频道 或 MoviePilot交流群获取。