Gamdl + Wrapper 一步到位：3 个参数打通 Apple Music 的 ALAC 无损下载
【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl
想从 Apple Music 下载 ALAC 无损音频，大多数人在第一步就卡住了：API 限制。Gamdl（Glomatico's Apple Music Downloader）配合 Wrapper 可以打通这条路——本文带你四步走完，从安装到出文件，新手照着做即可。
先说痛点：ALAC 为什么总下不动
Apple Music 给网页端开放的是 Web 版编码，比如 aac-web（256kbps）。而 ALAC 属于非 Web 编码组，规格最高可到 24-bit/192kHz，是编码列表里的音质天花板。
问题在于：只靠浏览器 cookies（cookies.txt 里的 media-user-token）这条路线，拿不到 ALAC 的播放资格。项目自己也明说：不启用 Wrapper 时，ALAC "可以尝试，但多半因 API 限制失败"。你在命令里选了 alac 却没开 wrapper，启动时就会直接收到一条警告。
Wrapper 接棒原理：把"身份"交给本地管家
打个比方：自己去柜台办业务，得反复出示自己的会员卡；换成 24 小时管家代办，你只需把身份交给管家，办完直接把结果拿回来。Wrapper 就扮演这个管家。
具体来说，Gamdl 通过WrapperApi连上本地 Wrapper 的 HTTP 接口，再由 gamdl/api/apple_music.py 中的create_from_wrapper方法，从 Wrapper 的账户信息里取出 music user token 和 dev token 两把"钥匙"，注入到 Apple Music API 实例。从此账户、播放、解密请求都改道 Wrapper，绕开了网页端 API 的开口限制——这就是它能下 ALAC 的关键。
🎯 ALAC 无损下载四步走
第一步：装好 Gamdl，把 Wrapper 服务跑起来
需要 Python 3.10 以上环境，先执行pip install gamdl。然后在本地安装并常驻运行 Wrapper v2 服务：HTTP 控制端默认监听 127.0.0.1，TCP 解密端口默认 10020。
第二步：Wrapper 三参数配置清单
完整参数定义在 gamdl/cli/cli_config.py，你只需要盯住这三个：
--use-wrapper：总开关，启用后账户、播放、解密请求全部走 Wrapper--wrapper-url：Wrapper 的 HTTP 控制地址，默认http://127.0.0.1--wrapper-decrypt-host/--wrapper-decrypt-port：TCP 解密通道，默认 127.0.0.1 和 10020
这些参数也能写进配置文件（Linux 在~/.gamdl/config.ini，Windows 在%USERPROFILE%\.gamdl\config.ini），命令行参数优先级更高，临时调试时更方便。
第三步：执行下载命令
把编码优先级加进命令，例如gamdl --use-wrapper --wrapper-url http://127.0.0.1 --song-codec-priority alac "<歌曲或专辑 URL>"。
如果 Wrapper 还没有登录状态，Gamdl 会交互式提示你输入 Apple 账户凭据，支持二次验证码。启用 Wrapper 后，cookies.txt 这一步可以直接省掉。
第四步：确认拿到的是真 ALAC
输出文件是 m4a 容器。用播放器或音乐管理软件查看元数据，编码一栏应为 ALAC，高采样率曲目能到 24-bit/192kHz。下载链路里，Gamdl 内置的 Rust 扩展 ammuxer 负责解密重组和 MP4/M4A 写入，Python 端管下载、打标签和编排，分工清晰。
收益与避坑清单
✅ 收益很直接：ALAC 基本只有一条能走通的路，就是 Wrapper；元数据完整，专辑批量下载照样稳定。
避坑建议：
- Wrapper 版本要对得上，gamdl 启动时会校验 wrapper-v2 版本，不匹配会直接报错。
- 个别 FairPlay 流如果 Wrapper 解不了，会自动回退到
--drm-backend（默认 widevine），不用慌。 - 只下 aac-web 这类 Web 编码时完全不需要 Wrapper，别为用不上的功能多维护一个服务。
- MV 走 Wrapper 播放时还能拿到额外元数据（编曲、gapless 等），属于顺手的福利。
四步走完，你的本地曲库就该多出一批 192kHz 的 ALAC 了。现在就把 Wrapper 拉起来，选一张专辑试试手感吧。
【免费下载链接】gamdlA command-line app for downloading Apple Music songs, music videos and post videos.项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
