​EmbyUserHub.png​

📋 系统概述

EmbyUserHub（Emby用户管理）是一款专为Emby服务器管理员开发的Docker环境轻量级Emby用户管理系统，集成了卡密激活、自动化管理和用户控制面板等功能，让您的媒体服务器管理工作变得轻松高效。(Emby用户 Emby用户管理 Emby用户管理系统)

感谢支持👉· 授权是最温暖的认可

版本(v3.7.8)的主要更新

  • 用户中心登录页面头像优化

    • 优先使用Emby模板用户头像，如果没有则使用默认图标

  • 用户中心用户名修改

    • 支持中文、字母、数字、下划线和短横线的用户名

  • 用户管理用户名同步

  • 修复了已知的问题。

查看更多

🌟 核心特性

🔑 卡密管理系统

  • 多样化卡密生成 - 支持1天、7天、30天、365天等多种有效期类型

  • 批量操作支持 - 批量生成、复制和管理卡密，提升运营效率

  • 自助激活流程 - 用户通过简单页面自助完成账户激活和续费

  • 清理机制 - 自动清理过期和已使用的卡密记录

👥 用户管理中心

  • 用户导入同步 - 从Emby服务器一键导入现有用户到管理系统

  • 实时会话监控 - 监控用户播放状态、设备使用情况和流量消耗

  • 批量用户操作 - 支持批量启用、禁用、删除和权限管理

  • 模板权限继承 - 新用户自动继承模板用户的权限配置

📧 通知系统

  • 邮件通知服务 - 支持SMTP配置，提供到期、续费、激活等多种邮件通知

  • Bark消息推送 - 实时推送用户状态变更和系统重要事件

🎫 工单服务

  • 问题跟踪处理 - 用户可创建工单，管理员统一处理和回复

  • 状态实时同步 - 工单状态变更时自动通知相关人员

  • 附件上传支持 - 支持文件附件，便于问题描述和解决

📊 数据

  • 用户状态统计 - 实时展示用户数量、状态分布和增长趋势

  • 卡密库存管理 - 统计各类型卡密的使用情况和剩余库存

  • 媒体库信息 - 展示媒体服务器的内容统计和最新入库

🔒 安全保障机制

  • 两步验证 - 管理员账户支持2FA双重认证保护

  • 访问控制 - 通过安全访问码保护管理界面

🎬 媒体中心功能

  • 媒体库展示 - 集中展示服务器所有媒体内容

  • 最新入库 - 实时显示最新添加的媒体资源

  • 分类统计 - 按电影、剧集、音乐等类型统计展示

📊 用户界面展示

管理员控制面板

​C-1.png

Z-1.jpg

授权使用说明：由于花费了许多精力与时间​，1）卡密管理 2）账户列表 需要许可证才能使用，感谢您的给予支持，敬请理解。

卡密管理界面

​C-3.png

k-1.jpg
​

用户管理页面

​C-2.png

U-1.jpg​

用户自助服务界面

​

PS.购买卡密，前往商城是一个接口链接（链接在管理员主页设置中的商城设置配置）
由于支付接口的某些原因，所以采用目前这种方式提供用于跳转到第三方下单发卡（比如跳转到独角数卡页面，91卡券）​通过发放卡密进行创建Emby账户或者对于已有账户用卡密进行续费。

💻 部署方式

一键安装部署（推荐）

使用以下命令可以一键安装和管理EmbyUserHub：

bash -c "$(curl -fsSL https://sh.mmdns.top/embyuserhub_install.sh)"

一键脚本提供以下功能：

  • 自动检测和安装Docker

  • 安装/更新EmbyUserHub

  • 重启服务

  • 查看日志

  • 备份/恢复数据库

  • 管理两步验证

  • 高级系统维护工具

Docker手动部署

如果需要手动部署，可以使用以下命令：

# 拉取最新镜像
docker pull mmbao/embyuserhub:latest

# 运行容器
docker run -d \
  --name embyuserhub \
  --restart always \
  --network host \
  -v "/opt/embyuserhub/data:/app/data" \
  -v "/opt/embyuserhub/config:/app/config" \
  -e TZ=Asia/Shanghai \
  -e FLASK_SECRET_KEY=wsH2KMJKJIQdwnRueNflgLqNFK6qiRGY2K-DfTKNWXM \
  -e ENABLE_SECURITY_ACCESS=True \
  -e CRON_MODE=thread \
  mmbao/embyuserhub:latest

Flask secret key 建议使用以下命令生成安全密钥：

python3 -c "import secrets; print(secrets.token_urlsafe(32))"

⚙️ 配置说明

首次启动后，系统会自动创建配置文件模板（为了持久化配置，推荐在config.py文件中设置配置项），配置文件位于:

/opt/embyuserhub/config/config.py

关键配置项:

配置项

说明

建议值

​EMBY_SERVER​

Emby服务器地址

您的服务器完整URL

​ADMIN_TOKEN​

管理员API密钥

Emby Server管理面板<高级><API密钥>获取

​TEMPLATE_USER_ID​

模板用户ID

作为新用户模板的用户GUID.Get: Emby Server管理面板<用户><地址栏>userId=<ef60e3ac63c64c92b5640dbf41e8xxxx>

​SECURITY_CODE​

安全访问码

复杂且唯一的字符串

​FLASK_SECRET_KEY​

会话加密密钥

随机生成的长字符串

完整配置项说明请参考配置文档。

📱 Bark通知功能

EmbyUserHub支持多种场景的Bark通知推送:

  • 到期通知 - 用户账户即将到期时推送提醒

  • 续费通知 - 用户成功续费时推送确认

  • 激活通知 - 新用户激活账户时推送提醒

配置示例:

ENABLE_EXPIRE_NOTIFICATION = True
ENABLE_RENEW_NOTIFICATION = True
ENABLE_ACTIVATION_NOTIFICATION = True
BARK_URL = 'https://api.day.app/yourkey/'

🛡️ 安全功能

两步验证

启用两步验证后，管理员登录需要提供验证码，大大提升账户安全性。

配置示例:

ENABLE_2FA = True
TOTP_ISSUER = 'MyEmbyService'  # 在验证器APP中显示的名称

安全访问码

通过安全访问码保护管理界面，访问格式为:

http://your_ip:29045/your_secure_code
http://your_ip:29045?code=your_secure_code

🔄 自动化任务

过期用户检查

系统会定期检查并处理过期用户，可配置检查频率:

CHECK_EXPIRE_INTERVAL = 60  # 每60分钟检查一次

自动清理功能

可配置自动清理已使用卡密和过期用户:

CLEAN_USED_CODES_DAYS = 30  # 30天后清理已使用卡密
ENABLE_AUTO_DELETE_EXPIRED_USERS = True  # 启用自动删除过期用户
AUTO_DELETE_EXPIRED_USERS_DAYS = 14  # 过期14天后删除用户

📊 性能优化

系统提供多项性能优化选项:

DATABASE_TIMEOUT = 120  # 数据库操作超时时间
DATABASE_RETRY_COUNT = 5  # 数据库操作重试次数
THREAD_POOL_SIZE = 8  # 并行任务线程池大小

🔄 系统维护

数据备份

建议定期备份数据目录下的database.db文件:

cp /opt/embyuserhub/data/database.db /backup/database_$(date +%Y%m%d).db

免责声明

本系统（EmbyUserHub）由个人独立开发，旨在为 Emby 媒体服务器的管理员提供本地用户账号的创建、查看与管理辅助功能，不涉及内容播放、内容分发、云端同步或远程服务。

本系统不包含任何影视资源或链接，亦不提供任何破解、绕过认证或侵犯第三方权益的功能。

使用本系统的用户应遵守其所在国家或地区的相关法律法规，确保其行为合法合规。

因用户非法使用本系统所造成的任何后果，开发者不承担任何法律责任。

如有任何疑问或建议，请联系开发者。

感谢支持

马小兔感谢您的支持！如果对您有帮助请支持我。

如有任何问题，欢迎随时联系我，祝您生活愉快！

更新日期：2025年7月19日

📚 更多资源

📞 支持与反馈

如果您在使用过程中遇到任何问题，请通过以下方式联系我:

EmbyUserHub - 让您的Emby管理更简单、更高效！