企业官网建设流程全解析

XHS-Downloader 小红书下载器使用教程:一条链接保存图文与视频到本地

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader

XHS-Downloader 是一个开源的小红书下载器(XiaoHongShu / RedNote 作品采集工具):粘贴作品链接,即可把图文、视频、LivePhoto 文件提取并保存为本地文件,也支持一次处理多个链接。本文按"先跑起来,再讲懂"的顺序:前半部分完成安装与首次运行,后半部分说明用法与配置。

如何安装 XHS-Downloader 并首次运行

环境要求 Python ≥ 3.12,Windows、macOS、Linux 均支持。在源码目录中依次执行以下命令,完成后会直接打开图形界面:

git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev uv run main.py

不想用源码的,可到项目 Releases 下载程序压缩包,解压后双击 main 即可;偏好容器化的,执行docker pull joeanamier/xhs-downloader后启动容器。

最短使用路径:从一条链接到本地文件

最短路径只有三步:

1. 在小红书 App 或网页端打开作品,点"分享"复制链接(xhslink.com短链与xiaohongshu.com/explore/...链接都能识别);
2. 把链接粘贴到输入框,点"下载作品文件";多个链接用空格分隔,可以一次粘贴;
3. 下载完成后,文件位于项目根目录的Volume/Download文件夹中,文件名按"发布时间 作者昵称 作品标题"规则生成。

图形界面、命令行与浏览器脚本怎么选

同一套能力有三种入口,按使用习惯选择即可:

建议:只保存几篇作品用图形界面;要小红书批量下载或配合自己的脚本,用命令行;平时就在网页端浏览、希望直接收集链接,用浏览器脚本(可与主程序联动手推下载任务)。

常用配置项、默认值与调整时机

配置集中在./Volume/settings.json(首次运行自动生成),修改后重启程序生效;默认值可在 source/module/settings.py 中查看。

改图片格式与保存目录的示例:

{ "image_format": "PNG", "work_path": "D:/收藏" }

开发者还可以用python main.py api或python main.py mcp启动服务器模式,交互式文档页在http://127.0.0.1:5556/docs,鉴权令牌在启动时输出。

小红书下载常见问题排查

• 视频清晰度低:cookie 默认为空,未配置时只能下载低分辨率视频;在网页端按 F12 打开开发者工具,从"网络"选项卡任一请求头复制 Cookie 写入 settings.json 即可。
• 下载慢、经常超时:调大timeout与max_retry,或在 settings.json 配置proxy。
• 文件保存在哪:默认在项目根目录Volume/Download(发布版在程序目录内);改了work_path则以新路径为准。
• 重复下载:download_record默认开启,已下载作品记录在Volume/ExploreID.db,再次下载同一作品会自动跳过。
• 链接失效、提取失败:作品链接带时效参数,较早复制的链接可能被风控,请使用最新复制的链接。

各参数完整说明见 README.md。

使用边界

下载内容请仅用于个人学习与备份,尊重创作者版权与平台条款,不用于商业用途;程序内置请求延时机制(avg_delay 默认 6 秒),不建议高频大量抓取。一条作品链接到本地归档,全程三步以内,这就是 XHS-Downloader 的核心价值。

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader