本教程适用于以下操作系统版本

  • Ubuntu 22.04 (Jammy Jellyfish)
  • Ubuntu 18.04 (Bionic Beaver)

本页内容

  • 前置条件
  • 第 1 步 - 配置防火墙
  • 第 2 步 - 安装 Nginx
  • 第 3 步 - 安装并配置 PHP
  • 第 4 步 - 安装 MySQL
  • 第 5 步 - 配置 MySQL
  • 第 6 步 - 安装 Rainloop
  • 第 7 步 - 安装 SSL
  • 第 8 步 - 配置 Nginx
  • 第 9 步 - 配置并访问 Rainloop
  • 结语

Rainloop 是一款用 PHP 编写的开源、基于 Web 的电子邮件客户端。它运行快速、轻巧,并支持 SMTP 和 IMAP 协议。

本指南将教你如何在 Ubuntu 22.04 服务器上安装 Rainloop 客户端。

前置条件

  • 一台运行 Ubuntu 22.04 的服务器。
  • 一个指向该服务器的域名。本教程中,我们将使用 rainloop.example.com 这个域名。
  • 一个具有 sudo 权限的非 root 用户。
  • 确保所有软件包都是最新的。$ sudo apt update && sudo apt upgrade
  • 安装基础工具包。其中部分可能已经安装。$ sudo apt install wget curl nano unzip -y

一台运行 Ubuntu 22.04 的服务器。

一个指向该服务器的域名。本教程中,我们将使用 rainloop.example.com 这个域名。

一个具有 sudo 权限的非 root 用户。

确保所有软件包都是最新的。

$ sudo apt update && sudo apt upgrade

安装基础工具包。其中部分可能已经安装。

$ sudo apt install wget curl nano unzip -y

第 1 步 - 配置防火墙

安装 Rainloop 之前的第一步是配置防火墙。检查防火墙的状态。

$ sudo ufw status

你应当会看到类似下面的输出。

Status: active

To                         Action      From
--                         ------      ----
OpenSSH                    ALLOW       Anywhere
OpenSSH (v6)               ALLOW       Anywhere (v6)

Rainloop 需要 HTTP 和 HTTPS 端口才能正常工作。

$ sudo ufw allow http
$ sudo ufw allow https

为你所使用的邮件账户开放相应端口。

$ sudo ufw allow 587/tcp
$ sudo ufw allow 993/tcp
$ sudo ufw allow 465/tcp

再次检查状态以确认。

$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
OpenSSH                    ALLOW       Anywhere
80/tcp                     ALLOW       Anywhere
443                        ALLOW       Anywhere
587/tcp                    ALLOW       Anywhere
993/tcp                    ALLOW       Anywhere
465/tcp                    ALLOW       Anywhere
OpenSSH (v6)               ALLOW       Anywhere (v6)
80/tcp (v6)                ALLOW       Anywhere (v6)
443 (v6)                   ALLOW       Anywhere (v6)
587/tcp (v6)               ALLOW       Anywhere (v6)
993/tcp (v6)               ALLOW       Anywhere (v6)
465/tcp (v6)               ALLOW       Anywhere (v6)

第 2 步 - 安装 Nginx

Ubuntu 22.04 自带的是较旧版本的 Nginx。要安装最新版本,你需要添加 Nginx 官方仓库。

导入 Nginx 的签名密钥。

$ curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
| sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null

添加 Nginx 稳定版的仓库。

$ echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg arch=amd64] \
http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
| sudo tee /etc/apt/sources.list.d/nginx.list

更新系统软件仓库。

$ sudo apt update

安装 Nginx。

$ sudo apt install nginx

验证安装。

$ nginx -v
nginx version: nginx/1.22.0

第 3 步 - 安装并配置 PHP

Ubuntu 22.04 默认自带 PHP 8.1。但要让 Rainloop 正常运行,我们需要安装 PHP 8.0。第一步是添加 Ondrej 的 PHP 仓库。

$ sudo add-apt-repository ppa:ondrej/php

安装 PHP 以及 Rainloop 所需的扩展。

 $ sudo dnf install php8.0-fpm php8.0-curl php8.0-mbstring php8.0-mysql php8.0-xml php8.0-cli

验证安装。

$ php --version
PHP 8.0.20 (cli) (built: Jun 25 2022 08:12:05) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.20, Copyright (c) Zend Technologies
    with Zend OPcache v8.0.20, Copyright (c), by Zend Technologies

检查 PHP 服务的状态。

$ sudo systemctl status php8.0-fpm
? php8.0-fpm.service - The PHP 8.0 FastCGI Process Manager
     Loaded: loaded (/lib/systemd/system/php8.0-fpm.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2022-07-04 01:52:55 UTC; 1min 22s ago
       Docs: man:php-fpm8.0(8)
    Process: 12463 ExecStartPost=/usr/lib/php/php-fpm-socket-helper install /run/php/php-fpm.sock /etc/php/8.0/fpm/pool.d/www.conf 80 (code=exited, status=0/SUCCESS)
   Main PID: 12460 (php-fpm8.0)
     Status: "Processes active: 0, idle: 2, Requests: 0, slow: 0, Traffic: 0req/sec"
      Tasks: 3 (limit: 2241)
     Memory: 8.7M
        CPU: 89ms
     CGroup: /system.slice/php8.0-fpm.service
             ??12460 "php-fpm: master process (/etc/php/8.0/fpm/php-fpm.conf)

打开 php.ini 文件进行编辑。

$ sudo nano /etc/php/8.0/fpm/php.ini

修改以下变量的值,将邮件附件大小设置为 25MB。

upload_max_filesize = 25M
post_max_size = 25M

按 Ctrl + X,并在提示时输入 Y 保存文件。

打开文件 /etc/php/8.0/fpm/pool.d/www.conf。

$ sudo nano /etc/php/8.0/fpm/pool.d/www.conf

在文件中找到 user=apache 和 group=apache 两行,并按如下方式修改。

...
; Unix user/group of processes
; Note: The user is mandatory. If the group is not set, the default user's group
;       will be used.
; RPM: apache user chosen to provide access to the same directories as httpd
user = nginx
; RPM: Keep a group allowed to write in log dir.
group = nginx
...

另外,找到 listen.owner = www-data 和 listen.group = www-data 两行,并按如下方式修改。

...
; Set permissions for unix socket, if one is used. In Linux, read/write
; permissions must be set in order to allow connections from a web server. Many
; BSD-derived systems allow connections regardless of permissions. The owner
; and group can be specified either by name or by their numeric IDs.
; Default Values: user and group are set as the running user
;                 mode is set to 0660
listen.owner = nginx
listen.group = nginx
...

按 Ctrl + X,并在提示时输入 Y 保存文件。

重启 PHP-FPM 服务。

$ sudo systemctl restart php8.0-fpm

第 4 步 - 安装 MySQL

Ubuntu 22.04 自带最新版本的 MySQL。你只需一条命令即可完成安装。

$ sudo apt install mysql-server

检查 MySQL 的版本。

$ mysql --version
mysql  Ver 8.0.29-0ubuntu0.22.04.2 for Linux on x86_64 ((Ubuntu))

此步骤对 MySQL 8.0.28 及以上版本是必需的。进入 MySQL Shell。

$ sudo mysql

运行以下命令为 root 用户设置密码。请确保密码包含数字、大写字母、小写字母和特殊字符的组合。

mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'YourPassword12!';

退出 shell。

mysql> exit

运行 MySQL 安全安装脚本。

$ sudo mysql_secure_installation

首先,系统会要求你输入 root 密码,请输入。接着会询问是否安装 Validate Password Component(密码验证组件),它用于检查 MySQL 中所用密码的强度。按 Y 安装它。

接下来,系统会要求你设置密码验证策略的级别。选择 2,因为它是最严格的级别。

接着,按 N 拒绝更改 root 密码。同时按 Y 以删除匿名用户、禁止远程 root 登录、删除测试数据库并重新加载权限表。

第 5 步 - 配置 MySQL

登录 MySQL shell。在提示时输入你的 root 密码。

$ sudo mysql -u root -p

为 Rainloop 创建一个数据库。

mysql> CREATE DATABASE rainloop;

创建一个用于访问该数据库的 SQL 用户。将 yourpassword 替换为你自己选择的密码。

mysql> CREATE USER 'rainuser'@'localhost' IDENTIFIED BY 'YourPassword23!';

授予 rainuser 对该数据库的访问权限。

mysql> GRANT ALL ON rainloop.* TO 'rainuser'@'localhost';

重新加载权限表。

mysql> FLUSH PRIVILEGES;

退出 shell。

mysql> exit

第 6 步 - 安装 Rainloop

为 Rainloop 创建公共目录。

$ sudo mkdir /var/www/html/rainloop -p

下载最新版本的 Rainloop。

$ wget http://www.rainloop.net/repository/webmail/rainloop-community-latest.zip

将下载的文件解压到公共目录。

$ sudo unzip rainloop-community-latest.zip -d /var/www/html/rainloop

将该目录的所有权更改为 Nginx。

$ sudo chown -R nginx:nginx /var/www/html/rainloop

设置 Rainloop 所需的读写权限。

$ sudo find /var/www/html/rainloop -type d -exec chmod 755 {} \;
$ sudo find /var/www/html/rainloop -type f -exec chmod 644 {} \;

第 7 步 - 安装 SSL

我们需要安装 Certbot,以生成由 Let's Encrypt 提供的免费 SSL 证书。

你既可以使用 Ubuntu 的仓库安装 Certbot,也可以通过 Snapd 工具获取最新版本。我们将使用 Snapd 版本。

Ubuntu 22.04 默认已安装 Snapd。运行以下命令,确保你的 Snapd 版本为最新。

$ sudo snap install core

安装 Certbot。

$ sudo snap install --classic certbot

使用以下命令在 /usr/bin 目录中创建符号链接,以确保可以运行 certbot 命令。

$ sudo ln -s /snap/bin/certbot /usr/bin/certbot

为 Rainloop 生成 SSL 证书。

$ sudo certbot certonly --standalone --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m 
[email protected]
 -d rainloop.example.com

生成 Diffie-Hellman 组证书。

$ sudo openssl dhparam -out /etc/ssl/certs/dhparam.pem 4096

打开文件 /etc/letsencrypt/renewal/rainloop.example.com.conf 进行编辑。

$ sudo nano /etc/letsencrypt/renewal/rainloop.example.com.conf

在底部粘贴以下代码。

pre_hook = systemctl stop nginx
post_hook = systemctl start nginx

按 Ctrl + X,并在提示时输入 Y 保存文件。

我们使用 Certbot 的 standalone 选项生成了 SSL 证书。它会运行自带的 Web 服务器来创建证书,这意味着在续期期间应关闭 Nginx。pre_hook 和 post_hook 命令分别在续期前后运行,用于自动关闭和重启 Nginx 服务器,因此无需人工干预。

要检查 SSL 续期是否正常工作,可对该流程进行一次预演(dry run)。

$ sudo certbot renew --dry-run

如果没有出现错误,就说明一切就绪。你的证书将自动续期。

第 8 步 - 配置 Nginx

打开文件 nginx.conf 进行编辑。

$ sudo nano /etc/nginx/nginx.conf

找到 include /etc/nginx/conf.d/*.conf; 这一行,并在其下方粘贴以下代码。

server_names_hash_bucket_size  64;

按 Ctrl + X,并在提示时输入 Y 保存文件。

创建 Rainloop 的 Nginx 配置文件并打开进行编辑。

$ sudo nano /etc/nginx/conf.d/rainloop.conf

在其中粘贴以下代码。

server {

    listen 443 ssl http2;
    listen [::]:443 ssl http2;

    server_name rainloop.example.com;
    root /var/www/html/rainloop;

    index index.php;
    client_max_body_size 25M;

    access_log  /var/log/nginx/rainloop.access.log;
    error_log   /var/log/nginx/rainloop.error.log;

    ssl_certificate      /etc/letsencrypt/live/rainloop.example.com/fullchain.pem;
    ssl_certificate_key  /etc/letsencrypt/live/rainloop.example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/rainloop.example.com/chain.pem;
    
    ssl_session_timeout  5m;
    ssl_session_cache shared:MozSSL:10m;
    ssl_session_tickets off;
    
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
    ssl_ecdh_curve X25519:prime256v1:secp384r1:secp521r1;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_dhparam /etc/ssl/certs/dhparam.pem;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_index index.php;
        fastcgi_split_path_info ^(.+\.php)(.*)$;
        fastcgi_keep_conn on;
        include fastcgi_params;
        fastcgi_pass unix:/run/php/php8.0-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

    location ~ /\.ht {
        deny all;
    }

    location ^~ /data {
        deny all;
    }
}
# enforce HTTPS
server {
    listen 80;
    listen [::]:80;
    server_name  rainloop.example.com;
    return 301   https://$host$request_uri;
}

按 Ctrl + X,并在提示时输入 Y 保存文件。

检查 Nginx 配置语法。

$ sudo nginx -t

重启 Nginx 服务。

$ sudo systemctl restart nginx

第 9 步 - 配置并访问 Rainloop

通过 URL https://rainloop.example.com/?admin 打开 Rainloop 的管理员页面,你将看到如下登录界面。

在 Ubuntu 22.04 系统上完整安装配置 Rainloop Webmail 网页邮箱教程

输入以下凭据并按回车登录。

Username: admin
Password: 12345

Rainloop 管理员仪表板将会打开,并附带一条修改默认密码的警告。

在 Ubuntu 22.04 系统上完整安装配置 Rainloop Webmail 网页邮箱教程

使用仪表板中的链接修改默认密码。

在 Ubuntu 22.04 系统上完整安装配置 Rainloop Webmail 网页邮箱教程

输入新密码并点击 Update Password 按钮继续。

Rainloop 使用 MySQL 存储联系人信息。打开 Contacts 页面,并从下拉菜单中选择 MySQL。

在 Ubuntu 22.04 系统上完整安装配置 Rainloop Webmail 网页邮箱教程

输入前面创建的数据库凭据。

在 Ubuntu 22.04 系统上完整安装配置 Rainloop Webmail 网页邮箱教程

点击 Test 按钮检查连接并安装数据表。如果按钮变为绿色,说明连接成功。

添加你的邮件账户后,即可开始使用 Rainloop。

结语

你已成功在 Ubuntu 22.04 服务器上安装了 Rainloop。如有任何疑问,欢迎留言交流。