在网站中启用 Waline 提供评论与浏览量服务。

LeanCloud 设置 (数据库)

  1. 登录open in new window注册open in new window LeanCloud 国际版 并进入 控制台open in new window

    国内版需要域名备案,比较麻烦。国际版需要翻墙软件支持,这里推荐

    微软自带的Edge浏览器,添加扩展插件Hola Free VPN Proxy Unblocker - Best VPN

  2. 点击左上角 创建应用open in new window 并起一个你喜欢的名字 (请选择免费的开发版):

    创建应用创建应用

  3. 进入应用,选择左下角的 设置 > 应用 Key。你可以看到你的 APP ID,APP KeyMaster Key。请记录它们,以便后续使用。

    ID 和 Key

Vercel 部署 (服务端)

Vercelopen in new windowVercel

  1. 点击上方按钮,跳转至 Vercel 进行 Server 端部署。

    如果你未登录的话,Vercel 会让你注册或登录,请使用 GitHub 账户进行快捷登录。

    授权注册时提示Github账户被锁,给 support@vercel.com 发封邮件解封

  2. 输入一个你喜欢的 Vercel 项目名称并点击 Create 继续:

    创建项目

  3. 此时 Vercel 会基于 Waline 模板帮助你新建并初始化仓库,仓库名为你之前输入的项目名。

    deploy

    一两分钟后,满屏的烟花会庆祝你部署成功。此时点击 Go to Dashboard 可以跳转到应用的控制台。

  4. 点击顶部的 Settings - Environment Variables 进入环境变量配置页,并配置三个环境变量 LEAN_ID, LEAN_KEYLEAN_MASTER_KEY 。它们的值分别对应上一步在 LeanCloud 中获得的 APP ID, APP KEY, Master Key

设置环境变量

注 :如果你使用 LeanCloud 国内版,请额外配置 LEAN_SERVER 环境变量,值为你绑定好的域名。

  1. 环境变量配置完成之后点击顶部的 Deployments 点击顶部最新的一次部署右侧的 Redeploy 按钮进行重新部署。该步骤是为了让刚才设置的环境变量生效。

redeploy

  1. 此时会跳转到 Overview 界面开始部署,等待片刻后 STATUS 会变成 Ready。此时请点击 Visit ,即可跳转到部署好的网站地址,此地址即为你的服务端地址。

redeploy success

绑定域名 (可选)

  1. 点击顶部的 Settings - Domains 进入域名配置页

  2. 输入需要绑定的域名并点击 Add

    Add domainAdd domain

  3. 在域名服务器商处添加新的 CNAME 解析记录

    Type Name Value
    CNAME example cname.vercel-dns.com
  4. 等待生效,你可以通过自己的域名来访问了🎉

    • 评论系统:example.yourdomain.com
    • 评论管理:example.yourdomain.com/ui

    success

HTML 引入 (客户端)

在你的网页中进行如下设置:

  1. 导入 Waline 样式 https://unpkg.com/@waline/client@v2/dist/waline.css

  2. 创建 <script> 标签使用来自 https://unpkg.com/@waline/client@v2/dist/waline.mjsinit() 函数初始化,并传入必要的 elserverURL 选项。

    • el 选项是 Waline 渲染使用的元素,你可以设置一个字符串形式的 CSS 选择器或者一个 HTMLElement 对象。
    • serverURL 是服务端的地址,即上一步获取到的值。
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    <head>
    <!-- ... -->
    <link
    rel="stylesheet"
    href="https://unpkg.com/@waline/client@v2/dist/waline.css"
    />
    <!-- ... -->
    </head>
    <body>
    <!-- ... -->
    <div id="waline"></div>
    <script type="module">
    import { init } from 'https://unpkg.com/@waline/client@v2/dist/waline.mjs';

    init({
    el: '#waline',
    serverURL: 'https://your-domain.vercel.app',
    });
    </script>
    </body>
  3. 评论服务此时就会在你的网站上成功运行 🎉

评论管理 (管理端)

  1. 部署完成后,请访问 <serverURL>/ui/register 进行注册。首个注册的人会被设定成管理员。
  2. 管理员登陆后,即可看到评论管理界面。在这里可以修改、标记或删除评论。
  3. 用户也可通过评论框注册账号,登陆后会跳转到自己的档案页。

国内不能访问vercel.app,导致博主现在都还没弄成功,网上搜了一堆,说是要买域名,难受哇😭