跳转至

分区通行码⚓︎

分区通行码用于临时开放某些媒体库，例如只给用户开放 4K、演唱会、纪录片 等分区一段时间。

配置分区⚓︎

在 config.json 中配置 partition_libs：

{
  "partition_libs": {
    "4K": ["4K 电影", "4K 剧集"],
    "Anime": ["动画电影", "番剧"]
  }
}

左侧是分区名称，右侧是 Emby 媒体库名称列表。媒体库名称需要和 Emby 中完全一致。

开启到期检查⚓︎

{
  "schedall": {
    "partition_check": true
  }
}

开启后 Bot 会定时检查分区授权是否到期，到期后回收对应媒体库权限。

管理员生成通行码⚓︎

进入 /config 面板，打开“分区通行码”。

创建格式：

分区名 时长(天) 数量

示例：

4K 3 10

含义：生成 10 个 4K 分区通行码，每个有效期 3 天。

Tip

单次最多生成 500 个，数量较多时建议分批创建。

用户兑换⚓︎

用户拿到通行码后，在 Bot 中兑换。兑换成功后：

  • Bot 记录兑换用户、Emby ID、分区和到期时间。
  • Bot 调用 Emby API 显示对应媒体库。
  • 用户会收到可访问到期时间。

管理功能⚓︎

分区通行码面板支持：

  • 创建通行码。
  • 查看未使用通行码。
  • 删除指定通行码。
  • 清理全部未使用通行码。
  • 清理已使用记录。
  • 清理全部分区数据。

Danger

“清理全部分区数据”会删除未使用通行码和已使用授权记录。执行前请确认不需要追溯历史授权。

排查⚓︎

提示未配置分区⚓︎

检查 partition_libs 是否为空，且分区名是否和生成通行码时输入的一致。

兑换成功但媒体库不可见⚓︎

检查：

  • partition_libs 中的媒体库名称是否和 Emby 完全一致。
  • Emby API key 是否有修改用户策略的权限。
  • 用户是否已经绑定 Emby 账号。

到期后没有回收⚓︎

检查 schedall.partition_check 是否为 true，并查看 Bot 日志中是否有分区检查任务报错。