linkyard/postal

Postal Docker镜像

本Docker镜像基于https://hub.docker.com/_/ruby/%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%BD%BF%E7%94%A8aTech Media发布的包，专为Kubernetes环境设计。

Postal以用户postal（UID 20000、GID 20000）运行，暴露端口25（SMTP服务）和5000（Web UI）。日志同时输出到标准输出和/opt/postal/log目录（按Postal默认规则轮转）。

配置说明

镜像通过多源合并生成Postal配置文件，优先级顺序为：

1. Postal默认配置 /opt/postal/app/config/postal.example.yml
2. 内置默认配置 default-config.yml
3. USER_CONFIG_PATH挂载的用户配置文件（可选）
4. 环境变量转换的配置项

必要环境变量

• MARIADB_HOST：MariaDB数据库主机
• MARIADB_USER：MariaDB用户名
• MARIADB_PASSWORD：MariaDB密码
• RABBITMQ_HOST：RabbitMQ主机
• RABBITMQ_USER：RabbitMQ用户名
• RABBITMQ_PASSWORD：RabbitMQ密码
• RAILS_SECRET_KEY：Rails秘钥（可通过openssl rand -hex 256生成）
• SIGNING_KEY：Base64编码的DKIM签名私钥
• LETS_ENCRYPT_KEY：Base64编码的Let's Encrypt证书私钥

可选环境变量

• USER_CONFIG_PATH：非机密配置文件路径（如DNS记录）
• SMTP_USER：SMTP服务用户名
• SMTP_PASSWORD：SMTP服务密码

密钥生成示例

bash
# 生成DKIM或Let's Encrypt密钥
KEYNAME=signing_key # 替换为lets_encrypt_key
KEYLENGTH=2048 # 1024适用于短签名场景

openssl genpkey -algorithm RSA -out ${KEYNAME}.pem -pkeyopt rsa_keygen_bits:${KEYLENGTH}
echo -e "\n$(echo ${KEYNAME} | tr a-z A-Z)=$(openssl enc -base64 -A -in ${KEYNAME}.pem)\n"

额外配置

覆盖DNS服务器

在配置的general section添加自定义DNS服务器：

yaml
general:
  nameservers:
    - "8.8.8.8"
    - "8.8.4.4"

启动流程

1. 检查MariaDB可用性，失败则退出（状态码1）
2. 创建postal数据库（若不存在）
3. 初始化Postal数据库（若未初始化）
4. 启动Postal服务

归属

本镜像基于https://github.com/CatDeployed/docker-postal%E7%9A%84%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%E3%80%82