前言
近期放假在家,弄了台 VPS 来学习 Linux 和 shell 知识。又想到之前多次在境外使用网易云音乐变灰、版权受限的问题,于是便打算使用这台 VPS 搭建一个网易云解锁服务。
实现原理
原理是通过代理拦截网易云相关请求,对请求与响应进行改写:匹配到受限歌曲时,将请求重定向到第三方音源(provider),获取可用音频后再改写为网易云的响应格式返回客户端。通俗地说,就是修改 HTTP 请求与响应达到“以源替灰”的效果。
- 使用 QQ / 咪咕 / 百度 / 酷狗 / 酷我 / JOOX 等音源 替换变灰歌曲链接(默认启用部分音源)
- 为请求增加
X-Real-IP参数 解锁海外限制,支持指定网易云服务器 IP,支持设置上游 HTTP / HTTPS 代理- 提供完整的流量代理功能(HTTP / HTTPS),可直接作为系统代理(支持 PAC)

参考项目地址:
- 原项目(更新较慢):https://github.com/nondanee/UnblockNeteaseMusic
- 维护小组版本(本文采用):https://github.com/UnblockNeteaseMusic/server
实现过程
本次记录使用的环境:
- VPS:Hong Kong BGP(cld 机房),有条件建议选择大陆服务器,速度更快
- 系统:Debian 11
- 环境:安装好 Docker、YouTube 下载工具 yt-dlp 等
维护小组提供了一键安装脚本(仅支持 CentOS / Debian / Ubuntu)。当然也可以用 Docker 安装,详见项目 README:
https://github.com/UnblockNeteaseMusic/server
- 以 root 登录 SSH,执行一键脚本:
curl -fsSLO https://raw.githubusercontent.com/UnblockNeteaseMusic/install-scripts/master/server/install.sh && sudo bash install.sh若系统未安装 curl,可先安装(建议与 wget 一并安装):
apt-get install wget curl -y安装过程成功时类似如下:

之后如需再次打开脚本管理界面,执行:
bash install.sh-
在提示“安装”时选择 1,等待安装完成。接着会提示“请输入监听端口”,可使用随机端口或自定义(建议选择高位端口,避免与常用端口冲突)。
-
选择“音源”时请注意:
- 若服务器在 境外(非中国大陆):不要选择只接受大陆 IP 的音源(如 QQ、咪咕)。可选择:
kuwo ytdlp kugou joox bilibili youtube(示例) - 若服务器在 境内(中国大陆):可选择:
qq migu kuwo kugou bilibili(示例)
- 后续的 EndPoint、自定义网易云服务器 IP、HTTP(S) 代理服务器地址等,若不清楚可直接回车使用默认值。严格模式建议开启(仅代理网易云相关流量,不能用于科学上网)。无损音质、本地黑胶按需开启。
配置完成后类似如下:

提示已安装 即成功。若需修改端口、音源、音质等,选择脚本菜单中的 5 进行配置调整。
[warning] 如果选择了 QQ、咪咕、JOOX、YouTube、第三方音源,需要前往“5 配置调整”补充相关 Cookie / API Key 等信息,否则可能无法正常使用。[/warning]
常用环境变量(示例)
| 变量名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| JOOX_COOKIE | str | JOOX 音源的 wmid 与 session_key Cookie | JOOX_COOKIE="wmid=<your_wmid>; session_key=<your_session_key>" |
| QQ_COOKIE | str | QQ 音源的 uin 与 qm_keyst Cookie | QQ_COOKIE="uin=<your_uin>; qm_keyst=<your_qm_keyst>" |
| YOUTUBE_KEY | str | YouTube Data API v3 Key | YOUTUBE_KEY="<your_data_api_key>" |
使用方法
下面分别介绍 Windows 与 Android 端的使用方法。
Windows 端
方法一:客户端内自定义代理
打开 “网易云音乐” 客户端 → 设置 → 工具 → 代理 → 自定义代理:
- 服务器:填写你的 VPS IP
- 端口:填写前面配置的监听端口
保存后重启客户端即可。

方法二:Clash 代理
-
安装 Clash for Windows:
项目地址:https://github.com/Fndroid/clash_for_windows_pkg -
在 Profiles 处导入已配置好的 Clash 规则文件,选中该规则文件;在 Proxies 处选择 UnblockMusic 代理;在 General 处打开 System Proxy。

- 打开 “网易云音乐” → 设置 → 工具 → 代理 → 使用系统代理,重启客户端。
示例 Clash 配置(YAML):
port: 7890socks-port: 7891allow-lan: falsemode: rulelog-level: infoexternal-controller: 127.0.0.1:9090dns: enable: true ipv6: true listen: 0.0.0.0:53 enhanced-mode: fake-ip nameserver: - 119.29.29.29 - 223.5.5.5proxies:- name: "UnblockMusic" type: http server: 你的服务器IP port: 你监听的端口
proxy-groups:- name: "Netease Music" type: select proxies: - UnblockMusic - DIRECT
rules:- DOMAIN-SUFFIX,music.126.net,DIRECT- DOMAIN-SUFFIX,music.163.com,Netease Music- DOMAIN-SUFFIX,man.netease.com,Netease MusicWARNING不保证一定成功,建议结合项目 issues 自行调整并多多尝试。
Android 端
方法一:杜比大喇叭 β 版(Xposed 模块)
杜比大喇叭 β 版 是一个网易云音乐的音源代理模块。需要手机支持 Xposed(root 后)或使用“太极”等框架。
项目地址:
https://github.com/nining377/dolby_beta
方法二:Clash for Android
下载使用 Clash for Android,导入与电脑端类似的配置文件并启用代理即可。
项目地址:
https://github.com/Kr328/ClashForAndroid
后记
本文记录了使用 VPS 搭建网易云音乐解锁服务的过程。初衷仅为对网易云音乐的热爱与学习用途,不提供在线 demo。请不要轻易信任使用他人提供的公开代理服务,以免发生安全问题。
感谢大家的观看!