OneList 是一个**专业的影视库管理系统**，它可以帮助你： - 🎬 **自动整理**你的影视资源（从 Alist 等网盘服务中扫描） - 🖼️ **智能刮削**影视元数据（海报、简介、演员信息等） - 📊 **美观展示**你的影视库（类似 Netflix 的界面） - ⭐ **记录观影**进度、收藏和评分 账号/密码在懒猫微服的文件管理中，找到 `/config/config.env`，查看默认： UserEmail=xxxx@qq.com # 这是你的管理员账号 UserPassword=xxxxx # 这是你的管理员密码 登录成功后，按以下顺序配置 OneList： ### 1. 配置 TMDB API Key（必需） TMDB（TheMovieDB）是一个免费的影视数据库，OneList 需要它来获取影视信息。 #### 步骤 1.1：申请 TMDB API Key 1. 访问 [https://www.themoviedb.org/](https://www.themoviedb.org/) 2. 注册一个免费账号 3. 登录后，进入 [设置 → API](https://www.themoviedb.org/settings/api) 4. 点击「Request an API Key」 5. 选择「Developer」类型 6. 填写简单的使用说明（可以随便写，比如"Personal media library"） 7. 同意条款后提交 8. 复制生成的 **API Key (v3 auth)** #### 步骤 1.2：在 OneList 中配置 1. 在 OneList 界面点击「设置」或「配置」 2. 找到「TMDB API Key」输入框 3. 粘贴你的 API Key 4. 保存 **或者直接修改配置文件**： ```bash # 编辑 /config/config.env KeyDb=你的TMDB_API_Key ``` --- ### 2. 添加 Alist 服务（必需） OneList 需要连接到 Alist 来扫描你的影视文件。 #### 前置要求 - ✅ 你已经部署了 Alist 服务 - ✅ Alist 中有影视文件（按标准命名） - ✅ 知道 Alist 的访问地址 #### 步骤 2.1：在 OneList 中添加 Alist 1. 进入 OneList 主界面 2. 点击「添加 Alist」或「数据源管理」 3. 填写 Alist 信息： ``` 名称: 我的网盘（自定义） 地址: https://your-alist.example.com 用户名: admin（如果 Alist 需要登录） 密码: ******（如果 Alist 需要登录） ``` 4. 点击「测试连接」 5. 连接成功后，点击「保存」 #### 步骤 2.2：验证连接 保存后，你应该能看到 Alist 中的文件目录列表。 --- ### 3. 创建媒体库 现在可以开始创建你的影视库了！ #### 步骤 3.1：创建电影库 1. 点击「创建媒体库」或「添加库」 2. 选择类型：**电影** 3. 填写信息： ``` 库名称: 我的电影（自定义） 数据源: 选择刚才添加的 Alist 路径: /电影 或 /Movies（选择 Alist 中存放电影的文件夹） ``` 4. 配置选项： - ✅ 启用自动刮削 - ✅ 下载海报和背景图 - ✅ 启用自动监控（检测新文件） 5. 点击「创建」 #### 步骤 3.2：创建电视剧库 1. 点击「创建媒体库」 2. 选择类型：**电视剧** 3. 填写信息： ``` 库名称: 我的剧集（自定义） 数据源: 选择 Alist 路径: /电视剧 或 /TVShows ``` 4. 配置选项（同上） 5. 点击「创建」 --- ### 4. 扫描和刮削 #### 步骤 4.1：开始扫描 1. 进入刚创建的媒体库 2. 点击「开始扫描」或「立即刷新」 3. OneList 会： - 📂 扫描 Alist 中的视频文件 - 🔍 识别影视名称和年份 - 🌐 从 TMDB 获取元数据 - 🖼️ 下载海报和背景图 #### 步骤 4.2：等待完成 首次扫描可能需要较长时间（取决于文件数量）： - 10 部电影：约 2-5 分钟 - 100 部电影：约 20-30 分钟 - 1000+ 部电影：可能需要数小时