PixivFlow

🐱 PixivFlow

把「刷 Pixiv 手动存图」变成一条命令。批量下载插画与小说,按标签、收藏数、日期筛选,Cron 定时自动收集——CLI 与 WebUI 双形态,Docker 部署即开即用。

Node.js 18+ · TypeScript · MIT License · Windows / macOS / Linux / Docker / Android(Termux)

核心能力

🔗

任意链接直下

插画、小说、系列、用户主页……粘贴 URL 或裸 ID 即可下载,10 种地址形态全部识别。

🏷️

标签搜索与多维筛选

标签匹配方式、排序、最低收藏数、发布日期窗口自由组合。

🏆

排行榜模式

日榜 / 周榜 / 月榜 / R18 榜直接抓取,先上榜后过滤。

🎲

随机发现

从结果中随机挑选下载,每天给它一个小惊喜。

Cron 定时收集

每天凌晨自动收昨日新作;YESTERDAY 占位符免改配置。

💾

去重与断点续传

SQLite 记录下载历史,重复执行安全跳过,中断接着传。

🗂️

12 种目录组织

按画师、标签、创建日、下载日……任何维度归档,normalize 一键重排。

🖥️

WebUI 管理台

统计仪表盘、任务管理、实时日志、在线改配置,端口 3000 开箱即用。

🐳

Docker 双服务

定时任务与 WebUI 各自独立容器,健康检查、自动重启、共享数据卷。

三步跑起来

  1. 安装 CLI

    npm install -g pixivflow
    pixivflow --help   # 出现帮助信息即成功

    服务器推荐 Docker Compose;Android 用户走 Termux 路线

  2. 登录一次 Pixiv 账号

    pixivflow login                 # 桌面环境,浏览器授权
    pixivflow login-headless -u 用户名 -p 密码   # 无图形界面的服务器

    凭据写入本地配置,之后所有命令复用,详见 登录指南

  3. 粘贴链接,直接下载

    pixivflow download --url https://www.pixiv.net/artworks/123456789
    
    # 或者按配置批量收集:
    pixivflow download
    # 挂机自动化:
    pixivflow scheduler

    文件默认保存在 ./downloads,运行 pixivflow dirs 查看实际位置。

两种形态,一套能力

能力CLIWebUI(:3000)
执行下载download / 定时调度任务面板,可启停
URL 直链下载--url 参数专用输入框,支持批量粘贴
修改配置config / 编辑 JSON表单编辑器 + JSON 高亮 + 历史版本回滚
查看成果status / dirs统计图表与文件预览缩略图
日志logs实时滚动 WebSocket 推送
适合场景脚本化、无人值守、ssh 环境日常浏览管理、远程操作

从这里继续

↑ 回到顶部