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

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

listmonk High performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app. 项目地址: https://gitcode.com/gh_mirrors/li/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 作为一款功能强大的邮件列表系统，能够满足从个人到中小企业的各种邮件营销需求。

listmonk High performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app. 项目地址: https://gitcode.com/gh_mirrors/li/listmonk