☰
Jellium Desktop 用户管理完全指南:账户登录、角色权限与设备设置
2026/10/23 1:42:02 网站建设 项目流程

Jellium Desktop 用户管理完全指南:账户登录、角色权限与设备设置

【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/GitHub_Trending/je/jellium-desktop

家里跑着 Jellyfin 媒体服务器的话,账户这件事迟早要管起来:成员各用一个账号、孩子的权限要收紧、换台电脑登录又别把凭据泄露出去。Jellium Desktop 是用 Rust 编写的 Jellyfin 桌面客户端,把登录、权限和设备管理都收进同一个窗口,不用在浏览器和播放器之间来回切。

适合谁用:三种典型场景

  • 家庭共享一个媒体库:每位成员一个账号,家长用管理员账号,孩子用受限账号,观看进度各记各的。
  • 服务器跑在家里或 VPS 上:客户端只负责填服务器地址,账户、角色这些资料都留在服务端,换机器不丢数据。
  • 多台设备交替使用:同一账号在 PC 和客厅那台机器上会被识别成两台设备,播放记录分别展示,方便追溯谁在什么时候放了什么。

三步完成安装并登录

第一步,拿到源码并构建(官方也提供 Windows、macOS、Linux AppImage/Flatpak 等预编译包,直接下载即可):

git clone https://gitcode.com/GitHub_Trending/je/jellium-desktop cd jellium-desktop just deps # 一次性准备依赖 just build just run

第二步,连接页面里填入 Jellyfin 服务器地址。客户端会先探测服务器是否在线,通了才加载登录页;探测与导航流程可以看 connection.rs。

第三步,输入账号密码登录,进入媒体库。这里的登录页是客户端内嵌的官方 Jellyfin Web 界面,账号、角色、策略的创建和管理都在那个熟悉的后台里完成,不需要任何额外插件。

权限与角色在哪里配置

这套用户管理思路是:Jellyfin 服务端管账户和策略,客户端只负责"服务端授权什么,就呈现什么"。

创建账户并分配角色

用管理员账号进入后台,为每个成员建账号。服务端自带管理员、家长、儿童等角色,配合策略可以收紧内容:比如给儿童角色加上分级限制,这个账号登录后可见的就只有适龄内容。

让客户端认识这台设备

每台安装都有设备名,会出现在服务端的设备列表和播放统计里。在设置面板改名后,"书房 PC"和"客厅盒子"就一目了然,排查"谁在播放"时特别有用。

权限如何落到播放上

账号能看到什么由服务端策略决定;而拿到某条片子后走直连播放还是转码,则由客户端上报的设备档案决定——jellyfin 设备档案构建里声明了支持的容器与编码,服务端据此选播放方式,受限账号也不影响播放顺畅度。

🔒 登录状态与凭据保护

  • 会话由服务端签发:登录后客户端持有会话,从 Web 端登出或改密码,会话立即失效,不需要在客户端里做任何事。
  • 日志不泄露凭据:运行日志默认写到 build/run.log,写入前经过脱敏处理,令牌等信息会被打码,见 redact.rs。
  • 服务器地址存在本地:连接成功后写入本地设置文件,下次启动直接复用,见设置存储。公共电脑上用完,可在原生设置面板里"重置已保存服务器"清掉。

常见问题排查

问:填了地址连不上,一直转圈。 先核对地址和端口,再确认防火墙放行;连接页的探测环节在日志里都有痕迹,能看出卡在哪一步。

问:登录成功,但部分片源无法播放。 多半是转码路径的问题:在设置面板切换硬件解码模式,或打开"强制转码"再试。

问:想定位具体原因。 把日志级别调高复现一次,build/run.log 里按播放、内嵌浏览器(CEF)、mpv 等子系统分类输出,按名字过滤即可。

问:已经从浏览器管理过账号,要重新建一遍吗? 不用。客户端复用服务端的全部账户与权限数据,原来在网页后台做的配置原样生效。

【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/GitHub_Trending/je/jellium-desktop

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询