QQ 相册照片下载器安全、高效地将 QQ 空间全部相册照片下载到本地扫码登录 · 原图下载 · 断点续传 · 并发加速下载地址https://github.com/hou-jia88/qq-album-downloader✨ 功能亮点特性说明扫码登录手机 QQ 扫码不涉及密码安全可靠️原图下载默认下载原始分辨率照片画质无损⚡并发加速多线程并发下载充分利用带宽全量备份自动遍历所有相册支持分页获取全部照片断点续传已下载文件自动跳过中断后继续无压力️智能限速控制请求频率避免触发腾讯风控心跳保活自动维持登录状态长时间运行不掉线安全跳过自动跳过无权限/私密相册不尝试破解 快速开始环境要求Python3.8 或更高版本支持Windows / macOS / Linux安装# 克隆仓库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~1510列表请求间隔_秒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\ │ └────────────────┘⚠️ 注意事项首次使用需要扫码登录Cookie 会保存供后续使用Cookie 有效期约 2~4 小时程序会自动心跳保活下载中断后重新运行会自动跳过已下载文件无需担心建议在稳定的网络环境下运行避免频繁中断大相册数千张下载较慢请耐心等待私密相册会自动跳过不会尝试破解 安全策略本工具严格遵守以下安全原则仅扫码登录— 不收集、不存储密码登录过程完全透明频率限制— 列表请求间隔 1.5 秒避免触发反爬机制跳过受限内容— 不尝试访问私密/加密相册本地存储— Cookie 仅保存在本地文件不进行任何网络传输尊重平台规则— 不暴力爬取模拟正常用户操作行为 免责声明本工具仅用于个人数据备份请勿用于商业用途使用前请阅读并遵守腾讯 QQ 空间用户协议使用者需自行承担使用风险请勿使用本工具进行任何违法违规操作☕ 支持项目如果这个工具帮到了你欢迎请我喝杯咖啡 ☕微信 / 支付宝 通用收款码 LicenseMIT © 2024