Plausible社区版数据迁移指南：从旧版本平滑升级

背景概述

Plausible作为一款轻量级网站分析工具，其社区版与旧版本在架构上存在一定差异。当用户需要从旧版迁移至社区版时，需特别注意数据兼容性和服务配置调整。本文将以典型Docker Compose部署场景为例，详解迁移过程中的关键步骤和技术要点。

核心迁移步骤

1. 镜像版本升级

原部署使用plausible/analytics:latest和clickhouse/clickhouse-server:22.6-alpine镜像，需替换为社区版推荐镜像：

• 主服务镜像更新至社区版最新稳定版本
• ClickHouse升级至22.6以上兼容版本（社区版已优化配置）

2. 服务架构调整

旧版中的独立邮件服务(bytemark/smtp)在社区版中已废弃，相关功能整合至主服务：

• 移除mail服务定义
• 原邮件配置参数需转移至主服务环境变量
• SMTP相关配置应直接在plausible-conf.env中设置

3. 数据卷处理

原有数据卷可保持挂载不变：

• PostgreSQL数据卷(db-data)保持原路径
• ClickHouse数据卷(event-data)继续使用
• 注意检查社区版对数据库结构的变更要求

迁移操作实践

1. 备份现有数据

   • 对PostgreSQL执行pg_dump全量备份
   • 备份ClickHouse数据目录
   • 导出当前环境变量配置

2. 修改docker-compose.yml

   services:
     plausible:
       image: plausible/community-edition:latest  # 改为社区版镜像
       # 移除mail服务依赖
       depends_on:
         - plausible_db
         - plausible_events_db
   

3. 环境变量迁移 将原邮件服务的配置参数转移到plausible-conf.env：

   MAILER_EMAIL=[e-mail]
   SMTP_HOST_ADDR=mailserer.mydomian.com
   SMTP_USER_NAME=[e-mail]
   

4. 启动验证

   docker-compose down
   docker-compose pull
   docker-compose up -d
   

注意事项

1. 版本兼容性

   • 建议先在测试环境验证迁移流程
   • 大版本升级可能涉及数据库schema变更

2. 监控建议

   • 迁移后密切观察数据收集是否正常
   • 检查定时任务（如报表发送）是否正常运行

3. 性能优化

   • 社区版对ClickHouse配置有默认优化
   • 可根据硬件配置调整ulimits参数

结语

通过上述步骤，用户可完成从Plausible旧版到社区版的无缝迁移。整个过程中最关键的是确保数据卷的完整性和环境变量的正确转移。社区版在架构上更为精简，同时保持了与旧版数据的良好兼容性，使得迁移过程相对平滑。建议用户在业务低峰期执行迁移操作，并做好完备的备份方案。