UnblockNeteaseMusic

解锁网易云音乐客户端变灰歌曲（Docker版）

想使用现成的项目服务在末尾 评论留言

特性

• 支持多个音源，替换变灰歌曲链接（现只能解决win客户端和网页端）
• 支持的完整音源清单可以见下方〈音源清单〉处。
• 完整的流量代理功能 (HTTP / HTTPS)，可直接作为系统代理 (同时支持 PAC)

运行

Docker-compose（推荐）

建议clone在服务器目录的上一级执行终端拉取代码，随后生成UnblockNeteaseMusic文件夹（也可替换成你想要的文件夹名称）

git clone https://github.com/UnblockNeteaseMusic/server.git UnblockNeteaseMusic
cd UnblockNeteaseMusic
docker-compose up

解析

先切换 UnblockNeteaseMusic 文件夹目录，再执行 docker-compose up 让项目运行起来，随后根据实际需要修改并执行参数，可以见下方<配置参数>处

执行 node app.js

我的Entrypoint

node app.js -o bodian bilibili -s -p 8080:8081 -e https://music.163.com

更新：

git pull

配置参数

$ unblockneteasemusic -h
usage: unblockneteasemusic [-v] [-p http[:https]] [-a address] [-u url] [-f host]
                           [-o source [source ...]] [-t token] [-e url] [-s]
                           [-h]

optional arguments:
  -v, --version                   显示版本号。执行后会打印当前安装的 UnblockNeeeMusic 版本并退出。
  -p port, --port http[:https]    指定服务器监听的端口。默认通常是 8080。可以用 http[:https] 
                                  格式同时启用 HTTP 和 HTTPS 服务。
  -a address, --address address   指定服务器绑定的主机地址。默认是 0.0.0.0（监听所有网络接口）。
                                  如果只想本地访问，可设为 127.0.0.1。
  -u url, --proxy-url url         设置上游代理。让本程序通过另一个代理服务器
                                 （如 Shadowsocks、HTTP 代理）来访问音源和网易云，适用于本身网络受限的环境。
  -f host, --force-host host      强制指定网易云服务器的 IP。用于解决 DNS 污染或指定特定服务器，通常高级用户使用。
  -o source [source ...], --match-order source [source ...]
                                  设置音源搜索优先级。当歌曲变灰时，按顺序从这些平台搜索可用版本。这是最常用的参数之一。
  -t token, --token token         设置代理认证令牌。为代理服务设置密码
                                  客户端使用时需在配置中填入此令牌，提升安全性（尤其在公网部署时）。
  -e url, --endpoint url          替换虚拟端点为公网主机。主要用于特定场景（如 iOS 的 HTTP 代理模式）
                                  将代理服务器内部使用的虚拟域名替换成一个可公开访问的地址。
  -s, --strict                    启用严格模式。开启后，代理服务器将只处理与网易云音乐相关的域名请求
                                  防止被滥用去代理其他网站，公网部署强烈建议开启。
  -c, --cnrelay host:port         设置中国大陆中继/代理。这是一个高级功能，用于解决某些音源（如QQ、咪咕）
                                  因IP限制在海外无法直接获取播放链接的问题。你需要自行准备一个在中国大陆的代理或服务器。
  -h, --help                      显示此帮助信息。

音源清单

将有兴趣的音源代号用 -o 传入 UNM 即可使用，像这样：

node app.js -o bilibili ytdlp

• 支持 pyncmd 的 API 服务由GD studio提供。

环境变量

日志等级 (LOG_LEVEL)

这些是常用的值：

• debug: 输出所有记录（调试用）
• info: 只输出一般资讯（默认值）
• error: 只在出严重问题时输出

详细请参见 Pino 对此的说明

使用

若将服务部署到公网，强烈建议使用严格模式 (此模式下仅放行网易云音乐所属域名的请求) -s 限制代理范围 (需使用 PAC 或 hosts)，或激活 Proxy Authentication -t <name>:<password> 设置代理用户名密码 (目前密码认证在 Windows 客户端设置和 macOS 系统设置都无法生效，请不要使用)，以防代理被他人滥用

方法 设置代理

PAC 自动代理脚本地址 http://<Server Name:PORT>/proxy.pac

客户端内 设置 > 工具 > 自定义代理 (客户端内) > 输入Docker部署的域名或IP（http） > 端口（默认8080）

HTTPs在PC端无法使用

全局代理地址填写服务器地址和端口号即可

代理工具和方法有很多请自行探索

设定 HTTPS 凭证

新版的 NeteaseMusic 需要 HTTPS 才能使用。证书的设置教学可参阅《安裝 UNM 的 HTTPS 憑證》一文。