listmonk 开源邮件列表系统安装指南

listmonk 是一款高性能、开源的邮件列表和通讯管理系统，采用 Go 语言开发，具有轻量级、易部署的特点。本文将详细介绍 listmonk 的多种安装方式，帮助您快速搭建自己的邮件列表系统。

系统要求

在开始安装前，请确保您的环境满足以下基本要求：

• 数据库：PostgreSQL 12 或更高版本
• 操作系统：支持 Linux、macOS 和 Windows
• 内存：建议至少 1GB 可用内存
• 存储空间：根据邮件列表规模而定，建议至少 10GB

二进制安装方式

二进制安装是最简单直接的部署方式，适合大多数 Linux 服务器环境。

1. 下载二进制文件

首先需要下载最新版本的 listmonk 二进制文件。根据您的 CPU 架构选择合适的版本（amd64 适用于大多数 Intel 和 AMD 处理器）。

2. 生成配置文件

解压下载的文件后，执行以下命令生成默认配置文件：

./listmonk --new-config

这将在当前目录下生成 config.toml 文件，您需要编辑此文件配置数据库连接等参数。

3. 初始化数据库

配置好数据库连接信息后，执行安装命令初始化数据库表结构：

./listmonk --install

专业提示：可以通过环境变量预设管理员账号：

LISTMONK_ADMIN_USER=admin LISTMONK_ADMIN_PASSWORD=yourpassword ./listmonk --install

4. 启动服务

完成安装后，直接运行二进制文件启动服务：

./listmonk

默认情况下，服务会监听 9000 端口，您可以通过浏览器访问 http://localhost:9000 进入管理界面。

Docker 容器化部署

Docker 部署方式更加便捷，特别适合需要快速部署或测试环境的用户。

1. 准备 docker-compose 文件

首先需要获取官方提供的 docker-compose.yml 文件，该文件已经配置好了 listmonk 和 PostgreSQL 服务。

2. 启动容器

使用以下命令启动所有服务：

docker compose up -d

专业提示：首次启动时可以通过环境变量设置管理员账号：

LISTMONK_ADMIN_USER=admin LISTMONK_ADMIN_PASSWORD=yourpassword docker compose up -d

3. 自定义配置

如果需要使用自定义配置文件，可以按照以下步骤操作：

1. 创建 config.toml 文件并配置必要参数
2. 修改 docker-compose.yml，添加卷挂载配置
3. 更新启动命令指向自定义配置文件路径

从源代码编译

对于开发者或需要定制功能的用户，可以从源代码编译 listmonk。

编译环境准备

需要安装以下工具：

• Go 语言环境（1.16+）
• Node.js 和 Yarn（用于前端构建）

编译步骤

1. 克隆源代码仓库
2. 进入项目目录执行 make dist 命令
3. 编译完成后会在目录下生成可执行文件

Kubernetes 部署

对于生产环境，可以使用 Helm Chart 在 Kubernetes 集群中部署 listmonk。

部署步骤

1. 准备 values.yaml 配置文件
2. 使用 Helm 命令部署：

helm upgrade --install listmonk --namespace listmonk --values values.yaml

生产环境建议

1. 数据库优化：对于大型邮件列表，建议对 PostgreSQL 进行性能调优
2. 反向代理：建议使用 Nginx 或 Apache 作为反向代理，并配置 SSL
3. 备份策略：定期备份数据库和配置文件
4. 监控：设置适当的监控告警机制

常见问题解答

Q：listmonk 支持哪些邮件发送服务？ A：listmonk 支持 SMTP 协议，可以与大多数邮件服务（如 SendGrid、Mailgun、Amazon SES 等）集成。

Q：如何升级 listmonk？ A：二进制方式只需替换二进制文件并重启服务；Docker 方式更新镜像版本即可。

Q：listmonk 支持多租户吗？ A：目前 listmonk 是单租户设计，每个实例只能服务一个组织。

通过本文介绍的多种安装方式，您可以根据实际需求选择最适合的部署方案。listmonk 作为一款功能强大的邮件列表系统，能够满足从个人到中小企业的各种邮件营销需求。