gitwtfhub

wtf is unblockneteasemusic?

nondanee/unblockneteasemusic — explained in plain English

Analysis updated 2026-06-24

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

TL;DR

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

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

Route Netease through an upstream proxy for additional privacy

What's in the stack?

JavaScriptNode.jsDocker

How it stacks up

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 spin it up?

Difficulty · moderate Time to first run · 30min

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

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.