MoviePilot 项目常见问题解决方案

MoviePilot 项目常见问题解决方案

MoviePilot NAS媒体库自动化管理工具 项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot

1. 项目基础介绍和主要编程语言

项目名称: MoviePilot
项目简介: MoviePilot 是一个基于 NAStool 部分代码重新设计的 NAS 媒体库自动化管理工具。该项目聚焦于自动化核心需求，旨在减少问题并更易于扩展和维护。仅用于学习交流使用，请勿在任何国内平台宣传该项目。
主要编程语言: Python（99.4%）

2. 新手使用项目时需要特别注意的3个问题及详细解决步骤

问题1: 安装过程中遇到依赖包缺失

问题描述: 在安装 MoviePilot 时，可能会遇到某些依赖包缺失的情况，导致安装失败。

解决步骤:

1. 检查错误信息: 首先查看安装过程中输出的错误信息，确定缺失的依赖包名称。
2. 手动安装依赖包: 使用 pip install <缺失的依赖包名称> 命令手动安装缺失的依赖包。
3. 更新 requirements.txt: 如果发现 requirements.txt 文件中缺少某些依赖包，可以手动添加并提交更新。

问题2: 配置文件错误导致服务无法启动

问题描述: 配置文件（如 config.yaml）中的错误配置可能导致 MoviePilot 服务无法正常启动。

解决步骤:

1. 备份配置文件: 在修改配置文件之前，先备份当前的配置文件。
2. 检查配置文件: 使用文本编辑器打开配置文件，检查是否有语法错误或不合理的配置项。
3. 恢复默认配置: 如果无法确定错误原因，可以尝试恢复默认配置文件，然后逐步添加自定义配置。

问题3: API 接口无法访问

问题描述: 在部署完成后，API 接口（如 http://localhost:3001/docs）无法访问。

解决步骤:

1. 检查服务状态: 使用 systemctl status moviepilot 命令检查 MoviePilot 服务是否正常运行。
2. 检查端口占用: 使用 netstat -tuln | grep 3001 命令检查端口 3001 是否被其他服务占用。
3. 防火墙设置: 确保防火墙允许 3001 端口的访问，可以使用 ufw allow 3001 命令（适用于 Ubuntu）。

通过以上步骤，新手用户可以更好地解决在使用 MoviePilot 项目时遇到的常见问题。

MoviePilot NAS媒体库自动化管理工具 项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot