小红书无水印下载工具 XHS-Downloader 上手指南：5分钟跑通，批量保存高清图文视频

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader

一、你是不是也遇到过这样的尴尬时刻

刷到一篇超赞的小红书笔记，想保存下来慢慢看，结果长按图片存下来全是水印；看中一条视频教程想离线学习，平台却只给你低清压缩版；收藏了几十个作品，想一次性整理到本地，却只能一个个截图、录屏，忙活一小时文件还乱成一团。

如果你对上面任何一个场景点头，那么XHS-Downloader就是为你准备的答案。这是一款开源免费的小红书无水印下载工具，核心就一句话：把小红书图文、视频作品，连同作品信息一起，干净、高清、有秩序地搬到你自己的电脑上。它不加密、不收费、不捆绑，装上就能用。

不过先别急着点下载——在动手之前，你有必要花三分钟搞清楚它到底能做什么、怎么选安装方式，免得白折腾一趟。往下看。

二、三分钟认识它

一句话概括：XHS-Downloader 是一个既能"提取链接"又能"采集信息"还能"下载文件"的小红书作品采集工具，从浏览器里复制一条作品链接丢给它，剩下的事它全包了。

它适合谁？

• 普通用户：想保存喜欢的内容，又嫌弃水印和画质；
• 学生党：把教程、笔记批量存下来离线学习；
• 设计师/创作者：收集灵感素材，需要干净的原始图片；
• 运营/市场：做竞品调研，需要按作者、按作品整理素材库。

下面是它的主界面，一个用键盘就能操作的 TUI 图形界面，输入链接、点一下按钮就能开下：

三、零基础快速上手：照着做 5 分钟跑起来

安装方式有三种（可执行程序、源码运行、Docker），对新手最友好的是源码运行，一条命令装完就能用，整个过程大约 5 分钟。

第一步：获取源码（约 1 分钟）

git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader

第二步：安装依赖（约 2-3 分钟）

推荐使用uv，速度快、省心：

uv sync --no-dev

习惯用 pip 也没问题：

pip install -r requirements.txt

第三步：启动程序（1 分钟）

python main.py # 或用 uv 启动：uv run main.py

看到上图那个图形界面，就说明跑通了。把任意小红书作品链接粘贴进输入框（多个链接用空格分隔），点"下载作品文件"，第一次下载就这样完成了。

建议顺手配一下 Cookie（约 2 分钟，可选）：不配也能用，但配了之后视频能下载更高分辨率。获取方式很简单——打开小红书网页版，按F12打开开发者工具，切到"网络"选项卡，过滤条件填cookie-name:web_session，点开任意一个数据包，把 Cookie 整段复制出来，粘贴到程序的"程序设置"里保存即可：

四、核心能力逐个拆解

4.1 链接智能解析：四种链接格式通吃

它解决什么问题？小红书的链接五花八门，长短不一，手写提取容易出错。

怎么用？直接把链接粘贴进去，XHS-Downloader 会自动识别这四类链接：

• 标准作品页：https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX
• 发现页：https://www.xiaohongshu.com/discovery/item/作品ID?xsec_token=XXX
• 个人主页作品：https://www.xiaohongshu.com/user/profile/作者ID/作品ID?xsec_token=XXX
• 短链接：https://xhslink.com/分享码

效果如何？多个链接一次粘贴、自动提取有效部分，无效参数会被过滤，过期链接会被拦截，你完全不用手动清洗链接。

4.2 文件下载与整理：命名、归档、去重一条龙

默认情况下，下载的文件会以"发布时间 作者昵称 作品标题"命名，自动存入Volume/Download文件夹。打开"程序设置"（主界面按S），你会发现一整页可调项：

重点看这几个开关：

• 作品归档保存模式（folder_mode）：每个作品单独一个文件夹，多图作品不再散落一地；
• 按作者归档（author_archive）：每个作者的素材自动归到"作者ID_作者昵称"目录下，作者改名了还会自动同步；
• 图片下载格式（image_format）：支持 PNG、WEBP、JPEG、HEIC，想要体积小选 WEBP，追求通用选 JPEG；
• 下载记录（download_record）：默认开启，下载过的作品 ID 会被记录，下次自动跳过，绝不重复劳动。

4.3 剪贴板监听：复制即下载

主界面里有个"开启监听"按钮（快捷键M）。打开后，程序会在后台盯着你的剪贴板——只要你在浏览器里复制了一条小红书链接，它立刻自动解析并开始下载，全程不用碰键盘鼠标。想保存收藏夹里的几十个作品？挨个复制就行，它替你排好队。

4.4 用户脚本：浏览器里一键提取链接

如果装了 Tampermonkey（油猴），再配上项目自带的用户脚本，你甚至不用离开小红书页面：

脚本能干这些事：

• 一键提取账号发布、收藏、点赞、专辑里的全部作品链接；
• 提取搜索结果里的作品链接和用户链接；
• 自动滚动页面，把懒加载的内容全部加载出来再提取；
• 把链接复制到剪贴板，回头统一丢给程序批量下载。

脚本负责"广撒网"提取链接，程序负责"高效率"批量下载，这一对组合拳非常省事。

五、真实场景演练

5.1 学生党：批量保存课程图文笔记

操作步骤清单：

1. 打开小红书，找到博主的"收藏"或"专辑"页面；
2. 用用户脚本一键提取全部作品链接，复制到剪贴板；
3. 打开 XHS-Downloader，粘贴链接（空格分隔），点下载；
4. 在设置里打开"按作者归档"，让同一门课的素材归到一起。

用前 vs 用后：以前手动截图 30 个笔记要 20 分钟，文件名全是"截图001"；现在 3 分钟下完，文件名自带标题和作者，期末复习直接按目录翻。

5.2 设计师：收集无水印灵感素材

操作步骤清单：

1. 在设置里把图片格式改为WEBP（体积小，适合建素材库）；
2. 用命令行模式指定只下载某几张图：

python main.py -u "https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX" -i "1 3 5"

3. 打开note_format保存作品描述，方便日后溯源。

用前 vs 用后：以前存图带水印、带平台压缩痕迹，二次创作还得重新找；现在拿到的是干净的原始图片，配合作者备注和作品描述，素材库直接变成可检索的灵感库。

5.3 运营：竞品素材批量归档

操作步骤清单：

1. 命令行批量处理（文件会按设置规则自动命名归档）：

python main.py -u "链接1 链接2 链接3" --folder_mode true --author_archive true

2. 开启record_data，所有作品信息持久化存进 SQLite 数据库，随时回溯；
3. 把下载目录同步到团队网盘，全员共享。

用前 vs 用后：以前整理竞品素材靠人工搬运、重复保存；现在自动命名、自动去重、自动归档，团队拿到手就是一份干净整齐的资料库。命令行运行时的输出效果长这样：

六、常见坑与避坑指南

坑 1：视频下载下来只有低分辨率

• 症状：视频文件又小又糊。
• 原因：没配置 Cookie，未登录状态只能拿到低清源。
• 解决办法：按第三节的方法配置一次 Cookie（无需登录账号），重启程序后再下载。

坑 2：明明复制的链接，却提示作品获取失败

• 症状：报错、返回空数据。
• 原因：链接带了过期的日期参数，被平台风控拦截。
• 解决办法：重新到小红书页面复制最新的链接；如果还是不行，检查并更新 Cookie。

坑 3：下载过的东西再下就不动了

• 症状：程序"跳过"了你想重新下载的文件。
• 原因：下载记录功能默认开启，作品 ID 已入库。
• 解决办法：这是防重复设计。想重新下载，去Volume目录下的下载记录数据库里删掉对应 ID，或者临时关掉download_record开关。

坑 4：Mac 上双击程序被系统拦截

• 症状：提示无法打开、来源不明。
• 原因：macOS 对未签名程序的安全限制。
• 解决办法：终端执行一次xattr -cr 项目文件夹路径移除安全标记即可。

坑 5：程序界面文字乱码或显示错位

• 症状：TUI 界面排版混乱。
• 原因：终端字体/编码兼容问题。
• 解决办法：Windows 推荐使用自带终端（Windows Terminal）运行；同时可以在设置里切换language为en_US排查是否为语言文件问题。

七、进阶玩法速览

跑通基础功能后，还有不少值得探索的玩法：

• 命令行参数调优：python main.py --help可以查看全部参数。例如用--chunk调大下载分块、用--max_retry增加重试次数，网络不稳时很管用；配合--update_settings能把命令行参数直接写回配置文件。
• 配置文件微调：首次运行后Volume/settings.json自动生成，proxy、timeout、video_preference（分辨率/码率/体积优先）等都能在这里改，改完重启生效。
• API 模式：运行python main.py api，浏览器打开http://127.0.0.1:5556/docs，就能看到自动生成的交互式接口文档，适合把下载能力集成进自己的脚本或工作流。
• MCP 模式：运行python main.py mcp，可以让 AI 助手直接帮你查作品数据、发下载任务：

• 二次开发：项目提供了完整的XHS类，参考仓库里的 example.py 的注释就能把采集下载能力嵌进你自己的 Python 项目。

八、写在最后：马上动手

回顾一下，XHS-Downloader 的三大价值很实在：干净——无水印、高清原始文件；高效——链接批量处理、剪贴板监听、自动去重归档；灵活——图形界面、命令行、API、MCP 四种用法任你组合。

你的下一步行动清单：

1. 克隆仓库，按第三节命令装好环境，5 分钟跑通首次下载；
2. 配一次 Cookie，让视频画质拉满；
3. 装好用户脚本，下次刷到好东西直接一键提取；
4. 根据你的使用习惯，在设置里把命名、格式、归档方式调顺。

最后提醒一句：请把下载的内容用于个人学习、研究和收藏，尊重每一位创作者，标注内容来源，不要用于商业用途或传播他人作品。工具是中性的，怎么用，取决于你。现在就去试试吧，第一条链接下载成功的那一刻，你会回来谢我的。

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader