XHS-Downloader 小红书下载器使用教程:一条链接保存图文与视频到本地【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-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后启动容器。最短使用路径:从一条链接到本地文件最短路径只有三步:在小红书 App 或网页端打开作品,点分享复制链接(xhslink.com短链与xiaohongshu.com/explore/...链接都能识别);把链接粘贴到输入框,点下载作品文件;多个链接用空格分隔,可以一次粘贴;下载完成后,文件位于项目根目录的Volume/Download文件夹中,文件名按发布时间 作者昵称 作品标题规则生成。图形界面、命令行与浏览器脚本怎么选同一套能力有三种入口,按使用习惯选择即可:入口适用读者操作方式核心优势图形界面 GUI不熟悉命令行的用户python main.py直接打开窗口粘贴链接点按钮,带读取剪贴板与后台监听命令行 CLI批量、自动化、脚本化调用python main.py -u 链接,可组合-i、-wp、-if等参数精确指定图片序号与保存路径,方便写进脚本做小红书批量下载浏览器脚本常在网页端浏览的用户Tampermonkey 安装后加载 static/XHS-Downloader.js提取当前页作品,批量提取账号发布、收藏、点赞的链接建议:只保存几篇作品用图形界面;要小红书批量下载或配合自己的脚本,用命令行;平时就在网页端浏览、希望直接收集链接,用浏览器脚本(可与主程序联动手推下载任务)。常用配置项、默认值与调整时机配置集中在./Volume/settings.json(首次运行自动生成),修改后重启程序生效;默认值可在 source/module/settings.py 中查看。配置项作用默认值何时调整work_path作品文件保存根路径项目根路径 Volume想把文件放到其他盘或目录folder_name作品文件储存文件夹名称Download想改默认文件夹名name_format文件命名格式发布时间 作者昵称 作品标题命名不利于自己检索时image_format图文下载格式,支持 PNG/WEBP/JPEG/HEIC/AUTOJPEG想要其他图片格式video_preference视频偏好:resolution / bitrate / sizeresolution画质与体积取舍不合意时cookie小红书网页版 Cookie,无需登录空需要更高清晰度视频timeout / max_retry请求超时秒数 / 失败重试次数10 / 5网络不稳、经常超时download_record记录已下载作品,自动跳过重复true一般保持开启author_archive按作者分文件夹归档false收藏同一作者的作品较多改图片格式与保存目录的示例:{ 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/4 19:10:44 · 阅读 1.2k XHS-Downloader 小红书下载器使用教程:一条链接保存图文与视频到本地
XHS-Downloader 小红书下载器使用教程:一条链接保存图文与视频到本地【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-DownloaderXHS-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后启动容器。最短使用路径:从一条链接到本地文件最短路径只有三步:在小红书 App 或网页端打开作品,点分享复制链接(xhslink.com短链与xiaohongshu.com/explore/...链接都能识别);把链接粘贴到输入框,点下载作品文件;多个链接用空格分隔,可以一次粘贴;下载完成后,文件位于项目根目录的Volume/Download文件夹中,文件名按发布时间 作者昵称 作品标题规则生成。图形界面、命令行与浏览器脚本怎么选同一套能力有三种入口,按使用习惯选择即可:入口适用读者操作方式核心优势图形界面 GUI不熟悉命令行的用户python main.py直接打开窗口粘贴链接点按钮,带读取剪贴板与后台监听命令行 CLI批量、自动化、脚本化调用python main.py -u 链接,可组合-i、-wp、-if等参数精确指定图片序号与保存路径,方便写进脚本做小红书批量下载浏览器脚本常在网页端浏览的用户Tampermonkey 安装后加载 static/XHS-Downloader.js提取当前页作品,批量提取账号发布、收藏、点赞的链接建议:只保存几篇作品用图形界面;要小红书批量下载或配合自己的脚本,用命令行;平时就在网页端浏览、希望直接收集链接,用浏览器脚本(可与主程序联动手推下载任务)。常用配置项、默认值与调整时机配置集中在./Volume/settings.json(首次运行自动生成),修改后重启程序生效;默认值可在 source/module/settings.py 中查看。配置项作用默认值何时调整work_path作品文件保存根路径项目根路径 Volume想把文件放到其他盘或目录folder_name作品文件储存文件夹名称Download想改默认文件夹名name_format文件命名格式发布时间 作者昵称 作品标题命名不利于自己检索时image_format图文下载格式,支持 PNG/WEBP/JPEG/HEIC/AUTOJPEG想要其他图片格式video_preference视频偏好:resolution / bitrate / sizeresolution画质与体积取舍不合意时cookie小红书网页版 Cookie,无需登录空需要更高清晰度视频timeout / max_retry请求超时秒数 / 失败重试次数10 / 5网络不稳、经常超时download_record记录已下载作品,自动跳过重复true一般保持开启author_archive按作者分文件夹归档false收藏同一作者的作品较多改图片格式与保存目录的示例:{ 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考