
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
解锁网易云音乐客户端变灰歌曲
X-Real-IP 参数解锁海外限制,支持指定网易云服务器 IP,支持设置上游 HTTP / HTTPS 代理使用 npx
$ npx @nondanee/unblockneteasemusic
或使用 Docker
$ docker run nondanee/unblockneteasemusic
$ docker-compose up
$ unblockneteasemusic -h usage: unblockneteasemusic [-v] [-p port] [-a address] [-u url] [-f host] [-o source [source ...]] [-t token] [-e url] [-s] [-h] optional arguments: -v, --version output the version number -p port, --port port specify server port -a address, --address address specify server host -u url, --proxy-url url request through upstream proxy -f host, --force-host host force the netease server ip -o source [source ...], --match-order source [source ...] set priority of sources -t token, --token token set up proxy authentication -e url, --endpoint url replace virtual endpoint with public host -s, --strict enable proxy limitation -h, --help output usage information
警告:本项目不提供线上 demo,请不要轻易信任使用他人提供的公开代理服务,以免发生安全问题
若将服务部署到公网,强烈建议使用严格模式 (此模式下仅放行网易云音乐所属域名的请求) -s 限制代理范围 (需使用 PAC 或 hosts),或启用 Proxy Authentication (目前密码认证在 Windows 客户端设置和 macOS 系统设置都无法生效,请不要使用),以防代理被他人滥用-t <name>:<password> 设置代理用户名密码
支持 Windows 客户端,UWP 客户端,Android 客户端,Linux 客户端 (1.2 版本以上需要自签证书 MITM,启动客户端需要增加 --ignore-certificate-errors 参数),macOS 客户端 (726 版本以上需要自签证书),iOS 客户端 (配置 https endpoint 或使用自签证书) 和网页版 (需要自签证书,需要脚本配合)
目前除 UWP 外其它客户端均优先请求 HTTPS 接口,默认配置下本代理对网易云所有 HTTPS API 连接返回空数据,促使客户端降级使用 HTTP 接口 (新版 Linux 客户端和 macOS 客户端已无法降级)
因 UWP 应用存在网络隔离,限制流量发送到本机,若使用的代理在 localhost,或修改的 hosts 指向 localhost,需为 "网易云音乐 UWP" 手动开启 loopback 才能使用,请以管理员身份执行命令
powershellchecknetisolation loopbackexempt -a -n="1F8B0F94.122165AE053F_j2p0p5q0044a6"
向 hosts 文件添加两条规则
<Server IP> music.163.com <Server IP> interface.music.163.com
使用此方法必须监听 80 端口
-p 80若在本机运行程序,请指定网易云服务器 IP
-f xxx.xxx.xxx.xxx(可在修改 hosts 前通过ping music.163.com获得) 或 使用代理-u http(s)://xxx.xxx.xxx.xxx:xxx,以防请求死循环Android 客户端下修改 hosts 无法直接使用,原因和解决方法详见云音乐安卓又搞事啦,安卓免 root 绕过网易云音乐 IP 限制
PAC 自动代理脚本地址 http://<Server Name:PORT>/proxy.pac
全局代理地址填写服务器地址和端口号即可
| 平台 | 基础设置 |
|---|---|
| Windows | 设置 > 工具 > 自定义代理 (客户端内) |
| UWP | Windows 设置 > 网络和 Internet > 代理 |
| Linux | 系统设置 > 网络 > 网络代理 |
| macOS | 系统偏好设置 > 网络 > 高级 > 代理 |
| Android | WLAN > 修改网络 > 高级选项 > 代理 |
| iOS | 无线局域网 > HTTP 代理 > 配置代理 |
代理工具和方法有很多请自行探索,欢迎在 issues 讨论
作为依赖库使用
$ npm install @nondanee/unblockneteasemusic
javascriptconst match = require('@nondanee/unblockneteasemusic') /** * Set proxy or hosts if needed */ global.proxy = require('url').parse('http://127.0.0.1:1080') global.hosts = {'i.y.qq.com': '59.37.96.220'} /** * Find matching song from other platforms * @param {Number} id netease song id * @param {Array<String>||undefined} source support qq, xiami, baidu, kugou, kuwo, migu, joox * @return {Promise<Object>} */ match(418602084, ['qq', 'kuwo', 'migu']).then(console.log)
Windows 客户端
UWP 客户端
Linux 客户端
macOS 客户端
Android 客户端
iOS 客户端
感谢大佬们为*** eapi 所做的努力
使用的其它平台音源 API 出自
https://github.com/trazyn/ieaseMusic
https://github.com/listen1/listen1_chrome_extension
向所有同类项目致敬
https://github.com/EraserKing/CloudMusicGear
https://github.com/EraserKing/Unblock163MusicClient
https://github.com/ITJesse/UnblockNeteaseMusic/
https://github.com/bin456789/Unblock163MusicClient-Xposed
https://github.com/YiuChoi/Unlock163Music
https://github.com/yi-ji/NeteaseMusicAbroad
https://github.com/stomakun/NeteaseReverseLadder/
https://github.com/fengjueming/unblock-NetEaseMusic
https://github.com/acgotaku/NetEaseMusicWorld
https://github.com/mengskysama/163-Cloud-Music-Unlock
https://github.com/azureplus/163-music-unlock
https://github.com/typcn/163music-mac-client-unlock
The MIT License
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务