Cách cài đặt Vanilla Forum trên Ubuntu 18.04 LTS

[theanh]

Vanilla là 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 Ubuntu 18.04 LTS 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!Ubuntu 18.04 LTS mặc định đi kèm với PHP 7.2, do đó chúng ta không cần phải lo lắng về phiên bản PHP.

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

• Hệ điều hành chạy Ubuntu 18.04 LTS.
• 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 Ubuntu của bạn:

lsb_release -ds
# Ubuntu 18.04.1 LTS

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

sudo dpkg-reconfigure tzdata

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

sudo apt install -y curl wget vim gitunzip 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 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

Để 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.10-0ubuntu0.18.04.1 (cli) (xây dựng: 13 tháng 9 năm 2018 13:45:02) (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.10-0ubuntu0.18.04.1, Bản quyền (c) 1999-2018, của Zend Technologies

Dịch vụ PHP-FPM được tự động khởi động và bật khi khởi động lại hệ thống Ubuntu 18.04, do đó không cần phải khởi động và bật dịch vụ này 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 MySQL và tạo cơ sở dữ liệu cho Vanilla Forum​

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

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

sudo apt install -y mysql-server

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

mysql --version
#mysql Ver 14.14 Distrib 5.7.24, dành cho Linux (x86_64) sử dụng trình bao bọc EditLine

Chạy cài đặt mysql_securescript để cải thiện bảo mật MySQL và đặt mật khẩu cho MySQLrootuser:

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 MySQL 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 MySQL trống và người dùng cho Diễn đàn Vanilla và ghi nhớ thông tin đăng nhập:

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

Thoát khỏi MySQL:

mysql>exit

Thay thếdbname,usernamevàpasswordbằng tên của bạn.

Bước 3 - Cài đặtacme.shclient 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 acme.sh client. 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ỉRSAvàECC/ECDSAcho yourdomain/hostname:

# 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 --stagingflage 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ẽ là trong:

• Đối vớiRSA:/home/username/example.comthư mục.
• Đối vớiECC/ECDSA:/home/username/example.com_eccthư mục.

Để 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
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 vớ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ữ Ubuntu:

sudo apt install -y nginx

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

sudo nginx -v
#phiên bản nginx: nginx/1.14.0 (Ubuntu)

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; }
 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 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ìnhvanilla.confmới bằng cách liên kết tệp đến thư mụcsites-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 - Cài đặt Vanilla Forum​

Tạo thư mục gốc 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 thư mục/var/www/vanillathành{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 đượ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.6.4.zip

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

giải nén vanilla-core-2.6.4.zip
rm vanilla-core-2.6.4.zip

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 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ị Vanilla Forum sẽ xuất hiện.

Liên kết​

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