Cách cài đặt Vanilla Forum trên Fedora 29

[theanh]

Vanilla là một diễn đàn thảo luận mã nguồn mở miễn phí được viết bằng PHP. Phần mềm Vanilla Forum được phân phối theo giấy phép GNU GPL2. Mã nguồn của nó có sẵn thông qua Github. Nó có một hệ thống tiện ích bổ sung phong phú mà bạn có thể tận dụng để thêm các tính năng tùy chỉnh vào diễn đàn Vanilla của mình.Nội dung cho Vanilla Forum có thể được viết bằng ngôn ngữ Markdown.Trong hướng dẫn này, chúng ta sẽ hướng dẫn cài đặt và thiết lập Vanilla Forum trên hệ thống Fedora 29 bằng cách sử dụng Nginx làm máy chủ web, MySQL 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à cơ quan cấp chứng chỉ Let's Encrypt để thêm hỗ trợ SSL.

Yêu cầu​

Vanilla yêu cầu một máy chủ có PHP, MySQL và phần mềm máy chủ web (như Apache hoặc NGINX). Bạn có thể cần sở hữu một tên miền và đã cấu hình tên miền đó trên máy chủ của mình với DNS nếu bạn muốn cài đặt trên máy chủ sản xuất, nhưng nếu chưa thì bạn không cần tên miền.

Yêu cầu tối thiểu của Vanilla Forum là:

• Phiên bản PHP 7.0 trở lên.
• Phần mở rộng PHP mbstring, cURL,GD và PDO,MySQLi, OpenSSL.
• MySQL phiên bản 5.0 trở lên (hoặc Percona/MariaDB tương đương).
• Phần mềm máy chủ web (Nginx, Apache ...).
• Chế độ nghiêm ngặt của MySQL đã bị vô hiệu hóa.

Diễn đàn Vanillakhuyến nghị mạnh mẽ:

• Phiên bản PHP 7.2 trở lên.
• Các phần mở rộng PHP mbstring, cURL,GD và PDO,MySQLi, OpenSSL.
• Phiên bản MySQL 5.7 trở lên(hoặc tương đương với Percona/MariaDB).
• Phần mềm máy chủ web (Nginx, Apache ...).
• Mã hóa SSL.

LƯU Ý:PHP 7.0 đã hết thời hạn sử dụng và sẽ không còn nhận được các bản vá bảo mật nữa, do đó, bạn nên sử dụng các phiên bản PHP mới hơn.Hỗ trợ của Vanilla cho PHP 7.0 sẽ sớm kết thúc!

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

• Hệ điều hành chạy Fedora 29.
• 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 zip 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​

Cài đặt PHP cũng như 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-curl php-gd php-mysqlnd 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
thông tin tệp
. . .
. . .

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

php --version

#PHP 7.2.16 (cli) (được xây dựng: 5 tháng 3 năm 2019 11:05:59) (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

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 và thiết lập cơ sở dữ liệu.

Bước 2 - Cài đặtMariaDBvà tạo cơ sở dữ liệu cho Vanilla Forum​

Vanilla Forum hỗ trợ cơ sở dữ liệu MySQL, MariaDB và Percona. 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 MariaDB bằng cách chạy:

sudo dnf install -y mariadb-server

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

mysql --version
# mysql Ver 15.1 Distrib 10.3.12-MariaDB, dành cho Linux (x86_64) bằng readline 5.1

Khởi động và bật dịch vụ MariaDB:

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

Chạy mysql_secure installation script để cải thiện bảo mật MariaDB và đặt mật khẩu cho MariaDB rootuser:

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

Kết nối đến 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 một cơ sở dữ liệu MariaDB trống và người dùng cho Diễn đàn Vanilla và ghi nhớ thông tin đăng nhập:

MariaDB [(none)]>CREATE DATABASE dbname;
MariaDB [(none)]>GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
MariaDB [(none)]>FLUSH PRIVILEGES;

Thoát khỏi MariaDB:

MariaDB [(none)]>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 mật lưu lượng truy cập trang web của bạn. Để lấy chứng chỉ TLS 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 phụ thuộc vào bất kỳ thứ gì.

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

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.

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

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"

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 NGINX và cấu hình NGINX choVanilla Forum​

Vanilla Forum có thể hoạt động tốt với nhiều phần mềm máy chủ web phổ biến. Trong hướng dẫn này, chúng tôi đã chọnNGINX. Nếu bạn thích máy chủ web Apache hơn NGINX, vui lòng truy cập https://docs.vanillaforums.com/developer/backend/server-apache/để tìm hiểu thêm.

Tải xuống và cài đặt NGINX từ kho lưu trữ Fedora:

sudo dnf install -y nginx

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

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

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 Vanilla bằng cách chạy:

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

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

server {

 listen 80;
 listen 443 ssl http2;
 server_name example.com;
 root /var/www/vanilla;
 index index.php;

 # RSA
 ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
 ssl_certificate_key /etc/letsencrypt/example.com/private.key;
 # ECC/ECDSA
 chứng chỉ ssl /etc/letsencrypt/example.com_ecc/fullchain.pem;
 chứng chỉ ssl /etc/letsencrypt/example.com_ecc/private.key;

 vị trí ~* /\.git { từ chối tất cả; trả về 403; }
 vị trí /build/ { từ chối tất cả; trả về 403; }
 vị trí /cache/ { từ chối tất cả; trả về 403; }
 vị trí /cgi-bin/ { từ chối tất cả; trả về 403; }
 vị trí /uploads/import/ { từ chối tất cả; trả về 403; }
 vị trí /conf/ { từ chối tất cả; trả về 403; }
 vị trí /tests/ { từ chối tất cả; trả về 403; }
 vị trí /vendor/ { từ chối tất cả; trả về 403; }

 vị trí ~* ^/index\.php(/|$) {
 include default.d/php.conf;
 fastcgi_param SCRIPT_NAME /index.php;
 fastcgi_param SCRIPT_FILENAME $realpath_root/index.php;
 fastcgi_param X_REWRITE 1;
 fastcgi_pass unix:/run/php-fpm/www.sock;
 }

 vị trí ~* \.php(/|$) {
 viết lại ^ /index.php$uri cuối cùng;
 }

 vị trí / {
 try_files $uri $uri/ @vanilla;
 }

 vị trí @vanilla {
 viết lại ^ /index.php$uri cuối cùng;
 }

}

LƯU Ý: Để có cấu hình Nginx hoàn chỉnh và sẵn sàng cho Vanilla, hãy truy cậphttps://docs.vanillaforums.com/developer/backend/server-nginx/.

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

sudo nginx -t

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

sudo systemctl reload nginx.service

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

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

sudo mkdir -p /var/www/vanilla

Thay đổi quyền sở hữu của Thư mục /var/www/vanilla[/ICODE] tới {jour_user}:

sudo chown -R {your_user}:{your_user} /var/www/vanilla

LƯU Ý: Thay thế{jour_user} bằng tên người dùng không phải root mà bạn tạo ban đầu.

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

cd /var/www/vanilla

Tải xuống kho lưu trữ zip của Diễn đàn Vanilla:

wget https://open.vanillaforums.com/get/vanilla-core-2.8.1.zip

Giải nén và xóa kho lưu trữ zip Vanilla:

giải nén vanilla-core-2.8.1.zip
rm vanilla-core-2.8.1.zip
mv vanilla-2.8.1/* . && mv vanilla-2.8.1/.* .

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

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

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

Điều hướng đến thư mục mà bạn đã tải Vanilla lên trong trình duyệt web và làm theohướng dẫn trên màn hình.

Bước 6 - Hoàn tất cài đặt và thiết lập VanillaForum​

Sau khi mở trang web của bạn trong trình duyệt web, bạn sẽ được chuyển hướng đến trang sau:



Điền thông tin bắt buộc và nhấp vào nút "Tiếp tục→" để hoàn tất cài đặt và thiết lập. Sau đó, giao diện quản trị Diễn đàn Vanilla sẽ xuất hiện.

Liên kết​

• https://open.vanillaforums.com/
• https://github.com/vanilla/vanilla