Cài Flarum trên VPS với PHP và MariaDB
Cài Flarum 1.8 trên VPS bằng PHP, Composer và MariaDB, chỉ expose /public qua TLS, đồng thời xử lý lỗi mail và extension upgrade làm hỏng forum mới.
Cài đặt Flarum trên VPS với PHP và MariaDB
Cài đặt Flarum trên VPS giúp bạn có một diễn đàn chạy trên PHP và MariaDB, không cần Docker, không cần Ruby và không cần trình chạy tác vụ riêng biệt. Đó là lý do để chọn nó. Cài đặt Discourse trên VPS đồng nghĩa với một stack Docker bao gồm Ruby, PostgreSQL, Redis và một background worker, và hướng dẫn cài đặt của Discourse khuyến nghị 2 GB RAM (1 GB chỉ hoạt động với swap), trước khi bạn thêm các bản sao lưu hoặc dịch vụ mail. Discourse xứng đáng với tài nguyên đó trên một cộng đồng bận rộn với hàng ngàn bài viết mỗi ngày. Trên một diễn đàn chỉ có vài trăm người, đó là bộ máy mà bạn phải trả tiền hàng tháng nhưng không bao giờ dùng tới. Flarum nằm gọn trong một stack PHP mà bạn có thể đã đang chạy, vì vậy một VPS 1 GB với nginx và MariaDB có thể host nó bên cạnh bất kỳ thứ gì khác. Nếu bạn vẫn đang cân nhắc, bài so sánh chi tiết hơn về các phần mềm diễn đàn tự host sẽ bao quát phần còn lại.
Hướng dẫn này cố định việc cài đặt ở Flarum 1.x, hiện tại là series 1.8. Flarum 2.0.0 đã trở thành bản phát hành ổn định vào ngày 9 tháng 10 năm 2026, nhưng tính đến ngày 12 tháng 10 năm 2026, hướng dẫn nâng cấp của chính Flarum cho biết nhiều extension cho đến nay mới chỉ gắn thẻ các bản phát hành beta cho 2.0, và dòng 1.x vẫn nhận được các bản sửa lỗi cho các lỗi nghiêm trọng và vấn đề bảo mật. Các extension quan trọng hơn phiên bản core ở đây, vì vậy 1.8 vẫn là phiên bản an toàn hơn để chạy cho một diễn đàn phụ thuộc vào chúng. Nếu bạn không cần extension của bên thứ ba, 2.0 là bản phát hành hiện tại: nó cần PHP 8.3 hoặc mới hơn, phiên bản mà Ubuntu 24.04 cung cấp, và tài liệu của Flarum cài đặt nó bằng composer create-project flarum/flarum:^2.0.0 .. Các lệnh dưới đây được viết cho phiên bản 1.8.
Các yêu cầu của Flarum 1.8 trên máy chủ
Các yêu cầu được tài liệu hóa của Flarum là PHP 7.3 trở lên, MySQL 5.6+ hoặc MariaDB 10.0.5+, và nginx hoặc Apache với mod_rewrite. Ubuntu 24.04 phát hành PHP 8.3 và MariaDB 10.11, vì vậy các gói của bản phân phối này đáp ứng cả hai mà không cần repository của bên thứ ba. Flarum 2.0 nâng mức tối thiểu đó lên PHP 8.3+, MySQL 5.7+ / 8.0.30+ hoặc MariaDB 10.3+, vốn cũng được các gói Ubuntu tương tự đáp ứng. Các extension PHP mà Flarum yêu cầu là curl, dom, fileinfo, gd, json, mbstring, openssl, pdo_mysql, tokenizer và zip. Bạn cũng cần quyền truy cập shell, vì Composer là bắt buộc ở đây: mọi extension của Flarum đều là một gói Composer, và không có cách nào để thêm extension mà không chạy Composer.
Flarum là một ứng dụng PHP thông thường. Nếu bạn đã chạy một LAMP stack trên Ubuntu 24.04, hầu hết các phần tiếp theo đã được cài đặt và bạn có thể đọc lướt qua phần cơ sở dữ liệu.
Cài đặt PHP và các extension mà Flarum yêu cầu
sudo apt update
sudo apt install -y nginx mariadb-server composer
sudo apt install -y php8.3-fpm php8.3-cli php8.3-curl php8.3-gd php8.3-mbstring php8.3-mysql php8.3-xml php8.3-zip
php -m | grep -E 'curl|dom|gd|mbstring|pdo_mysql|zip'
composer --versionTên các gói phần mềm không khớp hoàn toàn với danh sách của Flarum. Extension dom nằm bên trong php8.3-xml, còn fileinfo, json, openssl và tokenizer đã được tích hợp sẵn trong PHP 8.3 trên Ubuntu hoặc đi kèm với php8.3-common (gói mà các package trên sẽ tự động cài đặt), vì vậy bạn không cần cài thêm gì cho những thành phần này. Lệnh grep sẽ hiển thị bảy dòng: sáu extension cộng với random, một module mà PHP 8.3 luôn tải và tình cờ có tên chứa dom. composer --version sẽ báo phiên bản 2.x. Nếu thiếu extension nào, hãy khắc phục ngay. Ví dụ, nếu bỏ qua php8.3-xml, Composer sẽ từ chối cài đặt Flarum vì một trong các dependency của nó yêu cầu ext-dom, và thông báo lỗi sẽ chỉ đích danh extension đó cho bạn. Dòng quan trọng sẽ kết thúc như sau:
require ext-dom * -> it is missing from your system. Install or enable PHP's dom extension.Tuy nhiên, Composer không kiểm tra mọi extension trong danh sách của Flarum. Thư viện xử lý ảnh mà Flarum 1.8 sử dụng chỉ gợi ý gd, vì vậy một máy chủ thiếu gói này vẫn cài đặt thành công nhưng sẽ lỗi sau đó, khi Flarum cần xử lý ảnh avatar hoặc logo được tải lên.
Hãy kiểm tra để đảm bảo PHP dòng lệnh (CLI) và trình quản lý tiến trình FastCGI (PHP-FPM) cùng phiên bản. Composer chạy bằng binary dòng lệnh trong khi diễn đàn của bạn chạy bằng FPM, vì vậy php -v và sudo php-fpm8.3 -v phải khớp nhau. Chúng thường lệch phiên bản trên các máy chủ đã cài nhiều bản PHP từ repository của bên thứ ba, dẫn đến việc extension bạn cài cho bản này sẽ không hiển thị với bản kia.
Tạo database và user database riêng
sudo mariadb-secure-installation
sudo mariadbCREATE DATABASE flarum CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'flarum'@'localhost' IDENTIFIED BY 'use-a-long-random-password';
GRANT ALL PRIVILEGES ON flarum.* TO 'flarum'@'localhost';
FLUSH PRIVILEGES;
EXIT;Cấp cho Flarum một user database riêng thay vì root. Grant này chỉ bao phủ flarum.* và không có quyền nào khác, nên lỗi SQL injection trong một extension mà bạn không tự viết sẽ không thể đọc các database khác. Character set cũng rất quan trọng: utf8mb4 lưu emoji và các bộ chữ không phải Latin chính xác, còn utf8 cũ của MySQL chỉ dùng encoding ba byte nên sẽ cắt bài viết tại ký tự đầu tiên cần bốn byte. Hãy xác nhận user hoạt động trước khi tiếp tục.
mariadb -u flarum -p flarum -e 'SELECT DATABASE();'Lệnh này phải in ra flarum. ERROR 1045 (28000): Access denied for user 'flarum'@'localhost' nghĩa là password không khớp, hoặc user được tạo cho host khác với localhost.
Cài đặt Flarum trên VPS bằng Composer, ghim phiên bản 1.8
Trước tiên, hãy tạo một người dùng hệ thống để sở hữu mã nguồn. Chạy Composer với root sẽ để lại các file thuộc sở hữu của root trong vendor/ và storage/, khiến PHP không thể ghi cache sau đó và diễn đàn sẽ trả về lỗi 500 cho mọi yêu cầu.
sudo useradd --system --home-dir /srv/flarum --shell /bin/bash flarum
sudo install -d -o flarum -g flarum -m 755 /srv/flarum
sudo -iu flarumLệnh cuối cùng đó đưa bạn vào shell với tư cách người dùng flarum, tại /srv/flarum. Mọi lệnh từ đây đến cuối hướng dẫn đều chạy tại đó trừ khi bắt đầu bằng sudo.
composer create-project flarum/flarum:^1.8.0 .Ràng buộc ^1.8.0 là cách ghim phiên bản. Nó chấp nhận các bản vá 1.8.x và từ chối 2.0, điều này rất quan trọng vì 2.0.0 hiện đã là bản ổn định: nếu không có ràng buộc này, composer create-project sẽ cài đặt bản 2.0. Composer tải xuống bộ khung, phân giải flarum/core cùng các dependency của nó, và để lại cho bạn public/, storage/, vendor/, composer.json cùng một script dòng lệnh flarum.
Trên một VPS nhỏ, đây là bước dễ xảy ra lỗi, và hai loại lỗi khác nhau thường trông giống nhau. PHP Fatal error: Allowed memory size of 134217728 bytes exhausted là giới hạn memory_limit của chính PHP, và việc đặt COMPOSER_MEMORY_LIMIT=-1 trước lệnh sẽ gỡ bỏ giới hạn đó cho một lần chạy. Một lệnh Killed bị ngắt đột ngột mà không có lỗi PHP nào thường là do kernel kích hoạt tính năng out-of-memory killer, bạn có thể xác nhận điều này bằng dmesg | tail. Trường hợp đó nghĩa là máy chủ thực sự đã hết RAM, vì vậy hãy thêm swap: việc tăng giới hạn PHP chỉ làm tình hình tệ hơn, vì PHP sẽ yêu cầu thêm nhiều bộ nhớ hơn trước khi kernel can thiệp.
Vì sao chỉ /public nên được public trên web
Thư mục gốc của project chứa config.php với database password ở dạng plain text, vendor/ với toàn bộ dependency, và storage/ với log cùng các session đã cache. Không nội dung nào trong đó nên được đưa lên public internet. Flarum đặt toàn bộ nội dung có thể truy cập qua web trong một thư mục con là public/. Thư mục này chứa index.php, một thư mục assets/ và hầu như không có gì khác. Trỏ web server root vào /srv/flarum/public. Khi đó, phần còn lại của cây thư mục không thể truy cập qua HTTP ngay từ thiết kế, thay vì phụ thuộc vào một rule mà bạn phải nhớ cấu hình.
Nếu trỏ root vào /srv/flarum, hậu quả là có thật. Request đến /config.php không trả về nội dung hữu ích, vì PHP thực thi file này và file chỉ trả về một array. Nhưng /storage/logs/flarum.log lại đưa stack trace và database error cho người lạ, còn /composer.lock cho họ biết chính xác version của mọi package bạn đang chạy. Đây là danh sách các lỗ hổng đã biết để họ thử khai thác.
Cấp một pool riêng cho PHP-FPM
Flarum cần quyền ghi vào ba đường dẫn: thư mục gốc của project để installer có thể tạo config.php; storage/ để lưu log và cache; và assets/ để lưu avatar và logo đã upload. Các file thuộc về user flarum, nên cách phù hợp là tạo một PHP-FPM pool chạy với user flarum. nginx vẫn chạy với user www-data và chỉ đọc file.
Tạo /etc/php/8.3/fpm/pool.d/flarum.conf:
[flarum]
user = flarum
group = flarum
listen = /run/php/php8.3-fpm-flarum.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
pm = ondemand
pm.max_children = 10
pm.process_idle_timeout = 30s
php_admin_value[memory_limit] = 256M
php_admin_value[upload_max_filesize] = 16M
php_admin_value[post_max_size] = 17Msudo systemctl restart php8.3-fpm
ls -l /run/php/php8.3-fpm-flarum.sockSocket phải được khai báo là srw-rw---- 1 www-data www-data. Process master chạy dưới quyền root và tạo socket, nên process này có thể gán quyền sở hữu cho www-data trong khi các worker chạy với user flarum. Nếu không có socket, sudo journalctl -u php8.3-fpm -n 30 sẽ in dòng FPM rejected. pm = ondemand chỉ khởi chạy worker khi có request đến, nên một forum ít truy cập hầu như không tốn thêm memory giữa các lần truy cập.
Khối server của nginx
Flarum cung cấp một snippet của nginx trong thư mục gốc của project, có tên là .nginx.conf. Snippet này chứa rewrite rule, cache headers và thiết lập compression. Hãy include snippet thay vì sao chép nội dung, để khi Flarum upgrade và thay đổi snippet, server của bạn nhận được thay đổi đó mà không cần chỉnh sửa thủ công.
server {
listen 80;
listen [::]:80;
server_name forum.example.com;
root /srv/flarum/public;
index index.php;
client_max_body_size 16M;
include /srv/flarum/.nginx.conf;
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm-flarum.sock;
}
}Lưu nội dung đó thành /etc/nginx/sites-available/flarum, rồi enable nó.
sudo ln -s /etc/nginx/sites-available/flarum /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginxnginx -t phải trả về syntax is ok và test is successful. Dòng include là dòng thường bị bỏ sót nhất. Nếu thiếu dòng này, triệu chứng rất cụ thể sẽ xảy ra: trang chủ tải bình thường, nhưng mọi link đến discussion đều trả về lỗi 404 từ nginx. Flarum xử lý một URL như /d/1-hello-world bên trong PHP. Đường dẫn đó không phải là file trên disk. Vì vậy, nếu không có rule try_files $uri $uri/ /index.php?$query_string trong snippet, nginx sẽ tìm một directory có tên d, không tìm thấy directory đó và trả về 404 trước khi PHP được xử lý. Apache dùng cùng cơ chế routing từ file .htaccess đã có sẵn trong public/. Cơ chế này chỉ có hiệu lực khi block <Directory> tương ứng đặt AllowOverride All.
Thêm TLS trước khi chạy trình cài đặt
Tạo chứng chỉ ngay từ đầu, không làm sau. Trong quá trình cài đặt, Flarum ghi base URL của nó vào config.php và lấy URL đó từ địa chỉ trong trình duyệt. Nếu cài đặt qua http://, mọi asset URL mà Flarum tạo sau đó sẽ bắt đầu bằng http://. Khi bạn thêm TLS (transport layer security), trình duyệt sẽ chặn các request này vì mixed content. Forum sẽ chỉ tải dưới dạng văn bản không có style và không có JavaScript. Trước tiên, hãy làm theo hướng dẫn cấu hình certbot cho Let's Encrypt trên nginx, xác nhận https://forum.example.com hiển thị được một trang, rồi quay lại.
Nếu bạn đã cài đặt qua HTTP thuần, chỉ cần sửa một dòng. Chỉnh sửa /srv/flarum/config.php để key url có giá trị 'url' => 'https://forum.example.com',, rồi chạy php flarum cache:clear với user flarum.
Chạy installer và khóa chặt config.php
Mở https://forum.example.com trong trình duyệt. Web installer của Flarum yêu cầu tên database, user và password của database mà bạn đã tạo, tiêu đề forum và tài khoản admin. Installer ghi config.php và tạo các bảng. Khi hoàn tất, hãy siết quyền của file đang chứa database password.
sudo chmod 640 /srv/flarum/config.phpFile này vẫn có quyền đọc và ghi đối với flarum, là user mà FPM chạy dưới quyền, và không tài khoản nào khác trên máy có thể đọc file. Sau đó kiểm tra cài đặt từ shell.
php flarum infoLệnh này in ra version của core, version của PHP, các extension đã enable, mail driver và những path đang được sử dụng. Đây là lệnh đầu tiên cần chạy khi có vấn đề, đồng thời cũng là thông tin đầu tiên người hỗ trợ bạn sẽ yêu cầu.
Vì email đăng ký và đặt lại mật khẩu thất bại mà không có thông báo
Phần này quyết định forum của bạn có tồn tại qua tuần đầu tiên hay không. Hai email đầu tiên mà một forum mới gửi là email xác nhận đăng ký và email đặt lại mật khẩu. Cả hai đều được gửi đúng lúc một người lạ đang quyết định cộng đồng của bạn có hoạt động thật hay không. Cả hai đều có thể thất bại mà không báo lỗi. Người không nhận được email không thể cho bạn biết, còn dashboard quản trị cũng không hiển thị cảnh báo.
Flarum có 4 mail driver, được cấu hình trong Administration rồi đến Email: smtp, mail, mailgun và log. Chọn smtp và trỏ nó đến một mail service có khả năng gửi email thực sự. Driver mail chuyển message cho binary sendmail cục bộ. Binary này không có sẵn trên Ubuntu VPS mới cài, nên message không đi đâu cả và cũng không phát sinh lỗi. Driver log ghi nội dung message vào storage/logs/ và hoàn toàn không gửi email, vì driver này chỉ dành cho development.
Lưu các thiết lập, rồi nhấn nút Gửi email kiểm tra trên chính trang đó. Đây là feedback loop duy nhất bạn có, vì vậy hãy dùng nó trước khi mời bất kỳ ai. Nếu email không đến, hãy đọc log.
tail -n 50 /srv/flarum/storage/logs/flarum.logKết nối bị từ chối, đăng nhập bị từ chối và lỗi thương lượng TLS đều được ghi tại đó, cùng với host và port đã thử. Dòng có nội dung Connection could not be established with host smtp.example.com nghĩa là port bị chặn hoặc không đúng. Nguyên nhân thường gặp là provider mặc định chặn port outbound 25. Port 587 với trường encryption đặt thành tls là cấu hình hoạt động với gần như mọi mail service.
Khi mail bị lỗi, visitor đăng ký sẽ thấy banner lỗi chung của Flarum, Oops! Something went wrong. Please reload the page and try again., vì request phát sinh lỗi trong lúc gửi email xác nhận. Dù xảy ra theo cách nào, người đó cũng không thể đăng nhập và sẽ không viết cho bạn để báo lỗi.
Việc mail được chấp nhận là một vấn đề khác với việc mail được gửi đi. Email gửi từ địa chỉ VPS không có record SPF hoặc DKIM được công bố cho domain của bạn có thể rơi vào thư mục spam hoặc bị loại bỏ mà không có bounce message. Khi đó log vẫn hiển thị gửi thành công nhưng người nhận không thấy gì. Gửi mail ổn định từ các app tự host giải thích cần công bố những record DNS nào và nên dùng những relay service nào.
Extension là các package Composer, nên việc nâng cấp được thực hiện bằng command
Trong Flarum, một extension là một package Composer. Không có nút upload và cũng không có file zip để thả vào một thư mục. Đây là một quyết định thiết kế có chủ đích: các version được resolve dựa trên nhau, bộ package chính xác được ghi trong composer.lock, và extension phụ thuộc vào một PHP library sẽ được cài đúng cách. Đổi lại, mỗi lần thêm extension cần chạy ba command với user flarum.
composer require 'fof/upload:*'
php flarum migrate
php flarum cache:clearSau đó, bật extension tại Administration rồi Extensions. Mỗi command thực hiện một việc riêng. composer require ghi code vào disk. php flarum migrate chạy các database migration đi kèm extension, nhờ đó extension có thể tạo các table riêng. php flarum cache:clear build lại các bundle JavaScript và CSS đã compile mà browser tải xuống. Bỏ qua bước cuối sẽ dẫn đến lỗi khó hiểu thường gặp: extension đã xuất hiện trong danh sách, toggle đã bật, nhưng browser không thay đổi gì dù bạn reload bao nhiêu lần.
Việc gỡ extension được thực hiện theo chiều ngược lại. Trước tiên, disable extension trong admin panel, sau đó remove package. Flarum cố ý giữ lại các table của extension, để khi bật lại sau này dữ liệu không bị mất. Nếu cũng muốn xóa các table đó, hãy rollback migration của extension trước khi remove code.
php flarum migrate:reset --extension fof-upload
composer remove fof/upload
php flarum cache:clearExtension id trong command đó là tên package, với dấu slash được thay bằng dấu hyphen. Nếu muốn click thay vì gõ command, composer require 'flarum/extension-manager:*' sẽ thêm một trang admin chính thức để thao tác với Composer. Trang này chạy cùng các operation như web user, cần cùng lượng memory và cùng quyền ghi, đồng thời cũng gặp cùng các lỗi. Vì vậy, khi có sự cố, CLI vẫn là cách đáng tin cậy hơn.
Tại sao composer update từ chối nâng cấp Flarum
Việc nâng cấp Flarum và mọi extension chỉ cần một lệnh Composer theo sau bởi hai lệnh Flarum. Hãy sao lưu database trước.
composer update --prefer-dist --no-plugins --no-dev -a --with-all-dependencies
php flarum migrate
php flarum cache:clearHãy đọc kết quả đầu ra thay vì mặc định rằng nó đã thành công, vì trường hợp đáng chú ý là khi Composer từ chối thực hiện bất kỳ thay đổi nào:
Your requirements could not be resolved to an installable set of packages.Thông báo đó có nghĩa là một extension đã cài đặt khai báo một ràng buộc flarum/core loại trừ bản release mà bạn đang muốn chuyển tới. Composer sẽ không vi phạm ràng buộc đó, vì vậy nó giữ nguyên toàn bộ bản cài đặt ở phiên bản cũ thay vì lắp ghép một tổ hợp mà tác giả extension đã xác nhận là không hoạt động. Hãy tìm gói gây ra vấn đề này.
composer why-not flarum/core 1.8.20Kết quả đầu ra liệt kê mọi gói đang chặn phiên bản đó và ràng buộc mà mỗi gói khai báo. Từ đó, các lựa chọn của bạn là chờ tác giả phát hành bản cập nhật tương thích, hoặc gỡ bỏ extension đó và không sử dụng nó nữa. Đây là cái giá của mô hình Composer, và bạn nên hiểu điều này trước khi cài đặt mười lăm extension lên một diễn đàn mà người khác đang dựa vào. Hãy ưu tiên các extension vừa có bản release gần đây và giữ danh sách đủ ngắn để bạn có thể kiểm soát được.
Các lệnh này giữ bạn ở trong phạm vi 1.x. Việc chuyển từ 1.8 lên 2.0 là một bản nâng cấp lớn với hướng dẫn riêng trong tài liệu của Flarum: nó yêu cầu PHP 8.3, các chỉnh sửa trong composer.json, thay đổi driver trong config.php đối với các bản cài đặt MariaDB, và việc gỡ bỏ bất kỳ extension nào chưa có bản release cho 2.0.
Cần backup những gì
Hãy backup database và thư mục project. Mọi thứ khác có thể dựng lại.
mariadb-dump -u flarum -p --single-transaction flarum > flarum-$(date +%F).sql
sudo tar czf flarum-files.tgz -C /srv flarumTrên các hệ thống cũ, mariadb-dump được gọi là mysqldump; trên Ubuntu 24.04, cả hai tên đều hoạt động. Database chứa mọi bài viết, mọi user và mọi setting. Thư mục project chứa config.php, composer.json (đây mới là nơi ghi nhận chính xác các extension bạn đang chạy) và assets/ cùng các avatar và logo đã upload. Bạn có thể bỏ qua vendor/, vì composer install sẽ dựng lại nó từ composer.lock, còn storage/ sẽ tự tạo lại. Hãy copy cả hai file ra khỏi server, vì một bản backup nằm trên chính máy mà nó bảo vệ thì không phải là backup. Khôi phục cần một Flarum mới cùng version, composer install, đưa các file đã lưu trở lại đúng vị trí và load file SQL.
FAQ
Flarum có chạy được trên VPS 1 GB không?
Có, nếu là một cộng đồng nhỏ. Flarum khi vận hành bình thường gồm PHP-FPM xử lý các request và MariaDB. Với pm = ondemand, các PHP worker chỉ tồn tại khi có người đang đọc trang. Đỉnh điểm tiêu thụ tài nguyên là lúc cài đặt: composer create-project giải quyết toàn bộ cây dependency trong bộ nhớ và đây là bước dễ bị out-of-memory killer dừng lại nhất. Hãy thêm một swap file trước khi cài đặt, hoặc chạy Composer trên một máy mạnh hơn rồi copy toàn bộ thư mục sang.
Tại sao các link thảo luận trả về 404 trong khi trang chủ vẫn hoạt động?
Server block nginx của bạn đang thiếu include /srv/flarum/.nginx.conf;. Flarum xử lý các URL như /d/1-hello-world bên trong PHP, và đường dẫn đó không phải là một file thực tế trên ổ cứng. Nếu không có quy tắc try_files $uri $uri/ /index.php?$query_string trong snippet, nginx sẽ tìm một thư mục tên là d, không thấy, và tự trả về 404 mà không gọi PHP. Trên Apache, việc định tuyến tương tự được thực hiện qua public/.htaccess, nhưng nó sẽ bị bỏ qua trừ khi block <Directory> thiết lập AllowOverride All.
Tại sao diễn đàn của tôi mất hết định dạng sau khi bật HTTPS?
Flarum lưu base URL trong config.php, được ghi lại từ địa chỉ bạn dùng khi chạy trình cài đặt. Nếu bạn cài đặt qua HTTP thường, Flarum sẽ tiếp tục tạo các URL asset dạng http://, và trình duyệt sẽ chặn chúng vì lỗi mixed content trên trang HTTPS, dẫn đến việc trang web không có định dạng. Hãy sửa key url trong file /srv/flarum/config.php thành địa chỉ https:// và chạy lệnh php flarum cache:clear với user sở hữu các file đó.
Tại sao không ai nhận được email xác nhận đăng ký?
Trước tiên hãy kiểm tra mail driver. Driver mail yêu cầu một binary sendmail cục bộ mà VPS Ubuntu mới cài thường không có, còn driver log chỉ ghi vào storage/logs/ và không gửi đi đâu cả. Hãy chuyển sang smtp, sử dụng cổng 587 với mã hóa thiết lập là tls vì hầu hết các nhà cung cấp đều chặn cổng 25 chiều outbound, sau đó nhấn Send Test Mail. Nếu log báo gửi thành công nhưng mail vẫn không tới, vấn đề nằm ở khả năng deliverability chứ không phải cấu hình, hãy xuất bản các bản ghi SPF và DKIM cho domain gửi mail của bạn.
Tôi nên cài đặt Flarum 1.8 hay 2.0?
Hãy cài 1.8 nếu diễn đàn của bạn phụ thuộc vào các extension của bên thứ ba. Flarum 2.0.0 đã trở thành bản stable vào ngày 9 tháng 10 năm 2026, nhưng tính đến ngày 12 tháng 10 năm 2026, hướng dẫn nâng cấp của Flarum cho biết nhiều extension mới chỉ có bản beta cho 2.0. Bất kỳ extension nào chưa có bản 2.0 đều khai báo ràng buộc flarum/core dừng lại ở 1.x. Cài đặt 2.0 ngay bây giờ đồng nghĩa với việc Composer sẽ từ chối các extension đó, đây chính là xung đột ràng buộc mà composer why-not dùng để chẩn đoán. Hãy ghim phiên bản với flarum/flarum:^1.8.0 và chuyển lên 2.0 theo hướng dẫn nâng cấp của Flarum khi các extension bạn cần đã có bản 2.0 ổn định. Lưu ý rằng 1.x hiện chỉ nhận các bản vá lỗi nghiêm trọng và vấn đề bảo mật. Một diễn đàn không cần extension bên thứ ba có thể bắt đầu với 2.0 ngay hôm nay bằng lệnh flarum/flarum:^2.0.0.