Cách cài đặt Pagekit CMS với Nginx trên Fedora 29

[theanh]

Pagekit là CMS nguồn mở hiện đại, trực quan, theo mô-đun và linh hoạt (giấy phép MIT)được xây dựng bằng các thành phần Symfony và Vue.js.Nó cung cấp cho bạn các công cụ để tạo ra các trang web đẹp mắt. Nó có một hệ thống chủ đề và plugin phong phú.

Trong hướng dẫn này, chúng tôi sẽ hướng dẫn bạn quy trình cài đặt Pagekit CMS trên hệ điều hành Fedora 29bằng cách sử dụng NGINX làm máy chủ web, MariaDB làm máy chủ 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à chứng chỉ Let's Encrypt để thêm hỗ trợ SSL.

Yêu cầu​

Để cài đặt Pagekit, hãy đảm bảo máy chủ của bạn đáp ứng các yêu cầu sau:

• Apache phiên bản 2.2 trở lên hoặc máy chủ web NGINX.
• MySQL phiên bản 5.1 trở lên hoặc SQLite 3.
• PHP phiên bản 5.5.9 trở lên.
• Các phần mở rộng PHP bắt buộc: JSON, Session, ctype, Tokenizer, SimpleXML, DOM, mbstring, PCRE 8.0+, ZIP và PDO với trình điều khiển MySQL hoặc SQLite.
• Các phần mở rộng PHP tùy chọn: cURL, iconv và XML Parser, cũng như APC hoặc XCache để lưu trữ đệm.

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

• Một hệ thống chạy Fedora 29.
• Một 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 hệ thống Fedora của bạn:

cat /etc/fedora-release
# Fedora phát hành 29 (Hai mươi chín)

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

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

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:

sudo dnf 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 Fedora:

sudo dnf install -y curl wget vim gitsudo unzip socat bash-completion

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

Nền tảng PagekitCMS yêu cầu PHP phiên bản 7.0 trở lên. Fedora 29 có phiên bản PHP 7.2 trong kho lưu trữ mặc định của nó.

Tải xuống và cài đặt PHP và các tiện ích mở rộng PHP cần thiết:

sudo dnf install -y php-cli php-fpm php-common php-mbstring php-zip php-mysqlnd php-sqlite3 php-curl php-xml php-json

Để 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.14 (cli) (được xây dựng: 8 tháng 1 năm 2019 09:59:17) (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.14, Bản quyền (c) 1999-2018, của Zend Technologies

Khởi động và kích hoạt dịch vụ PHP-FPM:

sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service

Chúng ta có thể chuyển sang bước tiếp theo, đó là cài đặt cơ sở dữ liệu và thiết lập.

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

Pagekit CMS hỗ trợ cơ sở dữ liệu MySQL, MariaDB và SQLite. Trong hướng dẫn này, chúng ta sẽ sử dụng MariaDB làm máy chủ cơ sở dữ liệu.

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

sudo dnf install -y mariadb-server

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

mysql --version

Khởi động và kích hoạt dịch vụ MariaDB:

sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

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:

Nhập mật khẩu hiện tại đối với root (enter nếu không có): [B]Nhấn Enter[/b]
Đặt mật khẩu root? [Y/n] [B]Y[/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 root đăng nhập 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]

Đăng nhập vào 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 và người dùng mà bạn sẽ sử dụng để cài đặt Pagekit và ghi nhớ thông tin đăng nhập:

CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

Thoát khỏi shell MariaDB:

quit

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ỉ SSL từ Let's Encrypt mà không phụ thuộc vào bất kỳ thứ gì.

Tải xuống và cài đặtacme.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.1

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 --stagingflag vào các lệnh trên.

Để 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/letsencrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc

Cài đặt/sao chép chứng chỉ vào/etc/letsencryptthư 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"

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

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

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ỉ, thoát khỏi người dùng root và quay lại người dùng sudo bình thường:

exit

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

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

sudo dnf install -y nginx

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

nginx -v
# phiên bản nginx: nginx/1.14.1

Khởi động và kích hoạt dịch vụ Nginx:

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

Cấu hìnhNGINX cho Pagekit bằng cách chạy:

sudo vim /etc/nginx/conf.d/pagekit.conf

Và điền cấu hình sau vào tệp:

server {
 listen [::]:443 ssl http2;
 listen 443 ssl http2; listen [::]:80; listen 80; server_name example.com; index index.php index.html; gốc /var/www/pagekit;
 chứng chỉ ssl /etc/letsencrypt/example.com/fullchain.pem;
 khóa chứng chỉ ssl /etc/letsencrypt/example.com/private.key;
 chứng chỉ ssl /etc/letsencrypt/example.com_ecc/fullchain.pem;
 khóa chứng chỉ ssl /etc/letsencrypt/example.com_ecc/private.key;
 vị trí / { try_files $uri $uri/ /index.php?$query_string; }

 location ~ \.php$ {
 include default.d/php.conf;
 fastcgi_pass unix:/run/php-fpm/www.sock;
 }}

Kiểm tra cấu hìnhNGINX để tìm lỗi cú pháp:

sudo nginx -t

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

sudo systemctl reload nginx.service

Bước 5 - Tải xuống và cài đặt Pagekit CMS​

Tạo thư mục gốc của tài liệu nơi Pagekit sẽ lưu trú:

sudo mkdir -p /var/www/pagekit

Thay đổi quyền sở hữu của thư mục /var/www/pagekit thành [your_user]:

sudo chown -R [your_user]:[your_user] /var/www/pagekit

Điều hướng đến thư mục gốc của tài liệu:

cd /var/www/pagekit

Tải xuống bản phát hành ổn định mới nhất của Pagekit CMS qua wget:

wget https://github.com/pagekit/pagekit/releases/download/1.0.16/pagekit-1.0.16.zip

Giải nén nội dung CMS Pagekit và xóa tệp .zip đã tải xuống.

giải nén pagekit-1.0.16.zip
rm pagekit-1.0.16.zip

Cung cấp quyền sở hữu phù hợp:

sudo chown -R nginx:nginx /var/www/pagekit

Chạy sudo vim /etc/php-fpm.d/www.conf và đặt người dùng và nhóm thành nginx. Ban đầu, chúng sẽ được đặt thành apache:

sudo vim /etc/php-fpm.d/www.conf
# user = nginx
# group = nginx

Khởi động lại dịch vụ PHP-FPM:

sudo systemctl restart php-fpm.service

Bước 6 - Hoàn tất thiết lập Pagekit​

Mở trang web của bạn trong trình duyệt web và bạn sẽ thấy trang sau:



Nhấp vào biểu tượng mũi tên phải để tiếp tục cài đặt. Chọn ngôn ngữ của bạn và nhấp vào nút "Tiếp theo":



Tiếp theo, chọn cơ sở dữ liệu của bạn là SQLite hoặc MySQL và điền vào các trường bắt buộc và nhấp vào nút "Tiếp theo":





Sau đó, thiết lập trang web của bạn bằng cách nhập Tiêu đề trang web và tạo tài khoản người dùng quản trị:



Và thế là xong. Bạn sẽ được chuyển hướng đến trang đăng nhập Pagekit. Cung cấp tên người dùng và mật khẩu của bạn để đăng nhập vào bảng điều khiển Pagekit.



Vậy là xong. Nếu bạn gặp khó khăn, hãy xem tài liệu chính thức của Pagekit.

Liên kết​

• https://pagekit.com/
• https://github.com/pagekit/pagekit