188 lines
6.6 KiB
Markdown
188 lines
6.6 KiB
Markdown
# 在 Debian 或 Ubuntu 系统上安装 iRedMail
|
||
|
||
[TOC]
|
||
|
||
## 系统要求
|
||
|
||
!!! warning
|
||
|
||
阿里云、腾讯云均禁止使用邮件服务所必须的 25 端口提供邮件服务,因此您不能在
|
||
它们的云服务器部署邮件服务器。
|
||
|
||
!!! warning
|
||
|
||
iRedMail 只针对全新安装的操作系统设计,它要求你的操作系统上 __没有__ 事先
|
||
安装邮件服务相关的组件,例如 MySQL,OpenLDAP,Postfix,Amavisd,等。
|
||
iRedMail 会自动安装和配置邮件服务所需的组件,因此如果操作系统上已有相关
|
||
组件,iRedMail 可能会打乱你的配置并造成服务无法正常启动。
|
||
|
||
要在 Debian 或 Ubuntu 上安装 iRedMail,你需要:
|
||
|
||
* 一个全新安装的 Debian 或 Ubuntu 系统。支持的版本号在[下载](https://www.iredmail.org/download.html)页面有注明。
|
||
* 要运行一个低流量的邮件服务器,要求至少`2 GB` 内存才能使用完整的垃圾邮件和病毒扫描功能。
|
||
|
||
!!! attention
|
||
|
||
* 所有二进制软件包都从 Debian/Ubuntu 官方 apt 仓库安装。
|
||
repositories.
|
||
* 如果使用 Ubuntu 系统,建议选择 LTS(Long Term Support,长期支持)版本。
|
||
|
||
## 准备
|
||
|
||
### 为服务器设置一个完整域名(FQDN)的主机名
|
||
|
||
不管你的服务器将用于实际运行还是仅仅用作测试,都建议设置一个完整域名(FQDN)的主机名。
|
||
|
||
输入命令 `hostname -f` 查看当前的主机名
|
||
|
||
```shell
|
||
$ 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.list`
|
||
文件里启用它们。
|
||
* 安装 `bzip2` 程序用于解压缩文件:
|
||
|
||
```
|
||
# sudo apt-get install bzip2
|
||
```
|
||
|
||
### 下载最新版本的 iRedMail
|
||
|
||
* 访问[下载页面](https://www.iredmail.org/download.html)下载最新的版本。
|
||
* 上传 iRedMail 到服务器上。假设上传后的路径是 `/root/iRedMail-x.y.z.tar.bz2`
|
||
(这里以 `x.y.z` 代替实际的版本号)。
|
||
* 解压缩 iRedMail 安装包:
|
||
|
||
```
|
||
# cd /root/
|
||
# tar xjf iRedMail-x.y.z.tar.bz2
|
||
```
|
||
|
||
## 运行 iRedMail 安装程序
|
||
|
||
现在可以运行 iRedMail 安装程序了,它会问你几个简单的问题,仅此而已。
|
||
|
||
!!! warning
|
||
|
||
* 由于 iredmail.org 域名在国内无法访问,所以使用 `IREDMAIL_MIRROR` 指定
|
||
其它镜像站点。
|
||
* 由于 SOGo 网站在国内访问非常慢,且网络容易出问题,因此使用
|
||
`SOGO_PKG_MIRROR` 指定国内镜像站点。
|
||
|
||
```
|
||
cd /root/iRedMail-x.y.z/
|
||
IREDMAIL_MIRROR='https://dl.iredmail.org' \
|
||
SOGO_PKG_MIRROR='https://cnmirror.iredmail.org' \
|
||
bash iRedMail.sh
|
||
```
|
||
|
||
## 安装过程的截图
|
||
|
||
* 欢迎和感谢使用
|
||
|
||
![](./images/installation/welcome.png){: width="700px" }
|
||
|
||
* 指定用于存储用户邮箱的路径。默认是 `/var/vmail/`。
|
||
|
||
![](./images/installation/mail_storage.png){: width="700px" }
|
||
|
||
* 选择用于存储邮件账号的数据库。
|
||
|
||
!!! note
|
||
|
||
各个数据库之间没有太大区别,建议使用自己熟悉的数据库,便于后期维护。
|
||
|
||
![](./images/installation/backends.png){: width="700px" }
|
||
|
||
* 如果选择 OpenLDAP 数据库用于存储邮件账号,安装程序会要求你输入 LDAP 前缀:
|
||
|
||
![](./images/installation/ldap_suffix.png){: width="700px" }
|
||
|
||
!!! note "MySQL/MariaDB/PostgreSQL 用户"
|
||
|
||
如果选择 MySQL/MariaDB/PostgreSQL 用于存储邮件账号, 安装程序会为数据库的
|
||
root 用户生成一个随机的强密码,安装完成后可以在 `iRedMail.tips` 文件里找到。
|
||
|
||
* 添加第一个邮件域名
|
||
|
||
![](./images/installation/first_domain.png){: width="700px" }
|
||
|
||
* 设置邮件管理员的密码
|
||
|
||
!!! note
|
||
|
||
该账号即是邮件管理员,也是普通的邮件账号,可以登录管理后台和 webmail。
|
||
|
||
![](./images/installation/admin_pw.png){: width="700px" }
|
||
|
||
* 可选的组件
|
||
|
||
![](./images/installation/optional_components.png){: width="700px" }
|
||
|
||
|
||
回答完上面的几个问题之后,安装程序给出本次安装的基本信息并要求确认是否实际
|
||
执行安装,请输入 `y` 或 `Y` 并按回车键确认,或 `n`, `N` 并按回车键中止安装。
|
||
|
||
![](./images/installation/review.png){: width="700px" }
|
||
|
||
## 安装完成后你必须知道的几个重要事项
|
||
|
||
* 邮件服务器最薄弱的环节是用户的弱密码,所以请一定强制你的用户使用强度高的密码。
|
||
* 阅读 `/root/iRedMail-x.y.z/iRedMail.tips` 文件,它包含了:
|
||
|
||
* 各个 web 程序的访问地址(URL),用户名和密码。
|
||
* 各个组件的配置文件路径。除此之外还应该阅读文档:[Locations of configuration and log files of major components](./file.locations.html).
|
||
* 以及其它一些重要和敏感信息
|
||
|
||
* [设置 DNS 记录](./setup.dns.html)
|
||
* [如何配置邮件客户端程序](./index.html#configure-mail-client-applications)
|
||
* 强烈建议获取 SSL 证书以避免每次访问 web 程序时烦人的自签名 SSL 证书警告,
|
||
[Let's Encrypt 提供免费的 SSL 证书](https://letsencrypt.org)。可根据该文档
|
||
配置获取的证书:[use a SSL certificate](./use.a.bought.ssl.certificate.html).
|
||
* 如果需要批量添加邮件账号,可以参考以下针对不同数据库的批量建账号的文档:
|
||
[OpenLDAP](./ldap.bulk.create.mail.users.html),
|
||
[MySQL/MariaDB/PostgreSQL](./sql.bulk.create.mail.users.html)。
|
||
* 如果这是一台繁忙的服务器,这里有[一些提升性能的建议](./performance.tuning.html)。
|
||
|
||
## 访问 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)
|
||
|
||
## 技术支持
|
||
|
||
* 遇到问题、疑问,或有建议、功能需求,都可以发到活跃的在线论坛:
|
||
* [英文论坛](https://forum.iredmail.org/)
|
||
* [中文论坛](https://bbs.iredmail.org/)
|
||
* 如需及时快速的专业技术支持,请查看网页:[获取专业的技术支持](https://www.iredmail.org/support.html).
|