WebRender

WebRender 为小可的外置服务，主要用于处理 Wiki infobox 图片渲染、html 渲染以及部分功能的访问代理。

为了最大程度的网页兼容性，此服务仅支持 Chromium 内核和 Firefox 浏览器。

直接搭建

此服务目前已内置在机器人项目中，无须额外搭建。详见自搭建指南#WebRender。

远程搭建

直接下载

请前往此处下载源文件，并在终端内安装 Python 依赖。

然后使用 playwright install --with-deps chromium（或 firefox）安装浏览器及 Playwright 相关依赖即可。或是在配置文件中手动指定 executable_path 路径以手动选择本地浏览器。

Important

如果你遇到以下异常（通常在依赖更新后发生）：

可以尝试运行以下命令后再重新启动 WebRender：

playwright install

在项目根目录中找到 config.json 配置文件，并填写以下内容：

{
  "server": {
    "host": "127.0.0.1", # 服务器地址
    "port": 15551, # 服务器端口
    "debug": false, # 是否启用调试模式，此模式下浏览器将以有头模式运行
    "export_logs": false, # 是否允许导出日志
    "browser_type": "chromium", # 使用的浏览器类型
    "executable_path": null # 使用的浏览器可执行文件地址，若使用 playwright install 可留空
  }
}

Important

请删除 JSON 文件的所有注释，否则无法正常读取。

运行 run_server.py 来开启服务。

API 监听端口默认位于 15551，可自行选择自定义端口。

使用 Docker 镜像

请确保你的计算机已安装 Docker，且 Docker Daemon 正常运行。

目前 WebRender 的 Docker 镜像支持的架构为 amd64 和 arm64。

在终端内运行以下命令：

docker pull dorowolf/akari-bot-webrender:latest

请在终端内运行以下命令启用机器人：

docker run \
-d \
-p 15551:15551  \ # 服务端口
--name akari-bot-webrender  \ # 指定容器名称
dorowolf/akari-bot-webrender

如果终端中返回了 long_tag 类型的容器 ID，证明容器已成功创建。 在终端内运行 docker logs akari-bot-webrender 可以查看机器人日志。此处的 akari-bot-webrender 为容器名，若你忘记定义容器名，可以替换为容器 ID。

配置

请在机器人配置文件中 remote_web_render_url 配置项填写访问地址，如 http://127.0.0.1:15551。将 remote_only 设为 true 以仅允许使用远程服务。