Antra Navidrome/Jellyfin/Plex30分钟搭建家庭音乐流媒体服务器附目录结构详解【免费下载链接】AntraA desktop music library builder that turns Spotify, Youtube Music Apple Music, Amazon Music, Tidal, Qobuz, and Deezer links into fully tagged local library in FLAC, ALAC, Dolby Atmos, AAC, or MP3.项目地址: https://gitcode.com/gh_mirrors/an/AntraAntra是一款桌面音乐库构建工具能把 Spotify、Apple Music、YouTube Music、Amazon Music、Tidal、Qobuz、Deezer 的链接自动转成带完整标签的本地无损音乐库FLAC / ALAC / AAC / MP3并把文件整理成媒体服务器开箱即用的目录结构。配合Navidrome、Jellyfin 或 Plex30 分钟就能拥有属于自己的家庭音乐流媒体服务器。为什么选 Antra 做本地音乐库很多新手在搭建家庭音乐服务器时最头疼的不是服务器而是音乐从哪来、怎么整理。手动下载 手动打标签 手动建文件夹几小时就劝退了。Antra 把这三件事全自动化了环节传统做法用 Antra下载音源逐个平台手动扒粘贴链接自动走多源解析链优先无损打标签用其他工具二次处理自动写入标题、艺人、专辑、封面、流派、同步歌词、ISRC整理目录手动建文件夹自动落进艺术家 / 专辑 / 曲目结构重复去重靠肉眼基于ISRC全库去重同一首歌不会下两遍关键点在于Antra 输出的目录和编号方式就是Navidrome / Jellyfin / Plex期望的格式——所以不用改配置服务器直接就能正确识别艺人、专辑和碟片。它的启动界面就写着Optimized for Navidrome Jellyfin见 App.svelte。第一步安装 Antra约 3 分钟Antra 是单文件可执行程序无需安装 Python 或任何依赖。按平台下载对应文件即可详见 README.md平台文件Windows 10Antra.exemacOS 12Apple SiliconAntra-macOS.dmgmacOS 12IntelAntra-macOS-Intel.dmgLinuxAntra-Linux.AppImage 如果你更想看实现原理也可以从源码运行git clone https://gitcode.com/gh_mirrors/an/Antra目录结构、解析链和打标签逻辑都在 antra/ 下。第二步设置音乐库目录 选格式约 5 分钟首次启动会进入Setup引导页只需做两件事选择 Music Library Folder音乐库根目录⚠️ 这里的路径要指向媒体服务器的音乐目录。如果你打算用 Docker 跑 Navidrome就把它指向容器挂载的那个子目录例如D:\Music或~/Music。引导页的提示语就是Navidrome / Jellyfin compatible — point this at your media servers music directory.见 App.svelte选择输出格式主流家庭服务器推荐FLAC无损、通用苹果设备多可选ALAC想省空间选AAC / MP3。无损模式下 Antra 会并行查询所有支持的无损源挑选比特深度和采样率最高的那个甚至能拿到 24-bit/96kHz 的高解析母带而不是只取第一个命中见 FEATURES.md。第三步粘贴链接开始批量下载约 15 分钟切到URL标签把 Spotify / Apple Music / Amazon Music / YouTube Music 的歌曲、专辑或歌单链接粘进去支持多行 / 逗号分隔。粘贴后先出完整曲目列表确认无误再点Add to Library。默认并行下载 2 首带实时进度条几百首歌的歌单也能很快跑完。想批量导入自己账号里所有歌单连接 Spotify 账号后直接进My Library标签点击卡片即可连复制 URL 都省了。失败不慌下完会有专门的Failed (N)面板可以单曲重试或Retry All一键重试。Antra 目录结构详解媒体服务器友好这是本文重点。Antra 的默认目录和编号方式就是为让服务器看懂而设计的源码见 organizer.pyMusic/ ← 你在 Setup 里选的音乐库根目录 ├── .antra_state.json ← Antra 状态文件去重索引别手动删 │ ├── The Beatles/ ← 艺术家文件夹第一层 │ └── 1969 - Abbey Road/ ← 专辑文件夹默认{year} - {album} │ ├── 01 - Come Together.flac │ ├── 02 - Something.flac │ └── cover.jpg ← 自动附带的封面 │ ├── Drake/ │ └── 2021 - For All The Dogs/ │ ├── 101 - 0 to 100 (Part 1).flac │ └── 201 - 0 to 100 (Part 2).flac ← 第二碟用 201 编号 │ └── My Top Favs/ ← 歌单也会单独成文件夹 ├── 01 - rises the moon.flac └── My Top Favs.m3u ← 配套 M3U 播放列表几个新手常问的细节为什么是1969 - Abbey Road而不是Abbey Road (1969)这是默认文件夹模板{album_artist}/{year} - {album}渲染出来的完全可在设置里改见下文自定义模板。为什么用101 / 201这种编号多碟专辑默认采用碟片前缀编号第 1 碟101、102…第 2 碟201、202…这样 Plex / Navidrome / Jellyfin 永远知道某首歌属于哪张碟见 FEATURES.md。没有多余的Albums/、Playlists/套娃文件夹——所有内容直接落在库根目录下服务器扫描更干净。.antra_state.json是什么它是 Antra 维护的去重索引记录了库里已有曲目。删了它不影响已有音频但会让智能去重暂时失效。自定义文件名与文件夹模板不喜欢默认命名在Settings → Folder Settings里用模板变量自定义变量列表见 filename_prefs.py模板默认值效果示例单曲文件名{artist} - {title}The Beatles - Come Together.flac专辑内曲目{track} - {title}07 - Come Together.flac文件夹结构{album_artist}/{year} - {album}The Beatles/1969 - Abbey Road/可用变量{title}{artist}{album_artist}{album}{year}{track}{disc}{genre}{isrc}等改的时候有实时预览。⚠️ 一个小提醒如果你的媒体服务器习惯专辑 (年份)的写法把文件夹模板改成{album_artist}/{album} ({year})即可两者服务器都认。自动打标签媒体服务器为什么喜欢它服务器展示得好不好看全靠文件标签。Antra 每首文件都会自动写入完整元数据ID3v2 / Vorbis / MP4 atom格式全部正确标签说明标题 / 艺人 / 专辑 / 轨序来自流媒体元数据专辑封面全分辨率封面图发行日期有则完整 ISO 日期否则用年份流派 / 作曲从源元数据抓取MusicBrainz 兜底碟片编号多碟专辑正确打标同步歌词LRC 同步歌词Jellyfin/Plex 可直接显示ISRC嵌入音频保证匹配精准完整说明见 FEATURES.md。第四步部署媒体服务器约 5 分钟音乐库建好后下面三种服务器任选其一。核心只有一条把音乐目录指向上面 Antra 的库根目录。方案 ANavidrome最轻量最推荐Navidrome 专为音乐优化启动快、资源占用低。用 Docker 一行搞定docker run -d \ --name navidrome \ --restart unless-stopped \ -p 4533:4533 \ -v /path/to/Music:/music:ro \ deluan/navidrome:latest把/path/to/Music换成你 Antra 的库根目录。浏览器打开http://你的服务器IP:4533首次会自动扫描Artist / Album结构。方案 BJellyfin影音全能Jellyfin 同时管视频和音乐适合已有家庭影音库的用户docker run -d \ --name jellyfin \ --restart unless-stopped \ -p 8096:8096 \ -v /path/to/Jellyfin/config:/config \ -v /path/to/Music:/media/music \ jellyfin/jellyfin进入设置 → 媒体库 → 新建类型选音乐路径指向/media/music。方案 CPlex生态最成熟Plex 的媒体管理界面最友好客户端覆盖广docker run -d \ --name plex \ --restart unless-stopped \ -p 32400:32400 \ -v /path/to/Plex/config:/config \ -v /path/to/Music:/data/Music \ plexinc/pms-docker在 Plex 的添加文件夹里选择/data/Music媒体类型选音乐。 三者都会因为 Antra 的碟片编号 完整标签而正确分组、显示封面与歌词无需额外配置。第五步保持歌单常新 验证约 2 分钟验证打开服务器检查艺人 / 专辑分组是否正确、封面是否显示、点一首歌看同步歌词能否滚动高亮。自动同步Antra 支持歌单定时同步——给任意歌单卡片打开 ↺ 自动同步在设置里选好时间它会定期对比差异、只拉取新增曲目让家庭服务器上的歌单永远和你账号保持同步见 FEATURES.md。智能去重默认开启相同 ISRC 的曲目全库只存一份省硬盘见 organizer.py 的身份索引逻辑。常见问题 FAQQ服务器里专辑顺序乱 / 碟片不分开把多碟处理方式设为碟片前缀或101/201 偏移默认即此模式见 FEATURES.md别用仅轨序。Q为什么有的歌下载失败进入Failed (N)面板Retry All小众/绝版唱片可开启Soulseek P2P兜底零配置Antra 自动管理后端。Q想要无损还是高解析无损模式下 Antra 会优先挑最高比特深度 / 采样率的源Qobuz 链接还支持严格 24-bit避免把 16-bit 冒充 24-bit见 FEATURES.md。Q目录里能不能没有艺术家文件夹、直接平铺可以把文件夹模板清空即为扁平模式见 organizer.py 中的 flat mode 说明。 搞定现在你已拥有一座自动下载 → 自动打标 → 自动归档 → 服务器直接播放的家庭音乐流媒体服务器。以后想扩容只需在 Antra 里继续粘链接服务器扫描一下就是新歌。想了解完整功能清单看 FEATURES.md项目说明见 README.md。【免费下载链接】AntraA desktop music library builder that turns Spotify, Youtube Music Apple Music, Amazon Music, Tidal, Qobuz, and Deezer links into fully tagged local library in FLAC, ALAC, Dolby Atmos, AAC, or MP3.项目地址: https://gitcode.com/gh_mirrors/an/Antra创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考