explaingit

nondanee/unblockneteasemusic

Analysis updated 2026-06-24

17,414JavaScriptAudience · generalComplexity · 2/5Setup · moderate

TLDR

Local proxy server for the Netease Cloud Music app that swaps greyed-out tracks for working versions sourced from QQ, Kugou, Migu, and other music platforms.

Mindmap

mindmap
  root((UnblockNeteaseMusic))
    Inputs
      Netease Music traffic
      Greyed out song requests
    Outputs
      Substitute audio streams
      Working playback
    Use Cases
      Listen to locked songs in Netease
      Self host a music unblocker
      Embed in a Node project
    Tech Stack
      JavaScript
      Node.js
      Docker
      HTTP proxy
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a local proxy so the Netease Cloud Music app plays greyed-out tracks

USE CASE 2

Self-host the proxy in Docker on a home server for the whole household

USE CASE 3

Embed the library in a Node.js project that wraps Netease playback

USE CASE 4

Route Netease through an upstream proxy for additional privacy

What is it built with?

JavaScriptNode.jsDocker

How does it compare?

nondanee/unblockneteasemusiccommitizen/cz-clifacebookarchive/flux
Stars17,41417,45917,469
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasyeasy
Complexity2/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires editing hosts file or system proxy settings, HTTPS interception needs a local certificate to be trusted.

In plain English

UnblockNeteaseMusic is a proxy server (a middleman that sits between your app and the internet) that revives songs that have been "greyed out" in Netease Cloud Music, a popular Chinese music streaming app. When a song is unavailable in Netease's library due to licensing issues, this tool automatically finds and substitutes a working version from alternative music sources including QQ, Xiami, Baidu, Kugou, Kuwo, Migu, and JOOX. The way it works is straightforward: you run this tool as a local proxy server, then configure your Netease Cloud Music app to route its traffic through that proxy. When the app tries to play a greyed-out song, the proxy intercepts the request and silently replaces the broken link with a working audio stream from another platform. You can set it up in one of three ways, by modifying your system's "hosts" file (a routing table on your computer), by configuring a system-wide or app-level proxy in your network settings, or by calling it directly as a programming library in your own JavaScript project. The tool is written in JavaScript and can be run instantly using npx (a command-line tool that comes with Node.js) or via Docker (a way to run software in an isolated container). It supports a range of configuration options: you can set which music sources to prioritize, specify port and server address, enable strict mode to limit the proxy's scope, and route through an upstream proxy for additional privacy. You would use this if you're a Netease Cloud Music listener who frequently encounters locked or unavailable songs and wants an automated way to keep your music playing without switching apps.

Copy-paste prompts

Prompt 1
Show me the exact npx command to start UnblockNeteaseMusic on port 8080 and configure my system proxy
Prompt 2
Write a docker-compose file that runs UnblockNeteaseMusic and pins QQ and Kugou as the preferred sources
Prompt 3
Walk me through editing the hosts file on macOS so the Netease Cloud Music desktop app uses the local proxy
Prompt 4
Explain what strict mode does in UnblockNeteaseMusic and when I should turn it on
Prompt 5
Use UnblockNeteaseMusic as a Node library in a small script that resolves a single song id to a playable URL

Frequently asked questions

What is unblockneteasemusic?

Local proxy server for the Netease Cloud Music app that swaps greyed-out tracks for working versions sourced from QQ, Kugou, Migu, and other music platforms.

What language is unblockneteasemusic written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Docker.

How hard is unblockneteasemusic to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is unblockneteasemusic for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub nondanee on gitmyhub

Verify against the repo before relying on details.