sourceforgery/tachikoma-postfix

镜像概述

Tachikoma是一款自托管邮件服务提供商（Email Service Provider），由Postfix组件（tachikoma-postfix）和Web服务器组件（tachikoma-webserver）组成。本镜像为其Postfix组件，负责邮件传输核心功能，可处理多个不同的邮件账户和域名。需注意，每个域名需运行独立的tachikoma-postfix容器实例以实现隔离。

核心功能和特性

• 多域名与账户支持：可同时管理多个邮件账户及域名，满足多租户或多品牌邮件服务需求
• gRPC API接口：提供gRPC协议API，支持与主流编程语言（C、C++、C#、Go、Java、JavaScript、Python、Rust等）无缝集成，便于二次开发和系统对接
• 轻量化依赖：仅需外部PostgreSQL数据库（存储账户/域名数据）和RabbitMQ消息队列（处理邮件异步传输），且对这两类服务无特殊插件或配置要求

使用场景和适用范围

• 需搭建私有邮件服务的个人或企业用户
• 需管理多个独立域名邮件系统的组织（如企业多品牌、多部门邮件隔离）
• 需要通过编程方式自定义邮件处理逻辑的开发场景（如自动化邮件发送、接收回调处理）

使用方法和配置说明

前置依赖准备

部署本镜像前，需预先准备并启动以下服务：

• PostgreSQL数据库：用于存储邮件账户、域名配置等核心数据
• RabbitMQ消息队列：用于处理邮件消息的异步传输和队列管理

容器部署示例

基础部署命令（docker run）

bash
docker run -d \
  --name tachikoma-postfix-example.com \  # 建议用域名标识容器名
  -e DOMAIN=example.com \                # 绑定的目标域名
  -e POSTGRES_HOST=postgres-host \       # PostgreSQL主机地址
  -e POSTGRES_PORT=5432 \                # PostgreSQL端口（默认5432）
  -e POSTGRES_DB=tachikoma_db \          # 数据库名称
  -e POSTGRES_USER=db_user \             # 数据库用户名
  -e POSTGRES_PASSWORD=db_pass \         # 数据库密码
  -e RABBITMQ_HOST=rabbitmq-host \       # RabbitMQ主机地址
  -e RABBITMQ_PORT=5672 \                # RabbitMQ端口（默认5672）
  -e RABBITMQ_USER=mq_user \             # RabbitMQ用户名
  -e RABBITMQ_PASSWORD=mq_pass \         # RabbitMQ密码
  tachikoma-postfix

Docker Compose配置示例

yaml
version: '3.8'

services:
  # PostgreSQL数据库
  postgres:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: tachikoma_db
      POSTGRES_USER: db_user
      POSTGRES_PASSWORD: db_pass
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

  # RabbitMQ消息队列
  rabbitmq:
    image: rabbitmq:3.12-management-alpine
    environment:
      RABBITMQ_DEFAULT_USER: mq_user
      RABBITMQ_DEFAULT_PASS: mq_pass
    ports:
      - "15672:15672"  # 管理界面端口（可选）
    restart: unless-stopped

  # Tachikoma Postfix组件（example.com域名）
  tachikoma-postfix-example.com:
    image: tachikoma-postfix
    depends_on:
      - postgres
      - rabbitmq
    environment:
      DOMAIN: example.com
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: tachikoma_db
      POSTGRES_USER: db_user
      POSTGRES_PASSWORD: db_pass
      RABBITMQ_HOST: rabbitmq
      RABBITMQ_PORT: 5672
      RABBITMQ_USER: mq_user
      RABBITMQ_PASSWORD: mq_pass
    restart: unless-stopped

volumes:
  postgres_data:  # 持久化PostgreSQL数据

关键配置说明

注意事项

• 域名隔离：每个域名必须部署独立的tachikoma-postfix容器，避免配置冲突
• 依赖可用性：确保PostgreSQL和RabbitMQ服务在容器启动前就绪，且网络互通
• 数据持久化：建议对PostgreSQL配置数据卷持久化，防止数据丢失
• API集成：通过gRPC API集成时，需开放对应端口（默认gRPC端口需根据实际配置确定）并确保网络可达