三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

小红书无水印下载器XHS-Downloader：5分钟快速上手完整指南

发布时间：2026/8/5 6:05:40 三亩地 编程学习日记
小红书无水印下载器XHS-Downloader：5分钟快速上手完整指南

小红书无水印下载器XHS-Downloader：5分钟快速上手完整指南

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

想要高效下载小红书上的精彩内容却苦于水印和平台限制？XHS-Downloader正是你需要的解决方案！这款开源工具能够智能提取小红书作品链接，下载无水印原图与视频，支持批量处理和多种运行模式，让内容收集变得简单高效。无论你是内容创作者、设计师，还是普通用户想要收藏优质内容，这款工具都能满足你的需求。

🚀 快速入门：三种安装方式任你选

XHS-Downloader提供了多种安装方式，适合不同技术水平的用户。以下是三种主流的安装方法：

方法一：可执行文件（零基础用户首选）

对于不熟悉命令行的用户，这是最简单的入门方式：

  1. 访问项目仓库下载对应系统的可执行文件
  2. 解压下载的压缩包到本地文件夹
  3. 双击运行main程序文件即可启动

验证方法：启动程序后，你会看到简洁的用户界面，说明安装成功。

方法二：源码运行（开发者推荐）

如果你需要更多自定义功能或想要参与开发，源码运行是最佳选择：

# 克隆仓库到本地 git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader # 使用uv安装依赖（推荐） uv sync --no-dev # 启动程序 uv run main.py

实用提示：使用虚拟环境可以避免依赖冲突，运行python -m venv venv创建虚拟环境。

方法三：Docker容器部署

对于喜欢容器化部署的用户，Docker提供了最便捷的解决方案：

# 拉取镜像 docker pull joeanamier/xhs-downloader # 运行图形界面版本 docker run --name xhs-downloader -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader

🖥️ 图形界面操作：直观易用的下载体验

XHS-Downloader的图形界面设计简洁，功能布局合理，即使是新手也能快速上手。

XHS-Downloader主界面：支持链接输入、剪贴板读取和多种下载选项

核心功能区域：

  • 链接输入框：直接粘贴小红书作品链接，支持多个链接空格分隔
  • 功能按钮：下载作品、读取剪贴板、清空输入等一键操作
  • 设置菜单：按S键或点击相应按钮进入程序设置界面

操作步骤：

  1. 复制小红书作品链接到剪贴板
  2. 点击"读取剪贴板"按钮自动填充链接
  3. 点击"下载作品文件"开始下载
  4. 等待下载完成，文件保存在指定目录

⚙️ 程序设置：个性化配置指南

通过设置界面，你可以根据需求调整下载参数，获得最佳使用体验。

程序设置界面：丰富的参数配置选项满足不同需求

重要设置项说明：

设置项推荐值功能说明
图片格式WEBP/JPEG选择图片下载格式，WEBP体积小质量好
视频偏好resolution优先下载高分辨率视频
下载记录开启避免重复下载相同内容
语言设置zh_CN中文界面，操作更直观

实用提示：建议开启"下载记录"功能，这样重复下载相同作品时会自动跳过，节省时间和流量。

📋 剪贴板监听：自动化下载工作流

对于需要批量下载的用户，剪贴板监听模式提供了极大的便利。

剪贴板监听模式：自动识别和下载剪贴板中的小红书链接

使用方法：

  1. 在程序主界面按R键或选择相应选项进入监听模式
  2. 在小红书App或网页中复制作品链接
  3. 程序自动检测并开始下载
  4. 复制"close"文本到剪贴板退出监听模式

优势特点：

  • 无需手动粘贴链接
  • 支持连续批量操作
  • 后台运行不干扰其他工作

🔧 命令行模式：高级用户的高效工具

对于需要自动化或批量处理的用户，命令行模式提供了更强大的控制能力。

命令行参数说明：支持丰富的参数配置和批量下载功能

基础命令示例：

# 下载单个作品 uv run main.py --url "https://www.xiaohongshu.com/explore/作品ID" # 批量下载多个作品 uv run main.py --url "链接1 链接2 链接3" # 指定下载图片序号 uv run main.py --url "链接" --index "1,3,5"

高级参数配置：

  • --cookie：配置Cookie获取高清资源
  • --proxy：设置代理服务器
  • --image_format：指定图片格式
  • --folder_mode：每个作品单独文件夹

🌐 Cookie配置：解锁高清下载权限

配置Cookie可以显著提升下载体验，特别是对于视频内容。

获取Cookie步骤：通过浏览器开发者工具提取必要的认证信息

获取Cookie的详细步骤：

  1. 打开浏览器开发者工具

    • 使用Chrome或Edge浏览器访问小红书网页版
    • 按F12键打开开发者工具

  2. 定位Cookie信息

    • 切换到"网络"选项卡
    • 勾选"保留日志"选项
    • 在筛选框输入"cookie-name:web_session"

  3. 提取Cookie值

    • 点击任意小红书作品
    • 在请求列表中找到任意数据包
    • 在请求头中找到Cookie字段
    • 复制完整的Cookie值

  4. 配置到程序中

    • 在设置界面粘贴Cookie值
    • 或通过命令行参数--cookie传递

验证方法：配置Cookie后，尝试下载视频作品，如果能够下载高清版本，说明Cookie配置成功。

🕹️ 浏览器脚本：网页端无缝集成

XHS-Downloader提供了浏览器用户脚本，可以在小红书网页端直接操作。

Tampermonkey脚本安装界面：从URL安装用户脚本

安装步骤：

  1. 安装Tampermonkey浏览器扩展
  2. 点击扩展图标，选择"从URL安装"
  3. 输入脚本地址：https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/refs/heads/master/static/XHS-Downloader.js
  4. 点击安装，完成脚本添加

脚本功能展示：

浏览器脚本菜单：支持多种链接提取和下载功能

核心功能：

  • 一键提取：快速获取发布、收藏、点赞作品链接
  • 批量下载：支持选择多张图片下载
  • 智能打包：多个文件自动压缩为ZIP
  • 服务器推送：将任务推送到本地运行的XHS-Downloader

📁 文件管理：智能组织下载内容

XHS-Downloader提供了灵活的文件管理功能，让下载内容井然有序。

自动分类功能：

  1. 按作者归档：开启后，每个作者的作品会保存在独立文件夹
  2. 作品文件夹模式：每个作品创建独立文件夹，包含所有相关文件
  3. 智能命名：支持自定义文件名格式，如"发布时间 作者昵称 作品标题"

文件组织结构示例：

Download/ ├── 作者ID_作者昵称/ │ ├── 2024-01-01_作者名_作品标题1/ │ │ ├── 图片1.webp │ │ ├── 图片2.webp │ │ └── 作品信息.txt │ └── 2024-01-02_作者名_作品标题2/ │ └── 视频.mp4 └── 其他作品/ └── 单文件作品.jpg

🔍 故障排除：常见问题解决方案

在使用过程中可能会遇到一些问题，这里提供解决方案：

问题一：下载速度慢或失败

可能原因：

  • 网络连接不稳定
  • Cookie过期或无效
  • 平台限制或风控

解决方案：

  1. 检查网络连接，尝试使用代理
  2. 更新Cookie配置
  3. 降低并发下载数量
  4. 等待一段时间再尝试

问题二：下载的文件有水印

可能原因：

  • 未配置有效Cookie
  • 平台更新了反爬机制

解决方案：

  1. 按照前文方法获取最新Cookie
  2. 更新XHS-Downloader到最新版本
  3. 检查配置文件中的cookie参数格式

问题三：程序无法启动

排查步骤：

  1. 确认Python版本为3.12或更高
  2. 检查依赖是否完整安装
  3. 查看错误日志定位具体问题
  4. 尝试重新安装依赖包

🛠️ 高级技巧：提升使用效率

批量处理技巧

  1. 创建链接列表文件

    • 将多个小红书链接保存到文本文件
    • 每行一个链接，方便批量处理

  2. 使用脚本自动化

    # 示例：批量处理链接文件 import subprocess with open('links.txt', 'r') as f: links = f.read().splitlines() for link in links: subprocess.run(['uv', 'run', 'main.py', '--url', link])

  3. 定时任务设置

    • 使用系统定时任务（如cron或Task Scheduler）
    • 定期执行下载脚本，实现自动化采集

性能优化建议

日常使用配置：

  • 并发数：3-5个线程
  • 超时时间：10秒
  • 重试次数：3次

批量采集配置：

  • 并发数：2-3个线程（避免触发限制）
  • 启用代理服务器
  • 设置合理的请求间隔

📊 配置文件详解：定制你的下载体验

XHS-Downloader的配置文件位于./Volume/settings.json，支持20多个自定义参数。首次运行程序时会自动生成该文件。

关键配置项说明：

{ "work_path": "./Volume", // 作品存储根路径 "folder_name": "Download", // 下载文件夹名称 "name_format": "发布时间 作者昵称 作品标题", // 文件命名格式 "cookie": "", // 小红书Cookie（提升下载质量） "proxy": null, // 代理服务器设置 "timeout": 10, // 请求超时时间（秒） "max_retry": 5, // 最大重试次数 "image_format": "WEBP", // 图片下载格式 "folder_mode": false, // 每个作品单独文件夹 "author_archive": true, // 按作者分类存储 "download_record": true // 记录下载历史 }

配置验证方法：

  1. 修改配置文件后重启程序
  2. 尝试下载一个作品测试配置效果
  3. 检查下载的文件是否符合预期设置

💡 最佳实践：高效使用建议

个人用户使用建议

  1. 定期更新Cookie：建议每1-2周更新一次Cookie，确保下载权限
  2. 合理设置下载路径：选择空间充足的磁盘分区，避免存储不足
  3. 启用智能分类：开启作者归档功能，便于内容管理
  4. 备份重要配置：定期备份settings.json文件，防止设置丢失

内容创作者工作流

  1. 灵感收集阶段：使用浏览器脚本快速保存感兴趣的内容
  2. 素材整理阶段：按主题或作者分类存储下载内容
  3. 定期清理阶段：删除不需要的素材，释放存储空间
  4. 版权合规检查：确保下载内容符合使用规范

开发者集成方案

XHS-Downloader提供完整的API接口，可以轻松集成到现有系统中。核心源码位于source/application/目录，模块化设计便于二次开发和功能扩展。

API调用示例：

import requests server = "http://127.0.0.1:5556/xhs/detail" data = { "url": "小红书作品链接", "download": True, "index": [1, 3, 5], "proxy": "http://127.0.0.1:10808" } response = requests.post(server, json=data, timeout=10) print(response.json())

🎯 总结：为什么选择XHS-Downloader

XHS-Downloader作为一款功能全面的小红书内容下载工具，具有以下核心优势：

功能全面：支持图文、视频、动图等多种内容类型下载使用灵活：提供图形界面、命令行、API、浏览器脚本多种使用方式配置丰富：20+个自定义参数满足不同需求智能管理：自动去重、断点续传、智能分类等高级功能开源免费：完全开源，持续更新，社区支持

无论你是偶尔需要下载几个作品，还是需要批量处理大量内容，XHS-Downloader都能提供稳定可靠的解决方案。通过合理的配置和使用技巧，你可以充分发挥这个工具的潜力，高效管理你的小红书内容收藏。

最后提醒：请遵守相关法律法规和平台使用条款，合理使用本工具进行个人学习和创作。尊重原创内容，支持正版创作环境。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

编程学习 学习日记 实战经验
← 返回列表