版本说明
当前版本: v3.5.1
更新日期: 2025-06-04
配置说明
EmbyUserHub配置加载：
配置文件config.py默认路径：/opt/embyuserhub/config/config.py
当Docker容器重启时，系统会使用配置文件中的设置。
配置项详解
基础配置
配置项 | 说明 | 默认值 |
|---|
ADMIN_USERNAME | 管理员用户名 | admin |
ADMIN_PASSWORD | 管理员密码(支持明文或SHA256) | admin123 |
TOTP_ISSUER | 两步验证发行方名称 | EmbyUserHub |
SYSTEM_VERSION | 系统版本 | 3.5.1 |
USERNAME_PREFIX | 卡密创建用户名前缀 | emby |
USERNAME_DIGITS | 后缀数字长度 | 6 |
数据库配置
配置项 | 说明 | 默认值 |
|---|
DATABASE | SQLite数据库文件路径（相对于项目根目录） | 'data/database.db' |
日志配置
配置项 | 说明 | 默认值 |
|---|
APP_LOG_FILE | 应用日志文件路径 | "data/app.log" |
APP_LOG_MAX_SIZE | 应用日志最大大小 (bytes) | 10485760 (10MB) |
APP_LOG_BACKUP_COUNT | 应用日志备份数量 | 5 |
LOG_LEVEL | 日志记录等级 (DEBUG, INFO, WARNING, ERROR) | 'INFO' |
LOG_RETENTION_DAYS | 日志保留天数 | 7 |
ENABLE_OPERATION_LOG | 是否记录详细操作日志 | False |
Emby服务器配置
配置项 | 说明 | 默认值 |
|---|
EMBY_SERVER | Emby服务器地址(http://ip:8096) | '根据实际服务器地址' |
ADMIN_TOKEN | 管理员API密钥（从Emby管理页面获取） | - |
TEMPLATE_USER_ID | 模板用户ID（新用户将复制此用户的权限设置） | 从Emby模板用户地址栏中获取 |
Bark通知配置
配置项 | 说明 | 默认值 |
|---|
ENABLE_EXPIRE_NOTIFICATION | 是否启用到期通知 | False |
ENABLE_RENEW_NOTIFICATION | 是否启用续费通知 | False |
ENABLE_ACTIVATION_NOTIFICATION | 是否启用卡密激活通知 | False |
BARK_URL | Bark推送地址（可选，不使用则留空） | '' |
BARK_TIMEOUT | Bark请求超时时间（秒） | 15 |
BARK_SHOW_SSL_WARNINGS | 是否显示SSL警告 | False |
BARK_ALLOW_INSECURE | 是否允许不安全的HTTPS请求 | False |
Bark URL格式说明:
安全配置
配置项 | 说明 | 默认值 |
|---|
ENABLE_2FA | 是否启用两步验证 | False |
LOGIN_ATTEMPT_LIMIT | 登录尝试限制次数 | 5 |
LOGIN_BLOCK_TIME | 登录锁定时间（秒） | 1800 |
SECURITY_CODE | 安全访问码（用于保护管理页面） | 'admin123' |
ENABLE_SECURITY_ACCESS | 是否启用安全访问 | True |
FLASK_SECRET_KEY | Flask会话加密密钥 | wsH2KMJKJIQdwnRueNflgLqNFK6qiRGY2K-DfTKNWXM |
有效期选项
配置项 | 说明 | 默认值 |
|---|
VALIDITY_OPTIONS | 可配置的会员有效期选项 | 见下表 |
默认有效期选项:
{
'1d': 1, # 1天会员
'1m': 30, # 1个月会员
'3m': 90, # 3个月会员
'6m': 180, # 6个月会员
'12m': 365 # 12个月会员
}
系统配置
配置项 | 说明 | 默认值 |
|---|
CHECK_EXPIRE_INTERVAL | 检查过期用户间隔（分钟） | 60 |
CLEAN_USED_CODES_DAYS | 清理已使用卡密的天数 | 7 |
清理设置
配置项 | 说明 | 默认值 |
|---|
AUTO_DELETE_EXPIRED_USERS_DAYS | 自动删除过期用户天数 | 7 |
ENABLE_AUTO_DELETE_EXPIRED_USERS | 是否启用自动删除过期用户 | False |
AUTO_DELETE_EXPIRE_INTERVAL | 自动删除过期用户间隔(分钟) | 60 |
时区配置
配置项 | 说明 | 默认值 |
|---|
SHANGHAI_OFFSET | 上海时区偏移(UTC+8) | timedelta(hours=8) |
TZ | 容器时区 | 'Asia/Shanghai' |
定时任务模式
配置项 | 说明 | 默认值 |
|---|
CRON_MODE | 定时任务模式 (thread/daemon) | 'thread' |
性能优化选项
配置项 | 说明 | 默认值 |
|---|
DATABASE_TIMEOUT | 数据库操作超时时间(秒) | 60 |
DATABASE_RETRY_COUNT | 数据库重试次数 | 3 |
THREAD_POOL_SIZE | 并行操作线程池大小 | 5 |
配置文件优先级说明
为了持久化配置，推荐在config.py文件中设置配置项。
注意事项
评论