onlyoffice/mailserver

ONLYOFFICE Mail Server Docker 镜像文档

1. 镜像概述和主要用途

ONLYOFFICE Mail Server 是基于 iRedMail 包开发的全功能邮件服务器解决方案，包含以下组件：Postfix、Dovecot、SpamAssassin、ClamAV、OpenDKIM、Fail2ban。该镜像提供完整的邮件服务功能，可与 ONLYOFFICE Community Server 集成，实现企业级邮件管理。

2. 核心功能和特性

与 ONLYOFFICE Community Server 集成后，Mail Server 支持以下功能：

• 连接自有域名；
• 创建***账户；
• 为每个***添加别名；
• 创建***组。

3. 使用场景和适用范围

适用于需要自建邮件系统并与 ONLYOFFICE Community Edition 生态集成的企业或组织，可满足内部邮件通信、域名管理、***账户集中管控等需求。

4. 推荐系统要求

• 内存（RAM）：4 GB 或更高
• CPU：双核 2 GHz 或更高
• 交换文件（Swap）：至少 2 GB
• 硬盘空间（HDD）：至少 2 GB 可用空间
• 操作系统：64 位 Red Hat、CentOS 或其他兼容发行版（内核版本 3.8 或更高）；64 位 Debian、Ubuntu 或其他兼容发行版（内核版本 3.8 或更高）
• Docker：1.9.0 或更高版本

5. 运行 Docker 镜像

使用以下命令启动镜像：

bash
sudo docker run --privileged -i -t -d -p 25:25 -p 143:143 -p 587:587 \
-h yourdomain.com onlyoffice/mailserver

其中 yourdomain.com 需替换为您的自有域名。

在此配置下，邮件服务器将确保向部署在本服务器上的内部地址投递邮件。

6. 配置 Docker 镜像

为确保邮件既能投递到内部地址，也能投递到外部服务器地址，需准备自有域名并配置 DNS 服务器。

6.1 必要的 DNS 记录

需配置以下 DNS 记录：

• A 记录：将域名指向部署此 Docker 镜像的主机 IP 地址；
• PTR 记录（反向 DNS 记录）：将主机 IP 地址映射到主机名。

6.2 带数据卷的启动命令

bash
sudo docker run --privileged -i -t -d -p 25:25 -p 143:143 -p 587:587 \
-v /app/onlyoffice/MailServer/data/certs:/etc/pki/tls/mailserver -h yourdomain.com onlyoffice/mailserver

其中 yourdomain.com 为您的自有域名。

7. 安装 SSL 证书

运行容器时，默认会为您的域名创建自签名证书。如需使用 CA 认证证书，需在运行镜像前将证书文件重命名并复制到 /app/onlyoffice/MailServer/data/certs 目录。所需文件如下：

• /app/onlyoffice/MailServer/data/certs/mail.onlyoffice.key
• /app/onlyoffice/MailServer/data/certs/mail.onlyoffice.crt
• /app/onlyoffice/MailServer/data/certs/mail.onlyoffice.ca-bundle

若在容器运行后复制证书文件，需重启容器使配置生效。

7.1 可用配置参数

可通过环境变量配置镜像，建议使用 --env-file 选项将所有环境变量写入文件，避免冗长的命令行参数。

8. 数据存储

所有数据存储在容器内的专用数据卷中，路径如下：

• /var/log：ONLYOFFICE Mail Server 日志
• /var/lib/mysql：MySQL 数据库数据
• /var/vmail：邮件存储
• /etc/pki/tls/mailserver：证书

8.1 挂载主机目录到数据卷

通过 -v 选项将容器数据卷挂载到主机目录，实现数据持久化：

bash
sudo docker run --privileged -i -t -d -p 25:25 -p 143:143 -p 587:587 \
    -v /app/onlyoffice/MailServer/logs:/var/log  \
    -v /app/onlyoffice/MailServer/mysql:/var/lib/mysql  \
    -v /app/onlyoffice/MailServer/data:/var/vmail  \
    -v /app/onlyoffice/MailServer/data/certs:/etc/pki/tls/mailserver \
    -h yourdomain.com onlyoffice/mailserver

将数据存储在主机可确保升级镜像时不丢失数据。

9. 集成 Document 和 Community 服务器安装

ONLYOFFICE Mail Server 是 ONLYOFFICE Community Edition 的组成部分，需与 Document Server 和 Community Server 配合使用。以下是完整安装步骤：

9.1 步骤 1：创建 Docker 网络

bash
docker network create --driver bridge onlyoffice

后续容器均通过 --net onlyoffice 选项连接到此网络。

9.2 步骤 2：安装 Document Server

bash
sudo docker run --net onlyoffice -i -t -d --restart=always --name onlyoffice-document-server \
    -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
    -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \
    onlyoffice/documentserver

9.3 步骤 3：安装 Mail Server

需指定主机名 yourdomain.com：

bash
sudo docker run --net onlyoffice --privileged -i -t -d --restart=always --name onlyoffice-mail-server \
    -p 25:25 -p 143:143 -p 587:587 \
    -v /app/onlyoffice/MailServer/data:/var/vmail \
    -v /app/onlyoffice/MailServer/data/certs:/etc/pki/tls/mailserver \
    -v /app/onlyoffice/MailServer/logs:/var/log \
    -v /app/onlyoffice/MailServer/mysql:/var/lib/mysql \
    -h yourdomain.com \
    onlyoffice/mailserver

9.4 步骤 4：安装 Community Server

bash
sudo docker run --net onlyoffice -i -t -d --restart=always --name onlyoffice-community-server \
    -p 80:80 -p 5222:5222 -p 443:443 \
    -v /app/onlyoffice/CommunityServer/data:/var/www/onlyoffice/Data \
    -v /app/onlyoffice/CommunityServer/mysql:/var/lib/mysql \
    -v /app/onlyoffice/CommunityServer/logs:/var/log/onlyoffice \
    -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/DocumentServerData \
    -e DOCUMENT_SERVER_PORT_80_TCP_ADDR=onlyoffice-document-server \
    -e MAIL_SERVER_DB_HOST=onlyoffice-mail-server \
    onlyoffice/communityserver

9.5 自动安装脚本

可通过自动安装脚本一键部署 Community Edition（需指定 Mail Server 主机名 yourdomain.com）：

bash
# 下载脚本
wget http://download.onlyoffice.com/install/opensource-install.sh

# 执行安装
bash opensource-install.sh -md yourdomain.com

9.6 Docker Compose 部署

确保已安装 Docker Compose，执行以下命令：

bash
wget https://raw.githubusercontent.com/ONLYOFFICE/Docker-CommunityServer/master/docker-compose.yml
docker-compose up -d

10. 项目信息

• 官方网站：[***]
• 许可证：https://raw.githubusercontent.com/ONLYOFFICE/Docker-MailServer/master/LICENSE.txt
• SaaS 版本：[***]

11. 用户反馈与支持

如有问题或建议，请通过 dev.onlyoffice.org 联系支持团队。