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

  • Debian 11 (Bullseye)
  • Debian 10 (Buster)

本页内容

  • 先决条件
  • 安装 Nginx Web 服务器
  • 安装 MariaDB 服务器
  • 安装并配置 PHP-FPM 8.1
  • 配置 MariaDB 数据库和用户
  • 安装 Composer
  • 安装 Node.js 和 Yarn
  • 安装 Monica CRM
  • 配置 Nginx 服务器块
  • 收尾工作
  • 总结

Monica CRM 是一个用 PHP 编写的自由开源 CRM(客户关系管理器)。Monica CRM 可帮助你跟踪个人事件、活动、工作信息、联系人、日志、笔记以及更多内容。

Monica CRM 提供了许多功能,例如联系人管理以及联系人之间的关系、提醒、活动和任务管理、基础日志记录、导入和导出数据、上传文档和照片等媒体文件,以及更多功能。它可以通过多种方式安装,如通过 Docker、在服务器(VPS)上手动安装,或使用 PaaS(平台即服务)。

在本指南中,你将了解如何在 Debian 11 服务器上安装个人关系管理器 Monica CRM。你还将安装并配置 LEMP 栈(Nginx、MariaDB、PHP-FPM),通过 Composer 安装 PHP 依赖,并使用 Node.js 和 Yarn 安装和编译静态资源。

先决条件

要让本教程生效,你需要一台 Debian 11 服务器,并配置好具有 root 或管理员权限的非 root 用户。此外,如果你打算部署到生产环境,你需要一个指向你 Debian 服务器 IP 地址的域名。另外,建议在生产环境的 Debian 服务器上开启防火墙。

安装 Nginx Web 服务器

Monica CRM 是一个主要用 PHP 编写的 Web 应用程序。要安装 Monica CRM,你可以使用 Apache2、Nginx 或 Caddy 等 Web 服务器。

在本指南中,你将使用 Nginx Web 服务器运行 Monica CRM。因此,现在你将把 Nginx 软件包安装到你的 Debian 服务器上。

在开始安装软件包之前,运行以下 apt 命令以更新并刷新 Debian 软件包索引。

sudo apt update

现在,通过下面的 apt 命令安装 Nginx 软件包。当提示确认安装时,输入 Y 并按 ENTER 继续。

sudo apt install nginx

在 Debian 11 上从零搭建 Monica 个人关系管理系统

一旦 Nginx 安装完成,通过下面的 systemctl 命令验证 'nginx' 服务,以确保它正在运行。

sudo systemctl is-enabled nginx
sudo systemctl status nginx

你现在会看到 'nginx' 服务已启用,并将在系统启动时自动运行。Nginx 服务的当前状态为正在运行。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

安装 MariaDB 服务器

Monica CRM 支持使用 MySQL/MariaDB 进行安装。现在你将把 MariaDB 安装到你的 Debian 服务器上。你还将通过 'mysql_secure_installation' 脚本保护 MariaDB 服务器的部署。

通过下面的 apt 命令安装 MariaDB 服务器。当提示确认安装时,输入 Y 并按 ENTER 继续。

sudo apt install mariadb-server

在 Debian 11 上从零搭建 Monica 个人关系管理系统

如果 MariaDB 已安装,验证 MariaDB 服务并确保服务正在运行。运行以下 systemctl 命令。

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

你将看到 MariaDB 服务器已启用,并将在系统启动时自动运行。MariaDB 服务的当前状态为正在运行。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

接下来,你将通过 MariaDB 软件包提供的 'mysql_secure_installation' 脚本保护 MariaDB 服务器的部署。

运行以下命令开始保护 MariaDB 部署。

sudo mysql_secure_installation

你将被询问多个 MariaDB 配置:

  • 将认证方式更改为 unix_socket?输入 n。
  • 更改 MariaDB root 密码?输入 y 确认,输入 MariaDB 服务器的新密码并重复密码。
  • 禁用远程 root 登录?输入 y 确认 —— root 用户不应被允许远程连接。删除匿名用户?输入 y 确认。
  • 删除默认数据库 'test'?输入 y 确认并删除测试数据库。
  • 最后,输入 y 重新加载表权限并应用新更改。

MariaDB 服务器现已安装并受到保护。

安装并配置 PHP-FPM 8.1

Monica CRM 是一个基于 PHP 的 Web 应用程序,因此你必须在 Debian 服务器上安装 PHP 软件包。当前版本的 Monica CRM 至少需要 PHP v8.1 或更新版本。

对于 Debian 11 系统,你将通过第三方软件源安装 PHP 8.1 软件包。你现在将通过 sury.org 软件源安装 PHP-FPM 8.1,并根据 Monica CRM 的要求配置你的 PHP 安装。

运行以下命令将 PHP 8.1 软件源添加到你的 Debian 服务器。

curl -sSL https://packages.sury.org/php/README.txt | sudo bash -x

现在你将看到 PHP 8.1 的新软件源已添加,并且软件包索引已自动刷新和更新。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

接下来,通过下面的 apt 命令安装 PHP-FPM 8.1 软件包。

sudo apt install php8.1 php8.1-cli php8.1-fpm php8.1-common php8.1-mbstring php8.1-xml php8.1-mysql php8.1-curl php8.1-zip php8.1-intl php8.1-bcmath php8.1-gd php8.1-gmp php8.1-redis

输入 Y 确认安装并按 ENTER 继续。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

PHP 8.1 安装完成后,使用 nano 编辑器命令编辑配置文件 '/etc/php/8.1/fpm/php.ini'。

sudo nano /etc/php/8.1/fpm/php.ini

使用以下设置更改默认的 PHP 配置。

date.timezone = Europe/Paris
max_execution_time = 130
memory_limit = 256M
post_max_size = 128M
upload_max_filesize = 128M

完成后保存文件并关闭编辑器。

接下来,通过下面的 systemctl 命令重启 PHP-FPM 8.1 服务以应用新更改。

sudo systemctl restart php8.1-fpm

最后,运行以下 systemctl 命令验证 PHP-FPM 8.1 服务,并确保服务已启用且正在运行。

sudo systemctl is-enabled php8.1-fpm
sudo systemctl status php8.1-fpm

你将看到 PHP-FPM 8.1 已启用,并将在系统启动时自动运行。PHP-FPM 8.1 服务的当前状态为正在运行。

LEMP 栈现已安装并配置完成,接下来开始为 Monica CRM 创建新的数据库和用户。

配置 MariaDB 数据库和用户

要为 Monica CRM 安装配置 MariaDB 数据库和用户,你必须登录到 MariaDB shell。

通过下面的 mysql 命令登录到 MariaDB shell。

sudo mysql -u root -p

运行以下查询为 Monica CRM 创建新的数据库和用户。在本指南中,你将创建一个名为 monicacrm_db 的新数据库,以及 MariaDB 用户 monica@localhost。同时,请务必将密码更改为新密码。

CREATE DATABASE monicacrm_db;
CREATE USER monica@localhost;
GRANT ALL ON monicacrm_db.* TO 'monica'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

在 Debian 11 上从零搭建 Monica 个人关系管理系统

接下来,运行以下查询来验证 MariaDB 用户 monica@localhost 的权限。

SHOW GRANTS FOR monica@localhost;
quit

你将看到 MariaDB 用户 monica@localhost 被允许访问 Monica CRM 数据库 monicacrm_db。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

安装 Composer

配置好 MariaDB 数据库和用户后,你现在将安装 Composer,它将用于为 Monica CRM 安装 PHP 依赖。

通过下面的一行命令安装 Composer。该命令将下载 Composer 安装脚本并运行它。然后,将 Composer 安装到 /usr/bin/composer。

curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/bin --filename=composer

在 Debian 11 上从零搭建 Monica 个人关系管理系统

Composer 安装完成后,使用以下 composer 命令进行验证。你应该看到 Composer 的详细版本以及如何使用 Composer 的帮助页面。

sudo -u www-data composer -v

安装 Node.js 和 Yarn

安装 Composer 后,你现在将安装 Node.js 和 Yarn。这两个软件包都将用于为 Monica CRM 编译静态文件。当前版本的 Monica CRM 至少需要 Node.js v16。

默认的 Debian 软件源提供 Node.js v12,因此你将通过第三方软件源 Nodesource 安装最新版本的 Node.js。

运行以下命令添加 Node.js Nodesource 软件源。在本示例中,你将安装 Node.js v16。

curl -fsSL https://deb.nodesource.com/setup_16.x | bash -

现在你将看到 Nodesource 软件源已添加到你的 Debian 系统,并且软件包索引已刷新。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

接下来,运行以下命令将 Yarn 软件包软件源添加到你的系统。

curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/yarnkey.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/yarnkey.gpg] https://dl.yarnpkg.com/debian stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

现在更新并刷新你的 Debian 软件包索引。然后,通过以下 apt 命令安装 Node.js 和 Yarn。

sudo apt update
sudo apt install nodejs yarn

输入 y 确认安装并按 ENTER 确认并继续。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

Node.js 和 Yarn 安装完成后,运行以下命令检查这两个应用程序的二进制文件。

which node
which yarn

最后,使用以下命令检查 Node.js 和 Yarn 的版本。你将在输出中看到已安装的 Node.js 和 Yarn 版本。

node --version
yarn --version

至此,Monica CRM 的软件包依赖已安装完成。接下来,你将开始安装 Monica CRM:下载源代码、通过 Composer 安装软件包依赖,然后使用 Node.js 和 Yarn 编译静态文件。

安装 Monica CRM

现在你将开始安装 Monica CRM。你将下载源代码、设置正确的权限和所有权、通过 Composer 安装 PHP 依赖、通过 Yarn 和 Node.js 安装并生成静态文件,然后生成应用密钥并为生产环境迁移数据库。

在开始安装之前,请确保已安装 git 软件包。如果没有,你可以通过下面的 apt 命令安装它。

sudo apt install git -y

现在,将工作目录切换到 "/var/www/",并通过下面的 git 命令下载 Monica CRM 源代码。你将看到新目录 "monica"。

cd /var/www/
git clone https://github.com/monicahq/monica.git

切换到 "/var/www/monica" 目录,并将 master 分支切换到特定版本 "3.7.0"。你可以查看 Monica CRM 的 GitHub 页面以获取 Monica CRM 的详细版本信息。

cd /var/www/monica
git checkout tags/v3.7.0

接下来,将默认配置 .env.example 复制为 .env。然后,将所有权更改为 'www-data'。

cp /var/www/monica/.env.example /var/www/monica/.env
sudo chown www-data:www-data /var/www/monica/.env

使用 nano 编辑器编辑 .env 文件。

nano /var/www/monica/.env

将 'APP_ENV' 更改为 production,将 'APP_URL' 更改为你的 Monica CRM 安装的域名。然后,使用你之前创建的数据库和用户更改 MariaDB 数据库的相关信息。

APP_ENV=production
...
APP_URL=https://example.local/
...
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
...
DB_DATABASE=monica
DB_USERNAME=homestead
DB_PASSWORD=password

完成后保存文件并退出编辑器。

现在运行以下命令,将 Monica CRM 安装目录 '/var/www/monica' 的所有权更改为用户 www-data。然后,创建另一个目录 '/var/www/.cache',并将所有权更改为 www-data。

sudo chown -R www-data:www-data /var/www/monica
sudo mkdir -p /var/www/.cache
sudo chown -R www-data:www-data /var/www/.cache

接下来,运行以下 composer 命令以为 Monica CRM 安装 PHP 软件包依赖。

sudo -u www-data composer install --no-interaction --no-dev

你可以在下方看到 PHP 依赖的安装过程。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

依赖安装完成后,你将看到类似以下的输出:

在 Debian 11 上从零搭建 Monica 个人关系管理系统

接下来,创建另一个新目录,用于存储 JavaScript 软件包的缓存。然后,将所有权更改为 www-data。

sudo mkdir -p /var/www/.yarn
sudo chown -R www-data:www-data /var/www/.yarn

之后,通过下面的 yarn 命令为 Monica CRM Web 应用程序安装 JavaScript 软件包,并为生产环境生成静态文件。

sudo -u www-data yarn install
sudo -u www-data yarn run production

你可以在下方看到 JavaScript 软件包的下载过程。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

你可以在下方看到编译静态文件时的过程。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

静态文件编译完成后,你将看到类似 "Compiled Successfully in ..." 的输出信息。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

现在,运行以下命令为 Monica CRM 生成应用密钥。然后,为生产环境迁移数据库。当提示确认操作时,输入 'yes' 并按 ENTER 继续。

sudo -u www-data php artisan key:generate
sudo -u www-data php artisan setup:production -v

在 Debian 11 上从零搭建 Monica 个人关系管理系统

数据库迁移完成后,你将看到类似以下的输出:

在 Debian 11 上从零搭建 Monica 个人关系管理系统

最后,要完成 Monica CRM 配置,你还需要创建一个 Cronjob。运行以下命令为 www-data 用户创建一个新的 cron。

crontab -u www-data -e

选择你偏好的编辑器,并将以下配置粘贴到文件中。

* * * * *   /usr/bin/php /var/www/monica/artisan schedule:run >> /dev/null 2>&1

完成后保存文件并退出编辑器。

为确保 Monica CRM 安装目录的权限,运行以下命令将所有权更改为 www-data。然后,将 'storage' 目录的权限更改为 775。

sudo chown -R www-data:www-data /var/www/monica
sudo chmod -R 775 /var/www/monica/storage

至此,你已完成了 Monica CRM 的配置。接下来,你将为 Monica CRM 配置 Nginx 服务器块。

配置 Nginx 服务器块

在设置 Nginx 服务器块之前,请确保你的域名已指向服务器 IP 地址,并且你已拥有 SSL 证书。如果你没有 SSL 证书,可以通过 Let's Encrypt 生成免费的 SSL。

使用 nano 编辑器创建新文件 '/etc/nginx/sites-available/monicacrm'。

sudo nano /etc/nginx/sites-available/monicacrm

添加下面的 Nginx 配置。并确保更改域名和 SSL 证书的路径。

server {
    listen 80;
    server_name example.local;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    ssl_certificate /etc/letsencrypt/live/example.local/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.local/private.key;
    server_name example.local;
    root /var/www/monica/public;
    index index.php;
    location / {
        try_files $uri $uri/ /index.php?$args;
    }
    
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
    }
}

完成后保存文件并退出编辑器。

接下来,运行以下命令以激活 Nginx 服务器块 'monicacrm'。然后,验证 Nginx 配置以确保配置正确。

sudo ln -s /etc/nginx/sites-available/monicacrm /etc/nginx/sites-enabled/
sudo nginx -t

如果你的 Nginx 配置正确,你应该看到类似 "Syntax OK - test successfully" 的输出信息。

现在,运行以下 systemctl 命令重启 Nginx 服务并应用新的服务器块配置。

sudo systemctl restart nginx

你的 Monica CRM 安装现在可以通过 Web 浏览器访问了。

收尾工作

打开 Web 浏览器并访问你的 Monica CRM 安装的域名(例如:https://example.local/)。在首次设置时,你需要为你的 Monica CRM 安装注册一个账户。

输入用户名、密码和电子邮件地址等详细信息。然后点击 Register。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

用户注册后,你现在将看到 Monica CRM 用户仪表板。

在 Debian 11 上从零搭建 Monica 个人关系管理系统

总结

在本教程中,你已在 Debian 11 服务器上安装了 Monica CRM。你还在 Debian 服务器上配置了 LEMP 栈(Nginx、MariaDB 和 PHP-FPM),安装了 PHP 软件包管理工具 Composer,并安装了 Node.js 和 Yarn。

通过本教程,你现在已安装 Monica CRM 并通过 HTTPS 连接对其进行了保护。现在你可以开始整理你的联系人、创建日志,并记录有关联系人的每一个重要事项。