一键备份QQ相册，原图无损下载【QQ相册下载器】-尧图网站建设

📅 发布时间：2026/6/23 19:24:01

📷 QQ 相册照片下载器

安全、高效地将 QQ 空间全部相册照片下载到本地
扫码登录 · 原图下载 · 断点续传 · 并发加速

下载地址：https://github.com/hou-jia88/qq-album-downloader

✨ 功能亮点

特性	说明
🔐扫码登录	手机 QQ 扫码，不涉及密码，安全可靠
🖼️原图下载	默认下载原始分辨率照片，画质无损
⚡并发加速	多线程并发下载，充分利用带宽
📂全量备份	自动遍历所有相册，支持分页获取全部照片
🔄断点续传	已下载文件自动跳过，中断后继续无压力
🛡️智能限速	控制请求频率，避免触发腾讯风控
💓心跳保活	自动维持登录状态，长时间运行不掉线
🚫安全跳过	自动跳过无权限/私密相册，不尝试破解

🚀 快速开始

安装

# 克隆仓库gitclone https://github.com/hou-jia88/qq-album-downloader.gitcdqq-album-downloader# 安装依赖pipinstall-rrequirements.txt

运行

# 交互模式（推荐首次使用）python qq_album_downloader.py# 自动模式（跳过确认，适合脚本化运行）python qq_album_downloader.py--auto

登录流程

程序启动后，终端会显示一个二维码
打开手机QQ→ 右上角扫一扫
扫描终端中的二维码，在手机上确认登录
登录成功后，程序自动开始下载所有相册

💡 登录状态会保存在.cookie.json中，下次运行无需重复扫码。

⚙️ 配置说明

编辑config.json自定义下载行为：

{"下载设置":{"导出路径":"E:\\qq文件\\QQ_Pictures","下载原图":true,"并发下载数":10,"列表请求间隔_秒":1.5,"下载重试次数":3},"过滤设置":{"跳过私密相册":true,"仅下载指定相册":[],"跳过视频":true}}

配置项	说明	默认值
`导出路径`	照片保存目录	`E:\qq文件\QQ_Pictures`
`下载原图`	`true`=原图,`false`=缩略图	`true`
`并发下载数`	同时下载线程数（建议 5~15）	`10`
`列表请求间隔_秒`	API 请求间隔（防封）	`1.5`
`下载重试次数`	下载失败重试次数	`3`
`跳过私密相册`	自动跳过无权限相册	`true`
`仅下载指定相册`	留空=全部，填名称=仅下载指定	`[]`
`跳过视频`	是否跳过视频文件	`true`

📁 输出目录结构

E:\qq文件\QQ_Pictures\ ├── 幸福\ │ ├── 2025-04-25_a1b2c3d4.jpg │ ├── 2025-04-25_e5f6g7h8.jpg │ └── ... ├── 2023.11.27\ │ ├── ... ├── 记忆录\ │ ├── ... └── ...

文件名格式：原始名称_8位哈希.扩展名，哈希值确保同名文件不会覆盖。

📦 项目文件

文件	说明
`qq_album_downloader.py`	🚀 主程序（核心逻辑）
`config.json`	⚙️ 用户配置文件
`requirements.txt`	📋 Python 依赖清单
`.cookie.json`	🔑 登录 Cookie（自动生成）
`.session.json`	📊 下载进度记录（自动生成）

🧠 技术原理

┌─────────────┐ QR 扫码 ┌──────────────┐ │ 手机 QQ │ ◄────────────── │ 终端二维码 │ └─────────────┘ └──────┬───────┘ │ 确认登录 ▼ ┌─────────────────────────────────────────────┐ │ QQ 登录 API │ │ (ptqrshow → ptqrlogin → p_skey → g_tk) │ └─────────────────────┬───────────────────────┘ │ ┌──────────┴──────────┐ ▼ ▼ ┌──────────────┐ ┌──────────────────┐ │ 相册列表 API │ │ 照片列表 API │ │ (fcg_list_ │ │ (cgi_list_photo) │ │ album_v3) │ │ 分页 + 去重 │ └──────┬───────┘ └────────┬─────────┘ │ │ ▼ ▼ ┌──────────────────────────────────┐ │ 并发下载引擎 │ │ ThreadPoolExecutor + tqdm 进度 │ └──────────────┬───────────────────┘ ▼ ┌────────────────┐ │ 本地文件系统 │ │ E:\qq文件\ │ │ QQ_Pictures\ │ └────────────────┘