首次登录与基础设置

按本页顺序完成。推荐先使用“系统初始化”建立目录和填充路径，再配置 TMDB、Emby 并执行首次全量同步。第一次不要急着修改命名规则和洗版规则。

已有自己的 115 目录结构时，不要运行目录创建步骤，直接按“手动填写已有目录”配置。需要自定义电影或剧集目录和文件名时，参见命名与目录。

1. 读取临时管理员密码

用户名固定为 admin。

在 NAS 容器管理器中打开 QPlay 容器的“终端”，执行：

cat /config/initial_admin_password

复制显示的临时密码并登录。系统会要求设置至少 10 个字符的新密码。改完后临时密码会自动删除。

临时密码文件不存在

它通常表示你已经改过密码。先看容器日志，不要删除 config 或重新初始化数据。

2. 规划 115 中的目录

推荐让系统在 /qplay 下创建：

/qplay/待整理     放还没有整理的影片
/qplay/媒体库     放整理好、需要生成 STRM 的影片
/qplay/未识别     放暂时识别失败的文件
/qplay/临时       保存并发播放或子账号播放所需的临时副本

这些是 115 网盘中的路径，不是服务器上的 ~/qplay/media。全局临时目录用于同时播放和子账号播放所需的临时副本。

如果只想扫描已经整理好的内容，只需要媒体库目录；“待整理”和“未识别”可以留空。

3. 添加 115 主账号

1. 点击页面右上角“115 账号”。
2. 账号用途选择“主账号 · 提供资源”。
3. 点击“生成二维码”。
4. 用 115 手机客户端扫码并确认。
5. 确认账号出现在“已连接账号”中且已启用。

主账号不需要单独配置临时目录。Cookie 与密码一样敏感，不要发给别人；账号凭据由 QPlay 管理。

4. 运行系统初始化

主账号连接成功后：

1. 在“115 账号”窗口顶部点击“系统初始化”。
2. 保存位置保留 /qplay，或点击“浏览 115”选择其他 非根目录。
3. 新用户保留“创建基础文件夹”“应用分类策略”和“填充路径设置”勾选；需要一级目录时同时启用“一级分类”。
4. 第一次先取消“开始全量同步”。等 TMDB、Emby 和 STRM 播放入口配置完成后再同步。
5. 点击“开始初始化”。

初始化会复用已存在的同名目录，创建“待整理”“媒体库”“未识别”“临时”目录，并按设置中的分类选项建立媒体库目录。

“启用一级分类”会按当前 category.yaml 建立一级目录和对应分类。内置配置默认使用 电影 / 剧集，不会默认启用“动漫”一级目录；按需启用动漫或使用旧版 Movies / TV 兼容目录的说明见命名与目录。入库后不要频繁切换分类方式。

手动填写已有目录

已有目录结构时，进入“设置 → 存储与同步”，按实际路径填写：

页面项目	推荐填写
STRM 播放入口	http://服务器IP:8099
STRM 保存目录	/media
待整理网盘绝对路径	例如 /qplay/待整理，不用自动整理可留空
媒体库网盘绝对路径	例如 /qplay/媒体库，必填
未识别网盘绝对路径	例如 /qplay/未识别，不用自动整理可留空
临时网盘绝对路径	例如 /qplay/临时，主账号并发复制播放使用
定时任务	保留默认值即可
子账号临时目录清理时间	不需要时关闭；需要时按页面提示设置
全量同步已有 STRM	选择“覆盖”

四个全局网盘路径都在此处修改；主账号卡片不再保留临时目录配置。子账号仍可在账号卡片中配置各自的播放临时目录。其余文件后缀先保留默认值。

完整字段、默认值、洗版规则和路径编码说明见设置参考。首次配置只需填写必需路径和服务地址，其他选项可以保留默认值。

第一次不要随便运行自动整理

默认“跳过”同名文件时，可能删除“待整理”中的同名待处理文件。先用少量测试文件确认路径和规则。只做全量同步不会移动 115 文件。

5. 设置 TMDB 与 Emby

进入“设置 → 媒体服务”。

TMDB

填写自己的 TMDB API Key。没有 Key 时，自动整理不能可靠识别电影和剧集。页面帮助链接可直接前往 TMDB 申请。

Emby 地址

填写 QPlay 容器能够访问 的 Emby 地址：

Emby 在哪里	填写示例
与 QPlay 同一台服务器	http://host.docker.internal:8096
另一台局域网机器	http://192.168.1.30:8096
与 QPlay 在同一 Docker 网络，容器名为 emby	http://emby:8096

不要填写 localhost:8096，它会指向 QPlay 容器自己。

在 Emby 后台创建 API Key，再填入“Emby API Key”。

6. 保存并做第一次同步

1. 点击“保存设置”。
2. 第一次保存 Emby 地址后，在服务器执行 docker restart qplay 使播放入口配置生效；刷新页面并重新登录。
3. 回到“115 账号”，确认目录配置中的媒体库和临时目录显示“已配置”。
4. 如果文件已经在媒体库目录，回到“总览”运行“全量同步”。
5. 如果文件在待整理目录，先放入少量测试文件运行“自动整理”，确认结果后再运行“全量同步”。
6. 在“记录 → STRM 记录”中看到文件，就表示 QPlay 已生成 STRM。

全量同步会逐个读取 115 目录，大媒体库需要等待一段时间。不要连续重复点击。以后再次使用“系统初始化”时，按需取消不想重复执行的步骤；同步任务运行期间不能初始化。

后续可以按需配置记录与缓存、内置插件、Telegram 与企业微信和HTTPS 与网络配置。

下一步：连接 Emby 并开始播放。