手动创建新 Emby 用户,设置实例、密码、网盘模式和到期时间
Emby 用户
约 1058 字大约 4 分钟
2026-04-18
对应前端侧边栏 开服 → Emby 用户,是 Emby 开服的核心管理页面,管理所有 Emby 实例下的用户。
页面结构
顶部标题栏包含以下操作按钮:
从 Emby Server 批量导入已有用户到 RT 数据库
将 RT 用户批量同步到 Emby Server(创建/更新状态)
下方为搜索栏(按用户名搜索)+ Emby 实例筛选下拉 + 状态筛选下拉 + 网盘模式筛选下拉。
用户列表表格
| 列名 | 说明 |
|---|---|
| 用户名 | Emby 用户名 |
| Emby 实例 | 所属 Emby 302 实例名称 |
| 网盘模式 | 「共享」或「自备」标签 |
| 状态 | active(绿色)/ disabled(红色)/ expired(琥珀色) |
| 白名单 | 白名单 标记,白名单用户不受到期扫描影响 |
| 到期时间 | 到期日期,永久用户显示「永久」标签 |
| 积分 | 用户当前积分余额(签到模式下显示) |
| TG 绑定 | 已绑定的 Telegram 用户名或 ID |
| 设备数 | 当前设备数 / 设备上限 |
| 最后签到 | 最近一次签到时间(签到模式下显示) |
| 最后播放 | 最近一次播放时间 |
| 操作 | 编辑 / 同步到 Emby / 删除 |
白名单 vs 永久
- 永久用户 — 没有到期时间,但不具备白名单特权
- 白名单用户 — 具备特权:不受到期扫描影响、可访问隐藏线路和受管控媒体库
两者独立设置,可以是「永久 + 白名单」也可以是「有到期时间 + 非白名单」。
创建用户
点击「创建用户」按钮打开弹窗:
| 配置项 | 说明 |
|---|---|
| Emby 实例 | 选择用户所属的 Emby 302 实例 |
| 用户名 | Emby 用户名 |
| 密码 | Emby 密码 |
| 网盘模式 | 共享 / 自备 |
| 到期时间 | 日期选择器,或勾选「永久」 |
新建用户自动应用实例配置
创建用户时,系统自动应用该实例的默认设备上限和媒体库屏蔽规则,无需手动设置。
编辑用户
点击用户行的编辑按钮打开弹窗,除创建时的字段外,还可编辑:
| 配置项 | 说明 |
|---|---|
| 状态 | active / disabled |
| 白名单 | 开关,标记为白名单用户 |
| 积分 | 手动调整用户积分余额 |
| 设备上限 | 最大同时播放设备数,填 0 不限制 |
| TG 用户 ID | 绑定的 Telegram 用户 ID |
| 115 配置 | 自备模式下绑定的 115 账号配置 |
| 续期 | 快捷续期按钮(+7天 / +30天 / +90天 / +365天 / 永久) |
批量操作
表格支持多选,选中用户后顶部出现批量操作工具栏:
| 操作 | 说明 |
|---|---|
| 批量设备数 | 下拉选择设备上限:1/2/3/5/10 台、不限制、封禁 |
| 批量同步 | 将选中用户同步到 Emby |
| 批量删除 | 删除选中用户 |
批量设备数修改
常见场景:活动期间临时放宽设备限制,活动结束后批量恢复。选中所有用户 → 批量设备数 → 选择目标值,一键完成。
从 Emby 导入
点击「从 Emby 导入」
弹出导入弹窗,选择 Emby 实例
系统自动对比
拉取 Emby Server 上的用户列表,与 RT 数据库对比
查看导入结果
情况 处理 用户不存在 自动创建,应用实例的同步导入默认值(时长和白名单) 同名同实例 跳过,标记为「已存在」
导入默认值
导入用户的默认时长和白名单状态由 实例管理 中的「同步导入默认值」配置决定。
同步到 Emby
同步策略
- 新用户 — 在 Emby 上创建账号并设置权限
- 已有用户 — 仅同步启用/禁用状态,不覆盖已有权限设置(包括媒体库访问权限、字幕偏好等)
这是为了避免管理员在 Emby 后台手动调整过的个性化权限被覆盖。

