小红书原图下载 XHS-Downloader10分钟跑通第一次原图下载实战指南【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader你可能遇到过这种情况前阵子存的小红书原图链接再点开笔记已经删除。XHS-Downloader 是一款免费开源的链接提取与作品采集工具把这类线上笔记变成硬盘里永久属于你的文件——免登录、不用写代码粘贴链接即可。三条命令把下载工具跑起来读完这节你能从一台干净的电脑出发把程序跑起来并下完第一个作品。环境要求只有一行Python 3.12 及以上。先把源码拉到本地git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader然后装依赖pip 方式就够了pip install -r requirements.txt用 uv 的话执行uv sync --no-dev效果一样速度更快。最后启动程序python main.py回车后弹出一个窗口左侧边栏列出创建任务任务队列剪贴板模式下载记录等入口——看到它就是成功标志。把作品链接粘进创建任务输入框点下载作品文件几秒后任务队列里出现进度文件落在项目目录的Volume/Download文件夹里。走一遍小红书原图下载的三个阶段读完这节你能说清一条链接进去后程序每一步替你做了什么、哪个设置在哪一步生效。整条链路拆成输入、处理、输出三段每一段都有对应的开关。把链接变成任务这一步替你完成的是把一串文本变成可下载的任务。多个链接用空格分隔一起贴explore作品页、xhslink.com短链都认程序会自动从中提取出有效链接。走命令行更直接python main.py --url 作品链接 --index 3 6 9--index只挑指定序号的图片几十张图的长图文不必全量拉。注意它只对第一个链接生效想一次传多个链接就别带这个参数。全套参数执行python main.py --help会打印中文对照表查到哪个用哪个。把原图和视频文件写进硬盘这一步是小红书原图下载的核心程序从服务器请求到原始资源地址再把文件按你的规则落盘。日常会碰到的开关就四个image_format图片下载格式AUTO、PNG、WEBP、JPEG、HEIC 任选默认 JPEGlive_downloadLivePhoto 动图开关默认关闭想保留动效就打开video_preference视频下载偏好按分辨率、码率或文件大小选优name_format作品文件命名格式默认发布时间 作者昵称 作品标题记录已下载作品并自动跳过这一步保证同一篇作品永远不会下第二遍。下载成功后作品 ID 写进本地数据库由 source/module/recorder.py 管理再次提交同一链接直接跳过文件下载中断的话重新运行能接着续传。想让素材库更整齐还有三个归档开关值得打开author_archive按作者各建一个文件夹folder_mode每篇作品各建一个文件夹write_mtime把文件修改时间同步成作品发布时间时间线上自然有序让小红书批量下载跑起来从单链接到整个收藏夹读完这节你不用一条一条手复制链接而是让浏览器和 AI 替你干活。用浏览器脚本三步清空收藏夹前置条件浏览器装了 Tampermonkey且配置里script_server设为true。把项目自带的用户脚本static/XHS-Downloader.js导入 Tampermonkey小红书网页右上角会多出功能菜单。打开账号主页菜单里提取发布/点赞/收藏作品链接点一下成批链接进剪贴板。主程序后台挂着的时用脚本菜单推送下载任务直接把作品发给程序浏览器只管提取。脚本自带自动滚动页面选项默认关闭。打开后列表再长也能一次捞完但官方提示开启自动滚动可能触发风控自行权衡。把下载任务交给 AI 三步接入前置条件装 fastmcp 依赖pip install fastmcp4.1.0然后执行python main.py mcp启动。启动后终端会打印一个鉴权令牌后续调用都要带上先记下来。在支持 MCP 的对话工具里新建配置地址填http://127.0.0.1:5556/mcp/类型选可流式传输的 HTTP。回到对话窗口说一句帮我下载这个链接AI 就把整个流程走完了。不走 AI 也行python main.py api启动后浏览器打开http://127.0.0.1:5556/docsPOST 到/xhs/detail即可采集作品信息并触发下载。example.py 是完整的调用示例照着改就行想容器化部署项目里附带现成的 Dockerfile。一次性配置拿到小红书 Cookie 和参数速查读完这节你把影响最大的配置做完一次之后日常只翻表格调开关。先说透一句实话未配置 Cookie 时小红书视频下载只能拿到低分辨率版本。配好之后画质解锁请求也更稳。获取只要三步浏览器打开小红书网页版按 F12 打开开发者工具切到网络标签刷新页面。随便点开一篇作品选中一个数据包在请求标头里找到Cookie字段。整段复制粘进图形界面程序设置或Volume目录下的settings.json重启程序生效。所有设置项由 source/module/settings.py 统一管理首次运行自动生成settings.json设置界面觉得绕直接编辑这个 JSON 也行。最常用的参数集中在这张表里参数作用默认值cookie小红书网页版 Cookie决定视频画质空work_path作品保存根路径项目目录 Volumefolder_name作品存放文件夹名Downloadimage_format图片下载格式AUTO/PNG/WEBP/JPEG/HEICJPEGimage_download图片下载开关truevideo_download视频下载开关truelive_downloadLivePhoto 动图下载开关falsefolder_mode每篇作品单独一个文件夹falseauthor_archive每个作者单独一个文件夹falsedownload_record记录已下载 ID自动跳过重复truewrite_mtime文件修改时间同步为发布时间falsenote_format作品信息保存格式txt/md/all不保存完整参数清单就在该文件的default字典里每一项都带注释。问题诊断三分钟定位小红书原图下载常见故障读完这节卡住时你知道先查哪里多数问题一次就能定位。下载卡住或报网络错误第一嫌疑是全局代理开着它请求常被干扰先关掉再试。还不行就看运行日志里的具体报错判断是网络层还是解析层的问题。视频清晰度上不去八成是 Cookie 没配只能拿到低清源。按上一节三步配好重启程序重新下载无需其他操作。链接提示失效小红书作品链接自带日期信息太旧的链接容易被风控拦下尽量用刚抓取的链接也别短时间内高频请求内置的请求延时保持默认就好。升级路径源码用户执行git pull更新依赖即可换程序包的话把旧版的Volume文件夹复制进新版设置无缝迁移。工具已经躺在你的项目目录里把一条旧链接贴进去10 分钟后硬盘里就有第一份备份原图——剩下的交给 XHS-Downloader。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/4 11:11:58 · 阅读 1.2k 小红书原图下载 XHS-Downloader：10分钟跑通第一次原图下载实战指南
小红书原图下载 XHS-Downloader10分钟跑通第一次原图下载实战指南【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader你可能遇到过这种情况前阵子存的小红书原图链接再点开笔记已经删除。XHS-Downloader 是一款免费开源的链接提取与作品采集工具把这类线上笔记变成硬盘里永久属于你的文件——免登录、不用写代码粘贴链接即可。三条命令把下载工具跑起来读完这节你能从一台干净的电脑出发把程序跑起来并下完第一个作品。环境要求只有一行Python 3.12 及以上。先把源码拉到本地git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader然后装依赖pip 方式就够了pip install -r requirements.txt用 uv 的话执行uv sync --no-dev效果一样速度更快。最后启动程序python main.py回车后弹出一个窗口左侧边栏列出创建任务任务队列剪贴板模式下载记录等入口——看到它就是成功标志。把作品链接粘进创建任务输入框点下载作品文件几秒后任务队列里出现进度文件落在项目目录的Volume/Download文件夹里。走一遍小红书原图下载的三个阶段读完这节你能说清一条链接进去后程序每一步替你做了什么、哪个设置在哪一步生效。整条链路拆成输入、处理、输出三段每一段都有对应的开关。把链接变成任务这一步替你完成的是把一串文本变成可下载的任务。多个链接用空格分隔一起贴explore作品页、xhslink.com短链都认程序会自动从中提取出有效链接。走命令行更直接python main.py --url 作品链接 --index 3 6 9--index只挑指定序号的图片几十张图的长图文不必全量拉。注意它只对第一个链接生效想一次传多个链接就别带这个参数。全套参数执行python main.py --help会打印中文对照表查到哪个用哪个。把原图和视频文件写进硬盘这一步是小红书原图下载的核心程序从服务器请求到原始资源地址再把文件按你的规则落盘。日常会碰到的开关就四个image_format图片下载格式AUTO、PNG、WEBP、JPEG、HEIC 任选默认 JPEGlive_downloadLivePhoto 动图开关默认关闭想保留动效就打开video_preference视频下载偏好按分辨率、码率或文件大小选优name_format作品文件命名格式默认发布时间 作者昵称 作品标题记录已下载作品并自动跳过这一步保证同一篇作品永远不会下第二遍。下载成功后作品 ID 写进本地数据库由 source/module/recorder.py 管理再次提交同一链接直接跳过文件下载中断的话重新运行能接着续传。想让素材库更整齐还有三个归档开关值得打开author_archive按作者各建一个文件夹folder_mode每篇作品各建一个文件夹write_mtime把文件修改时间同步成作品发布时间时间线上自然有序让小红书批量下载跑起来从单链接到整个收藏夹读完这节你不用一条一条手复制链接而是让浏览器和 AI 替你干活。用浏览器脚本三步清空收藏夹前置条件浏览器装了 Tampermonkey且配置里script_server设为true。把项目自带的用户脚本static/XHS-Downloader.js导入 Tampermonkey小红书网页右上角会多出功能菜单。打开账号主页菜单里提取发布/点赞/收藏作品链接点一下成批链接进剪贴板。主程序后台挂着的时用脚本菜单推送下载任务直接把作品发给程序浏览器只管提取。脚本自带自动滚动页面选项默认关闭。打开后列表再长也能一次捞完但官方提示开启自动滚动可能触发风控自行权衡。把下载任务交给 AI 三步接入前置条件装 fastmcp 依赖pip install fastmcp4.1.0然后执行python main.py mcp启动。启动后终端会打印一个鉴权令牌后续调用都要带上先记下来。在支持 MCP 的对话工具里新建配置地址填http://127.0.0.1:5556/mcp/类型选可流式传输的 HTTP。回到对话窗口说一句帮我下载这个链接AI 就把整个流程走完了。不走 AI 也行python main.py api启动后浏览器打开http://127.0.0.1:5556/docsPOST 到/xhs/detail即可采集作品信息并触发下载。example.py 是完整的调用示例照着改就行想容器化部署项目里附带现成的 Dockerfile。一次性配置拿到小红书 Cookie 和参数速查读完这节你把影响最大的配置做完一次之后日常只翻表格调开关。先说透一句实话未配置 Cookie 时小红书视频下载只能拿到低分辨率版本。配好之后画质解锁请求也更稳。获取只要三步浏览器打开小红书网页版按 F12 打开开发者工具切到网络标签刷新页面。随便点开一篇作品选中一个数据包在请求标头里找到Cookie字段。整段复制粘进图形界面程序设置或Volume目录下的settings.json重启程序生效。所有设置项由 source/module/settings.py 统一管理首次运行自动生成settings.json设置界面觉得绕直接编辑这个 JSON 也行。最常用的参数集中在这张表里参数作用默认值cookie小红书网页版 Cookie决定视频画质空work_path作品保存根路径项目目录 Volumefolder_name作品存放文件夹名Downloadimage_format图片下载格式AUTO/PNG/WEBP/JPEG/HEICJPEGimage_download图片下载开关truevideo_download视频下载开关truelive_downloadLivePhoto 动图下载开关falsefolder_mode每篇作品单独一个文件夹falseauthor_archive每个作者单独一个文件夹falsedownload_record记录已下载 ID自动跳过重复truewrite_mtime文件修改时间同步为发布时间falsenote_format作品信息保存格式txt/md/all不保存完整参数清单就在该文件的default字典里每一项都带注释。问题诊断三分钟定位小红书原图下载常见故障读完这节卡住时你知道先查哪里多数问题一次就能定位。下载卡住或报网络错误第一嫌疑是全局代理开着它请求常被干扰先关掉再试。还不行就看运行日志里的具体报错判断是网络层还是解析层的问题。视频清晰度上不去八成是 Cookie 没配只能拿到低清源。按上一节三步配好重启程序重新下载无需其他操作。链接提示失效小红书作品链接自带日期信息太旧的链接容易被风控拦下尽量用刚抓取的链接也别短时间内高频请求内置的请求延时保持默认就好。升级路径源码用户执行git pull更新依赖即可换程序包的话把旧版的Volume文件夹复制进新版设置无缝迁移。工具已经躺在你的项目目录里把一条旧链接贴进去10 分钟后硬盘里就有第一份备份原图——剩下的交给 XHS-Downloader。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考