+ iRedMail
+
+ // Document Index
+ iRedMail
+
+ // Document IndexThis tutorial is available in other languages
+English /
+Warning
+iRedMail 只针对全新安装的操作系统设计，它要求你的操作系统上 没有 事先 +安装邮件服务相关的组件，例如 MySQL，OpenLDAP，Postfix，Amavisd，等。 +iRedMail 会自动安装和配置邮件服务所需的组件，因此如果操作系统上已有相关 +组件，iRedMail 可能会打乱你的配置并造成服务无法正常启动。
+要在 Debian 或 Ubuntu 上安装 iRedMail，你需要：
+2 GB 内存才能使用完整的垃圾邮件和病毒扫描功能。Attention
+不管你的服务器将用于实际运行还是仅仅用作测试，都建议设置一个完整域名（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
+/etc/apt/sources.lists
+ 文件里启用它们。bzip2 程序用于解压缩文件：# sudo apt-get install bzip2
+/root/iRedMail-x.y.z.tar.bz2
+ （这里以 x.y.z 代替实际的版本号）。# cd /root/
+# tar xjf iRedMail-x.y.z.tar.bz2
+现在可以运行 iRedMail 安装程序了，它会问你几个简单的问题，仅此而已。
+# cd /root/iRedMail-x.y.z/
+# bash iRedMail.sh
+
/var/vmail/。
Note
+各个数据库之间没有太大区别，建议使用自己熟悉的数据库，便于后期维护。
+
MySQL/MariaDB/PostgreSQL 用户
+如果选择 MySQL/MariaDB/PostgreSQL 用于存储邮件账号, 安装程序会为数据库的
+root 用户生成一个随机的强密码，安装完成后可以在 iRedMail.tips 文件里找到。
Note
+该账号即是邮件管理员，也是普通的邮件账号，可以登录管理后台和 webmail。
+
回答完上面的几个问题之后，安装程序会列出本次安装的基本信息并要求确认是否实际
+执行安装，请输入 y 或 Y 并按回车键确认，或 n, N 并按回车键中止安装。
阅读 /root/iRedMail-x.y.z/iRedMail.tips 文件，它包含了：
安装完成后，可以通过以下 URL 访问相关程序。注意：请将 <server\> 替换为实际的
+服务器地址。
?config=smtp for SMTP log)All documents are available in BitBucket repository, and published under Creative Commons license. If you found something wrong, please do contact us to fix it. + \ No newline at end of file diff --git a/html/install.iredmail.on.debian.ubuntu.html b/html/install.iredmail.on.debian.ubuntu.html index 9d98b724..2b963ad6 100644 --- a/html/install.iredmail.on.debian.ubuntu.html +++ b/html/install.iredmail.on.debian.ubuntu.html @@ -14,7 +14,11 @@ /> iRedMail - // Document Index
This tutorial is available in other languages
+简体中文 /
+-该文档有其它语言的版本：
--
-- English
-- Russian. Thanks to Everycloudtech.
-
Warning
diff --git a/zh_CN/installation/0-install.iredmail.on.debian.ubuntu.md b/zh_CN/installation/0-install.iredmail.on.debian.ubuntu.md new file mode 100644 index 00000000..4ec22df0 --- /dev/null +++ b/zh_CN/installation/0-install.iredmail.on.debian.ubuntu.md @@ -0,0 +1,171 @@ +# 在 Debian 或 Ubuntu 系统上安装 iRedMail + +[TOC] + +## 系统要求 + +!!! warning + + iRedMail 只针对全新安装的操作系统设计，它要求你的操作系统上 __没有__ 事先 + 安装邮件服务相关的组件，例如 MySQL，OpenLDAP，Postfix，Amavisd，等。 + iRedMail 会自动安装和配置邮件服务所需的组件，因此如果操作系统上已有相关 + 组件，iRedMail 可能会打乱你的配置并造成服务无法正常启动。 + +要在 Debian 或 Ubuntu 上安装 iRedMail，你需要： + +* 一个全新安装的 Debian 或 Ubuntu 系统。支持的版本号在[下载](../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.lists` + 文件里启用它们。 +* 安装 `bzip2` 程序用于解压缩文件： + +``` +# sudo apt-get install bzip2 +``` + +### 下载最新版本的 iRedMail + +* 访问[下载页面](../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 安装程序了，它会问你几个简单的问题，仅此而已。 + +``` +# cd /root/iRedMail-x.y.z/ +# bash iRedMail.sh +``` + +## 安装过程的截图 + +* 欢迎和感谢使用 + + + +* 指定用于存储用户邮箱的路径。默认是 `/var/vmail/`。 + + + +* 选择用于存储邮件账号的数据库。 + +!!! note + + 各个数据库之间没有太大区别，建议使用自己熟悉的数据库，便于后期维护。 + + + +* 如果选择 OpenLDAP 数据库用于存储邮件账号，安装程序会要求你输入 LDAP 前缀： + + + +!!! note "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](../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 访问相关程序。注意：请将 `