How unblockneteasemusic/server works
UnblockNeteaseMusic is a Node.js HTTP/HTTPS proxy that restores unavailable Netease Cloud Music tracks by matching them against alternate music providers. The main flow is client traffic through the proxy and Netease request hook, which invokes provider matching and returns a replacement audio URL; the proxy also supports general traffic forwarding, PAC, authentication, filtering, and relay configuration. Sampled source supports the main runtime calls; provider coverage and several proxy capabilities are documented in the README, while some provider implementations were not sampled.
Main entry points: server.js HTTP/S proxy · provider Music source adapters · request.js HTTP request client · app.js Application setup
Components 17
Runtime and proxy
- Application setup
src/app.js - CLI configuration
src/cli.js - HTTP/S proxy
src/server.js - Request interception
src/hook.js
Track matching
- Song matching
src/provider/match.js - Provider selection
src/consts.js
Music providers
- Music source adapters
src/provider - Relay adapter
src/provider/insure.js
Shared services
- HTTP request client
src/request.js - Cache storage
src/cache.js - Provider cryptography
src/crypto.js - Kuwo cipher
src/kwDES.js - Request utilities
src/utilities.js - Logging
src/logger.js
Other components
- Music client
- Netease API
- Alternate music services
Connections 22
- Music client → HTTP/S proxy: sends traffic
- Application setup → CLI configuration: parses options
src/app.js - Application setup → HTTP/S proxy: configures and starts
src/app.js - HTTP/S proxy → Request interception: intercepts requests
src/server.js - Request interception → Netease API: forwards requests
- Request interception → Song matching: requests replacement
src/hook.js - Song matching → Provider selection: reads source list
src/provider/match.js - Song matching → Music source adapters: queries providers
src/provider/match.js - Music source adapters → Alternate music services: searches and retrieves audio
- Music source adapters → HTTP request client: makes service requests
src/provider/bilivideo.js - Music source adapters → Cache storage: caches provider results
src/provider/bilivideo.js - Music source adapters → Provider cryptography: signs provider requests
src/provider/bilivideo.js - Relay adapter → HTTP request client: calls relay
src/provider/insure.js - Song matching → HTTP request client: validates audio URL
src/provider/match.js - Request interception → Provider cryptography: decrypts and encrypts payloads
src/hook.js - HTTP/S proxy → HTTP request client: forwards upstream
src/server.js - HTTP/S proxy → Request utilities: checks hosts
src/server.js - Provider cryptography → Kuwo cipher: loads cipher
src/crypto.js - Application setup → Cache storage: schedules cleanup
src/app.js - Application setup → HTTP request client: queries DNS services
src/app.js - HTTP/S proxy → Logging: logs proxy activity
src/server.js - Cache storage → Logging: logs cache activity
src/cache.js