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

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

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

你是否曾经遇到过想要保存小红书上的精彩内容，却发现平台限制下载或水印干扰？XHS-Downloader正是为解决这一痛点而生的开源工具，它能够高效提取小红书作品的无水印原图/视频，支持批量下载、智能管理和多平台部署。无论你是内容创作者、数据分析师还是普通用户，这个工具都能帮你轻松获取高质量素材。

📦 快速入门：5分钟上手体验

安装方式对比

XHS-Downloader提供多种安装方式，满足不同用户需求：

最简单的开始方式

如果你是Windows或macOS用户，推荐使用可执行文件版本：

# 1. 从GitHub Releases下载最新版本 # 2. 解压压缩包 # 3. 双击运行 main 程序

如果你是开发者或需要更多自定义功能：

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

XHS-Downloader图形界面：简洁直观的操作界面，支持多种功能模式

🔧 核心功能深度解析

支持的小红书链接类型

XHS-Downloader支持四种主流的小红书链接格式，智能识别并处理：

1. 标准作品链接：https://www.xiaohongshu.com/explore/作品ID
2. 发现页链接：https://www.xihongshu.com/discovery/item/作品ID
3. 用户主页链接：https://www.xiaohongshu.com/user/profile/作者ID/作品ID
4. 短链接：https://xhslink.com/分享码

无水印下载技术原理

XHS-Downloader通过模拟合法用户请求，绕过平台限制获取原始资源：

# 核心源码目录：source/application/explore.py async def extract(self, url: str, download: bool = False) -> dict: """提取作品信息并下载文件""" # 1. 解析链接获取作品ID note_id = self.__extract_link_id(url) # 2. 发送请求获取作品数据 data = await self.__get_note_data(note_id) # 3. 提取无水印资源地址 clean_urls = self.__extract_clean_urls(data) # 4. 下载资源文件 if download: await self.__download_files(clean_urls) return data

智能文件管理

系统内置智能去重机制，避免重复下载：

• 基于作品ID的记录：自动记录已下载作品
• 文件完整性检查：下载中断后支持断点续传
• 多种命名格式：支持自定义文件名模板

🚀 三种运行模式详解

1. 图形界面模式（TUI）

适合普通用户，提供直观的操作体验：

# 启动图形界面 python main.py

命令行模式：支持高级参数配置和批量处理

2. 命令行模式

适合批量处理和自动化任务：

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

3. API服务器模式

适合系统集成和二次开发：

# 启动API服务器 python main.py api # 访问API文档 # http://127.0.0.1:5556/docs

API接口示例：

import requests def download_xhs_content(): server = "http://127.0.0.1:5556/xhs/detail" data = { "url": "https://www.xiaohongshu.com/explore/xxxxxxxxxx", "download": True, "index": [1, 3, 5], # 仅下载指定序号的图片 } response = requests.post(server, json=data, timeout=30) return response.json()

⚙️ 高级配置与优化

配置文件详解

配置文件位于./Volume/settings.json，支持20+个自定义参数：

{ "work_path": "./Volume", "folder_name": "Download", "name_format": "发布时间 作者昵称 作品标题", "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36", "cookie": "web_session=xxx; a1=xxx", "proxy": "http://127.0.0.1:10808", "timeout": 10, "chunk": 2097152, "max_retry": 5, "image_format": "WEBP", "folder_mode": false, "download_record": true, "author_archive": true, "write_mtime": true }

性能优化建议

根据使用场景调整配置，获得最佳体验：

Cookie配置指南

获取Cookie是获取高清资源的关键：

1. 打开浏览器访问https://www.xiaohongshu.com/explore
2. 按F12打开开发者工具
3. 切换到Network选项卡
4. 筛选Fetch/XHR请求
5. 复制Cookie中的web_session和a1值

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

🐳 Docker容器化部署

快速启动容器

# TUI模式（图形界面） docker run --name xhs-downloader -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader # API模式（服务端） docker run --name xhs-downloader-api -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py api # MCP模式（AI集成） docker run --name xhs-downloader-mcp -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader python main.py mcp

Docker Compose部署

创建docker-compose.yml：

version: '3.8' services: xhs-downloader: image: joeanamier/xhs-downloader container_name: xhs-downloader ports: - "5556:5556" volumes: - xhs_downloader_volume:/app/Volume command: python main.py api restart: unless-stopped volumes: xhs_downloader_volume:

🔌 浏览器用户脚本集成

Tampermonkey脚本安装

1. 安装Tampermonkey浏览器扩展
2. 访问脚本地址：https://raw.githubusercontent.com/JoeanAmier/XHS-Downloader/refs/heads/master/static/XHS-Downloader.js
3. 点击安装即可

用户脚本安装：简单几步即可在浏览器中直接使用

脚本核心功能

• 一键下载：在小红书页面直接下载作品
• 批量提取：自动提取页面中的所有作品链接
• 智能推送：将任务推送到本地运行的XHS-Downloader
• 自动滚动：自动加载更多内容（可配置）

用户脚本界面：丰富的功能选项，支持多种操作模式

🛠️ 二次开发指南

核心模块结构

source/ ├── application/ # 应用层：业务逻辑实现 │ ├── app.py # 主应用类，协调各模块工作流 │ ├── download.py # 多线程下载引擎 │ ├── explore.py # 数据提取与解析 │ ├── image.py # 图片资源处理 │ ├── request.py # 网络请求封装 │ └── video.py # 视频资源处理 ├── module/ # 基础模块层 │ ├── manager.py # 资源管理器 │ ├── model.py # 数据模型定义 │ └── tools.py # 通用工具函数 └── expansion/ # 扩展层 ├── cleaner.py # 数据清洗与格式化 └── error.py # 自定义异常处理

API集成示例

from source import XHS import asyncio async def download_xhs_content(): """通过代码调用XHS-Downloader""" async with XHS( work_path="./downloads", folder_name="小红书素材", name_format="发布时间 作者昵称 作品标题", cookie="your_cookie_here", proxy="http://127.0.0.1:10808", image_format="WEBP", author_archive=True, download_record=True, ) as xhs: # 下载单个作品 result = await xhs.extract( "https://www.xiaohongshu.com/explore/xxx", download=True ) print(f"下载完成：{result.get('title', '未知标题')}") # 批量下载 urls = [ "https://www.xiaohongshu.com/explore/xxx1", "https://www.xiaohongshu.com/explore/xxx2", "https://www.xiaohongshu.com/explore/xxx3", ] for url in urls: await xhs.extract(url, download=True)

自定义扩展开发

你可以基于XHS-Downloader开发自己的功能：

1. 自定义数据处理器：继承source.module.extend.Extend类
2. 添加新的下载源：修改source.application.explore模块
3. 集成其他平台：参考现有架构实现新的平台适配器

📊 性能对比测试

不同配置下的下载速度

我们测试了在不同网络环境和配置下的下载性能：

功能特性对比

🔍 故障排除与常见问题

Q1: 下载速度很慢怎么办？

解决方案：

1. 检查网络连接，尝试使用代理
2. 调整chunk参数为较小的值（如 1024*1024）
3. 减少并发数，避免触发平台限制
4. 配置有效的Cookie获取高清资源

Q2: 下载的文件有水印？

可能原因：

1. 未配置Cookie或Cookie已过期
2. 平台更新了反爬机制

解决方案：

1. 重新获取有效的Cookie
2. 更新到最新版本的XHS-Downloader
3. 检查配置文件中的cookie参数

Q3: 程序无法启动？

排查步骤：

1. 检查Python版本是否为3.12或更高
2. 运行pip install -r requirements.txt安装依赖
3. 确保系统有足够的权限访问文件系统
4. 查看错误日志定位具体问题

Q4: Docker容器无法连接？

检查事项：

1. 确认端口映射正确：-p 5556:5556
2. 检查防火墙设置是否允许5556端口
3. 查看容器日志：docker logs xhs-downloader
4. 确保volume挂载正确

🌟 社区贡献指南

如何参与开发？

XHS-Downloader欢迎开发者贡献代码，以下是参与流程：

1. Fork仓库：点击GitHub页面的Fork按钮
2. 创建分支：基于develop分支创建功能分支
3. 开发功能：遵循现有代码风格，使用Ruff格式化
4. 提交PR：推送到你的仓库并创建Pull Request

代码规范要求

• 使用PEP 8代码风格
• 所有函数和类都需要文档字符串
• 新增功能需要包含单元测试
• 使用类型注解提高代码可读性

提交信息格式

<类型>: <简短描述> <详细说明> <相关Issue>

类型说明：

• feat: 新功能
• fix: 修复bug
• docs: 文档更新
• style: 代码格式调整
• refactor: 重构代码
• test: 测试相关
• chore: 构建过程或辅助工具变动

🎯 最佳实践与使用技巧

个人用户使用建议

1. 定期更新Cookie：Cookie有效期有限，建议每周更新一次
2. 合理设置并发数：根据网络状况调整，避免被封IP
3. 使用文件夹分类：启用author_archive功能按作者分类
4. 备份配置文件：定期备份settings.json文件

企业级部署方案

1. 多实例负载均衡：部署多个Docker容器，使用Nginx负载均衡
2. 数据库集成：将下载记录存入外部数据库（如MySQL、PostgreSQL）
3. 监控告警：集成Prometheus监控下载状态和错误率
4. 自动化任务：使用Celery或APScheduler定时执行批量下载

开发者集成示例

# 集成到现有系统的示例 class XHSDownloaderService: def __init__(self): self.downloader = None async def initialize(self): """初始化下载服务""" self.downloader = XHS( work_path="/data/xhs_downloads", cookie=self._get_cookie(), proxy=self._get_proxy(), download_record=True, author_archive=True ) await self.downloader.__aenter__() async def batch_download(self, urls: List[str]): """批量下载接口""" results = [] for url in urls: try: data = await self.downloader.extract(url, download=True) results.append({ "status": "success", "data": data }) except Exception as e: results.append({ "status": "error", "error": str(e) }) return results

📈 未来发展规划

短期目标（1-3个月）

1. AI增强功能：基于图像识别的内容分类和标签生成
2. 云存储集成：支持直接上传到云存储服务
3. 移动端适配：开发移动端应用版本

中期目标（3-6个月）

1. 多平台支持：扩展支持抖音、B站等其他平台
2. 智能推荐：基于下载历史的内容推荐
3. 集群部署：支持分布式下载集群

长期愿景

1. 开源生态建设：建立插件系统，支持第三方扩展
2. 商业化服务：提供企业级API服务和定制开发
3. 社区共建：建立活跃的开发者社区和用户论坛

💡 总结

XHS-Downloader作为一款功能全面、性能优异的小红书无水印下载工具，不仅解决了普通用户的内容保存需求，更为开发者和企业提供了强大的技术基础。其模块化设计、多运行模式支持和丰富的API接口，使其成为内容采集领域的重要工具。

无论你是需要批量下载素材的内容创作者，还是需要集成内容采集功能的开发者，XHS-Downloader都能提供稳定可靠的解决方案。项目的持续更新和活跃的社区支持，确保了工具的长期可用性和功能完善。

立即开始使用：访问项目仓库https://gitcode.com/gh_mirrors/xh/XHS-Downloader获取最新版本，开始你的小红书内容采集之旅！

注意：请遵守相关法律法规和平台使用条款，合理使用本工具。

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