linagora/tmail-backend

Tmail 后端服务器 Docker 镜像文档

镜像概述

Tmail 后端服务器 Docker 镜像是由 Linagora Vietnam Tmail 团队发布的邮件系统后端服务镜像，基于 Apache James 项目 进行适配与增强。该镜像提供了灵活的部署版本，支持从开发测试到生产环境的多节点分布式部署，旨在作为高性能、可靠的协作邮件套件后端。

主要用途

作为邮件系统的核心后端服务，负责邮件的接收、存储、分发及相关协作功能，支持百万级用户规模的弹性扩展，适用于企业级邮件系统、协作平台的后端基础设施构建。

核心功能与特性

协作性

提供协作邮件处理能力，支持团队级邮件协作场景。

高可靠性

• 基于 Apache James 成熟架构，采用分布式技术栈
• 支持多节点部署，具备故障转移和弹性扩展能力，可支撑数百万用户规模

安全性

内置***加密存储机制，保障邮件数据的安全存储与传输。

可持续性

• 深度参与开源社区，代码开源可审计
• 实现 JMAP 协议（绿色邮件协议），优化资源占用，降低环境影响

使用场景与适用范围

开发与测试环境

• 适用镜像标签：linagora/tmail-backend:memory-{TAG_VERSION}
• 场景说明：基于内存数据结构运行，无需外部依赖，快速启动，适合功能测试、集成测试及开发环境验证。

生产环境 - 多节点分布式部署

• 适用镜像标签：linagora/tmail-backend:distributed-{TAG_VERSION}
• 场景说明：支持多节点集群部署，具备高可用、高并发处理能力，适用于生产环境的企业邮件系统后端。

生产环境 - 兼容 ElasticSearch v6.3

• 适用镜像标签：linagora/tmail-backend:distributed-esv6-{TAG_VERSION}
• 场景说明：在分布式版本基础上，支持 ElasticSearch v6.3 后端存储，适用于需要兼容旧版 ElasticSearch 环境的生产部署。

使用方法

基础 Docker 运行命令

1. 测试环境（内存版）

bash
docker run -d \
  --name tmail-backend-test \
  -p 25:25 \  # SMTP 端口
  -p 143:143 \ # IMAP 端口
  -p 8080:8080 \ # JMAP/HTTP 端口
  linagora/tmail-backend:memory-{TAG_VERSION}

替换 {TAG_VERSION} 为具体版本号（如 1.0.0）。

2. 分布式生产环境（默认版）

bash
docker run -d \
  --name tmail-backend-distributed \
  -p 25:25 \
  -p 143:143 \
  -p 8080:8080 \
  -e JAMES_CONFIGURATION=/path/to/config \ # 外部配置文件路径
  -e DB_HOST=mysql-host \                  # 数据库主机地址
  -e DB_PORT=3306 \                        # 数据库端口
  -e ES_HOST=elasticsearch-host \          # ElasticSearch 主机地址
  -v /data/tmail:/var/lib/james \          # 持久化存储卷
  linagora/tmail-backend:distributed-{TAG_VERSION}

Docker Compose 示例（分布式部署）

yaml
version: '3.8'

services:
  tmail-node1:
    image: linagora/tmail-backend:distributed-{TAG_VERSION}
    ports:
      - "25:25"
      - "143:143"
      - "8080:8080"
    environment:
      - JAMES_NODE_ID=node1
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=james
      - DB_PASSWORD=secret
      - ES_HOST=elasticsearch
      - ES_PORT=9200
    volumes:
      - tmail-data:/var/lib/james
    depends_on:
      - mysql
      - elasticsearch

  tmail-node2:
    image: linagora/tmail-backend:distributed-{TAG_VERSION}
    ports:
      - "26:25"
      - "144:143"
      - "8081:8080"
    environment:
      - JAMES_NODE_ID=node2
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=james
      - DB_PASSWORD=secret
      - ES_HOST=elasticsearch
      - ES_PORT=9200
    volumes:
      - tmail-data:/var/lib/james
    depends_on:
      - mysql
      - elasticsearch

  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=rootsecret
      - MYSQL_DATABASE=james
      - MYSQL_USER=james
      - MYSQL_PASSWORD=secret
    volumes:
      - mysql-data:/var/lib/mysql

  elasticsearch:
    image: elasticsearch:7.14.0
    environment:
      - discovery.type=single-node
    volumes:
      - es-data:/usr/share/elasticsearch/data

volumes:
  tmail-data:
  mysql-data:
  es-data:

配置参数说明

Tmail 后端服务器支持通过环境变量或外部配置文件进行参数配置，以下为常用配置项说明：

可用标签说明

注：{TAG_VERSION} 需替换为具体版本号（如 1.2.3），可通过 https://hub.docker.com/ 或项目仓库获取最新版本信息。

参考链接

• https://github.com/linagora/openpaas-james
• Apache James 官方文档
• Linagora Vietnam Tmail 团队