自动更新失效:手动下载安装包还是等自动更新
更新方式变化
v5.1.0 之前:手动去 GitHub releases 下载安装包替换旧版v5.1.0 起:electron-updater 自动更新——设置里点检查更新,自动下载并重启
自动更新流程
- 打开 AlgerMusicPlayer
- 设置 → 关于 → 检查更新
- Alger 连接 GitHub releases 接口检查新版本
- 发现新版本后提示是否下载
- 下载完成后自动安装 + 重启
自动更新失败的常见原因
| 现象 | 可能原因 | 解决 |
|---|---|---|
| 点检查更新没反应 | 网络问题 / GitHub 访问受限 | 用浏览器打开 GitHub releases 页面手动下载 |
| 下载很慢或中断 | GitHub releases CDN 在国内不稳定 | 用 gh-proxy.com 镜像加速或手动下载 |
| 下载完安装失败 | 旧版文件被占用 / 权限不够 | 完全退出 Alger 后手动运行安装包 |
| 更新完版本没变 | 安装包版本号问题 | 去设置 → 关于确认实际版本号 |
手动下载(备用方案)
自动更新失败时,手动下载最稳:
- 浏览器打开 GitHub releases 页面搜索 AlgerMusicPlayer
- 下载对应平台的最新安装包
- 完全退出 AlgerMusicPlayer(包括后台进程)
- 运行新安装包覆盖安装
- 所有设置、登录状态、缓存都会保留(不会丢)
国内镜像加速
GitHub releases 下载慢的话,可用以下加速镜像(任选):
- gh-proxy.com
- gh.llkk.cc
- gh.dpik.top
- cdn.gh-proxy.com
把 GitHub 的 release 链接前面加上镜像域名前缀即可。
关于 GitHub Token
如果你从源码自己构建 AlgerMusicPlayer,需要配置 GitHub Token 才能触发自动更新检测(electron-updater 需要 Token 访问 API)。普通用户从官方安装包下载的不需要。
建议
- 定期手动检查版本号(每月一次),不要完全依赖自动更新
- 遇到功能异常时先检查是不是版本太旧——很多 bug 都是升级就好
- alger.fun 更新日志页也会同步最新版本信息