elmau
/
iredmail-doc
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

New: zh_CN/installation/0-install.iredmail.on.debian.ubuntu.md.

This commit is contained in:
Zhang Huangbin 2016-05-06 16:02:26 +08:00
parent 47cb68d073
commit 72d23c6719
5 changed files with 383 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

207
html/install.iredmail.on.debian.ubuntu-zh_CN.html Normal file
View File

@ -0,0 +1,207 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>在 Debian 或 Ubuntu 系统上安装 iRedMail</title>
<link rel="stylesheet" type="text/css" href="./css/markdown.css" />
</head>
<body>
<div id="navigation">
<a href="/index.html" target="_blank">
<img alt="iRedMail web site"
src="./images/logo-iredmail.png"
style="vertical-align: middle; height: 30px;"
/>&nbsp;
<span>iRedMail</span>
</a>
&nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><div class="admonition note">
<p class="admonition-title">This tutorial is available in other languages</p>
<p><a href="./install.iredmail.on.debian.ubuntu.html">English</a> /</p>
</div>
<h1 id="debian-ubuntu-iredmail">在 Debian 或 Ubuntu 系统上安装 iRedMail</h1>
<div class="toc">
<ul>
<li><a href="#debian-ubuntu-iredmail">在 Debian 或 Ubuntu 系统上安装 iRedMail</a><ul>
<li><a href="#_1">系统要求</a></li>
<li><a href="#_2">准备</a><ul>
<li><a href="#fqdn">为服务器设置一个完整域名（FQDN）的主机名</a></li>
<li><a href="#debianubuntu-apt">启用 Debian/Ubuntu 默认的官方 apt 软件源</a></li>
<li><a href="#iredmail">下载最新版本的 iRedMail</a></li>
</ul>
</li>
<li><a href="#iredmail_1">运行 iRedMail 安装程序</a></li>
<li><a href="#_3">安装过程的截图</a></li>
<li><a href="#_4">安装完成后你必须知道的几个重要事项</a></li>
<li><a href="#webmail-web">访问 webmail 和其它 web 程序</a></li>
<li><a href="#_5">技术支持</a></li>
</ul>
</li>
</ul>
</div>
<h2 id="_1">系统要求</h2>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>iRedMail 只针对全新安装的操作系统设计，它要求你的操作系统上 <strong>没有</strong> 事先
安装邮件服务相关的组件，例如 MySQL，OpenLDAP，Postfix，Amavisd，等。
iRedMail 会自动安装和配置邮件服务所需的组件，因此如果操作系统上已有相关
组件，iRedMail 可能会打乱你的配置并造成服务无法正常启动。</p>
</div>
<p>要在 Debian 或 Ubuntu 上安装 iRedMail，你需要：</p>
<ul>
<li>一个全新安装的 Debian 或 Ubuntu 系统。支持的版本号在<a href="../download.html">下载</a>页面有注明。</li>
<li>要运行一个低流量的邮件服务器，要求至少<code>2 GB</code> 内存才能使用完整的垃圾邮件和病毒扫描功能。</li>
</ul>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<ul>
<li>所有二进制软件包都从 Debian/Ubuntu 官方 apt 仓库安装。
repositories.</li>
<li>如果使用 Ubuntu 系统，建议选择 LTS（Long Term Support，长期支持）版本。</li>
</ul>
</div>
<h2 id="_2">准备</h2>
<h3 id="fqdn">为服务器设置一个完整域名（FQDN）的主机名</h3>
<p>不管你的服务器将用于实际运行还是仅仅用作测试，都建议设置一个完整域名（FQDN）的主机名。</p>
<p>输入命令 <code>hostname -f</code> 查看当前的主机名</p>
<pre><code class="shell">$ hostname -f
mx.example.com
</code></pre>
<p>在 Debian/Ubuntu 系统上，主机名需要在两个文件里设置：<code>/etc/hostname</code> 和 <code>/etc/hosts</code>。</p>
<ul>
<li><code>/etc/hostname</code>：短名称。</li>
</ul>
<pre><code>mx
</code></pre>
<ul>
<li><code>/etc/hosts</code> 里定义主机名和 IP 地址的对应关系。注意：一定要将 FQDN 主机名列在第一个。</li>
</ul>
<pre><code>127.0.0.1 mx.example.com mx localhost localhost.localdomain
</code></pre>
<p>确认系统已使用设置好的 FQDN 作为主机名。如果没有生效，请重启系统。</p>
<pre><code>$ hostname -f
mx.example.com
</code></pre>
<h3 id="debianubuntu-apt">启用 Debian/Ubuntu 默认的官方 apt 软件源</h3>
<ul>
<li>iRedMail 依赖 Debian/Ubuntu 官方的 apt 软件源，请在 <code>/etc/apt/sources.lists</code>
文件里启用它们。</li>
<li>安装 <code>bzip2</code> 程序用于解压缩文件：</li>
</ul>
<pre><code># sudo apt-get install bzip2
</code></pre>
<h3 id="iredmail">下载最新版本的 iRedMail</h3>
<ul>
<li>访问<a href="../download.html">下载页面</a>下载最新的版本。</li>
<li>上传 iRedMail 到服务器上。假设上传后的路径是 <code>/root/iRedMail-x.y.z.tar.bz2</code>
（这里以 <code>x.y.z</code> 代替实际的版本号）。</li>
<li>解压缩 iRedMail 安装包：</li>
</ul>
<pre><code># cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2
</code></pre>
<h2 id="iredmail_1">运行 iRedMail 安装程序</h2>
<p>现在可以运行 iRedMail 安装程序了，它会问你几个简单的问题，仅此而已。</p>
<pre><code># cd /root/iRedMail-x.y.z/
# bash iRedMail.sh
</code></pre>
<h2 id="_3">安装过程的截图</h2>
<ul>
<li>欢迎和感谢使用</li>
</ul>
<p><img alt="" src="../images/installation/iredmail/welcome.png" /></p>
<ul>
<li>指定用于存储用户邮箱的路径。默认是 <code>/var/vmail/</code>。</li>
</ul>
<p><img alt="" src="../images/installation/iredmail/location_to_store_mailboxes.png" /></p>
<ul>
<li>选择用于存储邮件账号的数据库。</li>
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>各个数据库之间没有太大区别，建议使用自己熟悉的数据库，便于后期维护。</p>
</div>
<p><img alt="" src="../images/installation/iredmail/backend.png" /></p>
<ul>
<li>如果选择 OpenLDAP 数据库用于存储邮件账号，安装程序会要求你输入 LDAP 前缀：</li>
</ul>
<p><img alt="" src="../images/installation/iredmail/ldap_suffix.png" /></p>
<div class="admonition note">
<p class="admonition-title">MySQL/MariaDB/PostgreSQL 用户</p>
<p>如果选择 MySQL/MariaDB/PostgreSQL 用于存储邮件账号, 安装程序会为数据库的
root 用户生成一个随机的强密码，安装完成后可以在 <code>iRedMail.tips</code> 文件里找到。</p>
</div>
<ul>
<li>添加第一个邮件域名</li>
</ul>
<p><img alt="" src="../images/installation/iredmail/first_mail_domain.png" /></p>
<ul>
<li>设置邮件管理员的密码</li>
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>该账号即是邮件管理员，也是普通的邮件账号，可以登录管理后台和 webmail。</p>
</div>
<p><img alt="" src="../images/installation/iredmail/pw_of_domain_admin.png" /></p>
<ul>
<li>可选的组件</li>
</ul>
<p><img alt="" src="../images/installation/iredmail/optional_components.png" /></p>
<p>回答完上面的几个问题之后，安装程序会列出本次安装的基本信息并要求确认是否实际
执行安装，请输入 <code>y</code> 或 <code>Y</code> 并按回车键确认，或 <code>n</code>, <code>N</code> 并按回车键中止安装。</p>
<h2 id="_4">安装完成后你必须知道的几个重要事项</h2>
<ul>
<li>邮件服务器最薄弱的环节是用户的弱密码，所以请一定强制你的用户使用强度高的密码。</li>
<li>
<p>阅读 <code>/root/iRedMail-x.y.z/iRedMail.tips</code> 文件，它包含了：</p>
<ul>
<li>各个 web 程序的访问地址（URL），用户名和密码。</li>
<li>各个组件的配置文件路径。除此之外还应该阅读文档：<a href="../file.locations.html">Locations of configuration and log files of major components</a>.</li>
<li>以及其它一些重要和敏感信息</li>
</ul>
</li>
<li>
<p><a href="../setup.dns.html">设置 DNS 记录</a></p>
</li>
<li><a href="../index.html#configure-mail-client-applications">如何配置邮件客户端程序</a></li>
<li>强烈建议获取 SSL 证书以避免每次访问 web 程序时烦人的自签名 SSL 证书警告，
<a href="https://letsencrypt.org">Let's Encrypt 提供免费的 SSL 证书</a>。可根据该文档
配置获取的证书：<a href="../use.a.bought.ssl.certificate.html">use a SSL certificate</a>.</li>
<li>如果需要批量添加邮件账号，可以参考以下针对不同数据库的批量建账号的文档：
<a href="../ldap.bulk.create.mail.users.html">OpenLDAP</a>，
<a href="../sql.bulk.create.mail.users.html">MySQL/MariaDB/PostgreSQL</a>。</li>
<li>如果这是一台繁忙的服务器，这里有<a href="../performance.tuning.html">一些提升性能的建议</a>。</li>
</ul>
<h2 id="webmail-web">访问 webmail 和其它 web 程序</h2>
<p>安装完成后，可以通过以下 URL 访问相关程序。注意：请将 <code>&lt;server\&gt;</code> 替换为实际的
服务器地址。</p>
<ul>
<li><strong>Roundcube webmail</strong>: <a href="https://your_server/mail/">https://your_server/mail/</a></li>
<li><strong>SOGo Groupware</strong>: <a href="https://your_server/SOGo">https://your_server/SOGo</a></li>
<li><strong>Web 管理后台</strong>: <a href="httpS://your_server/iredadmin/">httpS://your_server/iredadmin/</a></li>
<li><strong>Awstats</strong>: <a href="httpS://your_server/awstats/awstats.pl?config=web">httpS://your_server/awstats/awstats.pl?config=web</a> (or <code>?config=smtp</code> for SMTP log)</li>
</ul>
<h2 id="_5">技术支持</h2>
<ul>
<li>遇到问题、疑问，或有建议、功能需求，都可以发到活跃的在线论坛：<ul>
<li><a href="http://www.iredmail.org/forum/">英文论坛</a></li>
<li><a href="http://www.iredmail.com/bbs/">中文论坛</a></li>
</ul>
</li>
<li>如需及时快速的专业技术支持，请查看网页：<a href="../support.html">获取专业的技术支持</a>.</li>
</ul><p style="text-align: center; color: grey;">All documents are available in <a href="https://bitbucket.org/zhb/iredmail-docs/src">BitBucket repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-3293801-21', 'auto');
ga('send', 'pageview');
</script>
</body></html>

6
html/install.iredmail.on.debian.ubuntu.html
View File

@ -14,7 +14,11 @@
/>&nbsp;
<span>iRedMail</span>
</a>
&nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><h1 id="install-iredmail-on-debian-or-ubuntu-linux">Install iRedMail on Debian or Ubuntu Linux</h1>
&nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><div class="admonition note">
<p class="admonition-title">This tutorial is available in other languages</p>
<p><a href="./install.iredmail.on.debian.ubuntu-zh_CN.html">简体中文</a> /</p>
</div>
<h1 id="install-iredmail-on-debian-or-ubuntu-linux">Install iRedMail on Debian or Ubuntu Linux</h1>
<div class="toc">
<ul>
<li><a href="#install-iredmail-on-debian-or-ubuntu-linux">Install iRedMail on Debian or Ubuntu Linux</a><ul>

7
html/install.iredmail.on.rhel-zh_CN.html
View File

@ -39,13 +39,6 @@
</li>
</ul>
</div>
<blockquote>
<p>该文档有其它语言的版本：</p>
<ul>
<li><a href="../install.iredmail.on.rhel.html">English</a></li>
<li><a href="http://www.everycloudtech.com/install.iredmail.on.rhel">Russian</a>. Thanks to <a href="http://www.everycloudtech.com/">Everycloudtech</a>.</li>
</ul>
</blockquote>
<h2 id="_1">系统要求</h2>
<div class="admonition warning">
<p class="admonition-title">Warning</p>

171
zh_CN/installation/0-install.iredmail.on.debian.ubuntu.md Normal file
View File

@ -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
```
## 安装过程的截图
* 欢迎和感谢使用
![](../images/installation/iredmail/welcome.png)
* 指定用于存储用户邮箱的路径。默认是 `/var/vmail/`。
![](../images/installation/iredmail/location_to_store_mailboxes.png)
* 选择用于存储邮件账号的数据库。
!!! note
各个数据库之间没有太大区别，建议使用自己熟悉的数据库，便于后期维护。
![](../images/installation/iredmail/backend.png)
* 如果选择 OpenLDAP 数据库用于存储邮件账号，安装程序会要求你输入 LDAP 前缀：
![](../images/installation/iredmail/ldap_suffix.png)
!!! note "MySQL/MariaDB/PostgreSQL 用户"
如果选择 MySQL/MariaDB/PostgreSQL 用于存储邮件账号, 安装程序会为数据库的
root 用户生成一个随机的强密码，安装完成后可以在 `iRedMail.tips` 文件里找到。
* 添加第一个邮件域名
![](../images/installation/iredmail/first_mail_domain.png)
* 设置邮件管理员的密码
!!! note
该账号即是邮件管理员，也是普通的邮件账号，可以登录管理后台和 webmail。
![](../images/installation/iredmail/pw_of_domain_admin.png)
* 可选的组件
![](../images/installation/iredmail/optional_components.png)
回答完上面的几个问题之后，安装程序会列出本次安装的基本信息并要求确认是否实际
执行安装，请输入 `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 访问相关程序。注意：请将 `<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)
## 技术支持
* 遇到问题、疑问，或有建议、功能需求，都可以发到活跃的在线论坛：
* [英文论坛](http://www.iredmail.org/forum/)
* [中文论坛](http://www.iredmail.com/bbs/)
* 如需及时快速的专业技术支持，请查看网页：[获取专业的技术支持](../support.html).

5
zh_CN/installation/0-install.iredmail.on.rhel.md
View File

@ -2,11 +2,6 @@
[TOC]
> 该文档有其它语言的版本：
>
> * [English](../install.iredmail.on.rhel.html)
> * [Russian](http://www.everycloudtech.com/install.iredmail.on.rhel). Thanks to [Everycloudtech](http://www.everycloudtech.com/).
## 系统要求
!!! warning