linagora/tmail-web

TMail Web应用 Docker镜像

镜像概述和主要用途

本镜像为TMail客户端提供Web应用的Docker容器，主要用途是作为邮件客户端的Web界面，通过配置JMAP后端服务器地址，实现邮件登录、收发和管理等功能。

核心功能和特性

• 提供TMail客户端的Web界面，支持邮件登录及日常使用
• 通过环境变量SERVER_URL配置JMAP后端服务器地址，灵活适配不同后端环境
• 支持独立Docker容器运行，快速部署和启动
• 提供docker-compose配置文件，可与tmail-backend镜像联动，快速搭建包含前后端的测试环境

使用场景和适用范围

• 个人或团队需要快速部署TMail Web客户端进行邮件测试
• 开发或测试环境中搭建轻量级邮件客户端界面
• Docker化部署环境下集成TMail Web客户端

使用方法和配置说明

独立Docker容器运行

通过独立容器运行时，需先配置JMAP后端服务器地址，步骤如下：

1. 创建环境文件
   创建环境文件（如env.dev.file），添加JMAP后端服务器URL：

   SERVER_URL=https://my-jmap-server.com
   

2. 启动Docker容器
   挂载环境文件并运行容器，映射端口（容器内80端口映射到本地8080端口）：

   bash
   docker run -d -ti -p 8080:80 --mount type=bind,source="$(pwd)"/env.dev.file,target=/usr/share/nginx/html/assets/env.file --name web linagora/tmail-web:master
   

3. 访问应用
   打开浏览器访问http://localhost:8080，使用JMAP后端账号登录即可使用。

使用docker-compose文件

通过docker-compose可快速搭建包含前端（本镜像）和后端（tmail-backend）的完整测试环境，步骤如下：

1. 获取docker-compose文件
   下载https://raw.githubusercontent.com/linagora/tmail-flutter/master/docker-compose.yaml%E6%96%87%E4%BB%B6%E3%80%82

2. 生成JWT密钥
   为tmail-backend生成RSA密钥对：

   bash
   openssl genpkey -algorithm rsa -pkeyopt rsa_keygen_bits:4096 -out jwt_privatekey
   openssl rsa -in jwt_privatekey -pubout -out jwt_publickey
   

3. 创建环境文件
   创建env.file，配置本地JMAP后端地址：

   sh
   SERVER_URL=http://localhost/
   

4. 启动容器
   启动前端和后端容器：

   bash
   docker compose up -d
   

5. 初始化演示账户
   执行后端初始化脚本，创建演示账户（无需等待脚本完全执行完毕）：

   bash
   docker compose exec tmail-backend /root/provisioning/provisioning.sh
   

6. 访问应用及演示账户

   • TMail Web应用访问地址：http://localhost:8080
   • 演示账户 credentials：

     用户：alice@localhost
     密码：aliceSecret
     
     用户：bob@localhost
     密码：bobSecret
     
     用户：empty@localhost
     密码：emptrySecret