Cách cài đặt Vanilla Forum trên Debian 9

[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, tôi sẽ chỉ cho bạn cách cài đặt Vanilla Forum trên Debian 9 bằ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à 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 không 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 đang 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.7 (stretch)

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

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

sudo apt update && sudo 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:

sudo apt install -y curl wget vim gitunzip socat bash-completion apt-transport-https lsb-release ca-certificates dirmngr software-properties-common

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

Thêm kho lưu trữ mới vào hệ thống của bạn để cài đặt phiên bản PHP mới hơn:

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 && sudo apt upgrade -y

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

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-mbstring php7.2-curl php7.2-gd php7.2-mysql php7.2-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-1+0~20190113100742.14+stretch~1.gbpd83c69 (cli) (xây dựng: 13 tháng 1 năm 2019 10:07:43) (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-1+0~20190113100742.14+stretch~1.gbpd83c69, Bản quyền (c) 1999-2018, của Zend Công nghệ

Dịch vụ PHP-FPM được tự động khởi động và kích hoạ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à 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 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 MariaDBphiên bản 10.2 từ kho lưu trữ MariaDB chính thức cho Debian:

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

Kiểm tra phiên bảnMariaDB:

mysql --version

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

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 đế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>CREATE DATABASE dbname;
mariadb>GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'mypassword';
mariadb>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:

mariadb>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 cần bất kỳ sự phụ thuộc nào.

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à quay lại người dùng sudo bình thường:

thoát

Bước 4 - Cài đặt NGINX và cấu hình NGINX cho Vanilla 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ọn Nginx. 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ữ Debian:

sudo apt install -y nginx

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

sudo nginx -v

Cấu hình Nginx cho Vanilla bằng cách chạy:

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

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

server {

 listen 80;
 listen 443 ssl http2;
 server_name forum.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
 ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
 ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;

 location ~* /\.git { từ chối tất cả; trả về 403; }
 location /build/ { từ chối tất cả; trả về 403; }
 location /cache/ { từ chối tất cả; trả về 403; }
 location /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 snippets/fastcgi-php.conf;
 fastcgi_param TÊN_KẾ_HỆ_TẬP_TIN_KẾ_ĐỊNH /index.php;
 fastcgi_param TÊN_TẬP_TIN_KỊCH $realpath_root/index.php;
 fastcgi_param X_REWRITE 1;
 fastcgi_pass unix:/var/run/php/php7.2-fpm.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 sản xuất cho Vanilla, hãy truy cậphttps://docs.vanillaforums.com/developer/backend/server-nginx/.

Kích hoạt cấu hình vanilla.conf[/ICODE] 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/vanilla.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 - InstallVanilla Forum​

Tạo thư mục gốc tài liệu nơi Vanilla Forum sẽ nằm:

sudo mkdir -p /var/www/vanilla

Thay đổi quyền sở hữu thư mục /var/www/vanilla thành {your_user}. Thay thế chuỗi {your_user} bằng tên người dùng Linux mà bạn hiện đang đăng nhập, vì vậy khi tên người dùng của bạn là ví dụ: johndoe, sau đó thay thế '{your_user}' bằng 'johndoe'.

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 được tạo ban đầu của bạn.

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

unzip 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 www-data:www-data /var/www/vanilla

Điều hướng đến thư mục mà bạn đã tải Vanilla lên trong trình duyệt web của mình 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