API 设置
预览图质量设置
每个图站可分别设置 3 个级别的图片质量:缩略图 (preview) = 列表显示的缩略图,预览放大 (sample) = 长按查看的大图,下载 (file) = 下载按钮使用的原图。选项:原图 = 最佳质量(加载最慢),采样 = 高清采样图(折中),缩略 = 最小文件(最快)。
预览图代理设置
为各图源分别设置预览图的加载方式:服务器代理 = 预览图经本服务器转发(Danbooru 中被屏蔽或受限的帖子会回退到 Gelbooru 等图源,通常需要服务器代理),客户端直连 = 浏览器直接访问图源 CDN。浏览页「代理预览图」勾选时全部走服务器代理;未勾选时按此处各图源设置逐条执行(AI 翻译作品 / 收藏 / 收藏画师更新等混合多图源视图同样生效;danbooru 池复用 danbooru 设置)。
代理设置
本页的代理配置只决定「请求发去哪里」,而本接口无鉴权、任何人可改 —— 所以
Worker 地址必须同时在部署层声明为可信,否则该模式会被忽略
(请求直发真实站点,凭据不会经过未声明的主机):
WEBOORU_TRUSTED_PROXY_HOSTS=你的-worker.example(逗号分隔,支持子域后缀)。
出站 TLS 校验默认开启;仅当设置 WEBOORU_INSECURE_TLS=1 关闭校验时,
下方 HTTP 代理同样要求命中该白名单。详见 ADR-004。
常用 Tags 编辑
这些 Tag 会显示在主页的快捷选择区。每行一个 Tag。
下载设置
账户授权 (API Auth)
凭据字段「只写不读」:接口不回显密钥,此处显示为空是正常的;留空保存 = 保持原值,
只有填入新值才会覆盖。推荐的部署方式是用环境变量注入凭据(不落库、也不进导出备份):
WEBOORU_DANBOORU_USERNAME/API_KEY、WEBOORU_GELBOORU_USER_ID/API_KEY、
WEBOORU_RULE34_USER_ID/API_KEY、WEBOORU_IWARA_EMAIL/PASSWORD、
WEBOORU_PIXIV_REFRESH_TOKEN、WEBOORU_KEMONO_SESSION(或
WEBOORU_KEMONO_USERNAME/PASSWORD 自动登录)。详见 ADR-005。
Danbooru
Gelbooru
Rule34
Pixiv
Kemono
Iwara
配置后 iwara 视频/图片直链签发走登录态(可获取更全资源);留空则匿名签发(实测仍可用)。账号密码仅存于本地 data/config.json,不会入库或提交。
AI 漫画翻译设置 (Gemini)
密钥只从部署环境的 GEMINI_API_KEYS 读取(多个 Key 用英文逗号分隔,翻译时自动轮换),不写入数据库、不随备份导出。改环境变量后需重启服务生效。
可用变量: {char}(角色), {tags}(标签), {size}(尺寸)
用于 Pool 多图时每 5 张一批的翻译。可用变量: {char}, {tags}, {size}
Pool 翻译数量 > 6 时启用,对所有翻译进行全局校对。可用变量: {batch_results}
数据库 (webooru.db)
所有本地数据(收藏、翻译结果、关注画师、设置)都保存在 data/webooru.db。建议定期导出备份;导入会用文件完全覆盖当前数据库(不可撤销),导入前会自动备份原库到 data/backups/。
标签库 (tags.db)
标签模糊查询数据来自两个自动维护的线上翻译表仓库(pixiv 与 danbooru 各一)。点击更新会从线上下载并重建本地 data/tags.db(覆盖现有标签数据,不可撤销),更新前自动备份旧库到 data/backups/。
远程收藏同步
把 danbooru / pixiv 账号云端的收藏批量同步进本地收藏表(与手动收藏同表:按 (站点, id) 去重,已存在的帖会刷新评分/标签等元数据并保留入库时间与顺序)。danbooru 可同步任意公开用户名;pixiv 仅同步本服务器已配置账号(需 pixiv_refresh_token,公开 + 私密两档)。同步全量入库(含 q/e 分级),后台任务执行,可在进行中取消。个人私部署接口不做口令鉴权。