中文 · English · 日本語

PixivBiu

PixivBiu，一款不错的 Pixiv 辅助工具。

• 浏览：完整客户端体验，作品、用户、排行，收藏与关注等
• 筛选：快速筛选，如收藏数、浏览量、标签、类型等
• 下载：原图下载，包括单图、多图、动图
• 桌面与服务器：全平台支持，提供 Windows、macOS、Linux 程序包

使用

Core

Core 拥有完整前后端功能。如果你有轻量、可控、服务器使用需求，可以直接使用 Core 版本。

1. 前往 Releases，下载对应系统的程序包
2. 解压并运行 pixivbiu 文件
3. 在浏览器中打开 http://127.0.0.1:4001 即可

Desktop

Desktop 版本是对 Core 使用的封装，功能上与 Core 完全相同。如果在桌面系统使用，此版本会更加易用。

1. 前往 Desktop-Releases
2. 下载对应系统的桌面包，打开并运行即可

配置

与功能、使用相关的配置，可以直接在设置页面中修改。

但请注意，有部分运维相关配置项，只能通过配置文件或环境变量修改。

常用环境变量：

具体的配置说明，可参见 docs/CONFIGURATION.md 文档。

Docker

你也可以直接通过 Docker Image 运行 PixivBiu。

docker run -d --name pixivbiu -p 4001:4001 \
  -v pixivbiu-data:/data -v "$PWD/downloads:/downloads" \
  ghcr.io/txperl/pixivbiu:latest

亦或是通过 Docker Compose 运行。

# clone repo and move to
git clone https://github.com/txperl/PixivBiu.git
cd PixivBiu

# (host bind mount for downloads) make the dir writable by the container's uid
mkdir -p downloads && sudo chown 65532:65532 downloads

# start it
docker compose up -d

完整的 Docker 相关说明，可参见 docs/DOCKER.md 文档。

开发

构建与开发需要 Go 1.26+、bun、make 环境。

从源码构建

git clone https://github.com/txperl/PixivBiu.git
cd PixivBiu

# 构建前端与后端
# 产出的 bin/pixivbiu 已将前端内嵌
make dist

# 执行
./bin/pixivbiu

本地开发

开发时，可以 make dev 启动后端，然后 cd frontend && bun run dev 启动前端。

具体的项目架构与实现细节，可参见 AGENTS.md 文档。

Disclaimer & License

This project is intended for personal study and research only. Please comply with Pixiv's Terms of Service, respect creators' copyright, and refrain from any commercial or infringing use, or from redistributing downloaded works.

Released under the MIT License.