Polaris
SHA-256自托管音乐流媒体服务器，专为大曲库优化，界面美观，支持波形可视化，多用户多平台。
自建私有音乐云盘，流畅播放海量歌曲。
核心功能
- 支持 FLAC、MP3 等几乎所有主流音频格式
- 按专辑、艺术家、流派或文件目录浏览音乐
- 强大的搜索功能，可按字段精确查询
- 音频波形可视化，让播放更有趣
- 多用户独立账户，每人拥有专属播放列表
避坑指南
- •默认监听 5050 端口，注意防火墙放行；2. 大曲库首次扫描可能耗时，建议保持服务器持续运行；3. 音乐文件路径建议使用绝对路径，避免相对路径导致扫描失败；4. 远程访问建议使用 HTTPS 代理（如 Nginx）以保障安全。
适用场景
- 个人音乐库的远程流媒体播放（如从公司访问家里NAS中的音乐）
- 家庭共享：为不同成员创建独立账户和播放列表
- 音乐发烧友管理超大型无损音乐收藏
详细介绍
Polaris 是一款免费开源的自主托管音乐流媒体服务器，让你可以从任何设备欣赏自己的音乐收藏。它专为大型音乐库（超过10万首歌曲）优化，性能卓越。功能包括暗黑模式、可自定义调色板、按专辑/艺术家/流派/文件树浏览、强大的搜索、多用户支持（每个用户拥有独立播放列表）以及音频波形可视化。支持多种音频格式（FLAC、MP3、MP4、MPC、OGG、Opus、APE、WAV、AIFF），并提供安卓官方应用和iOS第三方应用。配置采用纯文本格式，并可通过内置界面编辑。服务器API通过OpenAPI文档化。在Windows、Linux、BSD或Docker上安装非常简单。官方提供包含创作共用音乐的在线演示。
常见问题与排障 (2)
故障排除为什么 Polaris 媒体服务器持续重新扫描且永远无法完成索引，显示“out of date”状态？
这是一个已知的错误（issue #261），已在 Polaris 0.16 版本中修复。更新到 0.16 版本或最新的 master 构建版本即可解决无休止的扫描循环和高 I/O 压力问题。作为临时解决方案，重启 Docker 容器以清除卡住的扫描进程。目前没有可配置选项来控制重新索引行为。
故障排除为什么当日期字段包含完整的日期（如'2025-04-27'）时，Polaris会显示'undefined'作为年份？
当音频文件的日期字段包含完整日期（例如来自 MusicBrainz Picard），但 Polaris 只期望年份时，会出现此问题。该问题已在 pull request #273 中修复。请更新至包含此修复的 Polaris 版本以解决此问题。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
1. 从 GitHub Releases 下载对应系统的安装包（或直接用 Docker）
2. 如果是桌面系统，双击运行（Windows/macOS），Linux 用户执行 ./polaris
3. 打开浏览器访问 http://localhost:5050，首次使用会引导配置音乐目录和账户
- 1. 从 GitHub Releases 下载对应系统的安装包（或直接用 Docker）
- 2. 如果是桌面系统，双击运行（Windows/macOS），Linux 用户执行 ./polaris
- 3. 打开浏览器访问 http://localhost:5050，首次使用会引导配置音乐目录和账户
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
6a9b51b52ec382c83974d72d7cdda6106c666b996ddd38aab782cae0a28238af该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
直接删除 Polarise 安装目录即可；若使用 Docker，执行 docker rm -f polaris 并删除镜像。配置和数据库默认保存在 ~/.polaris/，需要手动删除。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs