使用宝塔Docker从零部署Waline

站长在为博客的评论系统选择时，发现了 Waline 这个易上手的评论系统。

经过一段时间的使用，站长认为它还不赖，但是安装过程有些复杂，于是本篇文章便应运而生。

说明

本章书写与 2026-09-06，所使用宝塔面板版本为 13.0.0，Docker 版本为 26.1.3，若您使用的版本不同，请自行查阅相关文档。新手推荐使用MySQL数据库，若您使用的是其他数据库，请自行查阅相关文档。

选择 Waline 的理由是?#

快速

真·安全

Markdown 语法支持

轻量易用

免费部署

多种部署部署方式和存储服务支持，每列选择一项多达 243 种部署方式任君选择

Waline 是一款从 Valine 衍生的带后端评论系统。其作者的设计初衷是解决 Valine 的不开源、XSS 漏洞、隐私泄露、数据篡改等问题。

基于以上原因，Waline 横空出世了。Waline 最初的目标仅仅是为 Valine 增加上服务端中间层，但是由于 Valine 的不开源所以只能连带前端也实现一遍。当然前端的很多代码和逻辑为了和 Valine 的配置保持一致都有参考 Valine。甚至在名字上，我也是从 Valine 上衍生的，让大家能明白这个项目是 Valine 的衍生版。增加了服务端除了解决了上述的安全问题，之前 Valine 受限于无服务端的很多功能也可以实现了。包括但不限于邮件通知、垃圾评论过滤等。

环境准备#

安装宝塔面板#

注意

请确认您的服务器是干净的，未安装过宝塔面板。若已安装过宝塔面板，请自行卸载后再执行以下命令。您服务器造成的任何损失本站概不负责，请谨慎操作。建议在虚拟机中测试，确认无误后再在正式服务器上操作。

打开您的服务器SSH终端，执行以下命令安装宝塔面板：

1
if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh KZOqff1mn

创建 Waline Docker 项目#

安装 Waline

点击面板左侧 Docker，再点击上方 容器编排，点击页面中的 添加容器编排，编排名称 自行填写，Compose 填写以下内容：

1
services:
2
waline:
3
    container_name: waline
4
    image: lizheming/waline:latest
5
    restart: always
6
    ports:
7
    - 8360:8360
8
    volumes:
9
    - ${PWD}/data:/app/data
10
    environment:
11
    TZ: 'Asia/Shanghai'
12
    MYSQL_DB: 'DB' #MySQL 数据库名
13
    MYSQL_USER: 'DBUSER' #MySQL 用户名
14
    MYSQL_PASSWORD: 'DBPASS' #MySQL 密码
15
    MYSQL_HOST: '172.17.0.1' #MySQL 主机地址
16
    SITE_URL: 'https://www.yourdomain.com' #站点URL
17
    SECURE_DOMAINS: 'yourdomain.com' #安全域名

注意

请将 MYSQL_DB、MYSQL_USER、MYSQL_PASSWORD、MYSQL_HOST、SITE_URL、SECURE_DOMAINS 替换为您自己的信息。

完成 Waline 基础配置
1. 点击页面 启动，等待容器启动完成。
2. 点击上方 网站，再点击页面中的 创建，选择 反代容器，域名 自行填写，容器 填写您的 waline 容器，再选择您的端口，点击 确认。
3. 将您的域名解析到您的服务器IP，等待解析生效。

对接 Waline 评论系统

以本博客为例，配置页内容如下：

1
waline: {
2
  // waline 后端服务地址
3
  serverURL: "https://www.yourdomain.com/",
4
  // 设置 Waline 评论系统语言
5
  lang: "zh-CN",
6
  // 设置 Waline 评论系统表情地址
7
  emoji: [
8
    "https://unpkg.com/@waline/emojis@1.4.0/weibo",
9
    "https://unpkg.com/@waline/emojis@1.4.0/bilibili",
10
    "https://unpkg.com/@waline/emojis@1.4.0/bmoji",
11
  ],
12
  // 评论登录模式。可选值如下：
13
  //   'enable'   —— 默认，允许访客匿名评论和用第三方 OAuth 登录评论，兼容性最佳。
14
  //   'force'    —— 强制必须登录后才能评论，适合严格社区，关闭匿名评论。
15
  //   'disable'  —— 禁止所有登录和 OAuth，仅允许匿名评论（填写昵称/邮箱），适用于极简留言。
16
  login: "enable",
17
  // 是否启用文章访问量统计功能
18
  visitorCount: true,
19
}

将 serverURL 替换为您自己的域名，其他配置根据您的需求自行修改。点击跳转至 Waline 官方文档查看更多配置项。

音乐

音乐