3 种方式批量下载小红书图文与视频XHS-Downloader 实操笔记【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader看到喜欢的图文笔记和视频想一次性把整篇作品存下来XHS-Downloader 是一个开源的小红书作品采集工具输入作品链接就能把图片、视频、封面和动图全部下载到本地还能顺带保存点赞、评论数等作品信息。下文按装好→跑起来→下东西的顺序带你把它用起来。一、安装步骤三种运行方式选一条先说结论只想下载文件直接拿可执行文件最省事要改配置、接 API再从源码或 Docker 跑。可执行文件新手首选从 Releases 下载最新版压缩包解压后双击运行即可。Mac 用户首次运行前先在终端执行一次xattr -cr 项目文件夹路径移除系统安全标记之后就能正常打开。源码运行要改配置、接 API 时用需要 Python 3.12 及以上版本下面命令依次执行。# 克隆项目到本地 git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader # 用 uv 安装依赖推荐环境自动隔离 uv sync --no-dev # 启动图形界面 uv run main.py不想装 uv 的话用 pip 装requirements.txt里的依赖再跑python main.py启动即可。Docker 部署服务器环境# 拉取官方镜像 docker pull joeanamier/xhs-downloader # 起容器5556 端口对外数据挂到卷里 docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloaderDocker 里不支持读取/监听剪贴板其他功能正常。二、图形界面粘贴链接即可下载作品启动后就是下面这个主界面左侧是功能入口右侧是任务队列和运行日志。日常使用就两步进入创建任务粘贴作品链接。多个链接用空格分隔程序会自动提取有效链接不用手动整理点击运行文件自动落盘到默认下载目录两个值得留意的亮点剪贴板监听开启后程序在后台盯着剪贴板你复制小红书链接它就直接排队下载不用手动粘贴自动去重已下载过的作品会记进./Volume/ExploreID.db再次输入相同链接会自动跳过explore、discovery/item、user/profile详情页链接和xhslink.com分享短链都能识别。三、命令行批量下载与指定图片序号习惯终端、想写脚本的话直接用命令行参数下东西。所有参数用--help一次看全最常用的是两个动作# 一条命令批量下多个作品链接用空格分隔、整体用引号包住 python main.py --url 链接1 链接2 链接3 # 只下载图文作品里第 1、3、5 张图 python main.py --url 作品链接 --index 1 3 5需要换保存位置、改文件命名或图片格式时对应--work_path、--name_format、--image_format三个参数取值和项目配置里一致。注意--index一次只能配一个作品链接传多个程序只处理第一个。四、浏览器用户脚本一键提取作品链接不想来回切窗口装个 Tampermonkey 用户脚本就能在浏览器里直接操作。脚本装好后在小红书网页上单篇作品直接勾选要下载的图片点开始下载账号主页一键提取该账号发布、收藏、点赞、专辑的所有作品链接搜索结果页批量提取搜索结果里的作品链接提取到的一批链接粘回图形界面或命令行就能批量下载——脚本提取 程序下载是最常见的组合。想更省事可以在settings.json里把script_server设为true让主程序当服务器接收脚本推送的下载任务浏览器点一下就开始下。五、常见问题与解决方法Q为什么视频下下来画质不高A没配 Cookie 时视频只能拿到低分辨率版本。在./Volume/settings.json里填cookie字段即可无需登录账号。获取方式浏览器打开小红书 explore 页 → 按 F12 打开开发者工具 → 切到网络选项卡 → 过滤框输入cookie-name:web_session→ 点任意作品从请求头里复制完整 Cookie 粘贴进配置。Q怎么重新下载已经下载过的作品A默认开启下载记录download_record相同作品会被跳过。想重新下要么删掉./Volume/ExploreID.db里对应的作品 ID要么用--download_record false关掉记录此时程序改为检查文件是否存在来判断。Q下载的文件到底放在哪里A默认./Volume/Download可在图形界面里改也可以直接编辑settings.json的work_path和folder_name字段开启folder_mode后每个作品会存进单独的文件夹。Q怎么把文件命名得更整齐A改name_format字段支持 发布时间、作者昵称、作者ID、作品标题、作品描述、点赞数量、评论数量、收藏数量、作品ID、作品类型 等字段用空格分隔。默认是发布时间 作者昵称 作品标题。六、适用场景与下一步XHS-Downloader 适合想批量保存小红书作品的场景个人素材收集、竞品内容研究、按作者归档素材库。装好之后先拿一篇图文作品和一篇视频各试一次确认文件落盘位置和视频画质都符合预期再考虑接入 API 或用用户脚本批量干活。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考