Docker_Buildx_PixivBiu

DockerHub | GitHub

本项目使用 Docker Buildx 构建全平台镜像，支持 linux/amd64、linux/armv7、linux/armv8 框架，不再对 linux/386、linux/armv6、linux/ppc64le、linux/s390x 架构提供支持。

构建方式	底包采用	amd64 镜像大小
pyinstaller	alpine:latest	39.1M
源码构建	python:alpine3.14	200M

使用 GitHub Action 在 UTC+8 00:00 自动拉取 txperl/PixivBiu 的源码进行构建 Docker 镜像，但当源码版本和 Docker 镜像版本一致将不会构建镜像，总的构建时间大约需要 30 分钟。

使用方式

在启动镜像之前，你需要准备 .token 文件用以登录，请使用客户端获取 .token 文件。

当上述方法登录无效时，推荐下面方法

1. 取消映射 -v 本机路径:/Pixiv/usr/.token token文件
2. 将docker run -d 改为 docker run -itd
3. 使用docker start pixivbiu 启动docker容器
4. 使用docker attach pixivbiu 进入容器
5. 可能遇到进入容器无日志输出，这时按y
6. 根据日志给出提示进行操作
7. 使用 exit 推出容器
8. 使用attach进入容器并推出，这是容器也会关闭，使用docker start pixivbiu 重新启用容器即可

注意，使用 Docker 镜像时某些环境变量不建议修改

环境变量	注意事项
-e sys.host="0.0.0.0:4001"	如果你想在 Docker 外访问，请不要传入改环境变量
-e sys.autoOpen=false	反正 Docker 内也没提供浏览器窗口，所以这项传了没用
-e sys.ignoreOutdated=true	你敢改为false，容器就敢不启动
-e biu.download.saveURI="{ROOTPATH}/downloads/{KT}/"	如果不使用 aria2，{ROOTPATH}/downloads是不能修改
-e biu.download.saveURI="{ROOTPATH}/downloads/{KT}/"	使用 aria2，请改为对应 aria2 的下载路径，使用p3terx的Aria2Pro镜像则改为/downloads

pyinstaller 构建镜像的使用方式（默认拉取）

国内镜像地址

• 将 zzcabc/pixivbiu:latest 换成 registry.cn-hangzhou.aliyuncs.com/zzcabc/pixivbiu:latest

docker run -itd \
    --name pixivbiu \
    --user $(id -u):$(id -g) \
    -p 本机端口:4001 \
    -v 本机路径:/Pixiv/config.yml \
    -v 本机路径:/Pixiv/downloads \
    -v 本机路径:/Pixiv/usr/.token \
    zzcabc/pixivbiu

环境变量

• 具体参照源码的配置
• 使用了环境变量创建容器，可用不需要传入 config.yml
• 应用的配置优先级为：环境变量 > config.yml > 默认

如果你要使用环境变量传配置，请自行修改下方 -e 中的内容。

docker run -itd \
    --name pixivbiu \
    --user $(id -u):$(id -g) \
    -p 本机端口:4001 \
    -e sys.debug=false \
    -e sys.apiRoute="direct" \
    -e sys.proxy="" \
    -e sys.language="" \
    -e sys.theme="multiverse" \
    -e biu.search.maxThreads=8 \
    -e biu.search.loadCacheFirst=true \
    -e biu.search.maxCacheSizeMiB=512 \
    -e biu.download.mode="dl-single" \
    -e biu.download.aria2Host="localhost:6800" \
    -e biu.download.aria2Secret="" \
    -e biu.download.deterPaths=true \
    -e biu.download.maxDownloading=8 \
    -e biu.download.saveURI="{ROOTPATH}/downloads/{date_today}/" \
    -e biu.download.saveFileName="{title}_{work_id}" \
    -e biu.download.autoArchive=true \
    -e biu.download.whatsUgoira=webp \
    -e biu.download.imageHost="" \
    -e secret.key.apiSauceNAO="" \
    -v 本机路径:/Pixiv/downloads \
    -v 本机路径:/Pixiv/usr/.token \
    zzcabc/pixivbiu

以默认的配置启动容器

docker run -itd \
    --name pixivbiu \
    --user $(id -u):$(id -g) \
    -p 本机端口:4001 \
    -v 本机路径:/Pixiv/downloads \
    -v 本机路径:/Pixiv/usr/.token \
    zzcabc/pixivbiu

源码编译构建镜像的使用方式

国内镜像地址

• 将 zzcabc/pixivbiu:latest-src 换成 registry.cn-hangzhou.aliyuncs.com/zzcabc/pixivbiu:latest-src

docker run -itd \
    --name pixivbiu \
    --user $(id -u):$(id -g) \
    -p 本机端口:4001 \
    -v 本机路径:/Pixiv/config.yml \
    -v 本机路径:/Pixiv/downloads \
    -v 本机路径:/Pixiv/usr/.token \
    zzcabc/pixivbiu:latest-src

环境变量

• 具体参照源码的配置
• 使用了环境变量创建容器，可用不需要传入 config.yml
• 应用的配置优先级为：环境变量 > config.yml > 默认

如果你要使用环境变量传配置，请自行修改下方 -e 中的内容。

docker run -itd \
    --name pixivbiu \
    --user $(id -u):$(id -g) \
    -p 本机端口:4001 \
    -e sys.debug=false \
    -e sys.apiRoute="direct" \
    -e sys.proxy="" \
    -e sys.language="" \
    -e sys.theme="multiverse" \
    -e biu.search.maxThreads=8 \
    -e biu.search.loadCacheFirst=true \
    -e biu.search.maxCacheSizeMiB=512 \
    -e biu.download.mode="dl-single" \
    -e biu.download.aria2Host="localhost:6800" \
    -e biu.download.aria2Secret="" \
    -e biu.download.deterPaths=true \
    -e biu.download.maxDownloading=8 \
    -e biu.download.saveURI="{ROOTPATH}/downloads/{date_today}/" \
    -e biu.download.saveFileName="{title}_{work_id}" \
    -e biu.download.autoArchive=true \
    -e biu.download.whatsUgoira=webp \
    -e biu.download.imageHost="" \
    -e secret.key.apiSauceNAO="" \
    -v 本机路径:/Pixiv/downloads \
    -v 本机路径:/Pixiv/usr/.token \
    zzcabc/pixivbiu:latest-src

以默认的配置启动容器

docker run -itd \
    --name pixivbiu \
    --user $(id -u):$(id -g) \
    -p 本机端口:4001 \
    -v 本机路径:/Pixiv/downloads \
    -v 本机路径:/Pixiv/usr/.token.json \
    zzcabc/pixivbiu:latest-src

映射路径说明

此说明对应 Docker 容器内

• /Pixiv/downloads: 图片下载地址

• /Pixiv/config.yml: 配置文件（有环境变量即可不用传入）

• /Pixiv/usr/.token: Token 存放位置（必须映射）

• {ROOTPATH} 路径为 容器内/Pixiv

aria2 的使用方法

aria2 镜像

推荐使用 p3terx 的 Aria2Pro

SECRET 不配置默认为 p3terx

docker run -d \
    --name aria2-pro \
    --restart unless-stopped \
    --log-opt max-size=1m \
    -e PUID=$UID \
    -e PGID=$GID \
    -e UMASK_SET=022 \
    -e RPC_SECRET=<TOKEN> \
    -e RPC_PORT=6800 \
    -e LISTEN_PORT=6888 \
    -p 6800:6800 \
    -p 6888:6888 \
    -p 6888:6888/udp \
    -v 本地路径/aria2-config:/config \
    -v 本地路径/aria2-downloads:/downloads \
    p3terx/aria2-pro

使用 aria2 需要更改的地方

• biu.download.mode -> aria2
• biu.download.aria2Host -> aria的ip:6800
• biu.download.aria2Secret -> aria的secret
• biu.download.saveURI -> /downloads

测试地址

TODO

• 精简镜像大小
• 内置 aria2
• 上传阿里镜像仓库