Waline 部署教程：云服务器篇

2026年7月27日·#技术分享宝塔面板/Waline/教程·2875 字 14 分钟

浏览量加载中...

AI 摘要

介绍Waline如何从 Vercel 迁移到腾讯云服务器。

本教程记录了将 Waline 评论系统从 Vercel 迁移到腾讯云服务器的完整过程，使用宝塔面板 + Docker 部署，基于 SQLite 数据库。
适用场景：Vercel 数据库额度用完、想自建服务、需要更灵活的配置。

目录#

一、环境准备
二、安装宝塔面板
三、安装 Docker
四、部署 Waline
五、手动创建数据库表
六、配置 Nginx 反向代理
七、配置 SSL 证书（HTTPS）
八、注册管理员账号
九、配置邮件服务（可选）
十、环境变量参考
十一、常用维护命令
十二、常见问题排查

一、环境准备#

1.1 服务器要求#

项目	最低要求
CPU	1 核
内存	1 GB
带宽	1 Mbps（评论系统数据量小，够用）
系统	Ubuntu 22.04 / CentOS 7+ / OpenCloudOS

1.2 腾讯云安全组 / 防火墙放行端口#

在腾讯云控制台 → 防火墙 / 安全组，放行以下端口：

端口	用途
22	SSH 远程连接
80	HTTP
443	HTTPS
8888	宝塔面板

⚠️ Waline 服务端口 8360 不需要对外开放，通过 Nginx 反向代理即可。

1.3 域名解析#

将你的域名（如 waline.tsh520.cn）A 记录指向服务器公网 IP。

二、安装宝塔面板#

SSH 连接服务器后执行：

1
# Ubuntu / Debian
2
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
3

4
# CentOS
5
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh
6

7
# OpenCloudOS（与 CentOS 兼容）
8
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh

安装完成后会显示：

面板地址：http://你的公网IP:8888/安全入口
用户名 和密码

⚠️ 务必保存好用户名和密码！

首次登录面板后，会提示安装 LNMP 环境套件，点击「跳过」——Waline 是 Node.js 项目，不需要 PHP。

三、安装 Docker#

方式一：宝塔面板安装（推荐）#

宝塔面板 → 软件商店 → 搜索 Docker管理器 → 安装

方式二：手动安装#

1
# Ubuntu / Debian
2
curl -fsSL https://get.docker.com | sh
3
systemctl start docker
4
systemctl enable docker
5

6
# CentOS / OpenCloudOS
7
yum install -y docker
8
systemctl start docker
9
systemctl enable docker

验证安装：

1
docker --version

四、部署 Waline#

4.1 创建目录#

1
mkdir -p /opt/waline/data

4.2 创建 docker-compose.yml#

1
cat > /opt/waline/docker-compose.yml << 'EOF'
2
version: '3'
3

4
services:
5
  waline:
6
    container_name: waline
7
    image: lizheming/waline:latest
8
    restart: always
9
    ports:
10
      - "127.0.0.1:8360:8360"
11
    volumes:
12
      - ./data:/app/data
13
    environment:
14
      TZ: 'Asia/Shanghai'
15
      SQLITE_PATH: '/app/data'
16
      JWT_TOKEN: '替换为你的密钥'
17
      SITE_NAME: '你的网站名称'
18
      SITE_URL: 'https://你的域名'
19
      SECURE_DOMAINS: '你的域名'
20
      AUTHOR_EMAIL: '你的邮箱'
21
EOF

⚠️ 请将以上 JWT_TOKEN、SITE_NAME、SITE_URL、SECURE_DOMAINS、AUTHOR_EMAIL 替换为你自己的值。

配置说明：

变量	说明	示例
`JWT_TOKEN`	JWT 密钥，用于加密 token，建议用复杂字符串	`mySecretKey123!@#`
`SITE_NAME`	网站名称	`团子和蛋糕`
`SITE_URL`	网站地址（带 https）	`https://waline.tsh520.cn`
`SECURE_DOMAINS`	允许的域名（防止跨站请求）	`waline.tsh520.cn`

4.3 启动容器#

1
cd /opt/waline && docker compose up -d

4.4 验证运行#

1
# 查看容器状态
2
docker ps
3

4
# 测试服务是否响应
5
curl http://127.0.0.1:8360

正常情况下应返回 HTML 页面内容。

五、手动创建数据库表#

Waline 使用 SQLite 数据库时，表可能不会自动创建，需要手动建表。

5.1 进入容器#

1
docker exec -it waline sh

5.2 安装 sqlite3#

容器基于 Debian 系统，使用 apt 安装：

1
apt-get update && apt-get install -y sqlite3

5.3 创建数据表#

1
sqlite3 /app/data/waline.sqlite "
2
CREATE TABLE IF NOT EXISTS wl_comment (
3
  id INTEGER PRIMARY KEY AUTOINCREMENT,
4
  user_id INTEGER DEFAULT NULL,
5
  comment TEXT,
6
  insertedAt DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
7
  ip TEXT DEFAULT '',
8
  link TEXT DEFAULT NULL,
9
  mail TEXT DEFAULT NULL,
10
  nick TEXT DEFAULT NULL,
11
  pid INTEGER DEFAULT NULL,
12
  rid INTEGER DEFAULT NULL,
13
  sticky INTEGER DEFAULT NULL,
14
  status TEXT NOT NULL DEFAULT '',
15
  \"like\" INTEGER DEFAULT NULL,
16
  ua TEXT,
17
  url TEXT DEFAULT NULL,
18
  createdAt DATETIME DEFAULT CURRENT_TIMESTAMP,
19
  updatedAt DATETIME DEFAULT CURRENT_TIMESTAMP
20
);
21

22
CREATE TABLE IF NOT EXISTS wl_counter (
23
  id INTEGER PRIMARY KEY AUTOINCREMENT,
24
  time INTEGER DEFAULT NULL,
25
  reaction0 INTEGER DEFAULT NULL,
26
  reaction1 INTEGER DEFAULT NULL,
27
  reaction2 INTEGER DEFAULT NULL,
28
  reaction3 INTEGER DEFAULT NULL,
29
  reaction4 INTEGER DEFAULT NULL,
30
  reaction5 INTEGER DEFAULT NULL,
31
  reaction6 INTEGER DEFAULT NULL,
32
  reaction7 INTEGER DEFAULT NULL,
33
  reaction8 INTEGER DEFAULT NULL,
34
  url TEXT NOT NULL DEFAULT '',
35
  createdAt DATETIME DEFAULT CURRENT_TIMESTAMP,
36
  updatedAt DATETIME DEFAULT CURRENT_TIMESTAMP
37
);
38

39
CREATE TABLE IF NOT EXISTS wl_users (
40
  id INTEGER PRIMARY KEY AUTOINCREMENT,
41
  display_name TEXT NOT NULL DEFAULT '',
42
  email TEXT NOT NULL DEFAULT '',
43
  password TEXT NOT NULL DEFAULT '',
44
  type TEXT NOT NULL DEFAULT '',
45
  label TEXT DEFAULT NULL,
46
  url TEXT DEFAULT NULL,
47
  avatar TEXT DEFAULT NULL,
48
  github TEXT DEFAULT NULL,
49
  twitter TEXT DEFAULT NULL,
50
  facebook TEXT DEFAULT NULL,
51
  google TEXT DEFAULT NULL,
52
  weibo TEXT DEFAULT NULL,
53
  qq TEXT DEFAULT NULL,
54
  oidc TEXT DEFAULT NULL,
55
  huawei TEXT DEFAULT NULL,
56
  \"2fa\" TEXT DEFAULT NULL,
57
  createdAt DATETIME DEFAULT CURRENT_TIMESTAMP,
58
  updatedAt DATETIME DEFAULT CURRENT_TIMESTAMP
59
);
60
"

5.4 退出容器并重启#

1
exit
2
docker restart waline

关于这三张表：

wl_comment：存储评论数据

wl_counter：存储文章访问计数

wl_users：存储用户信息（管理员、评论者）

表名必须是小写：wl_comment、wl_counter、wl_users，不能写成 wl_Comment 或 wl_User。

六、配置 Nginx 反向代理#

6.1 安装 Nginx#

宝塔面板 → 软件商店 → 搜索 Nginx → 安装

6.2 添加站点#

宝塔面板 → 网站 → 添加站点

域名：填你的域名，如 waline.tsh520.cn
PHP 版本：选择 纯静态

6.3 配置反向代理#

点击站点 → 设置 → 反向代理 → 添加反向代理

配置项	值
代理名称	`waline`
目标URL	`http://127.0.0.1:8360`
发送域名	`$host`

6.4 编辑反向代理配置#

点击反向代理的编辑按钮，将配置替换为以下内容：

1
#PROXY-START/
2

3
location ^~ /
4
{
5
    # CORS 预检请求处理
6
    if ($request_method = 'OPTIONS') {
7
        add_header 'Access-Control-Allow-Origin' '$http_origin' always;
8
        add_header 'Access-Control-Allow-Methods' 'GET,POST,PUT,DELETE,OPTIONS' always;
9
        add_header 'Access-Control-Allow-Headers' 'Authorization,Content-Type' always;
10
        add_header 'Access-Control-Max-Age' 1728000 always;
11
        add_header 'Content-Length' 0;
12
        return 204;
13
    }
14

15
    proxy_pass http://127.0.0.1:8360;
16
    proxy_set_header Host $host;
17
    proxy_set_header X-Real-IP $remote_addr;
18
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
19
    proxy_set_header X-Forwarded-Proto $scheme;
20
    proxy_set_header REMOTE-HOST $remote_addr;
21
    proxy_set_header Upgrade $http_upgrade;
22
    proxy_set_header Connection $connection_upgrade;
23
    proxy_http_version 1.1;
24

25
    add_header X-Cache $upstream_cache_status;
26
    add_header 'Access-Control-Allow-Origin' '$http_origin' always;
27
    add_header 'Access-Control-Allow-Methods' 'GET,POST,PUT,DELETE,OPTIONS' always;
28
    add_header 'Access-Control-Allow-Headers' 'Authorization,Content-Type' always;
29

30
    set $static_filew6OwwKmG 0;
31
    if ( $uri ~* "\.(gif|png|jpg|css|js|woff|woff2)$" )
32
    {
33
        set $static_filew6OwwKmG 1;
34
        expires 1m;
35
    }
36
    if ( $static_filew6OwwKmG = 0 )
37
    {
38
        add_header Cache-Control no-cache;
39
    }
40
}
41

42
#PROXY-END/

为什么要加 CORS 配置？
Waline 管理后台（/ui/register、/ui/login）会通过 JavaScript 发送 POST 请求到 API 接口。浏览器会先发送 OPTIONS 预检请求，如果 Nginx 没有正确处理 CORS，浏览器会拦截请求，导致注册/登录时提示 “NetworkError when attempting to fetch resource” 或 “Failed to fetch”。

保存后在服务器上重载 Nginx：

1
nginx -t && nginx -s reload

七、配置 SSL 证书（HTTPS）#

7.1 申请免费证书#

站点设置 → SSL → Let’s Encrypt

选择 文件验证
点击申请

7.2 开启强制 HTTPS#

申请成功后，勾选 强制 HTTPS。

八、注册管理员账号#

8.1 方式一：浏览器注册#

访问 https://你的域名/ui/register，填写邮箱和密码注册。

第一个注册的用户自动成为 管理员。

8.2 方式二：命令行注册（如果浏览器注册失败）#

1
curl -X POST https://你的域名/api/user \
2
  -H "Content-Type: application/json" \
3
  -H "Referer: https://你的域名/ui/register" \
4
  -H "Origin: https://你的域名" \
5
  -d '{"email":"你的邮箱","password":"你的密码","display_name":"你的昵称"}'

返回 {"errno":0,"errmsg":"","data":""} 表示注册成功。

8.3 登录管理后台#

访问 https://你的域名/ui/login，用刚才注册的邮箱和密码登录。

九、配置邮件服务（可选）#

配置邮件服务后可以实现：

用户注册时发送验证邮件
评论通知博主
忘记密码时重置密码

9.1 以 QQ 邮箱为例#

第一步：获取 QQ 邮箱授权码

登录 QQ 邮箱
设置 → 账户 → 往下翻找到 POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务
开启 IMAP/SMTP服务
按提示用手机发短信验证，获取一个 16位授权码

⚠️ 授权码不是 QQ 密码！务必保存好。

第二步：修改 docker-compose.yml

编辑 /opt/waline/docker-compose.yml，在 environment 中添加：

1
      # 邮件配置
2
      SMTP_SERVICE: 'QQ'
3
      SMTP_USER: '你的QQ邮箱'
4
      SMTP_PASS: '你的16位授权码'
5
      SENDER_EMAIL: '你的QQ邮箱'
6
      SENDER_NAME: '你的网站名称'

第三步：重启容器

1
cd /opt/waline && docker compose up -d

9.2 其他邮箱服务商#

服务商	SMTP_SERVICE	SMTP_HOST	SMTP_PORT
QQ 邮箱	`QQ`	`smtp.qq.com`	465
163 邮箱	`163`	`smtp.163.com`	465
Gmail	`Gmail`	`smtp.gmail.com`	465
Outlook	`Outlook`	`smtp.office365.com`	587

如果服务商不在预设列表中，使用 SMTP_HOST + SMTP_PORT + SMTP_SECURE 代替 SMTP_SERVICE：

1
      SMTP_HOST: 'smtp.example.com'
2
      SMTP_PORT: '465'
3
      SMTP_SECURE: 'true'
4
      SMTP_USER: 'your@email.com'
5
      SMTP_PASS: 'your-password'

十、环境变量参考#

基础配置#

变量	说明	必填
`JWT_TOKEN`	JWT 加密密钥	✅
`SITE_NAME`	网站名称	✅
`SITE_URL`	网站地址	✅
`SECURE_DOMAINS`	允许的域名	❌
`AUTHOR_EMAIL`	博主邮箱	❌
`SQLITE_PATH`	SQLite 存储路径	✅（SQLite 模式）

数据库配置#

Waline 支持多种数据库，按优先级（环境变量存在即启用）：

数据库	环境变量
LeanCloud	`LEAN_KEY`
MongoDB	`MONGO_DB` / `MONGO_HOST`
PostgreSQL	`PG_DB` / `PG_HOST`
SQLite	`SQLITE_PATH`
MySQL	`MYSQL_DB` / `MYSQL_HOST`
TiDB	`TIDB_DB` / `TIDB_HOST`
GitHub	`GITHUB_TOKEN`
腾讯云 CloudBase	`TCB_ENV`

邮件配置#

变量	说明
`SMTP_SERVICE`	邮箱服务商（自动配置 host/port）
`SMTP_HOST`	SMTP 服务器地址
`SMTP_PORT`	SMTP 端口
`SMTP_SECURE`	是否 SSL（`true`/`false`）
`SMTP_USER`	登录用户名
`SMTP_PASS`	密码或授权码
`SENDER_EMAIL`	发件人地址
`SENDER_NAME`	发件人名称

通知服务#

变量	说明
`SC_KEY`	Server酱（微信通知）
`TG_BOT_TOKEN`	Telegram Bot Token
`TG_CHAT_ID`	Telegram Chat ID
`QYWX_AM`	企业微信应用
`PUSH_PLUS_KEY`	PushPlus（微信通知）
`DISCORD_WEBHOOK`	Discord Webhook
`LARK_WEBHOOK`	飞书 Webhook
`LARK_SECRET`	飞书签名密钥
`QMSG_KEY`	QQ 消息推送

安全配置#

变量	说明
`RECAPTCHA_V3_SECRET`	Google reCAPTCHA V3
`TURNSTILE_SECRET`	Cloudflare Turnstile

其他配置#

变量	说明
`DISABLE_AUTHOR_NOTIFY`	禁用博主通知
`AVATAR_PROXY`	头像代理地址

十一、常用维护命令#

容器管理#

1
# 查看容器状态
2
docker ps
3

4
# 查看日志
5
docker logs waline
6
docker logs waline --tail 100       # 最近 100 行
7

8
# 重启容器
9
docker restart waline
10

11
# 停止容器
12
docker stop waline
13

14
# 启动容器
15
docker start waline

更新 Waline 版本#

1
cd /opt/waline
2
docker compose pull                  # 拉取最新镜像
3
docker compose up -d                 # 重建容器

数据备份#

1
# 备份 SQLite 数据库
2
cp /opt/waline/data/waline.sqlite /opt/waline/backup/waline-$(date +%Y%m%d).sqlite
3

4
# 创建自动备份脚本
5
cat > /opt/waline/backup.sh << 'EOF'
6
#!/bin/bash
7
BACKUP_DIR="/opt/waline/backup"
8
mkdir -p $BACKUP_DIR
9
cp /opt/waline/data/waline.sqlite $BACKUP_DIR/waline-$(date +%Y%m%d_%H%M%S).sqlite
10
# 保留最近 30 天的备份
11
find $BACKUP_DIR -name "*.sqlite" -mtime +30 -delete
12
EOF
13

14
chmod +x /opt/waline/backup.sh
15

16
# 添加定时任务（每天凌晨 3 点备份）
17
echo "0 3 * * * /opt/waline/backup.sh" | crontab -

Nginx 管理#

1
# 测试配置
2
nginx -t
3

4
# 重载配置
5
nginx -s reload
6

7
# 查看错误日志
8
tail -f /www/wwwlogs/waline.tsh520.cn.error.log

添加 / 修改环境变量#

1
# 1. 编辑配置文件
2
vi /opt/waline/docker-compose.yml
3

4
# 2. 在 environment 下添加新变量
5
#    格式：变量名: '值'
6

7
# 3. 重启容器
8
cd /opt/waline && docker compose up -d
9

10
# 4. 验证变量是否生效
11
docker exec waline env | grep 变量名

十二、常见问题排查#

12.1 评论时提示 “no such table: wl_Comment”#

原因：数据库表未创建或表名大小写不对。

解决：按本文第五节手动创建数据库表。注意表名必须是小写：wl_comment、wl_users、wl_counter。

12.2 注册时提示 “NetworkError when attempting to fetch resource” 或 “Failed to fetch”#

原因：Nginx 反向代理没有正确处理 CORS（跨域请求）。

解决：按本文第六节编辑反向代理配置，添加 CORS 处理。

12.3 注册时返回 `{"errno":403,"errmsg":"Forbidden"}`#

原因：请求缺少 Referer 或 Origin 头，Waline 的安全检查拒绝了请求。

解决：

浏览器访问应该自动带 Referer，检查是否被浏览器插件拦截

命令行注册需要手动添加头：

1
-H "Referer: https://你的域名/ui/register"
2
-H "Origin: https://你的域名"

12.4 重置密码邮件发送失败#

原因：未配置邮件服务。

解决：按本文第九节配置 SMTP 环境变量。

12.5 容器启动失败#

1
# 查看详细错误
2
docker logs waline
3

4
# 检查端口是否被占用
5
netstat -tlnp | grep 8360

12.6 如何切换到 MySQL / PostgreSQL#

修改 docker-compose.yml，去掉 SQLITE_PATH，添加数据库连接信息：

MySQL 示例：

1
      MYSQL_HOST: '你的数据库地址'
2
      MYSQL_PORT: '3306'
3
      MYSQL_DB: 'waline'
4
      MYSQL_USER: '用户名'
5
      MYSQL_PASSWORD: '密码'

PostgreSQL 示例：

1
      PG_HOST: '你的数据库地址'
2
      PG_PORT: '5432'
3
      PG_DB: 'waline'
4
      PG_USER: '用户名'
5
      PG_PASSWORD: '密码'

⚠️ 切换数据库后，评论数据不会自动迁移。需要手动导出再导入。

完整 docker-compose.yml 示例#

1
version: '3'
2

3
services:
4
  waline:
5
    container_name: waline
6
    image: lizheming/waline:latest
7
    restart: always
8
    ports:
9
      - "127.0.0.1:8360:8360"
10
    volumes:
11
      - ./data:/app/data
12
    environment:
13
      TZ: 'Asia/Shanghai'
14
      SQLITE_PATH: '/app/data'
15
      JWT_TOKEN: '你的JWT密钥'
16
      SITE_NAME: '你的网站名称'
17
      SITE_URL: 'https://你的域名'
18
      SECURE_DOMAINS: '你的域名'
19
      AUTHOR_EMAIL: '你的邮箱'
20
      # 邮件通知（可选）
21
      SMTP_SERVICE: 'QQ'
22
      SMTP_USER: '你的QQ邮箱'
23
      SMTP_PASS: '你的16位授权码'
24
      SENDER_EMAIL: '你的QQ邮箱'
25
      SENDER_NAME: '你的网站名称'
26
      # 微信通知（可选，二选一）
27
      # SC_KEY: '你的Server酱Key'
28
      # PUSH_PLUS_KEY: '你的PushPlus Key'
29
      # Telegram 通知（可选）
30
      # TG_BOT_TOKEN: '你的Bot Token'
31
      # TG_CHAT_ID: '你的Chat ID'

参考链接#

Waline 评论系统自动备份到 GitHub

Meting-API-使用指南

评论区

[ 标签 ]

# AI2 # AI 编程2 # AI工具1 # Ajax2 # Apifox1 # Astro2 # CC Switch1 # CDN2 # Claude Code1 # claudecode2 # ClaudeCode1 # CloudFlare2 # Cloudflare1 # coc3 # CSS6 # DeepSeek2 # DELETE1 # EdgeOne3 # Gist1 # GitHub1 # hexo-circle-of-friends1 # HTML6 # HTTP2 # Java23 # java13 # JavaScript5 # JDBC3 # JSON1 # JUnit1 # Logback1 # Maven6 # Mybatis1 # MyBatis4 # MySQL6 # MySql1 # Obsidian1 # OpenCode3 # ORM1 # PathVariable1 # PicGo1 # py2 # RequestBody1 # RequestMapping1 # RESTful风格1 # skills1 # Slf4j1 # SpringBoot11 # SQL2 # Svelte2 # TailwindCSS1 # Telegram2 # Tlias2 # Vercel1 # Vue7 # Waline3 # WebDAV1 # Web基础6 # WinSCP1 # YAML1 # 三层架构1 # 使用文档9 # 刷步数1 # 前端32 # 动漫1 # 单词1 # 博客5 # 博客开发2 # 参数接收1 # 友链1 # 反思2 # 图床3 # 地图1 # 备份1 # 奇思妙想1 # 存储1 # 学习方法1 # 宝塔面板3 # 宝宝6 # 导航栏1 # 工具2 # 开发1 # 开发规范1 # 开心1 # 影视1 # 性能优化2 # 总结1 # 想法5 # 感悟6 # 指南1 # 教程6 # 数据库10 # 斩神1 # 日常44 # 日志框架1 # 朋友圈1 # 朱元璋1 # 测试1 # 游戏1 # 生活迁移1 # 电影1 # 碎碎念1 # 视觉识别1 # 网络教室1 # 羊毛1 # 脚本1 # 脚本工具1 # 自动化1 # 蓝奏云1 # 订阅推荐1 # 记录1 # 评论系统1 # 词根1 # 词缀1 # 说说1 # 足迹1 # 跑步2 # 路径参数1 # 转载1 # 运动1 # 部落冲突1 # 配置1 # 音乐3 # 音标1 # 饮食1 # 驼峰命名1 # 高德地图1

[ 分类 ]

# 编程学习63 # 技术分享16 # 博客指南12 # 英语笔记本5 # AI使用4 # python2 # 羊毛分享1 # 资源整理1

[ 公告 ]

如果你喜欢，那么欢迎来到我的世界！

了解更多

[ 音乐 ]

找不到相关结果。

[ contents ]

[ 全部文章 ]

团子和蛋糕

Waline 部署教程：云服务器篇

Waline 部署教程：云服务器篇

目录#

一、环境准备#

1.1 服务器要求#

1.2 腾讯云安全组 / 防火墙放行端口#

1.3 域名解析#

二、安装宝塔面板#

三、安装 Docker#

方式一：宝塔面板安装（推荐）#

方式二：手动安装#

四、部署 Waline#

4.1 创建目录#

4.2 创建 docker-compose.yml#

4.3 启动容器#

4.4 验证运行#

五、手动创建数据库表#

5.1 进入容器#

5.2 安装 sqlite3#

5.3 创建数据表#

5.4 退出容器并重启#

六、配置 Nginx 反向代理#

6.1 安装 Nginx#

6.2 添加站点#

6.3 配置反向代理#

6.4 编辑反向代理配置#

七、配置 SSL 证书（HTTPS）#

7.1 申请免费证书#

7.2 开启强制 HTTPS#

八、注册管理员账号#

8.1 方式一：浏览器注册#

8.2 方式二：命令行注册（如果浏览器注册失败）#

8.3 登录管理后台#

九、配置邮件服务（可选）#

9.1 以 QQ 邮箱为例#

9.2 其他邮箱服务商#

十、环境变量参考#

基础配置#

数据库配置#

邮件配置#

通知服务#

安全配置#

其他配置#

十一、常用维护命令#

容器管理#

更新 Waline 版本#

数据备份#

Nginx 管理#

添加 / 修改环境变量#

十二、常见问题排查#

12.1 评论时提示 “no such table: wl_Comment”#

12.2 注册时提示 “NetworkError when attempting to fetch resource” 或 “Failed to fetch”#

12.3 注册时返回 {"errno":403,"errmsg":"Forbidden"}#

12.4 重置密码邮件发送失败#

12.5 容器启动失败#

12.6 如何切换到 MySQL / PostgreSQL#

完整 docker-compose.yml 示例#

参考链接#

相关阅读

评论区

音乐

12.3 注册时返回 `{"errno":403,"errmsg":"Forbidden"}`#