¶ 用户初始密码
为了确保安全，MoviePilot 首次安装时需要为超级管理员设置初始密码。
- 如果安装时已设置
SUPERUSER_PASSWORD，或者在安装向导 / 本地 CLI 初始化向导中填写了管理员密码，则该值就是初始登录密码。 - 如果未设置，则系统会在第一次启动时生成随机复杂密码，需要从第一次启动的后台日志文件或终端日志中获取管理员用户初始密码才能登录系统。
登录后可在 设定 -> 用户 中修改密码。
- 日志文件路径为
/config对应映射目录下logs/moviepilot.log文件。 - 可以通过搜索关键字
超级管理员快速定位密码位置。
管理员用户不要使用弱密码！如非必要不要暴露到公网。如被盗取管理账号权限，将会导致站点Cookie等敏感数据泄露！
¶ API_TOKEN
为了确保安全，V2版本在每次启动时会检查API_TOKEN是否符合最低安全要求（16位或以上的复杂字符串）。若不满足要求，系统将自动生成一个随机API_TOKEN并记录到日志文件中。您可以通过后台日志文件查看详细信息，或者在登录后进入设定-系统-API令牌进行修改。请特别注意，如果在环境变量中设置了API_TOKEN，且该值未满足安全要求，则每次系统启动时都会生成新的随机API_TOKEN，请务必尽快修改。
- 日志文件路径为
/config对应映射目录下logs/moviepilot.log文件。 - 可以通过搜索关键字
API_TOKEN快速定位相关日志内容。 - 如果你要在 OpenClaw、Claude Code 等第三方 Agent 工具中接入 MoviePilot，也使用同一个
API_TOKEN作为 MCP 认证密钥，参考 MCP Server。
¶ 用户认证
为了控制用户数量避免大规范泛滥使用，MoviePilot引入了PT用户认证机制，你需要有认证站点范围内的账号才能使用软件的资源搜索、订阅及下载功能，出此下策与利益无关，属NAStool一路走来，吸取失败经验的无奈之举。
当前有三种常见配置方式：
- 首次安装时直接在初始化向导里完成用户站点认证
- 进入系统后，点击右上角头像菜单中的
用户认证 - 使用环境变量配置
AUTH_SITE及对应站点参数
推荐优先使用前两种方式，因为系统会直接按照当前资源支持情况动态列出可认证站点。环境变量方式仍然适用于自动化部署或批量维护场景，参考 配置参考 中 AUTH_SITE 的说明。
¶ 媒体识别
识别就是程序要根据仅有的资源名称想办法知道这是哪部电影或者电视剧，并找到其对应的元数据，这样才能实现自动化订阅和整理的目的，这也是MoviePilot区别于其它资源搜索下载类管理工具的核心特性。
对于人类来讲，看到一个很长的资源名称时我们能够很容易就知道这个是什么，但对于程序来说不是这样，程序要知道这个资源具体是什么需要满足两个条件：
- 资源按约定的格式命令，这样程序才能从名称中提出取需要的关键字。
- 对应的关键字在媒体管理平台有维护对应的元数据，这样程序才能查询出元数据并匹配。
MoviePilot根据内置的规则对资源名称进行分析，提取出名称关键字，并按这个关键字去TheMovieDb或豆瓣去查找匹配元数据，正确匹配到数据的情况下这个资源就是识别成功，否则就是识别失败。对于识别失败的资源，MoviePilot不会进行下载、整理等后续处理。
首次安装向导默认使用 themoviedb 作为识别来源，以减少首次使用时因来源切换导致的识别偏差。后续如有需要，仍可在系统设置中调整相关搜索与识别来源。
MoviePilot内置的识别程序针对PT站点资源进行了优化，但实际上并不是所有资源都是规范命名的，特别是网盘、BT以及动漫类的资源，除了使用内置的识别规则，目前还有以下方法可以提高识别率：
自定义识别词：通过人为设置规则对资源标题进行预处理，以达到识别格式要求，具体参考 进阶 章节相关说明。识别增强：比如ChatGPT插件开启增强识别后，可以利用ChatGPT的AI能力协助MoviePilot分析资源名称，补充识别信息，具体参考 插件 章节相关说明。完善元数据：登录 http://www.themoviedb.org 网站，新增元数据，添加别名、译名等，方便自已也方便别人。
WEB管理界面右上角
捷径 -> 识别可以打开识别测试窗口，快速确定资源名称的识别情况。
¶ 搜索匹配
相对于找到更多的资源，MoviePilot更倾向于找到更准确的资源，这个工具的目的是自动化订阅整理，能否自动找到最准确的资源而不会误命中更重要。
所以MoviePilot在默认模式下的搜索和订阅都是会做匹配的，匹配的过程就是根据元数据确定这个资源是不是这个电影或电视剧，如果不是或者存在可疑这个资源都会被过滤不会使用，这也是为什么很多人在使用MoviePilot搜索资源时结果比直接在站点搜索更少的原因。
当然，MoviePilot也提供了不匹配直接搜索站点的方式做为手动搜索的补充，具体参考 搜索 章节说明。
¶ 优先级
优先级是MoviePilot中的一个核心概念，在很多场景都有优先级的设定，比如站点优先级、目录优先级、过滤规则优先级、分类策略优先级等。
优先级统一遵循以优先级越小越优先的规则，程序在使用时会按优先级的顺序依次处理。在界面显示时高优先级的排在前面，可以通过拖动卡片顺序来快速调整优先级。