终极指南：listmonk CI/CD环境变量注入的5种方法对比与实践

listmonk是一款高性能、自托管的新闻通讯和邮件列表管理工具，具有现代化的仪表板界面，采用单二进制应用形式部署。本文将深入探讨在CI/CD流程中为listmonk注入环境变量的多种方法，帮助开发者选择最适合自己项目的方案。## 为什么环境变量注入对listmonk至关重要？环境变量是配置listmonk的关键方式，它允许你在不修改代码的情况下调整应用行为。特别是在CI/CD流程中，安全

翟萌耘Ralph

338人浏览 · 2026-02-03 03:19:30

翟萌耘Ralph · 2026-02-03 03:19:30 发布

终极指南：listmonk CI/CD环境变量注入的5种方法对比与实践

【免费下载链接】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是一款高性能、自托管的新闻通讯和邮件列表管理工具，具有现代化的仪表板界面，采用单二进制应用形式部署。本文将深入探讨在CI/CD流程中为listmonk注入环境变量的多种方法，帮助开发者选择最适合自己项目的方案。

为什么环境变量注入对listmonk至关重要？

环境变量是配置listmonk的关键方式，它允许你在不修改代码的情况下调整应用行为。特别是在CI/CD流程中，安全地管理数据库连接、API密钥和其他敏感信息至关重要。listmonk支持多种环境变量注入方式，每种方式都有其适用场景和优缺点。

图1：listmonk的SMTP配置界面，展示了环境变量在应用中的实际效果

方法一：Docker Compose环境变量注入

Docker Compose是本地开发和测试的常用工具，listmonk提供了完整的docker-compose.yml配置文件，支持直接在配置中定义环境变量。

version: '3.8'

services:
  app:
    image: listmonk/listmonk:latest
    environment:
      - LISTMONK_APP_ENV=production
      - LISTMONK_DB_HOST=db
      - LISTMONK_DB_PORT=5432
      - LISTMONK_DB_USER=listmonk
      - LISTMONK_DB_PASSWORD=${DB_PASSWORD}
      - LISTMONK_DB_NAME=listmonk
    depends_on:
      - db

优势：配置简单直观，适合本地开发和小型部署
局限：敏感信息直接暴露在配置文件中，不适合生产环境
适用场景：开发环境、测试环境

相关配置文件路径：docker-compose.yml

方法二：环境变量文件注入

对于生产环境，推荐使用.env文件配合Docker Compose，将敏感信息与配置文件分离。listmonk支持通过--env-file参数加载环境变量文件。

# 命令示例
docker-compose --env-file .env.prod up -d

# .env.prod文件内容
LISTMONK_APP_ENV=production
LISTMONK_DB_HOST=db.example.com
LISTMONK_DB_PORT=5432
LISTMONK_DB_USER=listmonk
LISTMONK_DB_PASSWORD=strong_password_here
LISTMONK_DB_NAME=listmonk

优势：敏感信息与配置分离，便于版本控制
局限：需要确保.env文件安全存储，不被提交到代码仓库
适用场景：生产环境、预发布环境

方法三：Docker Entrypoint脚本注入

listmonk提供了docker-entrypoint.sh脚本，支持在容器启动时动态注入环境变量。这种方式特别适合需要在启动过程中动态生成配置的场景。

#!/bin/sh
set -e

# 从环境变量生成配置文件
envsubst < /etc/listmonk/config.toml.sample > /etc/listmonk/config.toml

# 启动应用
exec ./listmonk --config /etc/listmonk/config.toml

优势：支持复杂的配置生成逻辑，适合动态环境
局限：需要理解entrypoint脚本逻辑，修改有一定门槛
适用场景：复杂部署环境、动态配置需求

相关文件路径：docker-entrypoint.sh

方法四：CI/CD管道变量注入

大多数CI/CD平台（如GitLab CI、GitHub Actions、Jenkins）都提供了安全的环境变量管理功能。以GitLab CI为例，可以在.gitlab-ci.yml中配置环境变量：

deploy:
  stage: deploy
  image: docker:latest
  services:
    - docker:dind
  variables:
    DOCKER_DRIVER: overlay2
  script:
    - docker-compose build
    - docker-compose up -d
  environment:
    name: production
    url: https://listmonk.example.com
  only:
    - main

在GitLab项目设置中配置环境变量，这些变量会安全地传递到CI/CD管道中，不会暴露在代码中。

优势：安全管理敏感信息，与CI/CD流程紧密集成
局限：依赖CI/CD平台功能，迁移成本可能较高
适用场景：自动化部署流程、团队协作开发

方法五：Kubernetes配置注入

对于Kubernetes部署，listmonk可以通过ConfigMap和Secret资源注入环境变量：

apiVersion: v1
kind: Secret
metadata:
  name: listmonk-secrets
type: Opaque
data:
  db-password: c3Ryb25nX3Bhc3N3b3JkX2hlcmUK # base64编码的密码
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: listmonk
spec:
  replicas: 1
  template:
    spec:
      containers:
      - name: listmonk
        image: listmonk/listmonk:latest
        env:
        - name: LISTMONK_DB_PASSWORD
          valueFrom:
            secretKeyRef:
              name: listmonk-secrets
              key: db-password

优势：适合大规模部署，支持动态更新配置
局限：需要Kubernetes知识，配置复杂度较高
适用场景：企业级部署、大规模集群环境

图2：合理配置环境变量可以优化listmonk性能，提升邮件发送效率

五种环境变量注入方法对比

注入方法	安全级别	配置复杂度	适用环境	维护成本
Docker Compose直接注入	低	低	开发环境	低
环境变量文件	中	低	生产环境	中
Entrypoint脚本	中	中	复杂部署	中
CI/CD管道变量	高	中	自动化部署	低
Kubernetes配置	高	高	企业级部署	高