全局设置

API 设置

建议设置在 20-40 之间,过大可能导致加载缓慢或被API封锁。(上限为100)

预览图质量设置

每个图站可分别设置 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。

本地代理使用下方配置的 HTTP 正向代理地址。Cloudflare Worker 需要部署 Worker 脚本并填入 Worker URL。
留空则不使用代理。Docker 部署时填入 http://host.docker.internal:代理端口。
控制 Pixiv 图片 CDN 地址的替换方式。选择 Cloudflare Worker 时使用上方 Worker 地址。

常用 Tags 编辑

这些 Tag 会显示在主页的快捷选择区。每行一个 Tag。

下载设置

可用变量: {site}(图源), {id}(图源的id), {artist}(画师), {char}(角色), {tags}(标签), {search_tags}(搜索使用的标签)
以空格分隔。若图片包含这些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

标签部分一致=tag 含该词即命中;标签完全一致=整条 tag 完全相同,更精准但会漏掉译名/别名作品;标题与说明文=按标题与作品说明检索。

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 分级),后台任务执行,可在进行中取消。个人私部署接口不做口令鉴权。

取消