This tutorial is available in other languages

在 Debian 或 Ubuntu 系统上安装 iRedMail

在 Debian 或 Ubuntu 系统上安装 iRedMail

系统要求

Warning

iRedMail 只针对全新安装的操作系统设计，它要求你的操作系统上没有事先安装邮件服务相关的组件，例如 MySQL，OpenLDAP，Postfix，Amavisd，等。 iRedMail 会自动安装和配置邮件服务所需的组件，因此如果操作系统上已有相关组件，iRedMail 可能会打乱你的配置并造成服务无法正常启动。

要在 Debian 或 Ubuntu 上安装 iRedMail，你需要：

一个全新安装的 Debian 或 Ubuntu 系统。支持的版本号在下载页面有注明。
要运行一个低流量的邮件服务器，要求至少2 GB 内存才能使用完整的垃圾邮件和病毒扫描功能。

Attention

所有二进制软件包都从 Debian/Ubuntu 官方 apt 仓库安装。 repositories.
如果使用 Ubuntu 系统，建议选择 LTS（Long Term Support，长期支持）版本。

准备

为服务器设置一个完整域名（FQDN）的主机名

不管你的服务器将用于实际运行还是仅仅用作测试，都建议设置一个完整域名（FQDN）的主机名。

输入命令 hostname -f 查看当前的主机名

$ hostname -f
mx.example.com

在 Debian/Ubuntu 系统上，主机名需要在两个文件里设置：/etc/hostname 和 /etc/hosts。

/etc/hostname：短名称。

mx

/etc/hosts 里定义主机名和 IP 地址的对应关系。注意：一定要将 FQDN 主机名列在第一个。

127.0.0.1   mx.example.com mx localhost localhost.localdomain

确认系统已使用设置好的 FQDN 作为主机名。如果没有生效，请重启系统。

$ hostname -f
mx.example.com

启用 Debian/Ubuntu 默认的官方 apt 软件源

iRedMail 依赖 Debian/Ubuntu 官方的 apt 软件源，请在 /etc/apt/sources.lists 文件里启用它们。
安装 bzip2 程序用于解压缩文件：

# sudo apt-get install bzip2

下载最新版本的 iRedMail

访问下载页面下载最新的版本。
上传 iRedMail 到服务器上。假设上传后的路径是 /root/iRedMail-x.y.z.tar.bz2 （这里以 x.y.z 代替实际的版本号）。
解压缩 iRedMail 安装包：

# cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2

运行 iRedMail 安装程序

现在可以运行 iRedMail 安装程序了，它会问你几个简单的问题，仅此而已。

# cd /root/iRedMail-x.y.z/
# bash iRedMail.sh

安装过程的截图

欢迎和感谢使用

指定用于存储用户邮箱的路径。默认是 /var/vmail/。

选择用于存储邮件账号的数据库。

Note

各个数据库之间没有太大区别，建议使用自己熟悉的数据库，便于后期维护。

如果选择 OpenLDAP 数据库用于存储邮件账号，安装程序会要求你输入 LDAP 前缀：

MySQL/MariaDB/PostgreSQL 用户

如果选择 MySQL/MariaDB/PostgreSQL 用于存储邮件账号, 安装程序会为数据库的 root 用户生成一个随机的强密码，安装完成后可以在 iRedMail.tips 文件里找到。

添加第一个邮件域名

设置邮件管理员的密码

Note

该账号即是邮件管理员，也是普通的邮件账号，可以登录管理后台和 webmail。

可选的组件

回答完上面的几个问题之后，安装程序给出本次安装的基本信息并要求确认是否实际执行安装，请输入 y 或 Y 并按回车键确认，或 n, N 并按回车键中止安装。

安装完成后你必须知道的几个重要事项

邮件服务器最薄弱的环节是用户的弱密码，所以请一定强制你的用户使用强度高的密码。
阅读 /root/iRedMail-x.y.z/iRedMail.tips 文件，它包含了：
- 各个 web 程序的访问地址（URL），用户名和密码。
- 各个组件的配置文件路径。除此之外还应该阅读文档：Locations of configuration and log files of major components.
- 以及其它一些重要和敏感信息
设置 DNS 记录
如何配置邮件客户端程序
强烈建议获取 SSL 证书以避免每次访问 web 程序时烦人的自签名 SSL 证书警告， Let's Encrypt 提供免费的 SSL 证书。可根据该文档配置获取的证书：use a SSL certificate.
如果需要批量添加邮件账号，可以参考以下针对不同数据库的批量建账号的文档： OpenLDAP， MySQL/MariaDB/PostgreSQL。
如果这是一台繁忙的服务器，这里有一些提升性能的建议。

访问 webmail 和其它 web 程序

安装完成后，可以通过以下 URL 访问相关程序。注意：请将 <server\> 替换为实际的服务器地址。

Roundcube webmail: https://your_server/mail/
SOGo Groupware: https://your_server/SOGo
Web 管理后台: httpS://your_server/iredadmin/
Awstats: httpS://your_server/awstats/awstats.pl?config=web (or ?config=smtp for SMTP log)

技术支持

遇到问题、疑问，或有建议、功能需求，都可以发到活跃的在线论坛：
- 英文论坛
- 中文论坛
如需及时快速的专业技术支持，请查看网页：获取专业的技术支持.

All documents are available in BitBucket repository, and published under Creative Commons license. You can download the latest version for offline reading. If you found something wrong, please do contact us to fix it.