无尽书证
快速开始

接入文档

无尽书证提供 Waline 兼容的托管评论服务。注册账号后创建实例,把实例 API 地址替换到现有 Waline 配置中即可。

1. 注册账号

使用 GitHub 或 Google 完成 OAuth 登录,注册即自动创建账号。

2. 创建实例

在控制台创建实例,得到 instance.waline.infvar.com/{标识} 地址。

3. 配置接入网站

在实例编辑页填写自己的博客域名,开启 CORS 防盗链。

4. 替换 serverURL

在 Waline 客户端中把 serverURL 指向实例的 /api 地址。

创建实例

登录后进入「实例」页面,点击「新建实例」。完成 PoW 人机验证后填写实例名称, 系统会自动生成实例标识和专属 API 地址。

实例地址格式为 https://instance.waline.infvar.com/{标识},评论 API 地址为 https://instance.waline.infvar.com/{标识}/api

你可以在实例列表中复制 API 地址、启停实例、修改名称,或进入审核与通知页面配置策略。

在「编辑实例」中填写允许接入的网站地址(每行一个)后,其他网站将无法跨域调用该实例的评论 API。

Waline 接入

引入 Waline 客户端时,把 serverURL 设置为实例地址。以下示例使用 Waline 官方客户端。

<link rel="stylesheet" href="https://unpkg.com/@waline/client@v3/dist/waline.css" />
<div id="comments"></div>
<script type="module">
  import { init } from "https://unpkg.com/@waline/client@v3";

  init({
    el: "#comments",
    serverURL: "https://instance.waline.infvar.com/myblog",
    path: location.pathname,
    lang: "zh-CN",
    dark: "auto"
  });
</script>

如果你的站点使用了 VuePress、VitePress 或 Hexo 的 Waline 插件,只需把 插件配置里的 serverURL 替换为实例地址,其他配置保持不变。

API 概览

以下接口使用实例地址作为服务端根路径。

GET
/api/comment?path=/post获取指定页面的评论列表
POST
/api/comment提交新评论
GET
/api/comment/:objectId获取单条评论
GET
/api/user?token=...获取当前评论用户信息
GET
/api/article?path=/post获取文章评论计数
POST
/api/token使用 Waline Token 换取用户数据

创建评论时需要携带表单数据与可选的人机验证 Token。评论默认进入待审核状态, 通过审核规则后公开显示。

审核策略

每个实例都可以独立配置基础审核开关、敏感词模式、Akismet 密钥、AI 审核接口、 IP/用户黑名单以及匿名评论与 PoW 验证策略。

敏感词支持「拦截」「替换」「转入待审核」三种动作;黑名单规则支持 IP、用户、 邮箱、链接与昵称五种维度。AI 审核使用 OpenAI 兼容接口,可替换为任意兼容提供商。

登录弹窗

无尽书证沿用 Waline 的登录弹窗协议:客户端打开 /ui/login,用户完成 OAuth 登录后弹窗通过 postMessage 返回 userInfo 并自动关闭。

Waline 官方客户端无需额外配置即可使用这一流程,第三方客户端也可以按相同 协议实现自定义登录。

更多问题请查看定价,或直接注册账号开始使用。