Docker部署Waline评论系统 (SQLite版)

目录结构#

1
~/docker/waline/
2
├── docker-compose.yml
3
└── data/            # 自动挂载的数据目录

配置文件 (docker-compose.yml)#

1
version: '3'
2

3
services:
4
  waline:
5
    image: lizheming/waline:latest
6
    container_name: waline
7
    restart: always
8
    ports:
9
      - "8360:8360"
10
    volumes:
11
      # 挂载数据目录
12
      - ./data:/app/data
13
    environment:
14
      # --- 数据库配置 (关键点) ---
15
      - SQLITE_PATH=/app/data/
16

17
      # --- 安全配置 ---
18
      # 建议使用单引号，防止特殊字符（如%）被Shell误读
19
      - JWT_TOKEN='Your_Long_Secure_Random_String_2026'
20

21
      # --- 基础配置 ---
22
      - TZ=Asia/Tokyo
23
      # 安全域名白名单
24
      # 只有来自这些域名的请求才会被允许，其他域名引用会报错
25
      - SECURE_DOMAINS=blog.jcaonet.com,localhost,127.0.0.1

注意：启动命令为 docker-compose up -d。

坑位一：生成的 waline.sqlite 是 0kb，无法写入表#

现象： 容器启动看似正常，但查看日志报错 SQLITE_ERROR: no such table: wl_Comment。检查本地 data 目录，发现 waline.sqlite 文件大小为 0kb。 问AI，结果AI一直在说是数据库文件必须指定到具体的文件名，不能只写目录！【SQLITE_PATH=/app/data/waline.sqlite】

原因： 被AI坑的极为惨烈，照着AI做的话 无论如何都是会生成一个【waline.sqlite】文件夹 而不是文件。

解决方法：

1. 删除坏文件：手动删除那个 0kb 的文件或者文件夹。

   1
   sudo rm data/waline.sqlite
   2
   docker-compose down && docker-compose up -d

2. 下载文件：必须直接去https://github.com/walinejs/waline/blob/main/assets/waline.sqlite下载waline.sqlite文件 放入SQLITE_PATH里面

坑位二：换个网络/电脑登录，提示“密码错误”#

现象： 在公司电脑注册好管理员账号，回家用家里电脑登录，死活提示密码错误。Waline 并没有 IP 锁定的功能，这很不科学。

原因：

1. JWT_TOKEN里面写了个【%】，特殊字符可能每次解析的结果不一致。
2. 如果在 docker-compose.yml 里变量名写错（或者没写死），Waline 每次重启或在不同环境下可能会生成临时的 Key。
3. Key 变了，密码的哈希值就对不上了。

解决方法： 确保JWT_TOKEN其值是一个固定的、用单引号包裹的字符串（防止 YAML 解析特殊字符）。

坑位三：403 Forbidden 与 Cloudflare 页面规则#

现象： 由于使用了 Cloudflare Tunnel，为了防止别人直接访问后端首页，我在 Cloudflare 设置了页面重定向规则。结果导致博客前端发评论、更新头像时报 403 Forbidden。

原因： 我的规则写成了 XXX.com*（带了星号），这把 API 请求（/api/comment）也给拦截重定向了。

正确的 Cloudflare Page Rule：

• URL: XXX.com/ (注意末尾斜杠，且不要加星号)
• Setting: Forwarding URL (301) -> https://blog.jcaonet.com/

坑位四：头像显示 “React blocked…” 或裂图#

现象： 在个人资料里填入本地路径 /home/jcao/images/me.jpg，报错被拦截；填入 Pixiv 外链，显示裂图 (403)。

原因：

1. 浏览器处于安全考虑，禁止网页直接读取本地硬盘文件。
2. Pixiv 等网站有防盗链机制，不允许第三方网站引用图片。

解决方法： 将头像放在博客项目的 public/assets 目录下，部署后使用博客的公网 URL。