UnblockNeteaseMusic自签证书配置：解决HTTPS接口访问问题-优快云博客

UnblockNeteaseMusic自签证书配置：解决HTTPS接口访问问题

【免费下载链接】UnblockNeteaseMusic Revive unavailable songs for Netease Cloud Music 项目地址: https://gitcode.com/gh_mirrors/un/UnblockNeteaseMusic

你是否在使用UnblockNeteaseMusic时遇到HTTPS接口访问失败的问题？本文将详细介绍如何通过配置自签证书解决这一问题，让你顺利解锁网易云音乐的灰色歌曲。读完本文后，你将了解自签证书的作用、安装方法以及在不同操作系统和客户端中的配置步骤。

为什么需要自签证书

随着网络安全要求的提高，新版网易云音乐客户端（如Linux客户端1.2版本以上、macOS客户端726版本以上）已默认优先使用HTTPS接口进行通信。UnblockNeteaseMusic作为一款用于解锁网易云音乐灰色歌曲的工具，需要对这些HTTPS请求进行处理。然而，由于客户端对HTTPS证书的验证机制，未经信任的证书会导致接口访问失败。

自签证书（Self-signed Certificate）是解决这一问题的关键。项目中已提供现成的自签根证书文件ca.crt，通过将其安装到系统或浏览器的信任列表中，客户端会信任由该根证书签发的服务器证书，从而允许UnblockNeteaseMusic正常处理HTTPS请求。

自签证书文件说明

UnblockNeteaseMusic项目根目录下提供了以下与证书相关的文件：

ca.crt: 自签根证书，需要安装到系统或浏览器的信任存储区。
server.crt: 由ca.crt签发的服务器证书，用于HTTPS通信。
server.key: 服务器证书对应的私钥文件。

其中，ca.crt是配置的核心，其内容格式如下（部分内容省略）：

-----BEGIN CERTIFICATE-----
MIIDdzCCAl+gAwIBAgIJAKX8LdIETDklMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNV
BAYTAkNOMSQwIgYDVQQDDBtVbmJsb2NrTmV0ZWFzZU11c2ljIFJvb3QgQ0ExHTAb
...
-----END CERTIFICATE-----

证书安装步骤

Windows系统

找到项目根目录下的ca.crt文件，双击打开。
在弹出的证书窗口中，点击"安装证书"。
选择"当前用户"或"本地计算机"（推荐选择"本地计算机"，需要管理员权限），点击"下一步"。
选择"将所有证书放入下列存储区"，点击"浏览"。
在"选择证书存储"窗口中，选择"受信任的根证书颁发机构"，点击"确定"。
点击"下一步"，然后点击"完成"。系统会弹出安全警告，点击"是"确认安装。

macOS系统

打开Finder，导航到项目根目录，找到ca.crt文件。
双击ca.crt，钥匙串访问工具会自动打开。
选择"登录"钥匙串和"证书"类别，找到刚添加的"UnblockNeteaseMusic Root CA"证书。
右键点击该证书，选择"显示简介"。
展开"信任"选项，将"使用此证书时"设置为"始终信任"。
关闭窗口，系统会要求输入管理员密码以保存更改。

Linux系统

不同Linux发行版的证书安装方法略有不同，以下是常见发行版的安装方式：

Ubuntu/Debian

# 将证书复制到系统证书目录
sudo cp ca.crt /usr/local/share/ca-certificates/UnblockNeteaseMusic.crt
# 更新证书信任列表
sudo update-ca-certificates

CentOS/RHEL

# 将证书复制到系统证书目录
sudo cp ca.crt /etc/pki/ca-trust/source/anchors/UnblockNeteaseMusic.crt
# 更新证书信任列表
sudo update-ca-trust extract

客户端配置

网易云音乐Linux客户端

对于Linux客户端，除了安装根证书外，还需要在启动时添加忽略证书错误的参数。可以通过以下命令启动客户端：

netease-cloud-music --ignore-certificate-errors

如果希望每次启动都自动应用该参数，可以修改桌面快捷方式文件（通常位于/usr/share/applications/netease-cloud-music.desktop或~/.local/share/applications/netease-cloud-music.desktop），将Exec行修改为：

Exec=netease-cloud-music --ignore-certificate-errors %U

网页版

网页版网易云音乐需要配合浏览器的证书信任设置和脚本使用。首先确保已在浏览器中安装并信任ca.crt证书，然后可以使用项目提供的浏览器扩展相关脚本，如src/browser/inject.js和src/browser/script.js，这些脚本可以帮助处理网页版的请求拦截和修改。

iOS客户端

iOS客户端配置HTTPS证书需要通过描述文件安装。首先将ca.crt文件发送到iOS设备（可通过邮件、AirDrop等方式），然后在设备上点击证书文件进行安装。安装完成后，需要在"设置" > "通用" > "关于本机" > "证书信任设置"中，开启对"UnblockNeteaseMusic Root CA"证书的完全信任。

验证证书配置是否成功

证书安装配置完成后，可以通过以下步骤验证是否生效：

启动UnblockNeteaseMusic服务。可以使用项目提供的多种启动方式，如：
- 使用npx：npx @nondanee/unblockneteasemusic
- 使用Docker：docker run nondanee/unblockneteasemusic
- 或通过项目源码启动：node app.js
按照README.md中介绍的方法（如修改网络配置或设置代理），将网易云音乐客户端的流量导向UnblockNeteaseMusic服务。
打开网易云音乐客户端，查看之前无法播放的灰色歌曲是否已解锁。如果能够正常播放，则说明证书配置成功。

如果仍然遇到问题，可以检查证书安装是否正确，或尝试重启客户端和UnblockNeteaseMusic服务。对于Linux和macOS客户端，确保已按照要求启用了证书信任或添加了启动参数。

常见问题解决

证书安装后仍提示不安全

检查证书存储位置：确保ca.crt安装在了"受信任的根证书颁发机构"（Windows）或"登录"钥匙串并设置为"始终信任"（macOS）。
重启客户端：证书安装后，需要重启网易云音乐客户端才能生效。
检查系统时间：如果系统时间与证书有效期不符（ca.crt有效期通常为5年），会导致证书验证失败，请确保系统时间准确。

Linux客户端启动参数不生效

检查快捷方式修改：确认桌面快捷方式文件中的Exec行已正确添加--ignore-certificate-errors参数。
终端启动验证：尝试直接在终端中使用netease-cloud-music --ignore-certificate-errors命令启动，观察是否有错误输出。

iOS证书信任设置灰显

在iOS 10.3及以上版本中，默认情况下企业级证书的信任设置可能灰显。需要先安装证书，然后在"设置" > "通用" > "关于本机" > "证书信任设置"中手动开启信任。

总结

通过安装和配置UnblockNeteaseMusic项目提供的自签根证书ca.crt，可以解决新版网易云音乐客户端因HTTPS证书验证导致的接口访问问题，从而顺利解锁灰色歌曲。本文详细介绍了证书的安装步骤和不同客户端的配置方法，帮助你快速完成设置。

如果在配置过程中遇到其他问题，可以查阅项目的README.md文档获取更多帮助，或在项目的Issues中寻求社区支持。享受你的音乐解锁之旅吧！

【免费下载链接】UnblockNeteaseMusic Revive unavailable songs for Netease Cloud Music 项目地址: https://gitcode.com/gh_mirrors/un/UnblockNeteaseMusic

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考