本教程适用于以下操作系统版本
- 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 的管理员页面,你将看到如下登录界面。

输入以下凭据并按回车登录。
Username: admin
Password: 12345
Rainloop 管理员仪表板将会打开,并附带一条修改默认密码的警告。

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

输入新密码并点击 Update Password 按钮继续。
Rainloop 使用 MySQL 存储联系人信息。打开 Contacts 页面,并从下拉菜单中选择 MySQL。

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

点击 Test 按钮检查连接并安装数据表。如果按钮变为绿色,说明连接成功。
添加你的邮件账户后,即可开始使用 Rainloop。
结语
你已成功在 Ubuntu 22.04 服务器上安装了 Rainloop。如有任何疑问,欢迎留言交流。