Skip to content

zzcabc/Docker_Buildx_PixivBiu

Repository files navigation

Docker_Buildx_PixivBiu

DockerHub | GitHub

GitHub release (latest by date)Docker Image Version (latest by date) Docker Pulls

本项目使用 Docker Buildx 构建全平台镜像,支持 linux/amd64linux/armv7linux/armv8 框架,不再对 linux/386linux/armv6linux/ppc64lelinux/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
  • 上传阿里镜像仓库

Releases

No releases published