Jellium Desktop 用户管理：四步配好家庭共享媒体账户
【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/GitHub_Trending/je/jellium-desktop
Jellium Desktop 是一款非官方 Jellyfin 桌面客户端，它的用户管理链路集中在服务器连接与账户登录：按四步把客户端接到自家服务器，全家即可分账号登录、各用各的权限。
🏠 场景切入
家里共用一台媒体服务器：家长要管理媒体库，孩子只看动画片。用浏览器打开服务器网页，地址、账号、设备信息全靠收藏夹和记忆，换台电脑又要重来一遍。Jellium Desktop 把服务器连接、账户登录、设备识别收进一个专用客户端，账户与权限的管理仍由 Jellyfin 服务端负责，客户端只管接对、登对。
🚀 从零跑起来
- 获取源码：
git clone https://gitcode.com/GitHub_Trending/je/jellium-desktop - 构建客户端：
cd jellium-desktop && cargo build - 启动应用：
just run，在连接界面输入服务器地址（带端口的根地址），点 Connect - 探测成功后进入内置登录页，输入用户名和密码，看到媒体库界面即连接成功
- 下次启动会自动带出上次保存的服务器地址，只需登录账号即可
📋 能力清单
| 能力 | 一句话说明 | 入口或配置位置 |
|---|---|---|
| 服务器探测 | 补全协议、确认服务器可达后才加载页面 | 连接界面地址输入框 |
| 账户登录 | 接入后展示 Jellyfin 登录页，每个家庭成员用各自账号 | 连接成功后的登录界面 |
| 地址持久化 | server_url、窗口大小等本地设置跨重启保留 | settings.json（由设置模块托管） |
| 设备档案注册 | 按本机解码能力生成 DeviceProfile，服务端据此决定直连或转码 | 连接时自动完成 |
| 角色与权限分配 | 建号、定角色、内容过滤都在服务端完成，客户端按所获权限登录 | Jellyfin 服务器管理后台（登录后进入） |
关键在连接与登录这条链。服务器地址解析与探测模块 先把你输入的地址规范化（缺省自动补http://、统一大小写），再提取出服务器根地址做可达性校验；连接状态机 按 表单、探测中、加载中、已连接 推进界面，任何一步失败都会回到表单而不是卡死。界面层在连接屏幕：地址输入、连接按钮、失败重试都在这里。
账户分工上，客户端不保存账号数据。建号、分配管理员或标准角色由 Jellyfin 服务端管理界面完成，设置持久化模块 只负责记住本机设备的server_url，让重启后地址不丢。
进阶与扩展
解码能力注册值得细看：设备档案生成逻辑 依据本机 mpv 实际支持的解码器生成编解码列表，换显卡或调整硬件解码后，服务端直连策略会随之变化。hwdec、force_transcoding等开关的默认值与持久化结构在配置文件结构 中定义。
⚠️ 避坑提醒
- 地址带错路径导致探测失败：只填根地址如
http://192.168.1.10:8096，不要带/web之类后缀。 - macOS 首次启动被隔离拦截：安装后执行
sudo xattr -cr /Applications/Jellium\ Desktop.app解除隔离属性。 - 子账号能看到却无权操作：角色权限在服务器端管理，客户端无法授权，请到服务器后台为其分配正确角色。
- 换了服务器地址不生效：地址缓存在 settings.json 中，需在连接界面更新并重新保存。
如果你在家中运行 Jellyfin 服务器，这套连接与账户流程解决的是接入的最后一公里：地址一次记住、登录一步到位、全家分账号互不干扰。客户端负责连接与播放，服务器负责权限与内容，两边各司其职。
【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/GitHub_Trending/je/jellium-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
