Mikus Blog

系统要求#

• Windows 操作系统
• Python 3.10+
• Visual C++ 生成工具（编译 mitmproxy 依赖必需）
• QQ音乐客户端（已登录）
• 网易云音乐客户端（已登录）

1. 安装 Visual C++ 生成工具（必需）#

mitmproxy 的某些底层依赖（zstandard、cffi）需要 C++ 编译器才能安装。

方式一：安装 Visual Studio Build Tools（推荐）

1. 访问 Visual Studio 下载页面
2. 展开 “所有下载” → 找到 “Visual Studio 2022 生成工具” → 下载
3. 运行安装程序，勾选 “C++ 生成工具”
4. 确保包含以下组件：
   • MSVC v143 - VS 2022 C++ x64/x86 生成工具
   • Windows 11 SDK (最新版本)
   • C++ CMake 工具（可选）

2. 安装 Python#

如果尚未安装 Python，请从 python.org 下载安装。

重要：安装时勾选 “Add Python to PATH”。

3. 创建虚拟环境（推荐）#

1
# 在项目目录打开终端
2
cd D:\miku\QQMusic-Cookie
3

4
# 创建虚拟环境
5
python -m venv venv
6

7
# 激活虚拟环境
8
venv\Scripts\activate

1. 安装依赖#

1
pip install -r requirements.txt

依赖说明：

2. 配置 .env 文件#

1
# 复制配置模板
2
copy .env.example .env

打开 .env 文件，填写以下关键配置：

1
# ===== 必填配置 =====
2
# Meting-API 地址（你的 Meting-API 服务地址）
3
TARGET_API_URL=https://meting.mikus.ink/admin/cookies
4

5
# Meting-API Token（在 Meting-API 管理后台获取，以 mapi_ 开头）
6
TARGET_API_TOKEN=mapi_your_token_here
7

8
# QQ音乐客户端路径
9
QQMUSIC_PATH=C:\QQMusic\QQMusic.exe
10

11
# 网易云音乐客户端路径
12
NETEASEMUSIC_PATH=C:\Program Files\Netease\CloudMusic\cloudmusic.exe
13

14
# Miotify 通知（详见下方通知配置章节）#也支持 gotify 通知
15
MIOTIFY_ENABLED=false
16
MIOTIFY_URL=http://localhost:8080
17
MIOTIFY_TOKEN=
18

19
# 代理配置（一般无需修改）
20
PROXY_HOST=127.0.0.1
21
PROXY_PORT=8080
22

23
# API 服务配置
24
API_HOST=0.0.0.0
25
API_PORT=5000
26
API_TOKEN=your_api_token

3. 安装 MITM 证书#

MITM 代理需要安装 SSL 证书才能解密 HTTPS 流量。

步骤：

1. 启动代理（任选一种方式）：

   1
   python main.py --proxy-only

2. 打开浏览器访问 http://mitm.it

3. 下载 Windows 证书：

   • 点击 Windows 图标下载 mitmproxy-ca-cert.p12

4. 安装证书：

   • 双击下载的证书文件
   • 选择 “本地计算机”
   • 选择 “将所有证书放入下列存储”
   • 点击 “浏览” → 选择 “受信任的根证书颁发机构”
   • 完成安装

或者通过命令行安装：

1
certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer

QQ音乐客户端#

1. 打开 QQ音乐客户端
2. 点击右上角 菜单（三条横线图标）
3. 选择 设置
4. 找到 网络设置 或 代理设置
5. 选择 自定义代理
6. 填写：
   • 类型：HTTP 代理
   • 服务器地址：127.0.0.1
   • 端口：8080
7. 点击 保存 或 确定

网易云音乐客户端#

1. 打开网易云音乐客户端
2. 点击右上角 设置（齿轮图标）
3. 找到 工具 或 代理设置
4. 选择 自定义代理
5. 填写：
   • 类型：HTTP 代理
   • 服务器地址：127.0.0.1
   • 端口：8080
6. 点击 保存 或 确定

注意：两个客户端都需要先登录账号，否则捕获的 Cookie 无效。

方式一：双击运行（最简单）#

直接双击对应的 .bat 文件即可启动。

方式二：命令行运行#

1
# 每24小时循环一次，抓取所有平台
2
python automate.py --interval 24
3

4
# 只抓取 QQ音乐
5
python automate.py --interval 24 --platform qqmusic
6

7
# 只抓取 网易云音乐
8
python automate.py --interval 24 --platform netease
9

10
# 执行一次后退出
11
python automate.py --once
12
python automate.py --once --platform qqmusic

1
# 完整服务（代理 + API + 定时任务）
2
python main.py
3

4
# 仅启动 API 服务
5
python main.py --api-only
6

7
# 仅启动代理抓包
8
python main.py --proxy-only
9

10
# 手动发送已存储的 Cookie 到 Meting-API
11
python main.py --send-now
12

13
# 查看当前 Cookie 状态
14
python main.py --status

各阶段说明#

定时执行#

• 脚本会每24小时自动执行一次完整流程
• 执行时间取决于首次启动时间（例如首次 17:00 启动，下次也是 17:00）
• 按 Ctrl+C 可随时停止

1. 部署 Miotify#

1
git clone https://github.com/mikus-loli/Miotify
2
cd Miotify
3
docker-compose up -d

服务默认运行在 http://localhost:8080。

2. 获取 App Token#

1. 浏览器打开 http://localhost:8080
2. 使用默认账号登录（admin / admin）
3. 点击 Apps → Create Application
4. 输入应用名称（如 “Cookie Manager”）
5. 创建后会生成一个 App Token（UUID 格式），复制保存

3. 配置 .env#

1
MIOTIFY_ENABLED=true
2
MIOTIFY_URL=http://localhost:8080
3
MIOTIFY_TOKEN=你的App_Token_（UUID格式）

4. 通知类型#

Cookie 状态检查#

1
python main.py --status

输出示例：

1
QQ Music Cookie Status
2
========================================
3
  UIN: 3166326944
4
  Key: Q_H_L_63k3NLuJcvgUCi...
5
  Refresh Token: Yes
6
  Status: Valid

认证方式#

需要认证的接口使用 Bearer Token：

1
curl -H "Authorization: Bearer your_token" http://localhost:5000/api/meting

接口列表#

QQ音乐#

最简格式（基本播放功能）：

1
uin=你的QQ号; qqmusic_key=Q_H_L_开头的key

完整格式（支持自动续期）：

1
uin=你的QQ号; qqmusic_key=Q_H_L_...; qm_keyst=Q_H_L_...; psrf_qqrefresh_token=...; psrf_qqaccess_token=...; qqmusic_guid=...

网易云音乐#

1
MUSIC_U=用户token; MUSIC_A=认证key; __csrf=csrf值

QQ音乐#

1
{
2
  "platform": "tencent",
3
  "cookie": "uin=3166326944; qqmusic_key=Q_H_L_63k3...; psrf_qqrefresh_token=...",
4
  "note": "Auto-synced from Music-Cookie-Manager",
5
  "isActive": true
6
}

网易云音乐#

1
{
2
  "platform": "netease",
3
  "cookie": "MUSIC_U=00FD08B3B2141E00C258...; __csrf=...",
4
  "note": "Auto-synced from Music-Cookie-Manager",
5
  "isActive": true
6
}

Q: 安装依赖报错 error: Microsoft Visual C++ 14.0 or greater is required？#

mitmproxy 的底层依赖 zstandard 和 cffi 需要 C++ 编译器。解决方案：

1. 安装 Visual Studio Build Tools（推荐）
2. 使用预编译 wheel 安装
3. 使用精简版依赖 requirements-lite.txt

Q: 自动化模式无法启动应用？#

检查 .env 中的 QQMUSIC_PATH 和 NETEASEMUSIC_PATH 是否正确，或确保应用安装在默认路径。

Q: Cookie抓取失败？#

1. 确保已安装MITM证书
2. 确保客户端已配置代理 127.0.0.1:8080
3. 确保客户端已登录账号

Q: 发送失败？#

检查 TARGET_API_URL 和 TARGET_API_TOKEN 配置是否正确。

Q: 网易云音乐抓取不到Cookie？#

1. 网易云音乐需要在设置中配置代理
2. 确保已登录账号
3. 检查代理日志 logs/proxy.log