你还在为网易云音乐海外版权限制烦恼吗？还在为不同设备部署解锁工具头疼吗？本文将详细介绍UnblockNeteaseMusic在Windows、macOS和Linux三大操作系统上的完整部署方案，无需专业技术背景，小白也能轻松上手。读完本文你将获得：
项目地址: https://gitcode.com/gh_mirrors/server3/server - 三种主流操作系统的部署步骤
- Docker容器化部署技巧
- 常见问题解决方案
- 环境变量配置指南
项目概述
UnblockNeteaseMusic是一款开源项目，旨在解决网易云音乐客户端中歌曲因版权问题变灰无法播放的问题。该项目通过替换变灰歌曲链接，支持多个音源，包括QQ音乐、酷狗、酷我等，让你畅享音乐无国界。
项目核心功能模块：
- 音源匹配系统：src/provider/
- 服务器核心逻辑：src/server.js
- 配置参数解析：src/cli.js
- 证书管理：generate-cert.sh、renew-cert.sh
部署环境准备
系统要求
| 操作系统 | 最低配置要求 | 推荐配置 |
|---|---|---|
| Windows | Windows 10+，4GB内存 | Windows 11，8GB内存 |
| macOS | macOS 10.15+ | macOS 12+，8GB内存 |
| Linux | Ubuntu 18.04+，4GB内存 | Ubuntu 20.04+，8GB内存 |
依赖软件安装
所有系统都需要安装以下基础软件：
Windows系统部署
方法一：可执行文件快速启动
- 访问项目仓库：
git clone https://gitcode.com/gh_mirrors/server3/server.git - 进入项目目录：
cd server - 运行预编译文件：
precompiled/app.js
方法二：注册为系统服务（推荐）
- 以管理员身份打开命令提示符
- 执行注册服务命令：
node nw.js - 在弹出的窗口中点击确认完成安装
- 服务配置文件路径：nw.js
服务启动后默认配置：
- 端口服务：127.0.0.1:8080
- 日志文件位置：项目根目录下的
daemon文件夹
macOS系统部署
方法一：使用Homebrew安装
# 安装Node.js
brew install node
# 克隆项目
git clone https://gitcode.com/gh_mirrors/server3/server.git
cd server
# 安装依赖
yarn install
# 启动服务
yarn start
方法二：Docker容器化部署
- 安装Docker Desktop for Mac：国内下载地址
- 启动Docker并执行：
docker-compose up -d - Docker配置文件：docker-compose.yml
Linux系统部署
Ubuntu/Debian系统
# 安装依赖
sudo apt update && sudo apt install -y nodejs npm git
# 克隆项目
git clone https://gitcode.com/gh_mirrors/server3/server.git
cd server
# 安装依赖
npm install
# 启动服务
npm start
CentOS/RHEL系统
# 安装Node.js
curl -fsSL https://rpm.nodesource.com/setup_16.x | sudo -E bash -
sudo yum install -y nodejs git
# 克隆项目并启动
git clone https://gitcode.com/gh_mirrors/server3/server.git
cd server
npm install
npm start
Docker跨平台部署
Docker部署是跨平台的最佳方案，一次配置，多平台通用。
快速启动
# 直接运行官方镜像
docker run -d -p 8080:8080 -p 8081:8081 --name unblockneteasemusic pan93412/unblock-netease-music-enhanced
自定义配置
- 复制环境变量示例文件：
cp env-example .env - 编辑.env文件配置端口和其他参数：env-example
- 使用docker-compose启动：
docker-compose up -d
客户端配置
设置端口服务
| 平台 | 配置方法 |
|---|---|
| Windows | 设置 > 工具 > 自定义端口服务，填写127.0.0.1:8080 |
| macOS | 系统偏好设置 > 网络 > 高级 > 端口服务，勾选"网页端口(HTTP)" |
| Linux | 系统设置 > 网络 > 网络端口服务，选择"手动"配置 |
| Android | WLAN > 修改网络 > 高级选项 > 端口服务，选择"手动" |
| iOS | 无线局域网 > HTTP端口服务 > 配置端口服务，选择"手动" |
PAC自动配置
对于多设备或频繁切换网络的用户，推荐使用PAC自动端口服务：
- 在端口服务设置中选择"自动配置URL"
- 输入PAC文件地址：
http://127.0.0.1:8080/proxy.pac
高级配置
环境变量配置
通过修改.env文件可以自定义多种功能：
# 启用无损音质
ENABLE_FLAC=true
# 设置日志级别
LOG_LEVEL=info
# 自定义音源优先级
MATCH_ORDER=bilibili,kugou,kuwo
完整环境变量说明：env-example
音源配置
UnblockNeteaseMusic支持多种音源，可通过命令行参数或环境变量设置优先级：
# 命令行方式
node app.js -o bilibili kugou kuwo
# 环境变量方式
export MATCH_ORDER=bilibili,kugou,kuwo
支持的音源清单：
- bilibili：B站音乐
- kugou：酷狗音乐
- kuwo：酷我音乐
- migu：咪咕音乐
- ytdlp：YouTube音源
常见问题解决
证书问题
当客户端提示证书错误时，需要安装项目自签证书：
- 生成证书：
./generate-cert.sh - 证书文件位置：server.crt、server.key
- 安装证书到系统信任根证书库
端口占用问题
如果启动时提示端口被占用，可修改配置文件更换端口：
# 修改.env文件
HTTP_PROXY_PORT=8888
HTTPS_PROXY_PORT=8889
更新维护
# 拉取最新代码
git pull
# 更新依赖
npm update
# 重启服务
npm restart
部署架构
总结
UnblockNeteaseMusic提供了灵活多样的部署方案，无论你使用Windows、macOS还是Linux系统，都能找到适合自己的部署方式。Docker容器化部署更是简化了跨平台的复杂性，让你在不同设备上都能轻松享受无版权限制的音乐体验。
项目配置完成后，记得定期更新以获取最新功能和bug修复。如有任何问题，可查阅项目官方文档或提交issue反馈。
官方文档：README.md 项目源码：src/ 配置示例：env-example
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
