常见问题

• Github常见的失败问题解决方法
———————-
※ 解决办法
①.请添加 'Github token' 变量后，再尝试；具体的申请方法，请发送 'Github token教程' 进行查看；
②.未使用任何代理的用户，请使用 'GITHUB_PROXY' 或 'PROXY_HOST' 代理后，再尝试；
③.只使用 'PROXY_HOST' 的用户，请检查 'DNS over HTTPS' 是否关闭，请关闭后，再尝试；
④.只使用 'GITHUB_PROXY' 的用户，请检查 镜像站的可用性，注意镜像站填写的时候末尾请以 "/" 结尾；
⑤.同时使用 'GITHUB_PROXY' 与 'PROXY_HOST' 请删除 'GITHUB_PROXY' 后，再尝试；
⑥.以上方法还未解决，请只使用 'PROXY_HOST' 并把 'socks5' 协议替换成 'socks5h' 协议，使用 'socks5' 协议的端口，同时关闭 'DNS over HTTPS' 再尝试。

常见问题

• 关于未找到媒体库的解决方法
———————-
※ 解决办法
• 请在 设定-目录-下载目录/媒体库目录 中，将电视剧类型和电影类型分开配置，即电影-全部和电视剧-全部。如果只写一个全部-全部，该配置不为有效配置，因而无法正常下载&转移。

常见问题

• 关于认证失败
———————-
※ 解决办法
①.错误填写环境变量，例如大写了或小写了所需填的内容，必须要填写的环境变量为AUTH_SITE，其他的变量根据站点要求填写。
②.仅有readme列表内的站点可以认证，其他站点无法认证
③.iyuu有时候会存在连接问题，可以尝试同时添加多个认证的参数避免出现无法认证的问题。（iyuu的token本身也需要认证才能使用，并不是注册了就能用于认证mp）
④.站点连接不上，可以增加代理的环境变量
⑤.uid不是站点的昵称，可在站点用户中心查看。passkey也不是账号的密码，需要在站点的控制面板中查看。
⑥.直接复制passkey可能会在末尾多一个空格，可以检查一下。
⑦.可以同时配置多个认证站点，当站点连接不上时可以顺位使用下一个站点认证，应使用“, ”进行分隔，例如iyuu,audiences
⑧.无论是windows版本还是docker版本，认证变量都需要写在环境变量中。
⑨.套件的配置和app.env变量与值的连接符号为"="不是":"，填写的时候注意参考其他变量是怎么写的。

常见问题

• 关于共享识别词
———————-
※由于部分影视的命名和季度分季的问题，导致mp没法很好的自动订阅，因此需要添加一些辅助的识别词，下面是一些可用的词表，可以将网址复制到“共享识别词”插件中使用。
如果你也写了对应的识别词，也欢迎添加到官方的词表中，共享给其他人使用。

● 关于识别词的简易教程
● 如果发现不能订阅的连载动漫可以在群内@pudingbuding

● 官方：
https://movie-pilot.org/etherpad/p/MoviePilot_TV_Words
https://movie-pilot.org/etherpad/p/MoviePilot_Anime_Words

※由于所有人均可编辑，所以一直存在人为捣乱的情况。只推荐查找相关识别词时或分享识别词时使用，不推荐添加到插件中。

● 个人维护（偏重于每季度的动漫更新）：
https://raw.githubusercontent.com/Putarku/MoviePilot-Help/main/Words/TV.txt
https://raw.githubusercontent.com/Putarku/MoviePilot-Help/main/Words/anime.txt
https://raw.githubusercontent.com/Putarku/MoviePilot-Help/main/Words/2025.01.txt
https://raw.githubusercontent.com/Putarku/MoviePilot-Help/main/Words/general.txt

常见问题

• 企业微信推送教程
———————-
※ https://pt-helper.notion.site/50a7b44e255d40109bd7ad474abfeba5

常见问题

• 关于运行中出现 'inotify' 的错误
#运行
———————-
※ 解决办法
①.请在宿主机执行下列代码
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

常见问题

• 馒头添加相关方法
———————-
※ 解决办法
教程1 教程2

常见问题

• 站点认证失败
———————-
1. 错误填写环境变量，例如大写了或小写了所需填的内容，必须要填写的环境变量为AUTH_SITE，其他的变量根据wiki说明的内容填写。

2.仅有wiki说明内的站点可以认证，其他站点无法认证，例如馒头便无法用于认证，但是可以在用其他站点认证完成后添加使用。

3. iyuu有时候会存在连接问题，可以尝试同时添加多个认证的参数避免出现无法认证的问题。（iyuu的token本身也需要认证才能使用，并不是注册了就能用于认证mp）

4.站点连接不上，可以增加代理的环境变量PROXY_HOST

5. uid不是站点的昵称，可在站点用户中心查看。passkey也不是账号的密码，需要在站点的控制面板中查看。

6.直接复制passkey可能会在末尾多一个空格，可以检查一下。

7.可以同时配置多个认证站点，当站点连接不上时可以顺位使用下一个站点认证，应使用“, ”进行分隔，例如iyuu,audiences

8. 无论是windows版本还是docker版本，认证变量都必须写在环境变量中。

9.套件的配置和app.env变量与值的连接符号为"="不是":"，填写的时候注意参考其他变量是怎么写的。

常见问题

• 硬链接相关须知
———————-
关于硬链接的使用方法与问题解答：
①.硬链接相当于一个指针，不同的硬链接文件包括下载的“源文件”均指向同一个文件块，因此不管硬链接出来几份，所占用的空间始终只有源文件那一份。
②.硬链接出来的文件与“源文件”，在文件系统上实质就是一个文件，但对其剪切、重命名均不会影响“源文件”做种，因此非常适合pt。
③.即便后续删除保种，也不会影响媒体库中的硬链接文件的使用。
④.只有所有的硬链接文件和“源文件”均删除，这部分存储空间才会被释放。
⑤.受文件系统限制，硬链接文件无法跨盘，如果跨盘剪切，实质上是复制。
⑥.多盘组成raid，可以在raid内进行硬链接。
⑦.群晖的不同共享文件夹之间无法进行硬链接。
⑧.有部分文件系统无法创建硬链接，比如fat32、exfat

常见问题

• 更新教程
———————-
①.安装并使用portainer，快速更新moviepilot；
②.极空间用户可以在b站搜索如何进入portainer，并图文教程的基础上额外打开“特权模式”进行更新。
图文教程

常见问题

• 订阅失败
———————-
①.订阅时请使用上面的搜索栏，搜索后添加订阅。注意：直接使用推荐页面添加订阅，可能会失败的问题。
②.订阅为自动定时任务，如需立刻订阅一次，请到 "订阅" 中自行手动运行一次。

常见问题

• 关于cookiescloud无法连接的解决方法
———————-
①.检查mp容器内部是否可以连接上cookiescloud的服务端，可以尝试在容器内使用curl+地址测试
②.填写的地址末尾如果有/，去除后再进行尝试
③.正确的地址例子：
· http://192.168.1.1:6600
· http://(mp地址):3000/cookiecloud
图文教程