Socket
Socket
Sign inDemoInstall

@unblockneteasemusic/server

Package Overview
Dependencies
3
Maintainers
2
Versions
22
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@unblockneteasemusic/server

Revive unavailable songs for Netease Cloud Music


Version published
Maintainers
2
Install size
3.87 MB
Created

Readme

Source
logo

UnblockNeteaseMusic

解锁网易云音乐客户端变灰歌曲

FOSSA Status

特性

  • 支援多个音源,替换变灰歌曲链接
    • 支援的完整音源清单可以见下方〈音源清单〉处。
  • 为请求增加 X-Real-IP 参数解锁海外限制,支持指定网易云服务器 IP,支持设置上游 HTTP / HTTPS 代理
  • 完整的流量代理功能 (HTTP / HTTPS),可直接作为系统代理 (同时支持 PAC)

运行

直接打开可运行文件

去右侧的 Releases 找到最新版本,然后在下方的 Assets 找到符合你系统架构的可运行文件。下载回来后点两下即可使用。

macOS 因为签名问题,暂时不提供可运行文件。请先按照其他做法使用。

NPM 安装

安装成依赖
npm install @unblockneteasemusic/server
yarn add @unblockneteasemusic/server # for Yarn users
用 NPX 运行
npx -p @unblockneteasemusic/server unblockneteasemusic

注册成 Windows 服务

安装服务

直接 clone 或下载本项目,在项目根目录运行 node ./nw.js。会有弹窗,直接确定即可。如果有安全管家等软件可能会阻止,直接允许即可。运行成功后可在电脑服务中看到该服务。

配置

http 代理使用 127.0.0.1,端口默认使用 8080

如果想要添加启动参数和环境变量,请在项目根目录中的 nw.js 中配置 scriptOptionsenv

如果想要卸载已安装的服务,请再次运行 node ./nw.js

安装服务后,会在项目根目录生成 daemon 文件夹。可在这里查看日志。

Docker 作法

Docker Hub

pan93412/unblock-netease-music-enhancedlatest 是从 enhanced 组建的最新版本;release 是最新 tag 的版本。

直接运行 pan93412/unblock-netease-music-enhanced 的命令如下:

docker run pan93412/unblock-netease-music-enhanced

若要更新 UnblockNeteaseMusic,请运行以下命令后重新 run

docker pull pan93412/unblock-netease-music-enhanced

若要指定环境变量,您可以往 docker run 传入 -e,就像这样:

docker run -e JSON_LOG=true -e LOG_LEVEL=debug pan93412/unblock-netease-music-enhanced

若要传入配置参数,只要在 docker run 的 image 之后传入参数即可:

docker run pan93412/unblock-netease-music-enhanced -o bilibili -p 1234
自行编译
git clone https://github.com/UnblockNeteaseMusic/server.git UnblockNeteaseMusic
cd UnblockNeteaseMusic
docker-compose up

直接使用 Repo 最新版本

git clone https://github.com/UnblockNeteaseMusic/server.git UnblockNeteaseMusic
cd UnblockNeteaseMusic
node app.js # 建议使用 screen / tmux 把 app.js 挂后台

更新:

git pull
编译最新的 package
yarn
yarn build
node app.js # 即可使用 repo 的最新开发内容
采用(而不编译)最新的 package
yarn
DEVELOPMENT=true yarn node app.js

BetterNCM 一键安装器

请移步至 RevivedUnblockInstaller

Android Xposed 模块

请移步至 杜比大喇叭 β 版

OpenWrt LuCI 插件

请移步至 luci-app-unblockneteasemusic

配置参数

$ 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                   output the version number
  -p port, --port http[:https]    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
  -c, --cnrelay host:port         Mainland China relay to get music url
  -h, --help                      output usage information

音源清单

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

node app.js -o bilibili ytdlp
名称代号默认启用注意事项
QQ 音乐qq需要准备自己的 QQ_COOKIE(请参阅下方〈环境变量〉处)。必须使用 QQ 登录。
酷狗音乐kugou
酷我音乐kuwo
咪咕音乐migu需要准备自己的 MIGU_COOKIE(请参阅下方〈环境变量〉处)。
JOOXjoox需要准备自己的 JOOX_COOKIE(请参阅下方〈环境变量〉处)。似乎有严格地区限制。
YouTube(纯 JS 解析方式)youtube需要 Google 认定的非中国大陆区域 IP 地址。
YouTube(通过 youtube-dl)youtubedl需要自行安装 youtube-dl
YouTube(通过 yt-dlp)ytdlp需要自行安装 yt-dlpyoutube-dl 仍在活跃维护的 fork)。
B 站音乐bilibili
第三方网易云 APIpyncmd

环境变量

变量名称类型描述示例
ENABLE_FLACbool激活无损音质获取ENABLE_FLAC=true
ENABLE_LOCAL_VIPstr激活本地黑胶 VIP,可选值:true(等同于 CVIP)、cvipsvipENABLE_LOCAL_VIP=svip
LOCAL_VIP_UIDstr仅对这些 UID 激活本地黑胶 VIP,默认为对全部用户生效LOCAL_VIP_UID=123456789,1234,123456
ENABLE_HTTPDNSbool激活故障的 Netease HTTPDNS 查询(不建议)ENABLE_HTTPDNS=true
BLOCK_ADSbool屏蔽应用内部分广告BLOCK_ADS=true
DISABLE_UPGRADE_CHECKbool禁用更新检测DISABLE_UPGRADE_CHECK=true
DEVELOPMENTbool激活开发模式。需要自己用 yarn 安装依赖 (dependencies)DEVELOPMENT=true
FOLLOW_SOURCE_ORDERbool严格按照配置音源的顺序进行查询FOLLOW_SOURCE_ORDER=true
JSON_LOGbool输出机器可读的 JSON 记录格式JSON_LOG=true
NO_CACHEbool停用 cacheNO_CACHE=true
MIN_BRint允许的最低源音质,小于该值将被替换MIN_BR=320000
SELECT_MAX_BRbool选择所有音源中的最高码率替换音频SELECT_MAX_BR=true
LOG_LEVELstr日志输出等级。请见〈日志等级〉部分。LOG_LEVEL=debug
LOG_FILEstr从 Pino 端设置日志输出的文件位置。也可以用 *sh 的输出重导向功能 (node app.js >> app.log) 代替LOG_FILE=app.log
JOOX_COOKIEstrJOOX 音源的 wmid 和 session_key cookieJOOX_COOKIE="wmid=<your_wmid>; session_key=<your_session_key>"
MIGU_COOKIEstr咪咕音源的 aversionid cookieMIGU_COOKIE="<your_aversionid>"
QQ_COOKIEstrQQ 音源的 uin 和 qm_keyst cookieQQ_COOKIE="uin=<your_uin>; qm_keyst=<your_qm_keyst>"
YOUTUBE_KEYstrYoutube 音源的 Data API v3 KeyYOUTUBE_KEY="<your_data_api_key>"
SIGN_CERTpath自定义证书文件SIGN_CERT="./server.crt"
SIGN_KEYpath自定义密钥文件SIGN_KEY="./server.key"
SEARCH_ALBUMbool在其他音源搜索歌曲时携带专辑名称(默认搜索条件 歌曲名 - 歌手,启用后搜索条件 歌曲名 - 歌手 专辑名SEARCH_ALBUM=true
NETEASE_COOKIEstr网易云 CookieMUSIC_U=007554xxx
日志等级 (LOG_LEVEL)

这些是常用的值:

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

详细请参见 Pino 对此的说明

使用

警告:本项目不提供在线 demo,请不要轻易信任使用他人提供的公开代理服务,以免发生安全问题

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

支持 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 才能使用,请以管理员身份运行命令

checknetisolation loopbackexempt -a -n="1F8B0F94.122165AE053F_j2p0p5q0044a6"

方法 1. 修改 hosts

向 hosts 文件添加几条规则

<Server IP> music.163.com
<Server IP> interface.music.163.com
<Server IP> interface3.music.163.com
<Server IP> interface.music.163.com.163jiasu.com
<Server IP> interface3.music.163.com.163jiasu.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 限制

方法 2. 设置代理

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

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

平台基础设置
Windows设置 > 工具 > 自定义代理 (客户端内)
UWPWindows 设置 > 网络和 Internet > 代理
Linux系统设置 > 网络 > 网络代理
macOS系统偏好设置 > 网络 > 高级 > 代理
AndroidWLAN > 修改网络 > 高级选项 > 代理
iOS无线局域网 > HTTP 代理 > 配置代理

代理工具和方法有很多请自行探索,欢迎在 issues 讨论

✳ 方法 3. 调用接口

作为依赖库使用

const match = require('@unblockneteasemusic/server');

/**
 * 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);

設定 HTTPS 憑證

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

效果

Windows 客户端

Windows 客户端

UWP 客户端

UWP 客户端

Linux 客户端

Linux 客户端

macOS 客户端

macOS 客户端

Android 客户端

Android 客户端

iOS 客户端

iOS 客户端

致谢

感谢大佬们为逆向 eapi 所做的努力

使用的其它平台音源 API 出自

trazyn/ieaseMusic

listen1/listen1_chrome_extension

向所有同类项目致敬

EraserKing/CloudMusicGear

EraserKing/Unblock163MusicClient

ITJesse/UnblockNeteaseMusic

bin456789/Unblock163MusicClient-Xposed

YiuChoi/Unlock163Music

yi-ji/NeteaseMusicAbroad

stomakun/NeteaseReverseLadder

fengjueming/unblock-NetEaseMusic

acgotaku/NetEaseMusicWorld

mengskysama/163-Cloud-Music-Unlock

azureplus/163-music-unlock

typcn/163music-mac-client-unlock

许可

(Original project) nondanee/UnblockNeteaseMusic: MIT

(This project) UnblockNeteaseMusic/server: LGPL-3.0-only

FOSSA Status

FAQs

Last updated on 19 May 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc