koishi-plugin-booru-pixiv
安装
- 在 Koishi 中下载并安装本插件,若你还未安装 Booru 插件,请先安装。
- 在 Pixiv 注册账号并登录。
- 安装 pixiv-auth 插件,根据其配置页面获取
Refresh Token
,注意此插件需求图形界面。- 如果你没有图形界面,也可以使用 Pixiv OAuth Script 脚本获取
Refresh Token
。
- 如果你没有图形界面,也可以使用 Pixiv OAuth Script 脚本获取
- 将
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 加密密钥对图片链接进行加密,以防止恶意访问。密钥无法在配置中设置,在插件第一次启动时会自动生成一个随机的密钥。访问此路径时,只允许成功解密的请求通过,理论上只可能是插件本身提供的链接。