小红书无水印下载神器：XHS-Downloader 5分钟跑通全流程

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

说真的，保存小红书内容这件事，我曾经忍了很久。刷到一篇干货图文想存下来慢慢看，截图满屏水印、放大就糊；遇到一段好视频想收藏，平台又把画质压得惨不忍睹；手动一张张保存、一个个改名，十分钟才搞定两个作品。直到我遇到XHS-Downloader——这款开源的小红书链接提取与作品采集工具，能直接解析作品原始链接，实现无水印、原画质下载，还能批量采集账号发布、收藏、点赞的作品。接下来的内容，我会陪你把"下载第一个作品"到"进阶玩法"完整走一遍。

五分钟跑通：下载你的第一个作品

先别管那些复杂参数，我们从零开始，拿到第一条无水印作品。

第一步：获取源码（仓库地址：https://gitcode.com/gh_mirrors/xh/XHS-Downloader）

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

第二步：安装依赖，推荐用uv工具，一条命令搞定：

uv sync --no-dev # 同步项目依赖，等效于 pip install -r requirements.txt

第三步：启动程序，回车后你会看到一个图形化交互界面：

uv run main.py # 或直接执行 python main.py

在界面输入框里粘贴小红书作品链接（多个链接用空格分隔，程序会自动过滤无效参数），回车即可看到下载进度。不到五分钟，你的第一个无水印作品就到手了——这就是最直接的成就感。

实战任务：三个场景边做边学

界面操作适合尝鲜，但真正高效的是命令行。我们把三个最常见的真实任务过一遍。

任务一：命令行批量下载，一次搞定多个作品

场景：你攒了十几个链接，想一次性全部下载。命令行模式就是为此设计的：

python -m source.CLI.main -u "链接1 链接2 链接3" -if webp -fm True

• -u：作品链接，空格分隔多个；-if webp：图片转 WebP 格式，约省 30% 存储空间；-fm True：每个作品存进独立文件夹，避免文件混在一起。

如果某个图文笔记有 6 张图，你只想要第 2、4 张，用-i指定序号：

python -m source.CLI.main -u "链接" -i "2 4"

这张图是-h参数输出的完整参数表，19 个参数一目了然，建议截图收藏。

上图为实际运行结果：download successful后，文件按你设定的规则落在下载目录。

任务二：配置 Cookie，解锁视频高清画质

不配置 Cookie 也能下载，但视频作品只能拿到低分辨率版本——这是很多人下载完才发现"画质不对"的原因。配置方法很简单：

1. 浏览器打开小红书网页版并登录
2. 按F12打开开发者工具，切到 Network（网络）标签
3. 刷新页面，在任意请求的 Headers 里找到 Cookie 并复制

然后把它传给程序（无需登录账号即可使用）：

python -m source.CLI.main -u "链接" -ck "你的Cookie值"

更省事的方式是直接写进配置文件Volume/settings.json的"cookie"字段，一劳永逸。

任务三：网络不稳？调参保证成功率

下载途中断网、限速是常事。XHS-Downloader 内置了断点续传和智能重试，你只需要把三个参数调到合适值：

python -m source.CLI.main -u "链接" -t 30 -c 1048576 -mr 5

实测在弱网环境下，这套组合能把成功率从"听天由命"拉到九成以上。

避坑指南：我踩过的坑与参数调优

踩坑清单：

• macOS 打不开程序：可执行文件未签名，先执行xattr -cr 项目文件夹路径移除安全标记，运行一次即可
• Windows 界面乱码/排版差：换成 Windows 终端运行，显示效果最佳
• 找不到下载目录：源码运行默认在Volume/Download，打包版在_internal/Volume/Download；配置文件同样位于对应Volume/settings.json
• 视频画质低：九成原因是没配 Cookie，回看任务二

配置优化建议（Volume/settings.json）：

进阶玩法：用户脚本、API 与 MCP

命令行玩熟了之后，还有三件"神器"值得体验：

• 浏览器用户脚本：安装油猴脚本后，在小红书页面一键提取发布、点赞、收藏、专辑作品链接，配合程序下载，效率再翻一倍

• API 模式：python main.py api启动后访问http://127.0.0.1:5556/docs，可编程调用下载能力
• MCP 模式：python main.py mcp，方便接入 AI 助手等工作流

想深入源码二次开发，核心逻辑在 source/application/（下载、请求、视频处理），命令行入口在 source/CLI/，值得一读。

写在最后

无论你是普通用户想保存学习资料，还是创作者要收集灵感素材，XHS-Downloader 都能让你摆脱水印与画质焦虑，把时间还给内容本身。现在就克隆仓库，跑通你的第一条下载命令吧。

最后提醒一句：请尊重原创作者的版权。下载的内容仅用于个人学习和研究，如引用或分享，务必注明内容来源。好工具要善用，更要合规使用。

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