hrfee/jfa-go

jfa-go 镜像说明

镜像概述

jfa-go是一款针对Jellyfin（及Emby）媒体服务器的用户管理应用，采用Go语言重写自Python版本的jellyfin-accounts，旨在提升效率与速度，提供邀请制账户创建等便捷管理功能。

核心功能

• 邀请制账户创建：通过链接或邮件发送邀请，支持设置有效期和使用次数，可分配预设账户配置（权限、主页布局等），并验证密码强度。
• Ombi集成：自动为新用户创建Ombi账户，同步***与登录信息及预设权限。
• 账户管理：批量或单独应用用户设置，删除用户时可发送带原因的邮件通知。
• 存储：收集现有用户，新用户注册时需提供***，可选以***代替用户名登录。
• 密码重置：读取Jellyfin密码重置PIN并通过邮件发送给用户。
• 通知功能：账户创建或邀请过期时发送通知。
• Jellyfin认证：使用Jellyfin账户登录jfa-go，支持多用户使用。
• 自定义外观：设置邮件和页面的联系/帮助信息，提供明暗主题。

使用场景

• 家庭或小团队媒体服务器：通过邀请制管理用户注册，避免手动创建账户。
• 需要批量管理用户权限的场景：快速应用预设配置到多个用户。
• 简化密码重置流程：自动发送重置PIN给用户，减少管理员负担。

配置说明

Docker部署示例

bash
docker create \
             --name "jfa-go" \
             -p 8056:8056 \
             # -p 8057:8057 若使用TLS
             -v /path/to/.config/jfa-go:/data \ # 存储配置文件及数据的路径
             -v /path/to/jellyfin:/jf \ # Jellyfin配置目录路径
             -v /etc/localtime:/etc/localtime:ro \ # 同步系统时间
             hrfee/jfa-go # 使用hrfee/jfa-go:unstable获取最新Git构建版本

启动参数说明

运行jfa-go时可指定以下参数：

• -config string：替代配置文件路径（默认：~/.config/jfa-go/config.ini）
• -data string：替代数据目录路径（默认：~/.config/jfa-go）
• -debug：启用调试日志和pprof
• -host string：替代Web UI绑定地址
• -port int：替代Web UI端口
• -swagger：在/swagger/index.html启用Swagger文档

首次使用

启动后访问localhost:8056完成设置向导，刷新页面即可使用。默认不后台运行，需自行配置守护进程。