本地优先架构：音乐文件与音频元数据完全保留在个人电脑上，扫描、索引与播放均在本地执行，不上传云端
Mac 与 Windows 上的本地音乐服务器：一个曲库、局域网原音播放、按需转码与加密远程访问（开发中）
把家里的音乐收回自己手里，一个曲库供所有设备聆听
PureStream 安装在家中的 Mac 或 Windows 电脑上，直接扫描本地文件夹并构建音乐索引。它基于 Subsonic 与 OpenSubsonic 标准协议，让 PurePlayer 或兼容客户端在局域网内享受原始音质串流，出门在外通过端到端加密直连随身聆听。所有音乐文件和元数据始终保留在本机，不上传云端，无需公网 IP 与域名。（当前处于开发中阶段）
核心价值
开放协议生态：兼容 Subsonic 与 OpenSubsonic 标准，PurePlayer 原生适配，也可接入支持该标准的第三方客户端
灵活音质策略：局域网内默认原文件直传无损输出，移动弱网智能按需转码，无需公网 IP 即可实现安全串流
极简无感配对：无需注册账号或提供邮箱，同一 Wi-Fi 下通过 PIN 码快速绑定设备，远程隧道采用 WireGuard 端到端加密
功能特性
本地曲库扫描与索引
直接选择电脑上的一个或多个本地音乐文件夹，支持操作系统已挂载的外置硬盘或 NAS 本地共享路径。深度递归扫描并读取内嵌音频标签、同目录封面和歌词文件，所有解析完全在本机完成，不做未经许可的文件更改或远程上传。
Subsonic / OpenSubsonic 兼容
服务端按 Subsonic 与 OpenSubsonic 开放接口标准设计，优先为 iOS 配套播放器 PurePlayer 提供曲库与播放能力。其他支持该标准的客户端可以按标准接口接入；不同客户端使用的接口不同，部分功能可能暂不可用。
局域网原音串流
在家庭或办公局域网环境中，默认采用原始音频文件直接推流传输。不经过重采样，不修改音质与声道信息，忠实呈现 Hi-Res、无损 FLAC、ALAC 或 DSD 音频的原始细节。
按需实时转码
当网络带宽受限或客户端规格受限时，服务端可按需将音频实时转码为 MP3、Opus、AAC 或 FLAC 等目标格式。转码结果由本地智能缓存管理，源文件发生变动时自动失效淘汰，兼顾音质还原与流畅播放。
大曲库与增量扫描
索引架构面向大型曲库设计，支持分页读取与快速过滤检索。具备增量扫描与文件系统变更监听能力，扫描可取消并续跑，异常中断时不会破坏已建立的曲库数据。
Web 管理与 Web 播放器
内置纯净的单用户 Web 管理控制台与基础 Web 播放器，在浏览器中即可完成文件夹挂载、曲库搜索、专辑浏览与脱敏日志排查。首次启动需初始化设置管理员密码，会话采用安全 Cookie 与防跨站保护机制。
PIN 配对与设备管理
无需注册账号或填写个人信息，在同一 Wi-Fi 环境下输入 6 位限时 PIN 码即可完成设备配对。管理端可清晰查看已绑定的播放设备列表，支持随时解绑或移除离线设备，保障私有曲库访问边界。
Pure Tunnel 远程访问（开发中）
基于 WireGuard 技术的安全网络直连隧道，让手机在外网环境下也能随时回连家中的音乐服务器。无需购买域名，无需公网 IP，亦无需在路由器上手动配置端口转发。（当前功能正在积极开发中）
订阅与家庭组（规划中）
计划通过 Mac App Store 与 Microsoft Store 统一提供订阅管理与家庭共享权益。订阅生效后可支持多台设备绑定并享受网络连接保障，局域网基础串流功能始终保持免费。（具体权益与计费方案以实际上线为准）
隐私优先的本地处理
软件不接入第三方商业广告 SDK 或行为追踪分析代码，不会上传用户的音乐偏好或听歌历史。控制面服务仅用于处理必要的设备凭据与订阅鉴权，绝不接触用户的音频内容本身。
深入了解
PureStream 是什么
PureStream 是一台运行在个人电脑（macOS / Windows）上的单用户本地音乐服务器，旨在让音乐收藏者把曲库的控制权完整收回自己手中。它是 Efficient Lab 打造的 Pure 音乐生态的核心纽带：
- PureLab：在电脑端负责音乐元数据深度整理、标签清洗、中日韩转写与内嵌回写；
- PureStream：在主机上运行，负责多目录音乐文件的扫描索引、Subsonic 接口输出、局域网原音推流与按需实时转码；
- PurePlayer：作为配套移动客户端，在手机上连接 PureStream 实现随时随地的高保真无损聆听。
PureStream 坚持单用户控制与本地优先原则，不依赖云存储，不强行聚合外部网盘，为您的大容量私人曲库提供一个干净、纯粹、随叫随到的专属音乐核心。
一次完整的播放流程
从安装 PureStream 到在移动端随心聆听，整个使用流程简单自然：
- 添加音乐目录：在应用中指定一个或多个存放音频的本地文件夹，亦可包含已挂载的 NAS 或移动硬盘；
- 构建本地索引：服务自动递归解析文件标签与封面信息，建立高效的本地搜索索引，长扫描支持随时中断与续跑；
- 局域网原音畅听：在同一 Wi-Fi 下打开 PurePlayer 或其他 Subsonic 播放器，直接连接服务器享受原音推流；
- 一键 PIN 码配对：需要远程访问时，只需在管理端生成限时 6 位 PIN 码，在播放器端输入即可安全绑定；
- 外网加密随身享：离家外出后，通过端到端加密的虚拟直连隧道继续播放家中音乐，智能转码自动保障弱网流畅度。
转码与网络适应策略
面对不同的网络环境与播放设备，PureStream 提供了兼顾音质保真与网络流畅的流媒体协商机制：
| 场景模式 | 输出策略 | 核心说明 |
|---|---|---|
| 局域网播放 | 原始音频直传 | 零重采样、零压缩损失，完整保留原始文件与无损格式细节 |
| 外网良好网络 | 高品质实时转码 | 将高码率无损实时编码为高质量音频流，保障音质与带宽平衡 |
| 移动弱网环境 | 自适应平滑转码 | 动态采用更高效的压缩规格，在弱网或流量敏感时防止卡顿 |
| 手动强制偏好 | 指定格式与码率 | 用户可根据个人偏好强制锁定输出格式或原音直出 |
所有转码流均由服务端的本地缓存池调度，采用自适应淘汰机制管理过期数据。一旦源音频文件或标签发生变动，相关缓存立即自动失效，确保聆听到的每一秒都是最新状态。
隐私与数据安全边界
在 Efficient Lab，我们坚信私人音乐与聆听习惯属于个人隐私：
- 音乐完全属于本地：音频文件、封面、歌词、播放历史与搜索记录仅保存在您的个人电脑中，绝不上传到任何中心化服务器；
- 无账号体系设计：不需要注册用户名、手机号或电子邮箱，无需为听音乐创建多余的网络身份；
- 轻量透明的控制面：云端控制服务仅用于辅助处理设备 PIN 配对凭据、心跳状态与应用商店订阅鉴权；
- 端到端加密传输：远程直连隧道基于现代 WireGuard 协议构建端到端加密，即便未来引入中转服务，节点也仅传递加密数据，无法读取您的音乐内容；
- 纯净无追踪：应用内不包含任何第三方广告分析、用户行为画像或数据追踪组件。
可用性与产品路线图
PureStream 目前处于积极开发与内测阶段，后续计划正式上架 Mac App Store 与 Microsoft Store。为了保持透明与负责，我们明确划分当前功能范围与后续规划：
-
当前开发与首发范围：
- macOS 与 Windows 桌面端单用户服务；
- 本地多文件夹扫描、增量更新与元数据提取；
- Subsonic / OpenSubsonic 标准流媒体接口兼容；
- 局域网原始音质串流与按需实时转码；
- Web 单用户管理后台与基础 Web 播放器；
- 本地 PIN 码设备配对与普通 P2P 远程直连（连通性视两侧 NAT 状况而定）。
-
后续演进与规划中能力：
- 高连通性加密中转：针对复杂对称 NAT 网络环境提供连通保障服务（规划中）；
- 多设备家庭组共享：家庭成员订阅与多播放终端管理（规划中）；
- AI 智能拓展：本地音频深度分析、语义检索与智能曲风推荐（规划中）；
- 更多存储来源扩展：原生 SMB/WebDAV 网络协议直连适配（规划中）。
适用人群
- 拥有大容量本地高保真曲库，不想把私人音乐文件与收藏托付给云端流媒体平台的人
- 使用 PurePlayer 或其他兼容 Subsonic 的播放器，希望拥有一台稳定、轻量且可控的专属音乐服务器的人
- 希望在户外也能随时串流家中的曲库，但不想购买域名、申请公网 IP 或繁琐配置路由器端口映射的人
- 家中拥有多台聆听设备，希望全家共享同一套本地音乐库与封面歌词资源的人（家庭共享功能规划中）
常见问题
使用 PureStream 需要公网 IP 或购买域名吗？
完全不需要。在家庭局域网内，客户端可直接通过本地网络地址发现并访问；对于出门在外的远程访问，PureStream 采用基于 WireGuard 的安全网络隧道技术建立点对点直连，无需申请动态公网 IP，也无需在路由器上做复杂的端口映射配置。
PureStream 支持哪些音频格式？
支持绝大多数常见的音频格式，包括无损的 FLAC、ALAC（M4A）、WAV、AIFF/AIF、DSF 与 DFF（DSD），以及有损的 MP3、AAC、OGG、Opus 和 WMA 等。扫描时会自动提取文件内嵌元数据并建立本地索引。
可以搭配哪些播放器客户端使用？
PureStream 是 PurePlayer 的官方配套流媒体服务端，优先为 PurePlayer 提供曲库连接。服务端按 Subsonic 与 OpenSubsonic 标准设计，支持该标准的第三方客户端也可以接入；具体可用功能取决于客户端使用的接口，建议以发布说明为准。
我的音乐文件会被上传到云端服务器吗？
绝不会。PureStream 坚持本地优先原则，您的所有音乐文件、专辑封面、歌词以及播放记录始终保留在您自己的电脑中。我们的云端控制服务仅用于处理设备配对凭据与订阅状态验证，绝不接触或存储您的任何音乐内容。
远程访问功能现在可以直接使用吗？
目前该功能处于开发与内测阶段，暂未正式发布可用。初期的远程直连采用普通 P2P 点对点隧道方式，其连通表现会受到用户两侧网络 NAT 类型的影响；对于严苛网络环境下的加密中转服务，已列入后续规划中。
PureStream 是如何收费的？
PureStream 的局域网直连使用完全免费，无需绑定账号。出门在外的远程网络直连及后续的多设备家庭共享将采用订阅制，通过 Mac App Store 和 Microsoft Store 进行官方安全结算。具体订阅方案与定价将在商店正式上架时公布。
支持读取 NAS 或外置硬盘中的音乐吗？
支持。只要您的 NAS 共享文件夹或外置硬盘已经被操作系统正确挂载为本地文件路径（例如 macOS 上的挂载卷或 Windows 上的网络驱动器映射），PureStream 即可正常添加该目录并完成扫描。软件本身暂不内置独立的 SMB 或 WebDAV 客户端。
对电脑配置和曲库规模有什么要求？
PureStream 支持主流的 macOS 与 Windows 操作系统。其底层索引引擎与数据层专为十万级以上的大型私人曲库设计，能提供流畅的分页检索体验；在配置适中的现代个人电脑上，即可稳定提供局域网串流与实时音频转码服务。
技术与隐私说明
PureStream 以本地离线处理为主，不依赖云端转码服务。你可以在隐私政策页面查看完整数据处理说明。
支持与反馈
你可以通过邮件 [email protected]，或通过 GitHub Issues 提交问题与建议。