Waline · 简洁带后端支持的评论系统｜Vercel/CloudBase/Docker 多端部署与使用全指南

项目仓库： https://github.com/walinejs/waline

开源协议：GPL-2.0 · 定位：简单、安全、快速的评论系统 · 客户端：@waline/client · 服务端：Vercel / CloudBase / 百度 CFC / 阿里 FC / Railway / Render / Zeabur / Netlify / Docker / 自托管 · 存储：PostgreSQL / MySQL / SQLite / TiDB / MongoDB / CloudBase / GitHub

1 项目简介

Waline 是一个简单、带后端支持的评论系统：快速、真正安全、支持完整 Markdown 语法、简单轻量，且可免费部署。官方提供至少 243 种部署组合：客户端（@waline/client、MiniValine、sodesu）× 服务端（Vercel、CloudBase、各家云函数、Docker、自托管）× 存储（多种数据库 / GitHub）。

1.1 核心信息一览

1.2 适用场景

• 静态博客 / 文档站接入评论系统，且希望评论数据存自己可控的数据库。
• 想免费部署（Vercel / CloudBase 等），也可 Docker 自托管。

1.3 能力边界（官方口径）

• 已完成：邮件 / 微信 / QQ / Telegram 通知、Akismet、文章计数、i18n、登录、评论管理、删评、更多数据库、IP 频率限制、关键词限制、IP 黑名单、重复检测、CloudBase 部署、社交登录、置顶评论、评论点赞。
• 待做：AWS / GCP / Azure 部署支持。

2 功能特性

• 快速、真正安全、完整 Markdown、轻量。
• 多部署组合：至少 243 种客户端 × 服务端 × 存储组合。
• 丰富通知：邮件 / 微信 / QQ / Telegram；Akismet 反垃圾。
• 管理能力：评论管理、删评、置顶、点赞、社交登录。
• 防护：IP 频率限制、关键词限制、IP 黑名单、重复内容检查。

3 官方界面预览

开头封面为 Waline 官方 Logo。评论框嵌入文章页，支持 Markdown、表情与通知。

4 官方跳转链接汇总

5 前置要求与服务器配置

5.1 软件前提

• 任选服务端：Vercel / CloudBase / 云函数 / Docker / 自托管。
• 一个受支持的数据库（PostgreSQL / MySQL / SQLite / MongoDB / CloudBase 等）。

5.2 硬件建议

• Docker 自托管用普通 VPS；Serverless 方式无需自备服务器。

5.3 端口与资源

• 自托管服务端暴露 HTTP 端口；客户端以 JS 嵌入网站。

6 方式一：Vercel / CloudBase 免费部署（推荐快速上手）

按官方文档，用 Vercel 或腾讯云 CloudBase 一键部署服务端，并在博客中引入 @waline/client。

7 方式二：Docker / 自托管

按官方文档用 Docker 部署服务端并连接数据库，客户端指向自托管地址。

8 配置项说明

• 服务端环境变量配置数据库连接、通知渠道（邮件 / 微信 / QQ / Telegram）、Akismet key。
• 客户端初始化时指定服务端地址与占位符等选项。

9 常用运维命令

• 自托管：容器启停与日志；升级按官方文档。

10 常见故障排查

• 查官方文档与 Discussions。

11 风险与合规说明

• 许可证：GPL-2.0。
• 本文整理自官方 README，命令以官方文档最新说明为准；不包含 star 数等动态数据。