周五晚上八点半,客厅电视在放剧,卧室平板接着电影,书房里有人戴着耳机听歌——三块屏幕连的是同一台机器,你自己那台。Valence 干的就是这件事:一个跑在你自己服务器上的流媒体平台,电影、剧集、音乐、书放进同一个库,数据不出家门。它和 Jellyfin 这类老牌方案差在哪?我把它最近一个月连发的四个版本拆开看了一遍。
项目背景与目标:它明说了对手是谁
官网定位只有一句:跑在你自己服务器上的流媒体平台,你运行的一切不依赖我们的服务器。听起来是老调重弹,但看迁移功能就露底了:首次安装时,它可以从 Jellyfin、Emby 或 Plex 把账号、观看历史、收藏、评分、播放列表、合集和片头标记整体搬过来,只从旧服务器读数据、不写一个字节;Radarr、Sonarr、Prowlarr 这套下载配套也能一并接手。
这个姿态说明它不是「又一个 Jellyfin」,而是冲着存量用户去的:你已经养好了库、配好了下载链,它赌你愿意为体验再搬一次家。内容上支持电影、剧集、音乐、书和有声书五类,内置 EPUB 阅读器并记住读到的页码——这点多数媒体服务器靠插件凑,它做成了本体。
约束条件:只读的库,和一套三合一的镜像
先看它给自己上的限制。媒体目录默认只读挂载,README 里专门写了 deliberately——刮削的元数据存自己的库,不碰你的原文件。这和我之前写在线工具与本地工具取舍时提过的顾虑是同一件事:文件交给别人的服务你未必放心,交给「会写你文件」的自建软件同样要掂量,只读是最干净的答案。
部署侧:官方口径是一个 Docker 镜像同时装下服务端、Web 客户端和媒体服务,起来后走 8420 端口,首次访问先过设置向导,走完才放行应用。数据库默认 Postgres 而不是很多自建软件惯用的 SQLite——多服务并发写、会话加转码队列这种负载下这是合理选型,之前实测过SQLite 在多端并发场景的边界,数据一旦被多台机器直接读写就该换客户端/服务器架构。不想用 Postgres,官方每次 release 附了 MySQL 8.0.21+ 和 MariaDB 10.6+ 的覆盖 compose 文件;「求片」服务是独立 profile,默认不启动。
执行过程:一个月四个版本,1.7 改了什么
版本节奏是最意外的发现。按官方 changelog:v1.4.0(10 月 7 日)上 Android TV 和 Fire TV,给手机补了完整音乐播放器,并关掉一轮全应用安全排查发现的一批洞;v1.5.0(10 月 11 日)加 Live TV 带节目单,浏览器直接播放 DTS、TrueHD、7.1 和 HDR 片源不用服务器转码;v1.6.0(10 月 13 日)上架 App Store,iPhone、iPad、Apple TV 一个应用通吃;v1.7.0(10 月 24 日)把界面和管理后台整个重做。十一天一个版本,一个月走完别人一个季度的路。
1.7 的重点三件事。一是家庭档案:一个账号下多个 profile,儿童档案由家长账号管,配上本就有的角色和年龄限制,把「全家共用」这条线补完。二是片尾识别全覆盖:片头靠跨集音频指纹,片尾靠读画面,不用手打时间戳,老库里现成的剧也能直接跳。三是转码底座:硬件转码走 VideoToolbox、NVENC、VAAPI、QSV 和 AMF,部分平台带 AV1,没 GPU 回退 CPU;协商粒度在「每一台设备」而非「服务器统一出一档」,设备能吃原文件就直连,HDR 保持 PQ/HLG 真映射。Whisper 字幕、MPEG-DASH、S3 桶做媒体库也都压在这个版本里。
结果数据:官网口径和仓库体量的落差
下面的数是我 2026 年 10 月 26 日用 GitHub API 和 release 页逐项核实的。仓库 ValenceOSS/Valence,MIT 许可,12 颗星;Hacker News 上 10 月 25 日那条 Show HN,4 分 0 评论。而官网一面的功能清单,从 passkey 登录、插件沙箱到 webhook 事件目录,铺了五大板块。
两组数据放一起,落差直白:按官网口径产品完成度已经是成熟能打的样子,社区体量却还在两位数以下。再补一个细节,release 附件里的 compose.yaml 从 v1.4.0 的 11,193 字节涨到 v1.7.0 的 14,078 字节,env.example 反而从 v1.5.0 的 10,519 字节缩到 v1.7.0 的 2,132 字节——配置面一边膨胀一边收敛,作者还在大改,谈不上稳定。开发渠道的 1.8.0-dev.160 安装包已在 200 MB 量级。星数低不代表不能用,但意味着你踩的每个坑大概率没有前人答案。
可复用的部分:三个设计值得抄
抛开「要不要用它看电影」,它有几个设计放到任何自建项目里都成立。第一是插件沙箱带声明式权限:每个插件跑独立进程,安装时明确声明能访问哪些站点、能读什么、能保留多少数据,官方插件走签名。大多数自建软件的插件体系至今还是「装了就全权放行」。第二是合同先行的 API:接口先用 Zod 定契约,从契约生成 OpenAPI 3.1 文档,参考文档由服务端自己托管,一百多条路由条条有出处,API key 能建能吊销。第三是认证不偷懒:TOTP 加备份码、WebAuthn passkey、电视端走设备授权码流程——自建软件通常在认证上省事,它把这块补齐了。
不值得复制的部分:入场前先想清楚
先交代验证边界:本机没有 Docker,以上部署信息全部来自官方 README、changelog 和 release 附件的静态核对,容器我没有实跑,细节以官方最新说明为准。在这个前提下,几条劝退线要自己掂量。其一,12 星的项目没有社区踩坑库,遇到刮削错误、转码花屏这类问题,检索到的现成答案基本为零,适合能读代码的人;同类「自建替代品」项目里,Stackdome 停在 alpha 的状态就是前车之鉴。其二,直连不是承诺——官方 README 明说 HEVC 能否直接播取决于设备系统给的解码器,设备不给就等转码,小主机转 4K HDR 的代价要有数。其三,版本迭代快是双面信息,功能进得快,配置面变动也快,投产前最好钉住一个大版本。
动机层面的话放最后:自建的收益是把「看什么、和谁看」留在自己家里,前提是你愿意维护;不想碰服务器的家庭,订阅制反而省心。
常见问题
Q:Valence 现在能替代 Jellyfin 吗?
A:看你缺什么。它强在家庭多档案、书和音乐的本体支持、认证与 API 这些工程面;Jellyfin 胜在多年积累的客户端兼容和社区。爱折腾的可以现在试,求稳的等版本节奏放缓再上。
Q:从 Plex 或 Jellyfin 迁移会动我的原库吗?
A:官方口径是从旧服务器只读取,账号、观看历史、评分、片头标记搬进 Valence 自己的库,原文件和原库不写入。迁移前照例先备份。
Q:不用 Docker 能部署吗?
A:官方主推路径就是一个 compose 文件起全套,桌面客户端是 Electron 独立安装。非 Docker 路径我在官方文档里没见到明确口径,以官方最新说明为准。
Q:需要什么样的服务器配置?
A:官方没有公布最低配置清单,查不到的数字我不编。可以确定的是:有支持 NVENC/VAAPI 等的 GPU,转码压力小很多;没 GPU 回退 CPU 软转,4K HDR 对小主机不友好,Postgres 默认库也建议按多服务占用预留内存。

