Cách cài đặt Pagekit CMS trên Debian 9

[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ệ sinh thái 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 Debian 9 (stretch)bằng cách sử dụng NGINX làm máy chủ web, MariaD 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 Debian 9 (stretch).
• 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 Debian của bạn:

lsb_release -ds
# Debian GNU/Linux 9.7 (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à 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. Theo mặc định, Debian 9 có phiên bản PHP 7.0 trong kho phần mềm mặc định, phù hợp với October CMS.

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

sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-mbstring php7.0-zip php7.0-mysql php7.0-sqlite3 php7.0-curl php7.0-xml

Để 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.0.33-0+deb9u1 (cli) (xây dựng: 7 tháng 12 năm 2018 11:36:49) (NTS)
# Bản quyền (c) 1997-2017 The PHP Group
# Zend Engine v3.0.0, Bản quyền (c) 1998-2017 Zend Technologies
# với Zend OPcache v7.0.33-0+deb9u1, Bản quyền (c) 1999-2017, của Zend Technologies

Dịch vụ PHP-FPM được tự động khởi động và bật khi khởi động lại trên hệ thống Debian 9, do đó không cần phải khởi động và bậ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 Pagekit​

Pagekit CMS hỗ trợ cơ sở dữ liệu MySQL, MariaDB và SQLite.Nhóm Debian đã thay thế MySQL bằng MariaDB làm cơ sở dữ liệu mặc định từ Debian 9 (stretch), vì vậy tronghướng dẫn này, chúng ta sẽ sử dụng MariaDB làm máy chủ cơ sở dữ liệu. Nếu bạn muốn cài đặt MySQL gốc, bạn có thể thêm và sử dụng kho lưu trữ MySQL chính thức do Oracle quản lý.

Cài đặt máy chủ cơ sở dữ liệu MariaDB phiên bản 10.2 từ kho lưu trữ MariaDB chính thức:

sudo apt install -y software-properties-common dirmngr apt-transport-https
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] https://mirrors.nxthost.com/mariadb/repo/10.2/debian stretch main'
sudo apt update
sudo apt install -y mariadb-server

LƯU Ý: Bạn sẽ được nhắc nhập mật khẩu người dùng root. Nhập mật khẩu mạnh và tiếp tục.

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

mysql --version
#mysql Ver 15.1 Distrib 10.2.22-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:

Nhập mật khẩu hiện tại cho root (nhập nếu không nhập): [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 thực hành để bảo mật lưu lượng truy cập trang web của bạn. Để có được chứng chỉ SSL từ Let's Encrypt, chúng tôi 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 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ìnhNGINX cho Pagekit bằng cách chạy:

sudo vim /etc/nginx/sites-available/pagekit.conf

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

máy chủ {
 lắng nghe [::]:443 ssl http2;
 lắng nghe 443 ssl http2; lắng nghe [::]:80; lắng nghe 80; tên máy chủ example.com; chỉ mục 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 snippets/fastcgi-php.conf;
 fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
 }}

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

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

Kiểm tra cấu hình NGINX để 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

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

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

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 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