| 名称 | 用途 | 不要混用 |
|---|---|---|
| MoviePilot 用户名与密码 | 登录网页或 App | 不等于站点账号 |
| 用户认证 | 确认使用站点搜索、订阅、下载等能力的资格 | 认证通过不代表所有站点 Cookie 都有效 |
| 站点 Cookie / API Key / Passkey | 访问具体站点和下载资源 | 不等于 MoviePilot API Key |
API_TOKEN |
MCP、兼容 API、Webhook 等集成 | 按管理员级凭据保护,不是普通用户登录令牌 |
| 登录会话令牌 | 当前用户登录后的身份与权限 | 不用于替换 MCP 固定 API Key |
| 通行密钥(Passkey) | 浏览器或系统提供的无密码登录 | 与 PT 站点的下载 Passkey 无关 |
V3 新安装通过首次 Web 初始化创建管理员。日常使用可创建普通用户,并按需要开放发现、搜索、订阅、管理分类及其具体功能;权限缺省与显示以当前用户管理界面为准。
管理员可维护系统设置、站点、插件与渠道授权,权限范围较大。普通账号不应通过共享管理员密码获得功能;菜单不显示时先检查账号权限,不要直接修改前端隐藏逻辑。
账号停用、权限修改与退出登录后,要分别验证网页、App、渠道身份和已创建定时任务的实际状态。已经提交到外部服务的请求不会因为账号停用而自动撤回。
在头像菜单的个人信息与账号安全区域维护密码、OTP 和通行密钥。
APP_DOMAIN,在最终 HTTPS 域名完成注册。当前 V3 通过 用户管理 → 渠道授权 集中审批和管理成员,不再依赖各渠道旧的用户/管理员白名单作为唯一授权来源。
申请使用,或点击申请按钮。普通成员通过受控 Agent 使用搜索、订阅和下载;传统管理命令及旧业务按钮仅渠道管理员可用。渠道管理员不能继续给别人审批授权。仅使用机器人无需创建网页账号,系统内部归属身份也不等于可网页登录的用户。
同一个人在不同机器人或通知实例中分别授权。默认收件人、群组 ID、昵称与机器人 ID 都不能替代真实平台用户身份。
登录网页后,在个人信息的账号绑定区域生成一次性关联码,五分钟内在机器人 私聊 中发送:
绑定账号 关联码
关联码一次有效,生成新码会撤销旧码。关联会核对双方身份并处理该成员自己的业务归属;执行中任务或归属冲突可能拒绝合并。关联不代替审批,也不会解除已停用状态。
详细行为与升级说明见主仓渠道授权文档。
API_TOKEN 至少 16 个字符,使用足够随机的值。只向可信 MCP 或 API 客户端提供;不要以为第三方 Agent 的每次写操作都会弹出 MoviePilot 内置确认框。
轮换 API Key 后,逐项更新 MCP、通知回调、Webhook 与其他集成,再验证。优先使用请求头认证;URL 中的凭据容易进入代理日志、浏览记录和截图。
部署密钥可以使用 /run/secrets/<配置项名>;环境变量与 app.env 的优先级高于 secret,迁移时要清理旧覆盖项。格式与轮换方法见配置参考。
APP_DOMAIN 本身不会建立访问控制。