极速上手XHS-Downloader：3分钟保姆级教程，免费下载小红书无水印图文与视频

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

想保存小红书里的高清图片和视频，结果不是带水印就是被压缩成马赛克？截图裁边、录屏剪辑折腾半天，画质还是惨不忍睹？别再手动存图了——XHS-Downloader就是一款专治小红书无水印下载的开源作品采集工具：完全免费、无需登录，图文与视频都能以原画质一键保存，Windows、macOS、Linux 全平台可用。

读完本文你将获得：

• ✅ 3 条难度递进的上手路径：直接运行、Docker 部署、源码启动
• ✅ 两种下载姿势：图形界面粘贴即下、命令行批量下载
• ✅ 文件命名规则、图片格式、保存路径等自定义技巧
• ✅ 下载失败、批量采集等高频问题的排查方案

工具速览：它到底能帮你做什么

XHS-Downloader 基于 AIOHTTP 模块开发，定位是"小红书链接提取/作品采集工具"，核心能力一句话概括：把小红书网页版上你能看到的内容，原画质搬运到本地。

• 采集作品信息：标题、描述、点赞、收藏、评论、标签等一键抓取
• 提取下载地址：自动解析图片、视频、动图（livePhoto）的真实直链
• 无水印下载：直接保存原始画质文件，自动跳过重复文件，支持断点续传
• 批量操作：多链接同时提交、后台监听剪贴板、记录已下载作品 ID

上手路径：三种方式按需选择

方式一：直接运行程序包（零基础首选）

前往项目发布页下载对应系统的程序压缩包（Windows / macOS / Linux），解压后双击运行main即可，无需安装 Python 或任何依赖。

📌 macOS 用户首次运行如被系统拦截，先在终端执行xattr -cr 项目文件夹路径移除安全标记，之后就能正常打开了。

适合人群：只想快速下载、不想折腾环境的新手。

方式二：Docker 容器部署（技术用户）

已装 Docker 的话，两条命令即可拉起一个隔离环境：

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

容器内数据统一存放在Volume卷中，便于备份与迁移。注意 Docker 模式不支持命令行调用、剪贴板读取与监听。

适合人群：熟悉容器、希望环境与系统隔离的用户。

方式三：源码运行（开发者）

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

推荐使用 uv 管理依赖：uv sync --no-dev && uv run main.py。需要 Python 3.12 及以上版本。

适合人群：想跟进最新功能、参与二次开发的用户。

核心操作：两种下载模式任选

场景一：图形界面模式，粘贴链接即下载

1. 启动程序，进入交互式操作界面
2. 打开小红书，复制作品链接（分享复制或地址栏复制均可）
3. 将链接粘贴到输入框中，支持一次粘贴多个（空格分隔）
4. 点击「下载作品文件」按钮，等待任务完成

下载完成后，文件默认保存在程序目录下的Volume/Download文件夹中，文件名按"发布时间 作者昵称 作品标题"自动命名。

场景二：命令行模式，一条命令批量下载

命令行模式适合快速操作，也支持图文作品按序号挑选图片：

# 下载单个作品 python main.py -u "https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX" # 批量下载多个作品（链接用空格分隔） python main.py -u "链接1 链接2 链接3" # 只下载图文作品的第1、3、5张图片 python main.py -u "作品链接" -i "1 3 5" # 临时指定保存路径 python main.py -u "作品链接" -wp "D:/xhs_download"

更多参数（代理、超时、语言切换等）可通过python main.py -h查看完整说明。

进阶玩法：自定义设置与 API 集成

自定义文件命名格式

首次运行后，程序会在Volume/settings.json生成配置文件。修改name_format即可定制文件名：

"name_format": "作者昵称 作品ID 作品标题"

可用字段包括：作品标题、作品描述、发布时间、作者昵称、作者ID、作品ID、作品类型、点赞/收藏/评论/分享数量、作品标签、最后更新时间等，字段间用空格分隔。

切换图片下载格式

image_format参数控制图片输出格式，可选AUTO、PNG、WEBP、JPEG、HEIC：

• PNG：无损画质，文件偏大
• WEBP：压缩率高、质量好，兼顾画质与体积
• JPEG：兼容性最好，通用场景首选
• HEIC：高效压缩，Apple 设备原生支持

启动 API 服务，接入自己的程序

python main.py api

服务启动后访问http://127.0.0.1:5556/docs可查看交互式接口文档，调用示例：

import requests resp = requests.post( "http://127.0.0.1:5556/xhs/detail", json={ "url": "https://www.xiaohongshu.com/explore/作品ID?xsec_token=XXX", "download": True, "index": [1, 3, 5], }, timeout=10, ) print(resp.json())

如果你在用 AI 编程助手，还可以通过python main.py mcp启动 MCP 服务，把"获取小红书数据/下载作品文件"作为工具直接接入智能体。

常见问题解决方案

Q1：下载失败或视频画质偏低怎么办？

XHS-Downloader 的 Cookie 配置是非必需的，但不配置 Cookie 时视频默认只能下载低分辨率版本。建议按以下步骤补充 Cookie：

1. 打开浏览器访问小红书网页版（可开无痕模式）
2. 按下F12打开开发者工具，切换到「网络」选项卡并勾选「保留日志」
3. 在过滤框输入cookie-name:web_session，点击任意一篇作品
4. 在请求数据包中全选复制 Cookie 值，粘贴到程序设置或settings.json的cookie参数中

获取 Cookie 无需登录账号，不影响正常使用。若下载依然失败，可尝试更新程序版本、检查网络代理，或在命令行模式加--debug查看详细日志。

Q2：如何批量下载一个账号的全部作品？

推荐"用户脚本 + 主程序"的组合拳：给浏览器安装 Tampermonkey 扩展并添加项目自带的用户脚本，进入作者主页后即可一键提取发布、收藏、点赞、专辑的全部作品链接；再把这些链接交给主程序批量下载。若在配置文件中把script_server设为true，脚本还能把下载任务直接推送给后台运行的程序，实现全自动。

Q3：下载文件默认存在哪里？如何改路径？

源码运行默认保存到Volume/Download；打包版程序保存在_internal/Volume/Download。三种改法任选：

• 在图形界面设置中修改「下载路径」
• 编辑settings.json中的work_path与folder_name
• 命令行加-wp "自定义路径"临时指定

总结：合规使用，也欢迎加入开源社区

至此，你已经掌握了 XHS-Downloader 的核心玩法：从零开始安装、两种下载模式、命名与格式自定义，再到 API/MCP 二次开发，基本覆盖了日常所有使用场景。这款工具最大的价值在于免费、轻量、无广告，把"下载小红书无水印作品"这件事做到了极致。

最后提醒两点：一是作品链接带有日期信息，建议用最新获取的链接下载，避免被风控；二是请尊重原创作者的版权，合理使用下载内容，不要将工具用于任何侵权或违规用途。

如果你喜欢这个项目，可以这样支持它：

• ⭐ 在项目仓库点个 Star，让更多人看到
• 🐛 遇到问题去 Issues 提交反馈，附上复现步骤和日志
• 🧩 通过 Pull Request 贡献代码，修复 Bug 或增加新功能
• 💬 把使用技巧分享给需要的朋友，帮助项目良性成长

你的每一次参与，都是开源项目持续迭代的动力。

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