Nuclear 免费音乐播放器 10 分钟实战指南从安装到远程控制与脚本接入【免费下载链接】nuclearStreaming music player that finds free music for you项目地址: https://gitcode.com/GitHub_Trending/nu/nuclear想要免费听歌、无广告无追踪但订阅付费麻烦、自建爬虫又不稳定Nuclear 是一款免费开源的流媒体音乐播放器搜索任意歌手或歌曲即可直接播放还能被脚本和 AI 接管。本文带你用 10 分钟完成安装、首首歌、手机遥控与 API 接入。Nuclear 项目定位与能力全景先说结论Nuclear 是一个把内容来源和播放器彻底解耦的桌面播放器。它本身只负责播放引擎、队列、播放列表、收藏和界面搜索结果、音频流、推荐、歌词全部由你安装的插件提供换来源不用改一行播放器代码。四个值得记住的亮点能力对你的意义免费无广告开源、无订阅、无追踪队列重启后依然保留插件化内容源元数据、流媒体、仪表盘、发现、播放列表 5 类 provider内置插件商店一键安装三端覆盖Windows / macOS / Linux支持 exe、dmg、AppImage、deb、rpm、Flatpak、Snap开放控制面HTTP API、MPD 协议、MCP 服务器三件套脚本、老客户端、AI 代理都能接管 与常见替代方案比一下商业订阅播放器内容丰富但贵且有地区限制自己写爬虫免费但维护成本高、时好时坏。Nuclear 走中间路线——内容源换成插件来源失效时你只换插件播放器原封不动。Nuclear 播放器 5 分钟上手安装、验证、首首歌1. 安装播放器按系统三选一命令都很短# Linux 推荐Flatpak由 Flathub 负责自动更新 flatpak install flathub com.nuclearplayer.Nuclear # 或者用 Snapstable 频道 sudo snap install nuclearmacOS 把 dmg 拖进 ApplicationsWindows 双击 x64-setup.exe 按用户级安装即可。Arch 用户可yay -S nuclear-player-bin。完整文件对照见 安装指南。2. 验证环境装好第一组插件首次打开 Nuclear 是空白欢迎页这是正常现象——还没有任何插件。我们先到插件商店完成环境验证元数据插件提供搜索能力歌手、专辑、曲目流媒体插件提供实际音频部分插件两者兼备装一个即可。点 Install 后立即生效无需重启。3. 最小可运行示例搜到并播放第一首歌在顶部搜索框输入歌手或歌名回车。Tracks 页签下点击入队或直接点三点的Play now。听到声音环境就算搭好了。Nuclear 核心场景实战从单首歌到多设备与脚本控制场景一单目标——把想听的歌按顺序排进队列 目标掌握曲目三点菜单里的三个高频操作一次排好一整晚的歌单Play now清空队列立即播这首Play next插到当前曲目后面Add to queue追加到队尾右侧队列面板显示接下来要播什么支持拖拽调序队列在重启后保留断点续听很省心。队列机制详见 The queue。场景二多设备目标——用浏览器遥控电脑里的 Nuclear 目标音乐留在电脑上人到手机旁。步骤只有三步Settings → Integrations打开Nuclear Jam顶栏出现二维码图标点它用手机相机扫码打开遥控页现在播放、播放控制、队列、搜索框一应俱全遥控端和主窗口双向同步手机上切歌电脑立刻更新多台设备可同时在线。注意 Jam 只监听局域网4120-4129 端口段数据不出你的网络适合聚会、做饭、客厅场景。细节见 远程控制文档。场景三工程化目标——用脚本和 AI 驱动播放器 目标不碰鼠标。开启 Nuclear Jam 后本地 HTTP API 与遥控页同服API URL字段就是基地址# 健康检查 curl http://192.168.1.42:4120/api/health # 输出{ status: ok } # 搜索歌曲返回 tracks / artists / albums / playlists 候选 curl -X POST http://192.168.1.42:4120/api/search \ -H Content-Type: application/json \ -d {query: Bohemian Rhapsody, limit: 5}高频端点速查目的方法与路径播放/暂停POST /api/playback/toggle下一首POST /api/playback/next跳转进度POST /api/playback/seekbody 为{seconds: 90}查看队列GET /api/queue订阅变更GET /api/eventsSSE 推送/api/events是 Server-Sent Events 流队列、播放状态、设置任何一处变化服务端就推一次该域的全量 JSON轮询可以省掉。完整端点表在 HTTP API 文档。接入 AI 走 MCPSettings → Integrations 开启后服务器默认起在http://127.0.0.1:8800/mcp一条命令接入 Claude Codeclaude mcp add nuclear --transport http http://127.0.0.1:8800/mcpMCP 端用分层发现设计list_methods → method_details → describe_type → call每步只回小载荷AI 查 API 不烧 token。如果你手上有 mpc、ncmpcpp 等老 MPD 客户端直接开启内置 MPD 服务器默认 127.0.0.1:6600mpc status # 查看播放状态 mpc next # 切下一首 mpc seek 10 # 快进 10 秒MPD 支持idle事件机制客户端无需轮询即可实时刷新参考 MPD Server 文档。Nuclear 进阶与优化来源、端口与事件订阅按问题 → 做法 → 效果梳理四个高频优化点问题装了多个同类插件搜索结果和之前不一样了。做法打开左侧Sources视图把 Metadata / Streaming 下拉到期望的 provider。效果来源固定行为可预期部分元数据源与流媒体源是绑定成对的选中后会自动锁定匹配项。问题MCP、MPD、Jam 端口被占用了。做法不必手动改——8800、6600、4120 被占时会自动递增到 8809、6609、4129设置页直接显示实际绑定地址复制即用。效果多实例共存零冲突。问题播放中某条流拉取失败。做法播放器内置流解析与恢复逻辑失败时自动尝试恢复无需手动干预。效果偶发网络抖动不打断收听体验。问题脚本每 5 秒轮询一次 API请求太多。做法改用GET /api/eventsSSE或 MPD 的idle命令改为事件驱动。效果每分钟几十次请求降到接近 0只在状态真的变化时收到一次全量数据。Nuclear 高频问题速查症状、原因、解法症状原因解法搜索框搜不出任何结果全新安装没有插件或缺少元数据/流媒体插件之一到插件商店各装一个仍不行则在 Sources 页切换其他 providermacOS 提示无法打开/已损坏Nuclear 未做 Apple 开发者签名右键应用选打开不行就执行sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app只需一次手机遥控器连不上不在同一局域网或端口不是默认的 4120确认同一 Wi-Fi从设置页复制 Remote URL别猜端口范围 4120-4129Flatpak 下部分功能异常Flatpak 沙箱限制了部分系统能力换.deb/.rpm/ AppImage 版本功能更全Nuclear 扩展方向与学习资源四条可以接着走的路写自己的插件用nuclearplayer/plugin-sdk实现元数据、流媒体、仪表盘等 provider把你想要的内容源发布出去参考 插件系统文档定制外观内置多套主题 主题商店 自定义 CSS文档见 Themes接入自动化用 HTTP API 做定时任务比如每天 9 点自动播早间电台源码级探索想深入播放引擎或插件桥接实现可以直接克隆仓库git clone https://gitcode.com/GitHub_Trending/nu/nuclear学习资源清单官方文档入口快速上手工作原理插件与 provider 模型HTTP API 参考MCP Server 文档开发贡献指南现在就装一个 Nuclear配上插件10 分钟后你的第一首歌就会在播放器里响起来。【免费下载链接】nuclearStreaming music player that finds free music for you项目地址: https://gitcode.com/GitHub_Trending/nu/nuclear创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考