UnblockNeteaseMusic is a proxy server that restores access to songs blocked or grayed out in Netease Cloud Music clients.
The tool solves the problem of unavailable tracks in Netease Cloud Music by fetching song links from multiple alternative sources and replacing the blocked URLs. It adds the X-Real-IP header to requests to bypass geographic restrictions and supports specifying upstream HTTP or HTTPS proxies. The server functions as a full traffic proxy for both HTTP and HTTPS, allowing it to be configured as a system proxy with PAC support.
The project suits users in regions where Netease Cloud Music restricts certain songs, or anyone experiencing greyed-out tracks in their library. It offers multiple deployment options: standalone executables for Windows and Linux, NPM installation, Docker containers, Windows service registration, or direct repository usage. The tool can also be integrated into BetterNCM as a plugin, used as an Xposed module on Android, or deployed on OpenWrt routers. Configuration is flexible, allowing users to specify which music sources to query, set proxy parameters, and customize startup options.
The project maintains active development with regular updates to its codebase and Docker images. Multiple deployment pathways are actively supported and documented, indicating ongoing effort to serve different user environments. The tool receives contributions focused on expanding source compatibility and improving proxy functionality. Documentation is provided in Chinese with examples for common deployment scenarios, suggesting sustained attention to user accessibility.
