listmonk 邮件列表系统升级指南

万宁谨Magnus

于 2025-06-02 09:04:16 发布

阅读量377

点赞数 5

本文链接：https://blog.csdn.net/gitblog_00441/article/details/148375497

版权

listmonk 是一款功能强大的开源邮件列表和通讯管理系统。随着项目的不断迭代更新，用户需要定期升级以获取新功能和安全性改进。本文将详细介绍 listmonk 系统的升级流程、注意事项以及常见问题的解决方案。

重要提示：在执行任何升级操作前，请务必备份您的 PostgreSQL 数据库。这是升级过程中最关键的安全措施，可以防止数据丢失。

备份数据库的常用命令：

pg_dump -h 主机名 -p 端口 -U 用户名 -W 数据库名 > 备份文件名.sql

停止运行中的 listmonk 实例
- 如果作为服务运行：sudo systemctl stop listmonk
- 如果直接运行：pkill -9 listmonk
获取最新版本
- 下载最新版本的 listmonk 二进制文件
- 覆盖旧版本的二进制文件
执行数据库升级
```
./listmonk --upgrade
```
- 此命令会升级数据库架构
- 升级操作是幂等的，多次运行不会有副作用

重新启动服务

./listmonk

或作为服务启动：

sudo systemctl start listmonk

如果遇到权限问题，可能需要：

chmod +x listmonk

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

docker-compose down
docker-compose pull && docker-compose run --rm app ./listmonk --upgrade
docker-compose up -d app db

注意：新版和旧版 docker-compose 文件格式有所不同，请根据您使用的版本选择正确的升级方式。

在某些情况下，您可能需要回滚到之前的版本。以下是标准回滚流程：

恢复升级前的数据库备份

psql -h 127.0.0.1 -p 端口 -U 用户名
drop schema public cascade;
create schema public;
\q
psql -h 127.0.0.1 -p 端口 -U 用户名 -W 数据库名 < 备份文件.sql

v4 是一个重大版本更新，引入了多项重要变更：

多用户支持：v4 首次实现了完整的用户管理系统，取代了之前简单的 BasicAuth 认证方式
登录界面变化：
- 升级后，管理员仪表盘将不再显示浏览器原生登录提示
- 新的登录界面将通过 listmonk 渲染，访问路径为 /admin/login
API 凭证管理：
- 升级后，需要通过"设置 -> 用户"创建专门的 API 用户
- 原有的 TOML 配置文件中的凭证将不再适用于 API 调用
配置清理：
- 升级完成后，建议从配置文件中移除 admin_username 和 admin_password 字段
- 系统会在管理员界面提示这些遗留配置的警告信息