XHS-Downloader 全平台兼容：Windows/macOS/Linux 账号作品采集指南
一、XHS-Downloader 的核心功能与优势
XHS-Downloader 是一款专为小红书设计的开源工具，支持全平台运行，包括 Windows、macOS 和 Linux。它允许用户批量采集账号发布、收藏、点赞、专辑中的作品链接，还能从搜索结果中抓取作品和用户链接。工具不仅能提取作品的详细信息，还能下载无水印的视频、图片等文件，提供高度定制化的下载选项。此外，它还具备自动跳过已下载作品、文件完整性校验、断点续传等智能机制，大大提升了下载效率和稳定性。
XHS-Downloader 是一款专为小红书设计的开源工具，支持全平台运行，包括 Windows、macOS 和 Linux。它允许用户批量采集账号发布、收藏、点赞、专辑中的作品链接，还能从搜索结果中抓取作品和用户链接。工具不仅能提取作品的详细信息，还能下载无水印的视频、图片等文件，提供高度定制化的下载选项。此外，它还具备自动跳过已下载作品、文件完整性校验、断点续传等智能机制，大大提升了下载效率和稳定性。
二、XHS-Downloader 的安装与配置
- Windows 系统安装
- 前往 GitHub 的 Releases 页面，下载 Windows 版本的压缩包，解压后双击运行 main.exe 即可使用。
- 若需使用命令行模式，需先安装 Python 3.12 及以上版本，然后在终端输入命令
pip install -r requirements.txt安装依赖，再运行python main.py。
- macOS 系统安装
- 下载 macOS 版本的压缩包，解压后在终端中进入解压目录，运行
./main即可。首次运行可能需要授予权限。 - 同样支持 Python 环境运行，步骤与 Windows 类似。
- 下载 macOS 版本的压缩包，解压后在终端中进入解压目录，运行
- Linux 系统安装
- 可以通过 Docker 部署，运行命令
docker pull joeanamier/xhs-downloader拉取镜像，然后docker run -it joeanamier/xhs-downloader启动。 - 也可下载源码，安装 Python 依赖后运行
python main.py。
- 可以通过 Docker 部署，运行命令
三、XHS-Downloader 的使用教程
- 配置 Cookie
- 打开浏览器，登录小红书，按 F12 打开开发者工具，选择网络选项卡，过滤框中输入
cookie-name:web_session，点击任一网页路径，获取右侧请求头中的 Cookie，复制到配置文件_internal/settings.json中的cookie字段。
- 打开浏览器，登录小红书，按 F12 打开开发者工具，选择网络选项卡，过滤框中输入
- 下载单个作品
- 打开小红书，复制作品链接，回到 XHS-Downloader 界面，点击 “读取剪贴板” 按钮获取链接，然后点击 “下载无水印作品文件” 即可。
- 批量下载
- 在输入框中输入多个作品链接，用空格分隔，程序会自动提取有效链接进行下载。
- 支持采集账号发布、收藏、点赞、专辑中的所有作品链接，只需输入账号主页链接即可。
- API 调用
- 启动服务器模式，运行命令
python main.py server，访问http://127.0.0.1:6666/docs查看 API 文档，通过 HTTP 接口控制下载行为。
- 启动服务器模式，运行命令
四、XHS-Downloader 的高级功能
- 剪贴板监听
- 开启监听功能后，后台会自动检测剪贴板中的小红书链接，并触发下载。
- 自定义设置
- 编辑
_internal/settings.json文件，可以调整下载路径、文件命名规则、是否记录下载历史等选项。 - 支持自定义图文作品文件下载格式（如 PNG、WEBP），以及视频下载的分辨率。
- 编辑
- 二次开发
- 项目采用 Python 语言开发，源代码结构清晰，注释详尽，开发者可根据自身需求进行二次开发，例如增加特定功能、优化下载逻辑等。
五、XHS-Downloader 的常见问题与解决方案
- 环境配置问题
- 确保安装了 Python 3.12 及以上版本，并正确安装了所有依赖库。
- Cookie 设置问题
- 若无法自动读取 Cookie，可手动设置 Cookie 参数，确保参数正确。
- 文件下载路径问题
- 默认下载路径为
_internal/Download，可在配置文件中修改。
- 默认下载路径为
- 下载失败问题
- 检查网络连接，确保链接有效。若下载中断，可启用断点续传功能继续下载。
六、XHS-Downloader 的安全与合规性
- 开源与免费
- XHS-Downloader 是完全免费且开源的工具，代码托管在 GitHub 上，用户可以自由查看和修改，确保了工具的安全性和可靠性。
- 隐私保护
- 工具不会收集用户的个人信息，所有数据均在本地处理，确保用户隐私安全。
- 合规使用
- 在使用过程中，需遵守小红书的相关规定，避免过度抓取或对平台造成过度负担，确保数据使用符合相关法律法规。
七、XHS-Downloader 的用户评价与推荐
XHS-Downloader 在用户中获得了广泛好评，用户称赞其操作简便、功能强大，特别是批量下载和无水印下载功能，大大节省了时间和精力。对于内容创作者、市场分析师、研究人员等人群，XHS-Downloader 是一款不可或缺的工具，能够帮助他们高效地采集和管理小红书内容。
XHS-Downloader 在用户中获得了广泛好评，用户称赞其操作简便、功能强大，特别是批量下载和无水印下载功能，大大节省了时间和精力。对于内容创作者、市场分析师、研究人员等人群，XHS-Downloader 是一款不可或缺的工具，能够帮助他们高效地采集和管理小红书内容。
总之，XHS-Downloader 凭借其全平台兼容、功能强大、操作简便等优势，成为了小红书内容采集与下载的首选工具。无论是普通用户还是专业人士，都能从这款工具中获得极大的便利。
该文章由dudu123.com嘟嘟 ai 导航整理，嘟嘟 AI 导航汇集全网优质网址资源和最新优质 AI 工具。
