极速上手XHS-Downloader：3分钟学会下载小红书无水印图文/视频
项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader 你是否还在为无法保存小红书无水印图片和视频而烦恼？是否厌倦了复杂的下载流程和低质量的水印文件？本文将带你3分钟掌握XHS-Downloader的使用方法，轻松下载小红书无水印作品，让你高效保存心仪内容。
读完本文你将获得：
- 3种快速安装XHS-Downloader的方法
- 2种下载模式的详细操作指南
- 常见问题的解决方案和高级技巧
- 自定义下载设置的实用方法
项目简介
XHS-Downloader是一款基于AIOHTTP模块实现的小红书图文/视频作品采集工具，具有以下核心优势：
- 完全免费：开源项目，无任何隐藏付费功能
- 轻量高效：体积小，资源占用低，下载速度快
- 无水印下载：直接获取原始画质的作品文件
- 多平台支持：Windows、MacOS、Linux系统均适用
- 多种运行模式：图形界面、命令行、API接口等多种使用方式
核心功能清单（点击展开）
- ✅ 采集小红书作品信息
- ✅ 提取小红书作品下载地址
- ✅ 下载小红书无水印作品文件
- ✅ 自动跳过已下载的作品文件
- ✅ 自定义图文作品文件下载格式
- ✅ 支持命令行下载作品文件
- ✅ 从浏览器读取Cookie
- ✅ 自定义文件名称格式
- ✅ 支持断点续传下载
快速安装
方法一：直接运行程序（推荐普通用户）
- 访问项目仓库：
https://gitcode.com/gh_mirrors/xh/XHS-Downloader - 点击"发布"或"Releases"，下载最新版本的程序压缩包
- 解压到本地任意文件夹
- 双击运行
main.exe（Windows）或main（Mac/Linux）
注意：Mac用户可能需要从终端启动程序，Linux用户可能需要赋予执行权限：
chmod +x main
方法二：Docker运行（推荐技术用户）
如果你已安装Docker，可以通过以下命令快速启动：
# 拉取镜像
docker pull joeanamier/xhs-downloader
# 启动容器（图形界面模式）
docker run -p 5556:5556 -v xhs_downloader_volume:/app/Volume -it joeanamier/xhs-downloader
方法三：源码运行（适合开发者）
# 克隆仓库
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader
# 进入项目目录
cd XHS-Downloader
# 安装依赖
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt
# 运行程序
python main.py
快速开始：两种下载模式任选
模式一：图形界面模式（推荐新手）
- 启动程序后，你将看到直观的图形界面
- 打开小红书APP或网页版，找到想要下载的作品
- 复制作品链接（分享后复制链接或浏览器地址栏复制）
- 将链接粘贴到XHS-Downloader的输入框中
- 点击"下载"按钮，等待下载完成
![程序运行界面示意图]
下载完成的文件默认保存在程序目录下的Volume/Download文件夹中。
模式二：命令行模式（适合高效操作）
对于熟悉命令行的用户，可以直接使用命令行模式快速下载：
# 基本用法
python main.py "https://www.xiaohongshu.com/explore/作品ID"
# 下载多个链接（用空格分隔）
python main.py "链接1" "链接2" "链接3"
# 指定下载图片序号（仅对图文作品有效）
python main.py --index 1,3,5 "https://www.xiaohongshu.com/explore/作品ID"
# 从浏览器读取Cookie
python main.py --browser_cookie Chrome "https://www.xiaohongshu.com/explore/作品ID"
进阶技巧：自定义下载设置
修改下载路径
- 打开程序目录下的
settings.json文件 - 找到
work_path参数，修改为你想要的保存路径：
"work_path": "D:\\小红书下载",
- 保存文件，重启程序即可生效
自定义文件命名格式
XHS-Downloader支持自定义下载文件的命名格式，默认格式为"发布时间 作者昵称 作品标题"。你可以在settings.json中修改name_format参数，支持的字段包括：
- 收藏数量
- 评论数量
- 分享数量
- 点赞数量
- 作品标签
- 作品ID
- 作品标题
- 作品描述
- 发布时间
- 作者昵称
- 作者ID
例如，设置为"作品ID 作者昵称 作品标题"：
"name_format": "作品ID 作者昵称 作品标题",
选择图片格式
在settings.json中，你可以通过image_format参数设置图片下载格式：
"image_format": "PNG", // 可选值：AUTO、PNG、WEBP、JPEG、HEIC
不同格式特点对比：
| 格式 | 特点 | 适用场景 |
|---|---|---|
| PNG | 无损压缩，质量最高，文件较大 | 需要高质量图片保存 |
| WEBP | 压缩率高，质量好，文件较小 | 平衡质量和存储空间 |
| JPEG | 兼容性好，压缩率高，有损耗 | 对质量要求不高的场景 |
| HEIC | 高效压缩，质量好，iOS原生支持 | Apple设备用户 |
| AUTO | 根据原始文件自动选择 | 不确定选择哪种格式时 |
常见问题解决
Q1: 下载失败怎么办？
如果遇到下载失败，可按以下步骤排查：
-
检查网络连接：确保网络稳定，尝试访问其他网站
-
更新程序版本：确保使用最新版本，旧版本可能存在兼容性问题
-
获取Cookie：某些内容需要登录才能访问，获取Cookie的方法如下：
- 打开浏览器访问小红书网页版
- 按F12打开开发者工具，选择"网络"选项卡
- 刷新页面，找到任意请求，复制Cookie值
- 在程序设置中粘贴Cookie
-
使用命令行模式：尝试使用命令行模式并添加
--debug参数查看详细错误信息
Q2: 如何批量下载作品？
XHS-Downloader支持多种批量下载方式：
- 命令行批量下载：一次性输入多个链接，用空格分隔
- 剪贴板监听：开启程序的剪贴板监听功能，复制链接自动下载
- 用户脚本辅助：安装配套的浏览器用户脚本，一键提取账号所有作品链接
Q3: 下载的文件保存在哪里？
默认下载路径为程序目录下的Volume/Download文件夹。你可以通过以下方式查看或修改：
- 在图形界面中，点击"设置"按钮，查看"下载路径"
- 直接修改配置文件
settings.json中的work_path参数 - 使用命令行参数
--work_path "自定义路径"临时指定
高级用法：API模式和二次开发
对于开发者，XHS-Downloader提供了API模式，可以方便地集成到其他项目中：
# 启动API服务器
python main.py api
API服务器启动后，访问http://127.0.0.1:5556/docs可查看完整的API文档。
以下是一个Python调用示例：
import requests
def download_xhs_video(url):
server = "http://127.0.0.1:5556/xhs/detail"
data = {
"url": url,
"download": True,
"index": [1, 3, 5] # 下载第1、3、5张图片（仅对图文作品有效）
}
response = requests.post(server, json=data)
return response.json()
# 使用示例
result = download_xhs_video("https://www.xiaohongshu.com/explore/作品ID")
print(result)
总结与展望
通过本文的介绍，你已经掌握了XHS-Downloader的基本使用方法和高级技巧。这款工具不仅解决了小红书无水印下载的痛点，还提供了丰富的自定义选项，满足不同用户的需求。
随着项目的不断发展，未来还将支持更多实用功能，如自动分类整理、AI智能下载推荐等。如果你有好的建议或功能需求，欢迎通过项目仓库提交反馈。
最后，再次提醒大家，下载和使用他人作品时请遵守相关法律法规，尊重原创作者的知识产权，合理使用下载的内容。
项目参与和支持
XHS-Downloader是一个开源项目，欢迎大家参与贡献：
- 提交代码：通过GitCode提交PR
- 报告问题：在项目仓库提交issue
- 分享经验：在社区中分享使用技巧和心得
如果你觉得这个项目对你有帮助，可以通过以下方式支持开发者：
- 给项目点Star
- 分享给有需要的朋友
- 在社交媒体宣传推荐
感谢你的使用和支持！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
