如何在 Debian 11 上安装 Monica Personal Relationship Manager
本教程适用于这些操作系统版本
- Debian 11（Bullseye）
- Debian 10（Buster）
在此页
- 先决条件
- 安装 Nginx 网络服务器
- 安装 MariaDB 服务器
- 安装和配置 PHP-FPM 8.1
- 设置 MariaDB 数据库和用户
- 安装作曲家
- 安装 Node.js 和 Yarn
- 安装 Monica CRM
- 设置 Nginx 服务器块
- 完成
- 结论
Monica CRM 是一个用 PHP 编写的免费开源 CRM（客户关系管理器）。 Monica CRM 帮助您跟踪个人事件、活动、工作信息、联系人、日记、笔记等等。
Monica CRM 提供了如此多的功能，例如联系人管理和联系人之间的关系、提醒、活动和任务管理、基本日记、导入和导出数据、上传文档和照片等媒体文件等等。它可以通过多种方式安装，通过 Docker、手动在服务器 (VPS) 上或使用 PaaS（平台即服务）。
在本指南中，您将了解如何在 Debian 11 服务器上安装 Personal Relationship Manager 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 服务器等 Web 服务器。
在本指南中，您将使用 Nginx Web 服务器运行 Monica CRM。所以，现在你将把 Nginx 包安装到你的 Debian 服务器上。
在开始安装软件包之前，运行以下 apt 命令来更新和刷新 Debian 软件包索引。
sudo apt update现在，通过下面的 apt 命令安装 Nginx 包。当提示确认安装时，输入 Y 并按 ENTER 继续。
sudo apt install nginx
安装 Nginx 后，通过下面的 systemctl 命令验证 nginx 服务以确保其正在运行。
sudo systemctl is-enabled nginx
sudo systemctl status nginx您现在将看到 nginx 服务已启用并将在系统启动时自动运行。而现在Nginx服务的状态是running。
安装 MariaDB 服务器
Monica CRM 支持安装 MySQL/MariaDB。现在您将 MariaDB 安装到您的 Debian 服务器。您还将通过脚本 mysql_secure_installation 保护 MariaDB 服务器的部署。
通过下面的 apt 命令安装 MariaDB 服务器。当提示确认安装时，输入 Y 并按 ENTER 继续。
sudo apt install mariadb-server
如果安装了 MariaDB，请验证 MariaDB 服务并确保该服务正在运行。运行以下 systemctl 命令。
sudo systemctl is-enabled mariadb
sudo systemctl status mariadb您将看到 MariaDB 服务器已启用并将在系统启动时自动运行。 MariaDB服务的当前状态是运行。
接下来，您将通过脚本 mysql_secure_installation 保护 MariaDB 服务器部署，该脚本由 MariaDB 包提供。
运行以下命令以开始保护 MariaDB 部署。
sudo mysql_secure_installation您将被询问有关多个 MariaDB 配置的信息：
- 将身份验证更改为 unix_socket？输入 n。
- 更改 MariaDB root 密码？输入 y 确认，输入 MariaDB 服务器的新密码并重复密码。
- 禁用远程根登录？输入 y 以确认 - 不应允许 root 用户远程连接。删除匿名用户？输入 y 确认。
- 删除默认数据库测试？输入 y 确认并删除测试数据库。
- 最后，输入 y 以重新加载表权限并应用新的更改。
MariaDB 服务器现已安装并受到保护。
安装和配置 PHP-FPM 8.1
Monica CRM 是基于 PHP 的 Web 应用程序，因此您必须将 PHP 软件包安装到您的 Debian 服务器。当前版本的 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 的新存储库已添加，并且包索引已自动刷新和更新。
接下来，通过下面的 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 继续。
安装 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完成后保存文件并关闭编辑器。
接下来，重新启动 PHP-FPM 8.1 服务以通过下面的 systemctl 命令应用新的更改。
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 Stack 现已安装和配置，接下来开始为 Monica CRM 创建新的数据库和用户。
设置 MariaDB 数据库和用户
要为 Monica CRM 安装设置 MariaDB 数据库和用户，您必须登录到 MariaDB shell。
通过下面的 mysql 命令登录到 MariaDB shell。
sudo mysql -u root -p运行以下查询为 Monica CRM 创建新的数据库和用户。对于本指南，您将使用 MariaDB 用户 [email 创建一个新的数据库 monicacrm_db。另外，请务必使用新密码更改密码。
CREATE DATABASE monicacrm_db;
CREATE USER ;
GRANT ALL ON monicacrm_db.* TO 'monica'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
接下来，运行以下查询以验证 MariaDB 用户 [email 的权限。
SHOW GRANTS FOR ;
quit您将看到 MariaDB 用户 [email 被允许访问 Monica CRM 数据库 monicacrm_db。
安装作曲家
配置 MariaDB 数据库和用户后，您现在将安装用于为 Monica CRM 安装 PHP 依赖项的 Composer。
通过下面的单行命令安装 Composer。此命令将下载 Composer 的安装程序脚本并运行它。然后，将 Composer 安装到 /usr/bin/composer。
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/bin --filename=composer
安装 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 存储库已添加到 ypur Debian 系统并且包索引已刷新。
接下来，运行以下命令将 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 确认并继续。
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 编译静态文件。
安装莫妮卡 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 更改为生产环境，将 APP_URL 更改为安装 Monica CRM 的域名。然后，使用您之前创建的数据库和用户更改 MariaDB 数据库的详细信息。
APP_ENV=production
...
APP_URL=https://hwdomain.io/
...
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 依赖项安装。
安装依赖项后，您将看到如下输出：
接下来，创建另一个新目录，用于存储 JavaScript 包缓存。然后，将所有权更改为 www-data。
sudo mkdir -p /var/www/.yarn
sudo chown -R www-data:www-data /var/www/.yarn之后，为 Monica CRM Web 应用程序安装 JavaScript 包，并通过下面的 yarn 命令为生产环境生成静态文件。
sudo -u www-data yarn install
sudo -u www-data yarn run production下面你可以看到JavaScript包的下载过程。
下面你可以看到编译静态文件时的过程。
编译静态文件时，您会看到诸如“Compiled Successfully in ...”之类的输出消息。
现在，运行以下命令为 Monica CRM 生成应用程序密钥。然后，迁移数据库以用于生产。当提示确认操作时，输入 yes 并按 ENTER 继续。
sudo -u www-data php artisan key:generate
sudo -u www-data php artisan setup:production -v
迁移数据库后，您将看到如下输出：
最后，要完成 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 证书，您可以通过 Letsencrypt 生成免费的 SSL。
使用 nano 编辑器创建一个新文件 /etc/nginx/sites-available/monicacrm。
sudo nano /etc/nginx/sites-available/monicacrm添加下面的 Nginx 配置。并且一定要更改SSL证书的域名和路径。
server {
listen 80;
server_name hwdomain.io;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
ssl_certificate /etc/letsencrypt/live/hwdomain.io/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/hwdomain.io/private.key;
server_name hwdomain.io;
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 服务并应用 nee 服务器块配置。
sudo systemctl restart nginx现在可以通过 Web 浏览器访问您的 Monica CRM 安装。
整理起来
打开网络浏览器并访问您安装的 Monica CRM 的域名（即：https://hwdomain.io/）。在第一次设置中，您需要为您的 Monica CRM 安装注册一个帐户。
输入详细的用户名、密码和电子邮件地址。然后点击注册。
用户注册后，您现在将看到 Monica CRM 用户仪表板。
结论
在本教程中，您已在 Debian 11 服务器上安装了 Monica CRM。您还在 Debian 服务器上配置了 LEMP Stack（Nginx、MariaDB 和 PHP-FPM），安装了 PHP 包管理 Composer，并安装了 Node.js 和 Yarn。
在本教程中，您现在已经通过 HTTPS 连接安装并保护了 Monica CRM。现在您可以开始组织您的联系人、创建日记并跟踪与您的联系人有关的每一件重要事情。