Cách cài đặt Fork CMS với NGINX trên Debian 9

[theanh]

Fork là một CMS mã nguồn mở dễ sử dụng sử dụng Symfony Components. Nó có giao diện trực quan và thân thiện với người dùng, các ứng dụng mạnh mẽ mà bạn có thể tải xuống để mở rộng trang web của mình và bộ sưu tập lớn các chủ đề đẹp.Trong hướng dẫn này, chúng ta sẽ hướng dẫn cài đặt và thiết lập Fork CMS trên hệ thống Debian 9 bằng cách sử dụng Nginx làm máy chủ web, MariaDB làm công cụ cơ sở dữ liệu và tùy chọn bạn có thể bảo mật lớp truyền tải bằng cách sử dụng máy khách Acme.sh và cơ quan cấp chứng chỉ Let's Encrypt để thêm hỗ trợ SSL.

Yêu cầu​

Yêu cầu để cài đặt và chạy Fork CMS là:

• Phiên bản PHP 7.1 trở lên.
• Cần cài đặt và kích hoạt các tiện ích mở rộng PHP sau: cURL, libxml, DOM, SimpleXML, SPL, PDO (có trình điều khiển MySQL), mb_string, iconv, Thư viện đồ họa GD2, JSON, PCRE, intl.
• MySQL 5.0 trở lên.
• NGINX hoặc Apache có .htaccess, mod_rewrite, mod_expires (tùy chọn nhưng được khuyến nghị), mod_deflate (tùy chọn) được bật.

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

• Hệ điều hành chạy Debian 9.
• Người dùng không phải root có quyền sudo.

Các bước ban đầu​

Kiểm tra phiên bản Debian của bạn:

lsb_release -ds
# Debian GNU/Linux 9.9 (stretch)

Thiết lập múi giờ:

dpkg-reconfigure tzdata

Cập nhật các gói hệ điều hành (phần mềm) của bạn. Đây là bước đầu tiên quan trọng vì nó đảm bảo bạn có các bản cập nhật và bản sửa lỗi bảo mật mới nhất cho các gói phần mềm mặc định của hệ điều hành:

apt update && apt upgrade -y

Cài đặt một số gói thiết yếu cần thiết cho việc quản trị cơ bản hệ điều hành Debian:

apt install -y curl wget vim gitsudo unzip socat bash-completion dirmngr apt-transport-https

Bước 1 - Cài đặt PHP và tiện ích mở rộng PHP​

Debian không cung cấp phiên bản PHP mới nhất trong kho phần mềm mặc định của nó. Chúng ta sẽ cần thêm một cộng đồng duy trì kho lưu trữ của bên thứ ba.

sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

Cài đặt PHP cũng như các tiện ích mở rộng PHP cần thiết cho Fork CMS:

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-mysql php7.2-curl php7.2-json php7.0-zip php7.2-gd php7.2-xml php7.2-mbstring php7.2-opcache php7.2-intl

Để hiển thị PHP đã biên dịch trong các mô-đun, bạn có thể chạy:

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Kiểm tra phiên bản PHP:

php --version
# PHP 7.2.19-1+0~20190531112637.22+stretch~1.gbp75765b (cli) (xây dựng: 31 tháng 5 năm 2019 11:26:38) (NTS)
# Bản quyền (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Bản quyền (c) 1998-2018 Zend Technologies
# với Zend OPcache v7.2.19-1+0~20190531112637.22+stretch~1.gbp75765b, Bản quyền (c) 1999-2018, của Zend Technologies

Dịch vụ PHP-FPM được tự động khởi động và kích hoạt khi khởi động lại hệ thống Debian 9, do đó không cần phải khởi động và kích hoạt thủ công. Chúng ta có thể chuyển sang bước tiếp theo, đó là cài đặt và thiết lập cơ sở dữ liệu.

Bước 2 - Cài đặt MariaDB và tạo cơ sở dữ liệu cho Fork CMS​

Cài đặt máy chủ cơ sở dữ liệu MariaDB:

sudo apt install -y mariadb-server

Kiểm tra phiên bản MariaDB:

mysql --version
# mysql Ver 15.1 Distrib 10.1.38-MariaDB, dành cho debian-linux-gnu (x86_64) bằng readline 5.2

Chạy tập lệnh mysql_secure installation để cải thiện bảo mật MariaDB và đặt mật khẩu cho người dùng root MariaDB:

sudo mysql_secure_installation

Trả lời từng câu hỏi sau:

Bạn có muốn thiết lập plugin VALIDATE PASSWORD không? [B]N[/b]
Mật khẩu mới: [B]your_secure_password[/b]
Nhập lại mật khẩu mới: [B]your_secure_password[/b]
Xóa người dùng ẩn danh? [Y/n] [B]Y[/b]
Không cho phép đăng nhập root từ xa? [Y/n] [B]Y[/b]
Xóa cơ sở dữ liệu thử nghiệm và quyền truy cập vào cơ sở dữ liệu đó? [Y/n] [B]Y[/b]
Tải lại bảng đặc quyền ngay bây giờ? [Y/n] [B]Y[/b]

Kết nối với shell MariaDB với tư cách là người dùng root:

sudo mysql -u root -p
# Nhập mật khẩu

Tạo cơ sở dữ liệu MariaDB trống và sử dụng forFork CMS và ghi nhớ thông tin đăng nhập:

mysql> CREATE DATABASE dbname;
mysql> GRANT ALL ON dbname.* TO 'username' IdentifiED BY 'mypassword';
mysql> FLUSH PRIVILEGES;

Thay thế từ mypassword bằng mật khẩu an toàn mà bạn chọn. Thoát khỏi MariaDB:

mysql> exit

Thay thế dbname, username và password bằng tên của riêng bạn.

Bước 3- Cài đặt máy khách Acme.sh và lấy chứng chỉ Let's Encrypt (tùy chọn)​

Không nhất thiết phải bảo mật trang web của bạn bằng HTTPS, nhưng đây là một biện pháp tốt để bảo vệ lưu lượng truy cập trang web của bạn. Để lấy chứng chỉ SSL từ Let's Encrypt, chúng ta sẽ sử dụng máy khách Acme.sh. Acme.sh là phần mềm shell Unix thuần túy để lấy chứng chỉ TLS từ Let's Encrypt mà không cần phụ thuộc.

Tải xuống và cài đặt acme.sh:

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh 
./acme.sh --install --accountemail [emailprotected]
source ~/.bashrc
cd ~

Kiểm tra phiên bản acme.sh:

acme.sh --version
# v2.8.2

Lấy chứng chỉ RSA và ECC/ECDSA cho tên miền/tên máy chủ của bạn:

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

Nếu bạn muốn có chứng chỉ giả để thử nghiệm, bạn có thể thêm --staging flag vào các lệnh trên.

Sau khi chạy các lệnh trên, chứng chỉ và khóa của bạn sẽ nằm trong:

• Đối với RSA: thư mục /home/username/example.com.
• Đối với ECC/ECDSA: thư mục /home/username/example.com_ecc.

Để liệt kê các chứng chỉ đã cấp, bạn có thể chạy:

acme.sh --list

Tạo một thư mục để lưu trữ các chứng chỉ của bạn. Chúng tôi sẽ sử dụng thư mục /etc/letsencrypt.

mkdir -p /etc/letsecnrypt/example.com
[ICODE]sudo mkdir -p /etc/letsencrypt/example.com_ecc[/ICODE]

Cài đặt/sao chép chứng chỉ vào /etc/letsencrypt thư mục.

# RSA
acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"

Tất cả các chứng chỉ sẽ được tự động gia hạn sau mỗi 60 ngày.

Sau khi lấy được chứng chỉ, hãy thoát khỏi người dùng root và trở lại người dùng sudo bình thường:

exit

Bước 4 - Cài đặt và cấu hình NGINX​

Cài đặt máy chủ web NGINX:

sudo apt install -y nginx

Kiểm tra phiên bản NGINX:

sudo nginx -v
# phiên bản nginx: nginx/1.10.3

Cấu hình NGINX cho Fork CMS. Chạy sudo vim /etc/nginx/sites-available/fork.conf và thêm cấu hình sau:

server { listen 80; listen 443 ssl;
 root /var/www/fork; index index.php index.html; server_name example.com;

 ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
 ssl_certificate_key /etc/letsencrypt/example.com/private.key;
 ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
 ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key; location / { # Kiểm tra xem url được yêu cầu có tồn tại dưới dạng tệp $uri hay thư mục $uri/ trong thư mục gốc hay không, nếu không thì chuyển hướng đến /index.php. try_files $uri $uri/ @redirects; } location @redirects { rewrite ^ /index.php; } location ~ \.php$ { try_files $uri =404; include fastcgi_params; fastcgi_pass unix:/var/run/php/php7.2-fpm.sock; fastcgi_index index.php; fastcgi_read_timeout 60; fastcgi_split_path_info ^(.+\.php)(/.+)$; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } # Không làm ô nhiễm nhật ký bằng các yêu cầu chung location = /robots.txt { access_log off; log_not_found off; } location = /favicon.ico { access_log off; log_not_found off; } # Vì Fork CMS có app_root là doc_root, chúng ta cần hạn chế quyền truy cập vào một số thứ vì mục đích bảo mật! location ~* ^/(composer\..*|vendor\/.*|Procfile$|\.git\/.*|src\/Console.*|.*\.gitignore|\.editorconfig|\.travis.yml|autoload\.php|bower\.json|phpunit\.xml\.dist|.*\.md|app\/logs\/.*|app\/config\/.*|src\/Frontend\/Cache\/Com piledTemplates.*|src\/Frontend\/Cache\/Locale\/.*\.php|src\/Frontend\/Cache\/Navigation\/.*\.php|src\/Frontend\/Cache\/Search\/.*|src\/Backend\/Cache\/CompiledTemplates\/.*|src\/Backend\/Cache\/Locale\/.*\.php)$ { từ chối tất cả; tắt access_log; tắt log_not_found; } # Từ chối truy cập vào các tệp dot. location ~ /\. { từ chối tất cả; tắt access_log; tắt log_not_found; }}

Kích hoạt cấu hình fork.confmới bằng cách liên kết tệp đến thư mục sites-enabled:

sudo ln -s /etc/nginx/sites-available/fork.conf /etc/nginx/sites-enabled

Kiểm tra lỗi cú pháp trong cấu hình NGINX:

sudo nginx -t

Tải lại dịch vụ NGINX:

sudo systemctl reload nginx.service

Bước 5 - Cài đặt Composer​

Cài đặt Composer, trình quản lý phụ thuộc PHP trên toàn cầu:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

php -r "if (hash_file('sha384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Đã xác minh trình cài đặt'; } else { echo 'Trình cài đặt bị hỏng'; unlink('composer-setup.php'); } echo PHP_EOL;"

php composer-setup.php

php -r "unlink('composer-setup.php');"

sudo mv composer.phar /usr/local/bin/composer

Kiểm tra phiên bản Composer:

composer --version
#Composer phiên bản 1.8.5 2019-04-09 17:46:47

Bước 6 - Cài đặt CMS Fork​

Tạo thư mục gốc của tài liệu.

sudo mkdir -p /var/www/fork

Thay đổi quyền sở hữu thư mục /var/www/fork thành người dùng mà bạn hiện đang đăng nhập, trong trường hợp của tôi, tên người dùng này là johndoe.

sudo chown -R johndoe:johndoe /var/www/fork

Thay thế johndoe bằng tên người dùng đăng nhập của bạn trong lệnh trên! Tải xuống bản phát hành ổn định mới nhất của Fork CMS từ dòng lệnh.

cd /var/www/fork
composer create-project forkcms/forkcms .

Thay đổi quyền sở hữu thư mục /var/www/fork thành www-data.

sudo chown -R www-data:www-data /var/www/fork

Chỉnh sửa tệp app/config/parameters.yml.dist và thiết lập thông tin cơ sở dữ liệu.

sudo vim /var/www/fork/app/config/parameters_install.yml

Sử dụng trình duyệt web ưa thích của bạn, mở trang web của bạn và làm theo trình cài đặt Fork CMS. Sau khi làm theo trình cài đặt, bạn sẽ có Fork và chạy. Để truy cập vào khu vực quản trị Fork, chỉ cần thêm /private vào URL trang web của bạn.

Bước 7 - Hoàn tất quá trình thiết lập Fork CMS​

Đảm bảo máy chủ của bạn đáp ứng mọi yêu cầu và tiếp tục:



Chọn ngôn ngữ và nhấp vào tiếp theo:



Chọn cài đặt theo ý muốn và nhấp vào tiếp theo:



Nhập cài đặt cơ sở dữ liệu của bạn và nhấp vào tiếp theo. Hãy đảm bảo rằng bạn đã tạo cơ sở dữ liệu.



Tạo người dùng và hoàn tất cài đặt:



Bạn sẽ thấy trang sau sau khi hoàn tất tất cả các bước trên:



Bạn đã cài đặt thành công Fork CMS. Hãy tận hưởng CMS mới của bạn!

Liên kết​

• https://www.fork-cms.com/
• https://github.com/forkcms/forkcms