Cách cài đặt Flarum Forum trên Debian 11

[theanh]

Flarum là phần mềm diễn đàn miễn phí và mã nguồn mở được viết bằng PHP, JavaScript và TypeScript. Ban đầu, Flarum là sự kết hợp của hai dự án khác nhau, FluxBB và esoTalk. Flarum là phần mềm diễn đàn thế hệ tiếp theo được thiết kế để tối giản với khả năng mở rộng cao thông qua các tiện ích mở rộng.

Flarum là giải pháp hiện đại cho phần mềm diễn đàn, nhanh chóng, đơn giản và dễ sử dụng và cài đặt.

Hướng dẫn này sẽ hướng dẫn bạn cách cài đặt Flarum trên Debian 11 Bullseye. Hướng dẫn này cũng đề cập đến một số cấu hình cơ bản của LAMP Stack và cài đặt PHP Composer cho ứng dụng web Flarum.

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

• Máy chủ Linux Debian 11 Bullseye.
• Người dùng root hoặc người dùng không phải root có quyền root.
• Tên miền trỏ đến máy chủ.

Cài đặt Apache2​

Bước đầu tiên sẽ là cài đặt máy chủ web Apache2 trên hệ thống Debian của bạn.

Kiểm tra để cập nhật chỉ mục gói kho lưu trữ của bạn bằng lệnh sau.

sudo apt update

Cài đặt gói Apache2 bằng lệnh dưới đây.

sudo apt install apache2 -y

Bạn sẽ nhận được kết quả như sau:



Sau khi cài đặt các gói Apache2, bạn có thể khởi động máy chủ apache2 và kích hoạt nó.

sudo systemcttl start apache2
sudo systemctl enable apache2

Dịch vụ apache2 hiện đang chạy.

Bây giờ hãy chạy lệnh sau để mở các cổng HTTP và HTTPS trên tường lửa. Trong ví dụ này, máy chủ Debian đang chạy với tường lửa UFW.

sudo ufw allow "WWW Full"
sudo ufw reload

Kiểm tra và xác minh các quy tắc tường lửa UFW.

sudo ufw status

Bạn sẽ nhận được kết quả sau.

Cài đặt máy chủ MariaDB​

Trong bước tiếp theo, bạn sẽ cài đặt và cấu hình cơ sở dữ liệu MariaDB trên máy chủ Debian.

Cài đặt các gói MariaDB bằng lệnh apt bên dưới.

sudo apt install mariadb-server -y

Bạn sẽ nhận được kết quả sau:



Sau khi quá trình cài đặt MariaDB hoàn tất, hãy khởi động và kích hoạt dịch vụ MariaDB bằng lệnh bên dưới.

sudo systemctl start mariadb
sudo systemctl enable mariadb

Bạn sẽ nhận được kết quả đầu ra bên dưới:



Dịch vụ MariaDB đang chạy, bây giờ bạn sẽ thiết lập mật khẩu gốc MariaDB.

Chạy lệnh mysql_secure_installation bên dưới để bắt đầu cấu hình cài đặt máy chủ MariaDB.

sudo mysql_secure_installation

Nhấn ENTER để tiếp tục thiết lập máy chủ MariaDB.



Khi được yêu cầu thay đổi phương thức xác thực thành unix_socket, hãy nhập Y để xác nhận.



Bây giờ hãy nhập Y để xác nhận và thiết lập mật khẩu gốc cho MariaDB. Sau đó nhập mật khẩu mới cho người dùng gốc MariaDB của bạn và lặp lại mật khẩu.



Nhập Y để xóa người dùng ẩn danh mặc định khỏi máy chủ MariaDB.



Nhập Y một lần nữa để vô hiệu hóa đăng nhập từ xa cho người dùng gốc MariaDB.



Nhập Y để xóa bài kiểm tra cơ sở dữ liệu mặc định khỏi cài đặt MariaDB của bạn.



Cuối cùng, nhập Y một lần nữa để tải lại tất cả các đặc quyền bảng trên máy chủ MariaDB để áp dụng các cấu hình mới.

Cài đặt các gói PHP​

Flarum là một ứng dụng web được viết bằng PHP. Bây giờ bạn sẽ cài đặt các gói PHP vào máy chủ Debian của mình.

Cài đặt các gói PHP với các tiện ích mở rộng bổ sung cho Flarum bằng lệnh sau.

sudo apt install php php-common php-mysql libapache2-mod-php php-gd php-curl php-json php-xmlrpc php-intl php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap php-tokenizer -y

Bạn sẽ nhận được kết quả đầu ra:



Sau khi cài đặt PHP hoàn tất, hãy chỉnh sửa tệp cấu hình php.ini bằng trình soạn thảo nano.

sudo nano /etc/php/7.4/apache2/php.ini

Thay đổi cấu hình php.ini mặc định theo các cấu hình sau.

memory_limit = 512M
upload_max_file_size = 150M
max_execution_time = 600
date.timezone = Europe/Paris

Lưu tệp bằng cách nhấn CTRL+X và xác nhận lưu bằng cách nhập Y.

Bây giờ, để áp dụng các thay đổi mới cho tệp cấu hình php.ini, hãy khởi động lại dịch vụ Apache2 bằng lệnh bên dưới.

sudo systemctl restart apache2

Đang cài đặt Composer​

Để cài đặt Flarum, bạn cần cài đặt Composer trên máy chủ Debian của mình. Composer là trình quản lý phụ thuộc cho PHP cho phép bạn quản lý các thư viện trên ứng dụng PHP của mình.

Hiện nay, Composer được sử dụng trên hầu hết các nền tảng PHP hiện đại như Symfony và Laravel.

Tải xuống và xác minh trình cài đặt Composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8') { echo 'Đã xác minh trình cài đặt'; } else { echo 'Trình cài đặt bị hỏng'; unlink('composer-setup.php'); } echo PHP_EOL;"

Nếu bạn thấy thông báo đầu ra "Trình cài đặt đã được xác minh", thì trình cài đặt Composer là hợp lệ.

Bây giờ hãy chạy tập lệnh cài đặt để cài đặt Composer. Khi quá trình cài đặt hoàn tất, hãy xóa tập lệnh cài đặt.

php composer-setup.php
php -r "unlink('composer-setup.php');"

Tệp nhị phân của Composer hiện có sẵn trong thư mục làm việc của bạn với tên composer.phar. Di chuyển tệp đến /usr/local/bin/composer để tất cả người dùng trên máy chủ có thể thực thi lệnh composer.

sudo mv composer.phar /usr/local/bin/composer

Tiếp theo, hãy xác minh phiên bản Composer mà bạn vừa cài đặt trên hệ thống của mình bằng lệnh sau.

sudo -u www-data composer --version
sudo -u www-data composer -v

Bạn sẽ nhận được kết quả sau.

Tạo cơ sở dữ liệu và người dùng mới cho Flarum​

Trước khi bắt đầu cài đặt Flarum, bây giờ bạn sẽ cần tạo cơ sở dữ liệu MariaDB và người dùng mới cho Flarum.

Đăng nhập vào shell MariaDB với tư cách là người dùng root bằng lệnh bên dưới.

sudo mysql -u root -p

Bây giờ hãy tạo một cơ sở dữ liệu mới flarumdb và người dùng flarum với mật khẩu flarumdbpassword để cài đặt Flarum.

CREATE DATABASE flarumdb;
CREATE USER flarum@localhost IDENTIFIED BY 'flarumdbpassword';
GRANT ALL PRIVILEGES ON flarumdb.* to flarum@localhost;
FLUSH PRIVILEGES;

Sau đó, nhập exit để đăng xuất khỏi shell MariaDB hoặc bạn có thể nhấn CTRL+D.

Thiết lập thư mục dự án Flarum​

Trong bước này, bạn sẽ tải xuống và cài đặt nguồn Flarum bằng PHP Composer.

Đầu tiên, hãy tạo một dự án mới thư mục /var/www/flarum và /var/www/.cache bằng lệnh bên dưới.

mkdir -p /var/www/{.cache,flarum}

Thư mục chính của dự án Flarum sẽ là /var/www/flarum. Và thư mục /var/www/.cache sẽ được sử dụng để lưu trữ bộ nhớ đệm cho PHP Composer.

Tiếp theo, hãy thay đổi quyền sở hữu của cả thư mục flarum và .cache thành người dùng www-data. Ngoài ra, bạn sẽ cần cấp quyền đọc và ghi cho người dùng www-data.

sudo chown -R www-data:www-data /var/www/{.cache,flarum}
sudo chmod u+rw /var/www/{.cache,flarum}

Bây giờ hãy thay đổi thư mục làm việc của bạn thành /var/www/flarum và cài đặt Flarum bằng lệnh Composer bên dưới.

cd /var/www/flarum
sudo -u www-data composer create-project flarum/flarum .

Bạn sẽ nhận được kết quả đầu ra sau:



Composer sẽ cài đặt Flarum và tất cả các phụ thuộc PHP bổ sung cần thiết cho Flarum.

Sau khi cài đặt toàn bộ Flarum, bạn sẽ thấy mã nguồn Flarum có sẵn tại thư mục /var/www/flarum. Và thư mục DocumentRoot cho Flarum có tại thư mục /var/www/flarum/public.

Thiết lập máy chủ ảo Apache​

Trước khi bắt đầu truy cập cài đặt Flarum, bạn sẽ cần tạo cấu hình máy chủ ảo Apache2 mới cho Flarum.

Chúng ta hãy bắt đầu bằng cách bật một số mô-đun Apache bằng lệnh sau.

sudo a2enmod ssl rewrite headers

Bạn sẽ nhận được kết quả sau.



Tiếp theo, tạo tệp cấu hình máy chủ ảo mới /etc/apache2/sites-available/flarum.conf bằng trình soạn thảo nano.

sudo nano /etc/apache2/sites-available/flarum.conf

Dán cấu hình máy chủ ảo sau. Bạn sẽ cần phải thay đổi một số tùy chọn bên dưới như Tên miền và đường dẫn của chứng chỉ SSL.

 ServerName example.io
 Chuyển hướng vĩnh viễn / https://example.io/



 ServerAdmin [emailprotected]
 DocumentRoot /var/www/flarum/public
 ServerName example.io

 Giao thức h2 http/1.1

 SSLEngine On
 SSLCertificateFile /etc/letsencrypt/live/example.io/fullchain.pem
 SSLCertificateKeyFile /etc/letsencrypt/live/example.io/privkey.pem

 
 Tùy chọn FollowSymlinks
 AllowOverride All
 Require all granted
 

 ErrorLog ${APACHE_LOG_DIR}/error.log
 CustomLog ${APACHE_LOG_DIR}/access.log combined
 
 
 RewriteEngine on
 RewriteBase /
 RewriteCond %{REQUEST_FILENAME} !-f
 RewriteRule ^(.*) index.php [PT,L]

Lưu tệp bằng cách nhấn nút CTRL+X và nhập Y để xác nhận.

Bây giờ, hãy kích hoạt cấu hình máy chủ ảo flarum.conf bằng lệnh bên dưới. Sau đó, hãy xác minh tất cả các cấu hình Apache2.

sudo a2ensite flarum.conf
sudo apachectl configtest

Nếu bạn thấy thông báo đầu ra Cú pháp OK, thì tất cả các cấu hình Apache2 của bạn đều hợp lệ.

Cuối cùng, hãy khởi động lại dịch vụ Apache2 bằng lệnh bên dưới để áp dụng các thay đổi mới trên máy chủ web Apache2 của bạn.

sudo systemctl restart apache2

Bắt đầu cài đặt Flarum​

Để bắt đầu cài đặt và cấu hình Flarum, bạn cần truy cập Flarum của mình qua URL https://yourdomain.com/ và bạn sẽ nhận được trang sau.

Nhập thông tin chi tiết về cài đặt Flarum của bạn như tiêu đề trang web và thông tin chi tiết về cơ sở dữ liệu. Sau đó nhập người dùng admin và mật khẩu cho Flarum.



Nhấp vào Cài đặt Flarum để bắt đầu và xác nhận cài đặt Flarum.

Khi quá trình cài đặt hoàn tất, bạn sẽ nhận được thông báo Chào mừng từ Flarum như bên dưới.



Nếu bạn vào cài đặt quản trị Flarum, bạn sẽ thấy thông tin bên dưới.

Flarum v1.2.1 được cài đặt trên máy chủ Debian 11 với PHP 7.4 và MariaDB 10.5.

Kết luận​

Xin chúc mừng! Bây giờ bạn đã cài đặt thành công ứng dụng web Flarum trên Debian 11 Bullseye mới nhất với LAMP Stack. Bây giờ bạn có thể bắt đầu thêm một số tiện ích mở rộng để mở rộng ứng dụng web Flarum của mình.