Sonixd服务器连接全攻略：支持Navidrome、Airsonic、Jellyfin等音乐服务器

【免费下载链接】sonixd A full-featured Subsonic/Jellyfin compatible desktop music player 项目地址: https://gitcode.com/gh_mirrors/so/sonixd

想要在桌面上优雅地管理你的个人音乐库吗？Sonixd是一款功能强大的跨平台桌面音乐播放器，专为Subsonic-API和Jellyfin兼容的音乐服务器设计。无论你是使用Navidrome、Airsonic还是Jellyfin搭建了个人音乐服务器，Sonixd都能为你提供完美的桌面端体验。🎵

📋 什么是Sonixd？

Sonixd是一款基于Electron和React构建的现代化桌面音乐播放器，支持所有兼容Subsonic-API和Jellyfin API的音乐服务器。它解决了传统音乐客户端在可扩展性、音乐库管理和用户体验方面的痛点，为音乐爱好者提供了流畅的桌面播放体验。

Sonixd的专辑浏览界面，支持大图浏览和快速播放

🚀 支持的服务器类型

Sonixd经过全面测试，完美支持以下主流音乐服务器：

Subsonic-API兼容服务器

• Navidrome - 轻量级、现代化的音乐服务器
• Airsonic - 经典的Subsonic兼容服务器
• Airsonic-Advanced - Airsonic的增强版本
• Gonic - 用Go编写的Subsonic服务器
• Astiga - 云端音乐流媒体服务器

Jellyfin服务器

• Jellyfin - 开源媒体服务器系统

🔧 快速安装指南

Windows用户安装

1. 从官方发布页面下载最新版本的Sonixd
2. 或者使用winget命令安装：

winget install sonixd

3. 也可以使用scoop包管理器：

scoop install sonixd

macOS用户安装

1. 下载macOS版本的安装包
2. 或者使用Homebrew安装：

brew install --cask sonixd

Linux用户安装

1. 下载AppImage或tar.xz包
2. 对于Arch Linux用户，可以在AUR中搜索sonixd包

艺术家详情页面，显示专辑和相关信息

🔐 服务器连接详细步骤

第一步：启动Sonixd应用

安装完成后，首次启动Sonixd会显示登录界面。如果你已经安装过，可以在设置中切换服务器。

第二步：选择服务器类型

在登录界面，你需要选择服务器类型：

• Subsonic - 用于Navidrome、Airsonic等Subsonic兼容服务器
• Jellyfin - 用于Jellyfin媒体服务器

第三步：填写服务器信息

根据你的服务器类型，填写以下信息：

Subsonic服务器配置

• 服务器地址：输入完整的服务器URL，例如 http://localhost:4040 或 https://your-server.com
• 用户名：你的服务器登录用户名
• 密码：对应的密码
• 传统认证：如果服务器不支持MD5加密，请勾选此项

Jellyfin服务器配置

• 服务器地址：Jellyfin服务器地址，例如 http://localhost:8096
• 用户名：Jellyfin用户名
• 密码：Jellyfin密码

第四步：连接测试

点击"连接"按钮，Sonixd会自动测试与服务器的连接。如果一切正常，你将进入主界面。

正在播放界面，显示当前曲目和播放控制

⚙️ 常见连接问题解决

连接失败排查步骤

1. 检查服务器地址格式

   • 确保包含http://或https://前缀
   • 确保端口号正确
   • 移除URL末尾的斜杠

2. 验证服务器状态

   • 确认音乐服务器正在运行
   • 检查防火墙设置是否允许连接
   • 如果是远程服务器，确保端口已正确转发

3. 认证问题处理

   • Subsonic服务器：尝试启用/禁用"传统认证"选项
   • Jellyfin服务器：确认用户名密码正确
   • 检查服务器日志获取详细错误信息

Airsonic-Advanced特殊配置

如果你使用Airsonic-Advanced服务器，需要在管理员控制面板中为登录用户创建decodable凭证。

🌟 Sonixd核心功能特色

高级播放功能

• HTML5音频支持 - 高质量音频播放
• 无缝播放和交叉淡入淡出 - 提供流畅的播放体验
• 支持大播放列表和队列 - 轻松管理数千首歌曲

音乐库管理

• 拖放操作和多选 - 直观的歌曲管理
• 播放列表编辑 - 轻松创建和修改播放列表
• 智能搜索 - 快速找到想要的音乐

跨平台特性

• 全局媒体键支持 - 使用键盘媒体键控制播放
• MPRIS支持（Linux） - 与桌面环境深度集成
• 多主题支持 - 自定义界面外观

强大的搜索功能，支持快速查找音乐

🔄 多服务器管理技巧

切换不同服务器

Sonixd支持保存多个服务器配置。要切换服务器：

1. 进入设置菜单
2. 选择"服务器"选项
3. 点击"断开连接"
4. 重新输入新的服务器信息

服务器配置备份

你的服务器配置保存在本地，包括：

• 服务器地址和认证信息
• 播放偏好设置
• 界面主题和布局

📱 移动设备访问

虽然Sonixd是桌面应用，但你可以通过以下方式在移动设备上访问音乐：

浏览器访问

大多数Subsonic和Jellyfin服务器都提供Web界面，可以直接在手机浏览器中访问。

移动应用

考虑使用官方的移动应用：

• Subsonic：DSub、Ultrasonic等
• Jellyfin：Jellyfin官方移动应用

🛠️ 高级配置选项

音频设置优化

在Sonixd的设置中，你可以调整：

• 音频质量设置
• 缓存大小
• 播放行为（如自动播放下一首）

界面个性化

• 选择喜欢的主题（深色/浅色）
• 调整字体和布局
• 自定义快捷键

🔍 故障排除与支持

查看连接日志

如果遇到连接问题，可以：

1. 打开开发者工具（F12）
2. 查看网络请求
3. 检查控制台错误信息

获取帮助

• 查看项目文档和FAQ
• 在GitHub Issues中搜索类似问题
• 加入社区讨论获取帮助

🎯 总结

Sonixd为个人音乐服务器用户提供了一个完美的桌面端解决方案。无论是简单的音乐播放还是复杂的音乐库管理，Sonixd都能提供出色的体验。通过本文的详细指南，你应该能够轻松连接你的Navidrome、Airsonic或Jellyfin服务器，开始享受个性化的音乐之旅。

记住，音乐的灵魂在于发现和分享，而Sonixd正是帮助你更好地管理个人音乐收藏的得力助手。🎶

提示：Sonixd目前处于维护模式，项目正在重写为Feishin。现有版本将继续获得错误修复，但新功能开发将集中在Feishin上。

【免费下载链接】sonixd A full-featured Subsonic/Jellyfin compatible desktop music player 项目地址: https://gitcode.com/gh_mirrors/so/sonixd