Skip to content
目录

koishi-plugin-booru-pixiv

安装

  1. 在 Koishi 中下载并安装本插件,若你还未安装 Booru 插件,请先安装。
  2. Pixiv 注册账号并登录。
  3. 安装 pixiv-auth 插件,根据其配置页面获取 Refresh Token,注意此插件需求图形界面。
    • 如果你没有图形界面,也可以使用 Pixiv OAuth Script 脚本获取 Refresh Token
  4. Refresh Token 填入配置项中的 token 项。

配置项

全局设置

TIP

此处的配置项可参考图源全局设置

搜索设置


token

  • 类型:string
  • 是否必填:是

Pixiv APP API 的 Refresh Token

minBookmarks

  • 类型: number
  • 默认值: 0

最少收藏数

bypassMethod

  • 类型: 'proxy' | 'route' | 'asset'

突破 Pixiv 站点图片防外部引用检测的方式。具体见下方说明

proxy

  • 类型: { endpoint: string } | string
  • 可选值: 'i.pixiv.re' | 'i.pixiv.cat'
  • 默认值: 'i.pixiv.re'

使用代理突破检测时的代理服务。如果是自定义代理服务,可以填写代理服务的地址。

route

  • 类型: string
  • 默认值: '/booru/pixiv/proxy'

使用 route 突破检测时的代理服务路径。

aesKey

  • 类型: string
  • 默认值: ''

使用 route 突破检测时的 AES 加密密钥。

突破 Pixiv 检测

Pixiv 站点全站引入了图片防外部引用检测,主要是检测 HTTP 请求的 Referer 头。这个检测会阻止插件直接引用图片链接,导致部分适配器无法直接发送图片链接。为了解决这个问题,本插件提供了三种突破检测的方式。

proxy

使用 Pixiv 的图片代理服务,将图片链接转换为代理链接。这通常使用公开的代理服务,如 pixiv.cat 等。

route

使用插件本身提供的图片代理服务,将图片链接转换到 Koishi 所在的服务器上。这通常需要插件的服务器能够访问到 Pixiv 的图片链接。

TIP

同时由于插件难以对访问来源进行可信检测,因此需要使用 AES 加密密钥对图片链接进行加密,以防止恶意访问。密钥无法在配置中设置,在插件第一次启动时会自动生成一个随机的密钥。访问此路径时,只允许成功解密的请求通过,理论上只可能是插件本身提供的链接。