jzmedia：家庭本地影视库，把硬盘和 NAS

14次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 jzmedia

家里的影片越存越多，麻烦的往往不是片子本身，而是找片的过程：电影存在硬盘里，剧集存在 NAS 上，想续看上一集，得先想起它在哪个共享文件夹。jzmedia 要解决的就是这一层：把已经拥有的本地收藏整理成一个可以在浏览器和电视上浏览的私人影视库，配上海报、元数据、字幕和观看进度。本篇讲它能管什么、部署前要确认什么、哪些家庭场景合用、哪些情况不建议硬上。

30秒速读

jzmedia 是面向家庭本地收藏的单实例影视库应用，用 Python、FastAPI、SQLite 与 Vue 3 构建。它连接电脑、NAS 或网络共享目录，扫描媒体后在浏览器里提供元数据浏览、播放与进度管理，另有独立的 Android TV 客户端与 DLNA 投屏能力。定位很明确：只服务家庭或受信任网络里的私人收藏，不做多用户平台。

项目信息

项目	jzmedia
定位	家庭本地私人影视库
技术栈	Python、FastAPI、SQLite、Vue 3
访问端	浏览器网页端、Android TV 客户端、支持 DLNA 视频接收的电视
媒体来源	本地目录、SMB、NFS、NFO、海报
部署方式	Docker、Compose、离线镜像、Linux 与 WSL 源码运行
获取方式	GitHub 开源仓库，见文末下载地址

核心能力

电影和剧集都支持多版本，选版本时各自的观看进度分开保存，同一部片的不同版本不会互相顶掉进度。
网页播放能处理样式字幕与图片字幕，音轨可以切换，播放时能预览进度，换字幕换音轨不用退出重进。
已有资料可以直接用：本地目录、SMB 或 NFS 共享接进来，已有的 NFO 与海报能离线入库，不用每次都联网重新匹配。
找片不只靠片名：可以按类型、地区、评分和观看状态筛选，也能沿着演员或合集一路找下去。
文件整理先给预览：路径变化和冲突先列出来确认，命名规则兼容常见的整理习惯，关联文件也能一并处理。
多端围绕同一个库：浏览器、Android TV 与支持 DLNA 视频接收的电视共享进度，也能把正在看的内容投到电视上。

上手指南

先确认运行环境：部署目标是 Linux amd64 电脑或 NAS，媒体目录必须可读，数据目录必须可写，权限没给对，后面扫描和写入都会卡住。
选一种部署方式：有 Docker 的环境直接走容器部署；内网或外网受限的机器用离线镜像；想改代码或做二次开发再走源码运行，普通家庭用户没必要从源码起步。
定好网络模式：是否需要 DLNA 发现，直接决定用桥接还是主机网络，部署前先想清楚电视投屏是不是刚需，装完再改网络模式等于返工。
挂目录时把用户身份写对：按部署命令里的 UID 与 GID 设置数据目录归属，媒体目录只读挂载也够用，数据目录一定要可写。
先小批量验证再全量入库：挑几部电影和一部多集剧集试扫描，确认海报与 NFO 识别、字幕与音轨切换、跨端进度同步都没问题，再把整个收藏交进去。

部署方式怎么选

部署方式	适合谁	要注意什么
Docker 与 Compose	上手最快，适合大多数家庭服务器	需要 Docker 环境，版本标签建议固定，不要长期追最新标签
离线镜像	外网受限或内网 NAS	镜像与版本要成套，先确认架构是不是 Linux amd64
Linux 与 WSL 源码运行	想改代码或排障的开发者	依赖细节以对应版本文档为准，普通用户不必选这条路

明确取舍

结论先行：已经有一堆本地影片、有一点 Docker 或 NAS 操作基础、希望网页与电视共用一个库的人，jzmedia 值得优先试；已有 NFO 与海报想离线利用、看重整理前能预览的人，会更喜欢它。反过来，四种情况不建议硬上：第一，需要给家人分账号、做权限隔离，它是单实例定位，没有完整多用户登录与权限系统；第二，打算公开到互联网上提供服务，它的适用范围就是家庭或受信任网络；第三，指望它包办转码效果，实际播放与转码取决于服务器、设备与网络条件；第四，想要 AI 匹配与自然语言搜索，却不打算自配模型服务与密钥，这两项能力依赖外部模型服务，普通搜索与手动匹配可以独立使用，不用为此勉强上 AI。