XHS-Downloader 完整指南小红书无水印作品下载入门【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader每次刷小红书看到喜欢的图文或视频能做的往往只有截图或录屏——水印还在、画质还差一个个存更费时间。XHS-Downloader 是一个开源的小红书作品采集工具把作品链接粘贴给它它自动解析并下载无水印的原始文件支持图文、视频和动图。读完这篇你就能把它跑起来并完成第一次下载。30秒认识 XHS-Downloader先用几句话交代这个项目的定位后面所有操作都围绕它展开。基于 Python 3.12 开发Windows、macOS、Linux 均可运行内置终端图形界面TUI也提供命令行、API、MCP 服务器等调用方式兼容小红书与 RedNote 域名链接支持xhslink短链自动解析图文支持 PNG/WEBP/JPEG/HEIC 格式选择视频支持分辨率、码率、文件大小三种偏好自动跳过已下载作品、断点续传、文件完整性校验核心逻辑在source/application/app.py做法截图 / 录屏XHS-Downloader画质带水印、画质损失无水印原始文件方式手动逐个保存多链接批量下载管理文件名混乱自定义命名 按作者归档从零跑起来安装与启动命令推荐用uv一条链路装完依赖并启动比手动建虚拟环境省事如果你没有 uv也可以照 README 用pip install -r requirements.txt走传统流程效果相同。下面这段命令完成克隆、安装依赖、启动程序三件事git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev # 安装依赖要求 Python 3.12 及以上 uv run main.py # 启动程序进入图形界面⚠️ 提示macOS 首次运行若提示无法打开是因为可执行文件未签名在终端执行xattr -cr 项目文件夹路径移除安全标记即可。三种打开方式图形界面、命令行与浏览器脚本程序有三种交互模式按你的使用习惯挑一种就行三种方式底层共用同一套下载逻辑。图形界面TUI适合谁不熟悉命令行、希望粘贴即用的用户。启动后进入主界面把作品链接粘贴到输入框多个链接用空格分隔点击下载作品文件开始下载也可以用读取剪贴板按钮直接取剪贴板内容按S进设置、R看下载记录、M开启剪贴板监听后台自动抓取新链接向剪贴板写入close即可停止命令行适合谁需要指定图片序号、自定义路径、批量处理的进阶用户。用--url传入作品链接引号内多个链接空格分隔需要时叠加参数比如只下第 2、5 张图注意设置--index时只处理第一个链接布尔参数可用true/false/1/0等形式下面这几条是日常最常用的命令行写法python main.py --url 链接1 链接2 # 批量下载 python main.py --url 链接 --index 2 5 # 只下第2、5张图 python main.py --url 链接 --work_path D:/xhs --folder_mode true浏览器用户脚本适合谁经常在网页版小红书浏览、想从页面上批量提取链接的人。给浏览器安装 Tampermonkey 扩展添加仓库自带的static/XHS-Downloader.js用户脚本在小红书页面用脚本菜单提取发布、收藏、点赞、专辑、搜索结果的作品或用户链接配置与调优参数速查表参数不需要全记先认识这几个高频项完整列表随时可以运行python main.py -h查看配置文件则保存在项目根目录的settings.json中。参数作用推荐值--url/-u作品链接多个空格分隔必填--index/-i指定图片序号仅图文1 3 5--image_format/-if图片格式JPEG或WEBP--video_preference/-vp视频偏好resolution--folder_mode/-fm每作品独立文件夹false--author_archive/-aa按作者归档false--max_retry/-mr失败最大重试次数5--chunk/-c下载块大小字节2097152Cookie 配置不配置 Cookie 也能用但视频作品只能拿到较低清晰度配置网页版 Cookie 后可获取更高画质且无需登录账号。获取步骤在小红书网页版打开任意页面按F12打开开发者工具切到 Network网络面板勾选保留日志过滤web_session找到对应的请求头复制完整 Cookie 值填入settings.json的cookie字段或命令行用--cookie传入存储管理默认所有文件平铺在work_path/Download下文件名按name_format生成默认发布时间 作者昵称 作品标题。想整理归档时有两种开关# 开启 --author_archive按作者分目录 Volume/Download/ └── 作者ID_作者昵称/ ├── 2026.01.01 昵称 作品A.jpg └── 2026.01.02 昵称 作品B.mp4 # 开启 --folder_mode每个作品独立文件夹 Volume/Download/ └── 2026.01.01 昵称 作品A/ └── 作品A的图片和视频文件排障手册按症状对照解决遇到问题先对照下面的症状描述找到对应原因再动手改比盲目重试效率高。提示提取小红书作品链接失败→ 链接不被识别或已过期短链失效、参数被截断→ 在浏览器打开该链接确认可访问复制地址栏完整链接再粘贴到程序视频下载清晰度偏低→ 未配置 Cookie只能拿到低码率文件 → 按上文步骤获取网页版 Cookie 并写入配置后重新下载下载中途失败或频繁重试→ 网络不稳或超时设置过短 → 用--max_retry 10增加重试次数必要时加--timeout 30延长超时、--proxy配置代理作品被提示跳过下载→ 该作品 ID 已存在于下载记录中属于重复检测机制 → 这不是故障确需重下时按R进入下载记录查看对应条目macOS 双击程序无反应→ 可执行文件未经签名被系统拦截 → 终端执行xattr -cr 项目文件夹路径后重试给开发者的通道API 与 Docker这一节面向有技术背景的读者把 API 服务器和容器化部署放在一起讲。API 服务器基于 FastAPI用下面命令启动随后访问http://127.0.0.1:5556/docs可以看到交互式接口文档python main.py api # API 模式监听 5556 端口 python main.py mcp # MCP 模式提供 get_detail_data / download_detail 工具主要端点POST /xhs/detail参数url必填、download、index、cookie、proxy、skip返回作品数据及下载地址GET /重定向到项目仓库页除了 HTTP 调用也可以直接 import 核心类最小可运行示例如下from asyncio import run from source.application.app import XHS async def main(): async with XHS(work_path./Volume, image_formatWEBP) as xhs: await xhs.extract(https://www.xiaohongshu.com/explore/作品ID, downloadTrue) run(main())容器化部署用仓库根目录的Dockerfile构建或直接docker pull joeanamier/xhs-downloaderTUI 与 API 两种模式的运行命令docker run --name xhs -p 5556:5556 -v xhs_vol:/app/Volume -it joeanamier/xhs-downloader docker run --name xhs -p 5556:5556 -v xhs_vol:/app/Volume -it joeanamier/xhs-downloader python main.py api注意Docker 内不支持命令行调用模式读取与监听剪贴板功能不可用其余功能正常。下一步现在就可以动手了按顺序走完这四步克隆仓库并执行uv sync --no-dev用uv run main.py启动在主界面粘贴一个作品链接完成第一次下载文件落在Volume/Download下配置网页版 Cookie重新下载一个视频作品对比清晰度差异使用过程中遇到问题到项目仓库提交 Issue 反馈版本变动可查阅static/Release_Notes.md把链接交给它把整理时间留给自己——你的第一个无水印文件离现在只差一条命令。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 XHS-Downloader 完整指南：小红书无水印作品下载入门
XHS-Downloader 完整指南小红书无水印作品下载入门【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader每次刷小红书看到喜欢的图文或视频能做的往往只有截图或录屏——水印还在、画质还差一个个存更费时间。XHS-Downloader 是一个开源的小红书作品采集工具把作品链接粘贴给它它自动解析并下载无水印的原始文件支持图文、视频和动图。读完这篇你就能把它跑起来并完成第一次下载。30秒认识 XHS-Downloader先用几句话交代这个项目的定位后面所有操作都围绕它展开。基于 Python 3.12 开发Windows、macOS、Linux 均可运行内置终端图形界面TUI也提供命令行、API、MCP 服务器等调用方式兼容小红书与 RedNote 域名链接支持xhslink短链自动解析图文支持 PNG/WEBP/JPEG/HEIC 格式选择视频支持分辨率、码率、文件大小三种偏好自动跳过已下载作品、断点续传、文件完整性校验核心逻辑在source/application/app.py做法截图 / 录屏XHS-Downloader画质带水印、画质损失无水印原始文件方式手动逐个保存多链接批量下载管理文件名混乱自定义命名 按作者归档从零跑起来安装与启动命令推荐用uv一条链路装完依赖并启动比手动建虚拟环境省事如果你没有 uv也可以照 README 用pip install -r requirements.txt走传统流程效果相同。下面这段命令完成克隆、安装依赖、启动程序三件事git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader uv sync --no-dev # 安装依赖要求 Python 3.12 及以上 uv run main.py # 启动程序进入图形界面⚠️ 提示macOS 首次运行若提示无法打开是因为可执行文件未签名在终端执行xattr -cr 项目文件夹路径移除安全标记即可。三种打开方式图形界面、命令行与浏览器脚本程序有三种交互模式按你的使用习惯挑一种就行三种方式底层共用同一套下载逻辑。图形界面TUI适合谁不熟悉命令行、希望粘贴即用的用户。启动后进入主界面把作品链接粘贴到输入框多个链接用空格分隔点击下载作品文件开始下载也可以用读取剪贴板按钮直接取剪贴板内容按S进设置、R看下载记录、M开启剪贴板监听后台自动抓取新链接向剪贴板写入close即可停止命令行适合谁需要指定图片序号、自定义路径、批量处理的进阶用户。用--url传入作品链接引号内多个链接空格分隔需要时叠加参数比如只下第 2、5 张图注意设置--index时只处理第一个链接布尔参数可用true/false/1/0等形式下面这几条是日常最常用的命令行写法python main.py --url 链接1 链接2 # 批量下载 python main.py --url 链接 --index 2 5 # 只下第2、5张图 python main.py --url 链接 --work_path D:/xhs --folder_mode true浏览器用户脚本适合谁经常在网页版小红书浏览、想从页面上批量提取链接的人。给浏览器安装 Tampermonkey 扩展添加仓库自带的static/XHS-Downloader.js用户脚本在小红书页面用脚本菜单提取发布、收藏、点赞、专辑、搜索结果的作品或用户链接配置与调优参数速查表参数不需要全记先认识这几个高频项完整列表随时可以运行python main.py -h查看配置文件则保存在项目根目录的settings.json中。参数作用推荐值--url/-u作品链接多个空格分隔必填--index/-i指定图片序号仅图文1 3 5--image_format/-if图片格式JPEG或WEBP--video_preference/-vp视频偏好resolution--folder_mode/-fm每作品独立文件夹false--author_archive/-aa按作者归档false--max_retry/-mr失败最大重试次数5--chunk/-c下载块大小字节2097152Cookie 配置不配置 Cookie 也能用但视频作品只能拿到较低清晰度配置网页版 Cookie 后可获取更高画质且无需登录账号。获取步骤在小红书网页版打开任意页面按F12打开开发者工具切到 Network网络面板勾选保留日志过滤web_session找到对应的请求头复制完整 Cookie 值填入settings.json的cookie字段或命令行用--cookie传入存储管理默认所有文件平铺在work_path/Download下文件名按name_format生成默认发布时间 作者昵称 作品标题。想整理归档时有两种开关# 开启 --author_archive按作者分目录 Volume/Download/ └── 作者ID_作者昵称/ ├── 2026.01.01 昵称 作品A.jpg └── 2026.01.02 昵称 作品B.mp4 # 开启 --folder_mode每个作品独立文件夹 Volume/Download/ └── 2026.01.01 昵称 作品A/ └── 作品A的图片和视频文件排障手册按症状对照解决遇到问题先对照下面的症状描述找到对应原因再动手改比盲目重试效率高。提示提取小红书作品链接失败→ 链接不被识别或已过期短链失效、参数被截断→ 在浏览器打开该链接确认可访问复制地址栏完整链接再粘贴到程序视频下载清晰度偏低→ 未配置 Cookie只能拿到低码率文件 → 按上文步骤获取网页版 Cookie 并写入配置后重新下载下载中途失败或频繁重试→ 网络不稳或超时设置过短 → 用--max_retry 10增加重试次数必要时加--timeout 30延长超时、--proxy配置代理作品被提示跳过下载→ 该作品 ID 已存在于下载记录中属于重复检测机制 → 这不是故障确需重下时按R进入下载记录查看对应条目macOS 双击程序无反应→ 可执行文件未经签名被系统拦截 → 终端执行xattr -cr 项目文件夹路径后重试给开发者的通道API 与 Docker这一节面向有技术背景的读者把 API 服务器和容器化部署放在一起讲。API 服务器基于 FastAPI用下面命令启动随后访问http://127.0.0.1:5556/docs可以看到交互式接口文档python main.py api # API 模式监听 5556 端口 python main.py mcp # MCP 模式提供 get_detail_data / download_detail 工具主要端点POST /xhs/detail参数url必填、download、index、cookie、proxy、skip返回作品数据及下载地址GET /重定向到项目仓库页除了 HTTP 调用也可以直接 import 核心类最小可运行示例如下from asyncio import run from source.application.app import XHS async def main(): async with XHS(work_path./Volume, image_formatWEBP) as xhs: await xhs.extract(https://www.xiaohongshu.com/explore/作品ID, downloadTrue) run(main())容器化部署用仓库根目录的Dockerfile构建或直接docker pull joeanamier/xhs-downloaderTUI 与 API 两种模式的运行命令docker run --name xhs -p 5556:5556 -v xhs_vol:/app/Volume -it joeanamier/xhs-downloader docker run --name xhs -p 5556:5556 -v xhs_vol:/app/Volume -it joeanamier/xhs-downloader python main.py api注意Docker 内不支持命令行调用模式读取与监听剪贴板功能不可用其余功能正常。下一步现在就可以动手了按顺序走完这四步克隆仓库并执行uv sync --no-dev用uv run main.py启动在主界面粘贴一个作品链接完成第一次下载文件落在Volume/Download下配置网页版 Cookie重新下载一个视频作品对比清晰度差异使用过程中遇到问题到项目仓库提交 Issue 反馈版本变动可查阅static/Release_Notes.md把链接交给它把整理时间留给自己——你的第一个无水印文件离现在只差一条命令。【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考