Cách cài đặt Monica Personal Relationship Manager trên Debian 11

[theanh]

Monica CRM là CRM (Quản lý quan hệ khách hàng) miễn phí và mã nguồn mở được viết bằng PHP. Monica CRM giúp bạn theo dõi các sự kiện cá nhân, hoạt động, thông tin công việc, danh bạ, nhật ký, ghi chú và nhiều tính năng khác.

Monica CRM cung cấp rất nhiều tính năng như quản lý danh bạ và mối quan hệ giữa các danh bạ, lời nhắc, hoạt động và quản lý tác vụ, nhật ký cơ bản, nhập và xuất dữ liệu, tải lên các tệp phương tiện như Tài liệu và ảnh và nhiều tính năng khác. Có thể cài đặt theo nhiều cách, thông qua Docker, thủ công trên máy chủ (VPS) hoặc sử dụng PaaS (Nền tảng dưới dạng dịch vụ).

Trong hướng dẫn này, bạn sẽ tìm hiểu cách cài đặt Personal Relationship Manager Monica CRM trên máy chủ Debian 11. Bạn cũng sẽ cài đặt và cấu hình LEMP Stack (Nginx, MariaDB, PHP-FPM), cài đặt các phụ thuộc PHP thông qua Composer, cài đặt và biên dịch các tài sản tĩnh bằng Node.js và Yarn.

Điều kiện tiên quyết​

Để hướng dẫn này hoạt động, bạn sẽ cần một máy chủ Debian 11 và cấu hình người dùng không phải root với quyền root hoặc quản trị viên. Ngoài ra, nếu bạn có kế hoạch triển khai trên môi trường sản xuất, bạn sẽ cần một tên miền được trỏ đến địa chỉ IP máy chủ Debian của mình. Ngoài ra, bạn nên bật Tường lửa trên máy chủ Debian của mình trên môi trường sản xuất.

Cài đặt Máy chủ web Nginx​

Monica CRM là một ứng dụng web chủ yếu được viết bằng PHP. Để cài đặt Monica CRM, bạn có thể sử dụng máy chủ web như máy chủ web Apache2, Nginx hoặc Caddy.

Trong hướng dẫn này, bạn sẽ chạy Monica CRM bằng máy chủ web Nginx. Bây giờ, bạn sẽ cài đặt các gói Nginx vào máy chủ Debian của mình.

Trước khi bắt đầu cài đặt các gói, hãy chạy lệnh apt sau để cập nhật và làm mới chỉ mục gói Debian.

sudo apt update

Bây giờ, hãy cài đặt các gói Nginx thông qua lệnh apt bên dưới. Khi được nhắc xác nhận cài đặt, hãy nhập Y và nhấn ENTER để tiếp tục.

sudo apt install nginx

Sau khi Nginx được cài đặt, hãy xác minh dịch vụ 'nginx' để đảm bảo rằng nó đang chạy thông qua lệnh systemctl bên dưới.

sudo systemctl is-enabled nginx
sudo systemctl status nginx

Bây giờ bạn sẽ thấy dịch vụ 'nginx' được bật và sẽ tự động chạy khi khởi động hệ thống. Và trạng thái của dịch vụ Nginx hiện đang chạy.

Cài đặt Máy chủ MariaDB​

Monica CRM hỗ trợ MySQL/MariaDB để cài đặt. Bây giờ bạn sẽ cài đặt MariaDB vào máy chủ Debian của mình. Bạn cũng sẽ bảo mật việc triển khai máy chủ MariaDB thông qua tập lệnh 'mysql_secure_installation'.

Cài đặt máy chủ MariaDB thông qua lệnh apt bên dưới. Khi được nhắc xác nhận cài đặt, hãy nhập Y và nhấn ENTER để tiếp tục.

sudo apt install mariadb-server

Nếu MariaDB đã được cài đặt, hãy xác minh dịch vụ MariaDB và đảm bảo dịch vụ đang chạy. Chạy lệnh systemctl sau.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Bạn sẽ thấy máy chủ MariaDB đã được bật và sẽ tự động chạy khi khởi động hệ thống. Và trạng thái hiện tại của dịch vụ MariaDB đang chạy.



Tiếp theo, bạn sẽ bảo mật việc triển khai máy chủ MariaDB thông qua tập lệnh 'mysql_secure_installation', được cung cấp bởi các gói MariaDB.

Chạy lệnh sau để bắt đầu bảo mật việc triển khai MariaDB.

sudo mysql_secure_installation

Bạn sẽ được hỏi về nhiều cấu hình MariaDB:

• Đổi xác thực thành unix_socket? nhập n.
• Đổi mật khẩu gốc MariaDB? nhập y để xác nhận, nhập mật khẩu mới cho máy chủ MariaDB của bạn và lặp lại mật khẩu.
• Vô hiệu hóa đăng nhập gốc từ xa? nhập y để xác nhận - người dùng gốc không được phép kết nối từ xa.Xóa người dùng ẩn danh? nhập y để xác nhận.
• Xóa cơ sở dữ liệu mặc định 'test'? nhập y để xác nhận và xóa cơ sở dữ liệu thử nghiệm.
• Cuối cùng, nhập y để tải lại các đặc quyền của bảng và áp dụng các thay đổi mới.

Máy chủ MariaDB hiện đã được cài đặt và bảo mật.

Cài đặt và cấu hình PHP-FPM 8.1​

Monica CRM là ứng dụng web dựa trên PHP, vì vậy bạn phải cài đặt các gói PHP vào máy chủ Debian của mình. Phiên bản hiện tại của Monica CRM yêu cầu ít nhất PHP v8.1 hoặc mới hơn.

Đối với hệ thống Debian 11, bạn sẽ cài đặt các gói PHP 8.1 thông qua kho lưu trữ của bên thứ ba. Bây giờ, bạn sẽ cài đặt PHP-FPM 8.1 thông qua kho lưu trữ sury.org và cấu hình cài đặt PHP của mình theo các yêu cầu của Monica CRM.

Chạy lệnh sau để thêm kho lưu trữ PHP 8.1 vào máy chủ Debian của bạn.

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

Bây giờ bạn sẽ thấy kho lưu trữ mới cho PHP 8.1 được thêm vào và chỉ mục gói được tự động làm mới và cập nhật.



Tiếp theo, cài đặt các gói PHP-FPM 8.1 thông qua lệnh apt bên dưới.

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

Nhập Y để xác nhận cài đặt và nhấn ENTER để tiếp tục.



Sau khi PHP 8.1 được cài đặt, hãy chỉnh sửa tệp cấu hình '/etc/php/8.1/fpm/php.ini' sử dụng lệnh trình soạn thảo nano.

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

Thay đổi cấu hình PHP mặc định bằng các thiết lập sau.

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

Lưu tệp và đóng trình soạn thảo khi bạn hoàn tất.

Tiếp theo, khởi động lại dịch vụ PHP-FPM 8.1 để áp dụng các thay đổi mới thông qua lệnh systemctl bên dưới.

sudo systemctl restart php8.1-fpm

Cuối cùng, chạy lệnh systemctl sau để xác minh dịch vụ PHP-FPM 8.1 và đảm bảo dịch vụ được bật và đang chạy.

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

Bạn sẽ thấy PHP-FPM 8.1 được bật và sẽ tự động chạy khi khởi động hệ thống. Và trạng thái hiện tại của dịch vụ PHP-FPM 8.1 đang chạy.

LEMP Stack hiện đã được cài đặt và định cấu hình, tiếp theo hãy bắt đầu tạo cơ sở dữ liệu và người dùng mới cho Monica CRM.

Thiết lập Cơ sở dữ liệu và Người dùng MariaDB​

Để thiết lập cơ sở dữ liệu và người dùng MariaDB cho quá trình cài đặt Monica CRM, bạn phải đăng nhập vào shell MariaDB.

Đăng nhập vào shell MariaDB thông qua lệnh mysql bên dưới.

sudo mysql -u root -p

Chạy các truy vấn sau để tạo cơ sở dữ liệu và người dùng mới cho Monica CRM. Đối với hướng dẫn này, bạn sẽ tạo một cơ sở dữ liệu mới monicacrm_db với người dùng MariaDB monica@localhost. Ngoài ra, hãy đảm bảo thay đổi mật khẩu bằng mật khẩu mới.

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

Tiếp theo, chạy truy vấn sau để xác minh các đặc quyền cho người dùng MariaDB monica@localhost.

SHOW GRANTS FOR monica@localhost;
quit

Và bạn sẽ thấy người dùng MariaDB monica@localhost được phép truy cập cơ sở dữ liệu Monica CRM monicacrm_db.

Cài đặt Composer​

Sau khi cơ sở dữ liệu MariaDB và người dùng được định cấu hình, bạn sẽ bây giờ hãy cài đặt Composer sẽ được sử dụng để cài đặt các phụ thuộc PHP cho Monica CRM.

Cài đặt Composer thông qua lệnh một dòng bên dưới. Lệnh này sẽ tải xuống tập lệnh cài đặt cho Composer và chạy nó. Sau đó, cài đặt Composer vào /usr/bin/composer.

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

Sau khi Composer được cài đặt, hãy xác minh bằng lệnh composer sau. Bạn sẽ thấy phiên bản chi tiết của Composer và trang trợ giúp về cách sử dụng Composer.

sudo -u www-data composer -v

Cài đặt Node.js và Yarn​

Sau khi cài đặt Composer, bây giờ bạn sẽ cài đặt Node.js và Yarn. Cả hai gói sẽ được sử dụng để biên dịch các tệp tĩnh cho Monica CRM. Và phiên bản hiện tại của Monica CRM yêu cầu ít nhất là Node.js v16.

Kho lưu trữ Debian mặc định cung cấp Node.js v12, vì vậy bạn sẽ cài đặt phiên bản mới nhất của Node.js thông qua kho lưu trữ của bên thứ ba Nodesource.

Chạy lệnh sau để thêm kho lưu trữ Node.js Nodesource. Trong ví dụ này, bạn sẽ cài đặt Node.js v16.

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

Bây giờ bạn sẽ thấy kho lưu trữ Nodesource được thêm vào hệ thống Debian của bạn và chỉ mục gói được làm mới.



Tiếp theo, hãy chạy lệnh sau để thêm kho lưu trữ gói Yarn vào hệ thống của bạn.

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

Bây giờ hãy cập nhật và làm mới chỉ mục gói Debian của bạn. Sau đó, cài đặt Node.js và Yarn thông qua lệnh apt sau.

sudo apt update
sudo apt install nodejs yarn

Nhập y để xác nhận cài đặt và nhấn ENTER để xác nhận và tiếp tục.



Sau khi Node.js và Yarn được cài đặt, hãy chạy lệnh sau để kiểm tra tệp nhị phân của cả hai ứng dụng.

which node
which yarn

Cuối cùng, hãy kiểm tra phiên bản Node.js và Yarn bằng lệnh sau. Bạn sẽ thấy phiên bản đã cài đặt của Node.js và Yarn trong đầu ra.

node --version
yarn --version

Tại thời điểm này, các gói phụ thuộc cho Monica CRM đã được cài đặt. Tiếp theo, bạn sẽ bắt đầu cài đặt Monica CRM bằng cách tải xuống mã nguồn, cài đặt các gói phụ thuộc thông qua Composer, sau đó biên dịch các tệp tĩnh bằng Node.js và Yarn.

Cài đặt Monica CRM​

Bây giờ bạn sẽ bắt đầu cài đặt Monica CRM. Bạn sẽ tải xuống mã nguồn, thiết lập quyền và quyền sở hữu chính xác, cài đặt các phụ thuộc PHP thông qua Composer, cài đặt và tạo các tệp tĩnh thông qua Yarn và Node.js, sau đó tạo khóa ứng dụng và di chuyển cơ sở dữ liệu để sản xuất.

Trước khi bắt đầu cài đặt, hãy đảm bảo rằng gói git đã được cài đặt. Nếu chưa, bạn có thể cài đặt thông qua lệnh apt bên dưới.

sudo apt install git -y

Bây giờ, hãy di chuyển thư mục làm việc đến "/var/www/" và tải xuống mã nguồn Monica CRM thông qua lệnh git như bên dưới. Bạn sẽ thấy thư mục mới "monica".

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

Di chuyển đến thư mục "/var/www/monica" và di chuyển nhánh chính đến phiên bản cụ thể "3.7.0". Bạn có thể kiểm tra trang GitHub của Monica CRM để biết phiên bản chi tiết của Monica CRM.

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

Tiếp theo, sao chép cấu hình mặc định .env.example vào .env. Sau đó, thay đổi quyền sở hữu thành 'www-data'.

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

Chỉnh sửa tệp .env bằng trình chỉnh sửa nano.

nano /var/www/monica/.env

Thay đổi 'APP_ENV' thành production và 'APP_URL' thành tên miền cài đặt Monica CRM của bạn. Sau đó, thay đổi thông tin chi tiết của cơ sở dữ liệu MariaDB bằng cơ sở dữ liệu và người dùng mà bạn đã tạo trước đó.

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

Lưu tệp và thoát khỏi trình chỉnh sửa khi bạn hoàn tất.

Bây giờ hãy chạy lệnh sau để thay đổi quyền sở hữu thư mục cài đặt Monica CRM '/var/www/monica' thành người dùng www-data. Sau đó, tạo một thư mục khác '/var/www/.cache' và đổi quyền sở hữu thành 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

Tiếp theo, chạy lệnh composer sau để cài đặt các gói phụ thuộc PHP cho Monica CRM.

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

Bên dưới, bạn có thể thấy cài đặt các gói phụ thuộc PHP.



Sau khi các gói phụ thuộc được cài đặt, bạn sẽ thấy đầu ra như sau:



Tiếp theo, tạo một thư mục mới khác sẽ được sử dụng để lưu trữ bộ đệm của các gói JavaScript. Sau đó, hãy thay đổi quyền sở hữu thành www-data.

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

Sau đó, hãy cài đặt các gói JavaScript cho các ứng dụng web Monica CRM và tạo các tệp tĩnh cho môi trường sản xuất thông qua lệnh yarn bên dưới.

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

Dưới đây, bạn có thể thấy quy trình tải xuống các gói JavaScript.



Dưới đây, bạn có thể thấy quy trình khi biên dịch các tệp tĩnh.



Khi các tệp tĩnh được biên dịch, bạn sẽ thấy thông báo đầu ra như "Đã biên dịch thành công trong ...".



Bây giờ, hãy chạy lệnh sau để tạo khóa ứng dụng cho Monica CRM. Sau đó, di chuyển cơ sở dữ liệu để sản xuất. Khi được nhắc xác nhận hành động, hãy nhập 'yes' và nhấn ENTER để tiếp tục.

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

Sau khi cơ sở dữ liệu được di chuyển, bạn sẽ thấy đầu ra như sau:



Cuối cùng, để hoàn tất cấu hình Monica CRM, bạn cũng sẽ cần tạo một Cronjob. Chạy lệnh sau để tạo một cron mới cho người dùng www-data.

crontab -u www-data -e

Chọn trình soạn thảo bạn thích và thử cấu hình sau cho tệp.

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

Lưu tệp và thoát khỏi trình soạn thảo khi bạn hoàn tất.

Để đảm bảo quyền của thư mục cài đặt Monica CRM, hãy chạy lệnh sau để thay đổi quyền sở hữu thành www-data. Sau đó, thay đổi quyền của thư mục 'storage' thành 775.

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

Tại thời điểm này, bạn đã hoàn tất cấu hình Monica CRM. tiếp theo, bạn sẽ thiết lập khối máy chủ Nginx cho Monica CRM.

Thiết lập khối máy chủ Nginx​

Trước khi thiết lập khối máy chủ Nginx, hãy đảm bảo tên miền của bạn được trỏ đến địa chỉ IP của máy chủ, đồng thời hãy đảm bảo rằng bạn đã có chứng chỉ SSL. Nếu bạn không có chứng chỉ SSL, bạn có thể tạo SSL miễn phí qua Let'sencrypt.

Tạo tệp mới '/etc/nginx/sites-available/monicacrm' bằng trình soạn thảo nano.

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

Thêm các cấu hình Nginx bên dưới. Và hãy chắc chắn thay đổi tên miền và đường dẫn của chứng chỉ SSL.

server {

 listen 80;
 server_name howtoforge.local;
 return 301 https://$host$request_uri;

}

server {
 listen 443 ssl http2;

 ssl_certificate /etc/letsencrypt/live/howtoforge.local/fullchain.pem;
 ssl_certificate_key /etc/letsencrypt/live/howtoforge.local/private.key;

 server_name howtoforge.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;
 }
}

Lưu tệp và thoát khỏi trình chỉnh sửa khi bạn hoàn tất.

Tiếp theo, chạy lệnh sau để kích hoạt khối máy chủ Nginx 'monicacrm'. Sau đó, hãy xác minh cấu hình Nginx để đảm bảo rằng bạn có cấu hình phù hợp.

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

Nếu bạn có cấu hình Nginx phù hợp, bạn sẽ thấy thông báo đầu ra như "Cú pháp OK - kiểm tra thành công".

Bây giờ, hãy chạy lệnh systemctl sau để khởi động lại dịch vụ Nginx và áp dụng cấu hình khối máy chủ nee.

sudo systemctl restart nginx

Cài đặt Monica CRM của bạn hiện có thể truy cập thông qua trình duyệt web.

Hoàn tất​

Mở trình duyệt web và truy cập tên miền cài đặt Monica CRM của bạn (ví dụ: https://howtoforge.local/). Trong lần thiết lập đầu tiên, bạn sẽ cần đăng ký một tài khoản để cài đặt Monica CRM.

Nhập thông tin chi tiết về tên người dùng, mật khẩu và địa chỉ email. Sau đó, nhấp vào Đăng ký.



Sau khi người dùng đăng ký, bây giờ bạn sẽ thấy bảng điều khiển người dùng Monica CRM.

Kết luận​

Trong hướng dẫn này, bạn đã cài đặt Monica CRM trên máy chủ Debian 11. Bạn cũng đã định cấu hình LEMP Stack (Nginx, MariaDB và PHP-FPM) trên máy chủ Debian, cài đặt trình quản lý gói PHP Composer và cài đặt Node.js và Yarn.

Trong suốt hướng dẫn này, giờ đây bạn đã cài đặt và bảo mật Monica CRM thông qua kết nối HTTPS. Bây giờ, bạn có thể bắt đầu sắp xếp danh bạ, tạo nhật ký và theo dõi mọi thông tin quan trọng về danh bạ của mình.