小红书下载工具XHS-Downloader怎么用？5分钟学会无水印图文视频批量下载

小红书下载工具XHS-Downloader怎么用？5分钟学会无水印图文视频批量下载

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

看到喜欢的博主发了绝美照片，想保存却发现截图全是水印、长按还没反应；刷到一条高价值的视频，网页却不提供下载入口——这种"看得见、存不下"的憋屈，玩小红书的你一定不陌生。要解决它，一个免费开源的XHS-Downloader就够了：粘贴链接，无水印图文视频直接落到你的硬盘，还支持批量、自动、接口调用等多种玩法。

读完你将掌握：

• ✅ 3 种获取程序的方式，选出最适合你的那一种
• ✅ 5 分钟内完成第一次小红书无水印下载
• ✅ 批量下载某位博主全部作品的完整方法
• ✅ 开启无人值守、复制链接自动下载的姿势
• ✅ 下载失败、低清视频等高频问题的排查思路

项目一瞥：一个能"读懂"小红书链接的采集工具

XHS-Downloader 是一个基于 AIOHTTP 模块开发的小红书作品采集工具。通俗地说，你给它一个作品链接，它能自动解析出作品信息、找到原始文件地址，并把无水印文件保存到你的电脑上。核心亮点有四条：

• 无水印、高质量：直接获取原始画质的图文和视频文件，不是网页截图
• 三种运行方式：图形界面、命令行、服务器接口（API/MCP），总有一种适合你
• 批量与自动化：支持多链接批量下载、剪贴板监听、浏览器用户脚本一键提取链接
• 完全免费开源：无隐藏收费，代码公开透明，可自行研究修改

下面进入正题，我们按最常见的三个真实场景一步步来。

场景一：只想下载一个作品，怎么5分钟搞定？

你只需要三步：拿到程序 → 复制链接 → 粘贴下载。

第 1 步：拿到可运行的程序（三选一）

方式 A：直接下载现成程序（最省事，推荐）

前往项目仓库的"发布（Releases）"页面，下载对应系统的最新版压缩包，解压后打开程序文件夹，双击运行main（Windows 下是main.exe）即可。

注意：Mac 用户首次运行时如果被系统拦截，请在终端执行xattr -cr 程序文件夹路径命令移除安全标记，执行一次后即可正常打开。

方式 B：用 Docker 一键启动（适合喜欢容器化的朋友）

docker pull joeanamier/xhs-downloader docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader

第一条命令拉取镜像，第二条命令启动容器并开放 5556 端口，之后在浏览器访问http://127.0.0.1:5556就能进入程序界面。

方式 C：从源码运行（适合开发者）

git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader pip install -r requirements.txt python main.py

提示：源码方式需要电脑安装 Python 3.12 或更高版本，最后一行python main.py就是启动命令。

第 2 步：复制作品链接

在小红书 App 或网页版找到想下载的作品，点"分享 → 复制链接"，或直接复制浏览器地址栏的网址。XHS-Downloader 能识别以下几种常见格式：

• https://www.xiaohongshu.com/explore/作品ID?xsec_token=xxx
• https://www.xiaohongshu.com/discovery/item/作品ID?xsec_token=xxx
• https://xhslink.com/分享码（App 分享出来的短链接）

它一次还能识别多个链接，多个链接之间用空格分隔，程序会自动过滤出有效部分，无需手动清理。

第 3 步：粘贴链接，回车下载

启动程序后，在输入框中粘贴链接，按回车或点击下载。程序会自动完成"解析作品 → 提取下载地址 → 下载文件"的全过程，你只需要等待进度条走完。

下载完成的文件默认保存在程序目录下的Volume/Download文件夹中。图文作品会保存全部图片，视频作品会保存视频文件，文件名默认是"发布时间 作者昵称 作品标题"的格式，一眼就能认出是哪条内容。

小贴士：如果第一次运行提示需要登录或下载失败，别慌，先看后面的"避坑指南"，通常配置一下 Cookie 就能解决。

场景二：想批量下载整个账号的内容，怎么办？

单个下载学会之后，你大概率会想要更多：喜欢的主播发了几百条笔记，能不能一次全存下来？这里给你三种批量方案。

方法 1：命令行一次传入多个链接

如果你习惯用终端，最直接的批量方式就是多传几个链接：

python main.py "链接1" "链接2" "链接3"

程序会逐个处理每个链接并依次下载，中途无需任何人工干预。

方法 2：用户脚本一键提取"整个账号"的链接（强烈推荐）

想下载某位博主发布的全部作品，一条条复制链接太痛苦了。XHS-Downloader 配套了一个浏览器用户脚本，安装后能在小红书网页上"一键提取"链接，把整个账号的作品链接全部列出来，再一次性交给程序下载。

安装步骤：

1. 在浏览器中安装 Tampermonkey（油猴）扩展
2. 从项目仓库中找到static/XHS-Downloader.js这个脚本文件，把内容复制到油猴"新建脚本"中保存，或按仓库说明从 URL 安装

安装完成后打开小红书网页版，左侧会出现一个脚本菜单，支持提取发布、点赞、收藏、专辑里的作品链接，也能提取搜索结果中的用户链接：

提取出的链接复制出来，粘贴到程序里，剩下的交给程序批量下载。脚本 + 程序组合，就是你自己专属的"博主内容备份方案"。

方法 3：开启剪贴板监听，复制即下载

在程序里开启"监听剪贴板"功能后，只要你在小红书复制了一个作品链接，程序就会在后台自动开始下载，连粘贴都省了。适合需要连续保存多条内容的场景。

场景三：想挂机自动下载，能做到吗？

不想一直盯着界面？XHS-Downloader 提供了几种"无人值守"玩法：

• 剪贴板监听挂后台：开着监听，随时复制链接随时下载，程序自己处理一切
• 用户脚本推送任务：在配置文件settings.json里把script_server设为true，保持程序后台运行，然后在浏览器作品页点击用户脚本菜单中的"推送下载任务"，链接直接发给程序下载，你连复制粘贴都不用
• API / MCP 接口：让程序以服务器模式运行，其他程序甚至 AI 助手都能调用它来下载

其中 API 和 MCP 属于进阶玩法，我们放到后面展开。

避坑指南：下载总失败、视频总是低清怎么办？

问题 1：下载失败，或视频只有低分辨率

这是最常见的两个问题，原因往往是同一个：没有配置 Cookie。

Cookie 可以理解为浏览器访问小红书时的一张"临时通行证"，有了它，程序就能以更完整的身份获取资源。好消息是：Cookie 非必需配置，而且无需登录账号也能获取。

获取方法：

1. 打开浏览器访问小红书网页版，按F12打开开发者工具
2. 切换到"网络（Network）"选项卡，勾选"保留日志"，刷新页面后点任意一个请求，在"请求头"里找到Cookie字段，整段复制

然后打开程序设置，把 Cookie 粘贴进去，重启程序即可。配置之后，视频作品就能下载到更高画质的文件了。

问题 2：提示链接无效或被风控

作品链接里携带日期信息，用很早之前获取的旧链接去下载，容易被平台风控拦截。建议始终使用最新获取的作品链接进行下载。

问题 3：重复下载同一个作品，程序却自动跳过

这是"下载记录"功能在起作用：程序会把下载过的作品 ID 记录下来，下次遇到相同作品直接跳过，帮你省流量省时间。如果确实想重新下载，可以在设置里关闭记录功能，或清空下载记录。

问题 4：Mac 打不开、Linux 剪贴板没反应

• Mac：参照场景一说明，先执行xattr -cr解除系统拦截
• Linux：剪贴板功能依赖xclip或xsel，若未安装，执行sudo apt-get install xclip安装即可

问题 5：开了代理反而下载失败

如果你使用了全局代理工具，可能会干扰文件下载。遇到异常时先尝试关闭代理，必要时可在配置文件的proxy参数里单独为程序设置代理。

进阶玩法：把工具调成你想要的样子

1. 自定义下载路径与文件命名

程序首次运行后，会在Volume目录生成settings.json配置文件，可以直接编辑。比如把下载目录改到 D 盘：

"work_path": "D:\\小红书下载"

文件名格式由name_format控制，支持"作品标题、作品ID、发布时间、作者昵称、点赞数量"等十余个字段，例如：

"name_format": "作品标题 作者昵称 点赞数量"

2. 选择图片下载格式

用image_format参数控制图文作品的保存格式，可选AUTO、PNG、WEBP、JPEG、HEIC：

3. 命令行按序号下载指定图片

图文作品有十几张图，只想下载其中几张？命令行加--index参数即可：

python main.py --index 1,3,5 "作品链接"

这条命令只会下载第 1、3、5 张图片。命令行下还能用--work_path临时指定下载目录、用--language切换中英文提示。

4. 用 API 模式做二次开发

在项目目录运行python main.py api启动 API 服务，浏览器访问http://127.0.0.1:5556/docs可查看自动生成的接口文档。下面是一个用 Python 调用接口下载作品的示例：

import requests server = "http://127.0.0.1:5556/xhs/detail" data = { "url": "https://www.xiaohongshu.com/explore/作品ID", "download": True, "index": [1, 3, 5] # 只下载第 1、3、5 张图片（仅对图文作品生效） } response = requests.post(server, json=data) print(response.json())

5. 用 MCP 模式实现对话式下载

运行python main.py mcp启动 MCP 模式后，可以把程序接入支持 MCP 的 AI 助手，直接说"帮我下载这个链接"，AI 就能调用程序获取作品数据甚至完成文件下载：

写在最后

从单个作品到整账号备份，从手动复制到无人值守自动下载，XHS-Downloader 把"保存小红书内容"这件事的复杂度降到了最低。它免费、开源、跨平台，还提供图形界面、命令行、API、MCP 等多种使用方式，普通用户和开发者都能找到适合自己的用法。

最后提醒一句：下载和保存他人作品时，请遵守平台规则与相关法律法规，尊重原创作者的版权，把工具用在正当用途上。

如果你觉得这个工具好用，欢迎在项目仓库给作者点个 Star；遇到使用问题，可以在仓库的 Issue 区反馈，也可以直接参与代码贡献。一个开源项目能走多远，离不开每一位使用者的参与和支持。

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