【免费下载链接】aonsokuA modern desktop client for Navidrome/Subsonic servers built with React and Electron.项目地址https://gitcode.com/gh_mirrors/ao/aonsoku点击查看免费下载Aonsoku是一款基于 React Electron 构建的现代桌面音乐客户端专门用于连接Navidrome / Subsonic 服务器。本文带你从源码层面剖析它是如何与 Subsonic 服务器对话的请求如何拼装、Token 认证机制如何用 MD5 加盐保护密码、登录流程如何握手协商版本以及音频流媒体又是怎样复用同一套认证的。无需任何前置知识跟着读就能看懂。30秒速览Aonsoku 的通信架构Aonsoku 与服务器之间所有的通信都收敛在一个薄薄的 API 层上整体分为三层层级目录职责数据查询层src/queries/基于 React Query 的缓存与分页逻辑业务服务层src/service/按专辑、歌曲、电台等模块封装具体 API 调用传输层src/api/拼 URL、注入认证参数、解析 Subsonic 响应所有业务模块最终都调用统一的服务门面 src/service/subsonic.ts它把 albums、artists、songs、playlists、scrobble 等 12 个子服务聚合成一个subsonic对象调用方只需subsonic.songs.getSong(id) subsonic.playlists.create(...)就像跟服务器说人话一样简单而把话翻译成协议的脏活全部由传输层完成。Subsonic API 请求格式每个请求都长什么样Subsonic 协议是一个基于 HTTP GET 的 REST APIAonsoku 的传输层核心是 src/api/httpClient.ts。它做三件事1️⃣ 拼装 URLgetUrl 函数把任意 API 路径拼成标准格式{服务器地址}/rest/{接口名}?u用户t令牌v1.16.0cAonsokufjson2️⃣ 注入认证参数每次请求都会自动附带一组公参这是理解 Subsonic 认证的关键 参数含义示例u用户名alicetToken 令牌MD5 哈希a1b2c3...s客户端盐值 salt40n50kuPl4y3rp密码Password 模式下使用enc:xxxxv协议版本1.16.0c客户端名称Aonsokuf返回格式json3️⃣ 解析响应浏览器抓取函数 负责解析 Subsonic 的标准响应包装——所有 JSON 响应都被包在一个subsonic-response字段里同时从响应头x-total-count读取总数用于分页。以获取随机歌曲为例src/service/songs.ts 的写法非常直白业务层只关心要什么认证、版本、格式等细节全部由httpClient自动处理。Token 认证机制密码是怎么变成令牌的这是全文最核心的部分 Subsonic 协议定义了两种认证方式Aonsoku 在 src/types/serverConfig.ts 中用枚举定义AuthType.TOKEN // 令牌认证默认推荐 AuthType.PASSWORD // 密码认证兜底方案方式一Token 认证MD5 固定盐值Subsonic 规范规定令牌 MD5(密码 客户端盐值)。Aonsoku 的实现位于 src/utils/salt.tssaltWord 40n50kuPl4y3r // 固定盐值随客户端发布 token MD5(密码 40n50kuPl4y3r)这个盐值就像客户端的暗号签名——不同客户端使用不同盐值服务器端可以为每个 Subsonic 账户生成多个令牌分别授权给 Aonsoku、DSub 等其他客户端。为什么不用明文传密码因为 Token 是不可逆哈希即使请求被截获攻击者也无法还原你的真实密码配合 HTTPS 使用安全性更佳。方式二Password 认证十六进制编码部分服务器可能禁用令牌Aonsic 的兜底方案是把密码做十六进制编码后传输p enc: 密码的十六进制串对应 genEncodedPassword参数前缀enc:告知服务器这是编码后的密码请解码。认证参数的最终拼装src/api/httpClient.ts 中的authQueryParams函数根据认证类型输出不同的参数对象Token 模式返回{u, t, s}三元组Password 模式返回{u, p}二元组然后与版本、客户端名等公参合并注入到每一个请求中——包括后续的音频流请求。桌面端彩蛋Aonsoku 支持构建期预置服务器配置。env-config.js.template 模板在打包时把SERVER_URL、APP_USER、APP_PASSWORD、APP_AUTH_TYPE注入window全局对象src/utils/salt.ts 检测到有效配置后跳过登录页直接进入应用适合单用户专用客户端的部署场景。登录全流程从输入密码到握手成功打开 src/app/components/login/form.tsx登录提交时依次执行三个动作第 1 步探测服务器版本queryServerInfo 使用dummy 假凭据调用/rest/ping.view不需要真正登录拿到协议版本、服务器类型以及是否支持 OpenSubsonic 扩展。若版本低于1.15.0会弹出兼容性警告可强制跳过。第 2 步双认证尝试登录saveConfig 是登录逻辑的灵魂——它按TOKEN → PASSWORD的顺序各试一次用密码分别生成 Token 和编码密码调用 pingServer 请求/rest/ping.view若服务器返回error code 30版本错误自动改用服务器声明的版本号重试一次任何一种认证status ok即视为登录成功把 URL、用户名、认证后的令牌注意存的不是原始密码而是哈希值、协议版本一并写入 Zustand 持久化存储第 3 步路由守卫持续守护之后每次进入受保护页面protectedLoader 都会重新 ping 一次服务器配置缺失或服务器宕机时自动重定向回登录页保证永远不拿过期凭据去请求。音频流媒体播放也走同一套认证登录只是开始真正的重头戏是放歌。看 src/app/components/player/player.tsxgetSongStreamUrl(songId, maxBitRate, format, cacheBustToken)getSongStreamUrl 最终生成{服务器地址}/rest/stream?idxxxformatmp3estimateContentLengthtrueu...t...s...关键点音频流 URL 同样携带完整的认证参数audio标签直接加载这个 URL 即可播放无需额外的流媒体鉴权握手。此外还支持下载getDownloadUrl 走/rest/downloadformatraw表示原始格式播放上报歌曲播完时调用 scrobble向/rest/scrobble上报id、time、submission参数让服务器统计你的最热歌曲封面图getSimpleCoverArtUrl 请求/rest/getCoverArt?idxxxsize300无封面时优雅降级到本地默认图进阶细节版本协商与 OpenSubsonic 扩展现代 Subsonic 生态中Navidrome 等服务器实现了OpenSubsonic 扩展如歌词扩展songLyrics。Aonsoku 在登录时就把服务器支持的能力探测一遍queryServerInfo存进extensionsSupported能力表之后按需调用。以歌词功能为例src/service/lyrics.ts如果服务器支持songLyrics扩展就优先从服务器取若服务器没提供或歌词没有时间轴则回退到 LRC 歌词源查找——一套能力探测 优雅降级的打法这也是客户端应对异构 Subsonic 服务器的通用思路。总结新手可以记住的 5 个要点一个入口所有请求走src/api/httpClient.tsURL 格式统一为{url}/rest/{接口}?认证参数业务参数两种认证Token 模式 MD5(密码 40n50kuPl4y3r)传tsPassword 模式 enc:十六进制传p登录时自动择优安全设计本地持久化的是哈希令牌而非原始密码截获请求无法还原密码版本协商登录即探测服务器版本error code 30 触发自动重试低于 1.15.0 提示不兼容能力探测通过 OpenSubsonic 扩展表按需启用歌词等功能不支持则降级理解了这套机制你不仅看懂了 Aonsoku也掌握了Subsonic API 集成的通用范式——换到 DSub、Amperfy 或其他 Subsonic 客户端你会看到惊人相似的代码结构 想深入阅读重点文件清单API 传输层src/api/httpClient.tsToken 生成src/utils/salt.ts登录握手src/api/pingServer.ts src/store/app.store.ts服务门面src/service/subsonic.ts赞分享【免费下载链接】aonsokuA modern desktop client for Navidrome/Subsonic servers built with React and Electron.项目地址https://gitcode.com/gh_mirrors/ao/aonsoku点击查看免费下载相关推荐Excel-DNA部署指南将.NET插件打包为XLL文件的完整步骤Excel DNA部署指南将.NET插件打包为XLL文件的完整步骤 Excel DNA是一款免费且易用的工具可帮助开发者将.NET代码集成到Excel中创桌面应用插件系统B站番剧、弹幕、媒体库一站备齐BiliTools 哔哩哔哩工具箱跨平台实操指南B站番剧、弹幕、媒体库一站备齐BiliTools 哔哩哔哩工具箱跨平台实操指南 BiliTools哔哩哔哩工具箱是一款免费开源、遵循 GPL 3.0 协议桌面应用音视频Authelia认证机制深度剖析WebAuthn与TOTPAuthelia认证机制深度剖析WebAuthn与TOTP 本文深入分析了Authelia身份验证系统中的核心认证机制重点剖析了WebAuthn安全密钥认证后端认证鉴权身份认证单点登录上一篇最完整ML图表需求调研100模板背后的用户真实诉求下一篇颠覆性知识图谱构建革命LLM-Graph-Builder重塑企业数据智能新范式创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考