PixivFanboxDownloader

xuejianxianzunGPL-3.0活跃维护

Chrome 扩展,用来批量下载 Pixiv Fanbox 上的投稿文件,省去逐个手动保存的麻烦。

A Chrome extension for downloading files on Pixiv Fanbox in batches. Chrome 扩展,用于批量下载 Pixiv Fanbox 上的文件。

v5.1.1发布于 2026-10-26 16:40 UTC1,117star +2 / 7 天50fork同步于 2026-11-11 05:48 UTC

怎么上手

由 README 提炼,执行前请确认
从 Chrome Web Store 在线安装,或从 releases 页面下载 pixivfanboxDownloader.zip 离线安装
硬件要求按 README 说明

README 未说明

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

Chrome 扩展,用于批量下载 Pixiv Fanbox 上的文件,支持筛选文件类型和自定义文件名

Chrome 扩展,用来批量下载 Pixiv Fanbox 上的投稿文件,省去逐个手动保存的麻烦。

核心能力

  • 在主页抓取所有赞助用户的投稿
  • 在用户页抓取该用户全部投稿
  • 在投稿页抓取单篇投稿
  • 支持多种筛选条件选择投稿和文件
  • 支持自定义文件名规则

容易踩的坑

无法直接解锁 Fanbox 付费内容,需先购买;下载前需关闭浏览器“下载前询问保存位置”设置;文件名异常时需禁用其他带下载功能的扩展;Android 浏览器不创建子文件夹,不推荐使用

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v5.1.1
  1. v5.1.15.1.1最新正式版2026-10-26 · 2026-10-26 16:40 UTC

    💡新增提示:在无痕(隐私)窗口里,浏览器无法下载 Fanbox 的付费资源,会导致下载失败

    下载器会把文件交给浏览器去下载。如果当前页面处于无痕(隐私)模式里,浏览器可能无法下载 fanbox 的付费资源,此时下载会失败,错误代码是 SERVER_FORBIDDEN。

    现在遇到这个错误时,下载器会在日志里显示提示。

    🐞修复问题:在 Firefox 上抓取投稿评论时,会导致抓取出错

    https://github.com/xuejianxianzun/PixivFanboxDownloader/issues/94

    在 Firefox 上,如果启用了“保存评论”,抓取投稿时可能会出现这个错误,并且一直重试、无法继续抓取:

    Not allowed to define cross-origin object as property on [Object] or [Array] XrayWrapper
    

    原因:Firefox 的内容脚本通过 fetch 获取到的接口数据被 XrayWrapper 包装,属于页面的隔离环境。下载器获取评论后需要把评论写入投稿数据(post.commentList),这种修改跨隔离环境对象的操作会被 Firefox 阻止。

    修复方式:Firefox 里在 API.request 拿到数据后,先把它深拷贝为内容脚本自己的对象,之后再修改就不会触发这个限制。

    😊在导出下载记录时,文件名里包含 fanbox 标记

    https://github.com/xuejianxianzun/PixivFanboxDownloader/issues/93

    这样导出的文件可以与其他站点的文件(pixiv)区分开来。

  2. v5.1.05.1.02026-09-07 · 2026-09-07 18:01 UTC
    查看更新说明

    ✨新增设置:文件名重复时的处理方式

    当你重复下载一个投稿里的文件时,经常会产生同名文件。之前下载器总是会添加序号,现在你可以选择不同的处理方式:“覆盖已有文件”或者“手动处理”。

    已知问题: 这个设置在手机浏览器里可能无效,或者行为不符合预期。这是因为手机浏览器似乎不会覆盖同名文件。

    以移动版 Edge 浏览器为例:

    • 选择添加序号:当有同名文件时,Edge 会跳过这个新文件,所以不会保存新文件,也不会产生序号
    • 选择覆盖:Edge 此时反而为下载新文件,并为其添加序号。行为与字面描述不符
    • 选择手动处理:情况同“添加序号”,不会保存新文件。Edge 也不会像电脑上的浏览器那样显示另存为窗口。 其他浏览器可能会使用其他处理方式,我没有测试。

    ✨在日志区域底部添加了“导出日志”按钮

    ✨新增命名标记 {PVA}

    {PVA} 用来输出每篇投稿的资源标记。P、V、A 分别表示图片、视频、音频。完整输出如【15P1V1A】或[15P+1V+1A](这取决于下载器的语言),每个投稿独立计算。根据投稿的实际情况,可能只会输出部分标记,或者不输出任何内容。它适合放在最后一层文件夹的末尾,例如:fanbox/{user}/{date}-{title}{PVA}/{name}

    🔧保存投稿中的文字为 HTML 格式时,它里面的文件总是使用相对路径

    之前如果用户排除了投稿里的一些文件(不下载它们),那么它们在 HTML 里的路径会使用 fanbox 上的原 URL。这经常会导致内容无法加载。

    现在 HTML 里总是会使用相对路径,即优先使用本地文件,而不是原 URL。

    https://github.com/xuejianxianzun/PixivFanboxDownloader/issues/92

    🦊支持在 PC 版 Firefox 浏览器上使用

    该扩展近期将会上架 Add-ons 扩展商店,可以在 PC 端 Firefox 浏览器上安装使用。

    PS:该扩展无法在移动端 Firefox 上使用,因为移动端 Firefox 浏览器的下载功能是残废的。

    https://github.com/xuejianxianzun/PixivFanboxDownloader/issues/80

    已知问题: 不支持在移动端 Firefox 上使用。这不是下载器的 Bug,而是因为移动端 Firefox 的下载功能是残废的,限制太多无法实现:

    • 没有扩展程序的 downloads API,无法让浏览器下载文件;
    • 使用 a 标签的 download 属性来下载文件时,由于文件域名 downloads.fanbox.cc 相对于网页域名 www.fanbox.cc 是跨域的,所以移动端 Firefox 会打开这个链接,而非下载文件。
    • 叠加该浏览器的其他问题,所以我放弃了支持移动端 Firefox 的尝试。

    📱优化了移动端界面

    在移动设备里可以正常使用下载器了。

    🐞修复问题:在主页里保存所有粉丝卡时,会提示没有赞助的用户

    这是因为 Fanbox API 返回的数据结构变化导致的,现在修复。

    🐞修复问题:当后台脚本被回收时,点击“查看历史数据”按钮没反应

    由于后台脚本被回收,在第一次点击该按钮时,回调会产生错误。之后后台脚本被唤醒,所以第二次点击可以正常显示数据。

    现在进行修复:在出现这个错误时,稍等一下然后重试最多 3 次。

    😊优化文件下载失败时的处理

    现在的处理方式如下:

    • 每个文件最多重试 3 次
    • 重试达到上限时,保存同名 txt 文件,记录错误信息
    • 在日志里显示更详细的错误提示和重试指引

    😊优化了一些文本的翻译

    早期一些文本是使用谷歌翻译机翻的,不准确,现在我让 AI 把所有语句都重新翻译了一遍。

  3. v5.0.05.0.02026-08-11 · 2026-08-11 16:07 UTC
    查看更新说明

    ✨在保存投稿中的文字时,新增了 HTML 格式

    https://github.com/xuejianxianzun/PixivFanboxDownloader/issues/87

    之前该设置只有 TXT 格式,查看时不会显示投稿里的图片、视频等内容。新增的 HTML 格式可以显示这些内容,阅读体验接近 Fanbox 的网页浏览效果。

    感谢 Eganchiyu 提交了该功能。

    ✨新增设置:保存投稿中的评论

    https://github.com/xuejianxianzun/PixivFanboxDownloader/issues/79

    感谢 Eganchiyu 提交了该功能。

  4. v4.9.44.9.42026-07-22 · 2026-07-22 10:33 UTC
    查看更新说明

    🐞修复了抓取文章列表时出错的问题

    Fanbox 的 API 变化导致了此问题,现在修复。

    这次是文章分页网址 /post.paginateCreator 里添加了一层 pageUrls 属性。

  5. v4.9.34.9.32026-07-22 · 2026-07-22 06:53 UTC
    查看更新说明

    🐞修复了抓取文章列表时出错的问题

    Fanbox 的 API 变化导致了此问题,现在修复。

    上次是文章数据里添加了一层 post 属性,这次是文章列表里添加了一层 posts 属性。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    English | 简体中文 | 繁體中文 | 日本語 | 韩国语

    Introduction

    This is a Chrome browser extension for batch downloading files on Pixiv Fanbox.

    Supports filtering file types, custom file names, and multiple languages.

    Note: This program cannot directly unlock paid content on Fanbox. If you want to download paid content, you must first purchase it.

    screenshot

    Installation

    We recommend using Chrome or Edge browsers.

    Online Installation

    Chromium-based browsers such as Chrome and Edge can install this extension from the Chrome Web Store.

    Firefox users can install this extension from the Add-Ons store.

    Offline Installation

    You can refer to the offline installation tutorial for the Pixiv Downloader: Offline Installation

    There is only one difference: the tutorial above will ask you to download the zip file for the Pixiv Downloader. Instead, download the zip file for the Fanbox Downloader. You can download pixivfanboxDownloader.zip from the releases page of this repository.

    Using on Android

    On Android, you can install this extension using the Quetta browser. Quetta is a mobile browser with the Chromium core, and you can install extensions online from the Chrome Web Store — very convenient. However, browsers on Android do not create subfolders, so I do not recommend using it on Android.

    How to Use

    • After installing this extension, refresh the fanbox page. You will see a blue download button on the right side of the page. Click this button to start using it.
    • On the home page, you can crawl posts from all the sponsored users.
    • On a user's page, you can crawl all of their posts.
    • On a post page, you can crawl an individual post.
    • After crawling is complete, the downloader will automatically start downloading.
    • You can use a variety of filters to select the posts and files you want to download, and you can set file name rules.
    • Downloaded files will be saved in the browser's download directory. If you want to save them to a different location, you need to change the browser's download directory.
    • Please disable the browser setting "Ask where to save each file before downloading" to avoid the save-as dialog during downloads.
    • If the filename of the downloaded file is abnormal, please disable other browser extensions with download functions.

    Development

    Tech stack: This project uses TypeScript, LESS, and Webpack 5.

    Development and build commands:

    npm install            # Install dependencies
    npm run ts            # Bundle TypeScript with webpack → dist/js/
    npm run less          # Compile src/style/style.less to dist/style/style.css with lessc
    npm run fmt           # Format with prettier
    npm run pre-build     # ts + less + fmt
    npm run build         # pre-build + pack.js: updates the contents of /dist and packs them into a zip file
    

    You can run the corresponding command depending on what you modified:

    • If you only modified ts files: npm run ts
    • If you only modified less files: npm run less
    • If you modified other files (e.g. manifest.json): run node pack to copy the files into the /dist directory
    • Full build: npm run build runs all the commands

    In the browser's extension management page, load the /dist directory to install this extension locally and debug it. After you modify the source code and compile it into /dist, you need to refresh the extension, and then refresh the web page, to apply the changes.

    Patreon

    You can support me on patreon. Thank you!