连接服务失败：AlgerMusicPlayer 启动时提示无法连接
报错现象
启动 AlgerMusicPlayer 后立即弹出「无法连接到服务」「服务启动失败」或类似提示，界面停留在加载页。
排查流程
第一步：确认网络通
AlgerMusicPlayer 虽然采用本地服务架构，但首次启动需要联网验证（拉取网易云接口鉴权 token）。
- 打开浏览器访问 alger.fun 和 music.163.com
- 如果都打不开，先解决网络问题
第二步：检查代理设置
如果你在用代理 / VPN：
| 情况 | 解决 |
|---|---|
| 用全局代理（Clash/V2RayN 的「全局模式」） | 先关掉代理重试 |
| 规则代理把 music.163.com 分到了海外节点 | 把 music.163.com 和替代音源平台加入「直连」规则 |
| 代理设置只给浏览器用（系统代理） | AlgerMusicPlayer 可能走系统代理，试试关掉系统代理 |
| 海外 VPN 节点 | 国内音乐平台在海外可能不稳定，切回国内节点 |
第三步：确认本地服务是否启动
v5.1.0 本地音乐 API 仅监听回环地址。检查方式：
# Windows 打开 PowerShell，执行
netstat -ano | findstr -i "listen" | findstr "127.0.0.1"看有没有 AlgerMusicPlayer 注册的端口在监听。如果没有，说明本地服务进程没起来。
第四步：清理 NeteaseCloudMusicApi 残留文件
v5.1.0 修复了「anonymous_token 文件不存在导致启动崩溃」的 bug。旧版本升级后可能有残留配置导致新进程起不来。
- 关闭 AlgerMusicPlayer
- 删除数据目录下的
anonymous_token文件（如果存在） - 重新启动 Alger
第五步：防火墙拦截
部分安全软件（360、火绒、Windows Defender 防火墙）可能拦截 Electron 应用的本地端口监听。
- Windows：设置 → 隐私和安全 → Windows Defender 防火墙 → 允许应用通过防火墙 → 添加 AlgerMusicPlayer.exe
- macOS：系统偏好设置 → 隐私与安全 → 防火墙 → 允许传入连接
快速修复
以上步骤都试了还不行的话，最快的办法：
- 完全退出 AlgerMusicPlayer（包括后台进程）
- 删除数据目录
%APPDATA%/AlgerMusicPlayer/整个文件夹 - 重新启动 AlgerMusicPlayer
这会重置所有设置和缓存，但能解决大部分不明原因的启动问题。注意：这也会清除登录状态，需要重新扫码登录。