
Hướng dẫn cài đặt V2Board trên aaPanel từ A-Z (kèm lưu ý bảo trì 2026)

Lưu ý cập nhật: Bài viết này đăng lần đầu ngày 28/06/2023. Từ tháng 11/2026 bài được viết lại đầy đủ các bước kèm giải thích, và phải nói rõ một việc quan trọng trước khi bạn bắt đầu: V2Board gốc (repo v2board/v2board) đã ngừng phát triển từ lâu — không còn commit, không còn vá bảo mật. Hướng dẫn dưới đây vẫn cài được bản cổ điển như cũ (nhiều hệ thống cũ vẫn đang chạy), nhưng nếu bạn dựng hệ thống mới, hãy cân nhắc nghiêm túc các fork còn được bảo trì (tiêu biểu là XBoard, dùng chung họ API nên các node backend như soga/V2bX vẫn đối tiếp được) thay vì bắt đầu với một panel đã chết bảo trì. Một sửa đổi nữa: bản cũ của bài từng in công khai đường dẫn quản trị bí mật của panel mẫu — bài này chỉ dùng đường dẫn minh hoạ, và bạn cũng đừng bao giờ công khai đường dẫn admin thật của mình.
1. Yêu cầu hệ thống
Máy chủ đã cài aaPanel và các thành phần sau (cài từ App Store của aaPanel):
| Thành phần | Yêu cầu |
|---|---|
| Nginx | 1.17 trở lên |
| MySQL / MariaDB | MySQL 5.7+ hoặc MariaDB 10.2+ |
| PHP | 7.3 trở lên (bản V2Board cổ điển chạy ổn với PHP 7.4/8.0 — chọn đúng phiên bản mà bản bạn cài yêu cầu) |
| Redis | Bắt buộc (hàng đợi + cache) |
| Extension PHP | redis và fileinfo (cài trong trang quản lý PHP → Install extension) |
Trước khi cài, chuẩn bị sẵn: một tên miền/subdomain trỏ về IP máy chủ (ví dụ panel.tenmien-cua-ban.com) và thông tin database sẽ tạo cho panel.
2. Bước 1 — Gỡ các hàm PHP bị vô hiệu hoá
V2Board (viết bằng Laravel) cần một số hàm mà aaPanel mặc định chặn. Vào App Store → PHP (bản đã chọn) → Settings → Disable function và xoá khỏi danh sách cấm bốn hàm sau:
putenv
proc_open
pcntl_alarm
pcntl_signal
Thiếu bước này, trình cài đặt sẽ báo lỗi hoặc hàng đợi (queue) không chạy được về sau.
3. Bước 2 — Tạo website và database trên aaPanel
- Vào Website → Add Site: nhập tên miền panel, chọn phiên bản PHP đã chuẩn bị, và tạo luôn database kèm theo (aaPanel cho tạo DB ngay trong form này — ghi lại tên DB, user, mật khẩu).
- Ghi nhớ thư mục gốc của site:
/www/wwwroot/<ten-mien-cua-ban>.
4. Bước 3 — Tải mã nguồn V2Board và chạy trình cài đặt
SSH vào máy chủ, di chuyển tới thư mục web và dọn các file mặc định của aaPanel:
cd /www/wwwroot/<ten-mien-cua-ban>
chattr -i .user.ini
rm -rf .htaccess 404.html index.html .user.ini
Tải mã nguồn từ GitHub chính thức về ngay thư mục hiện tại (dấu chấm cuối lệnh):
git clone https://github.com/v2board/v2board.git .
Chạy trình cài đặt tích hợp và trả lời các câu hỏi nó đưa ra (thông tin database vừa tạo, email + mật khẩu quản trị, đường dẫn quản trị bí mật…):
sh init.sh
Khi được hỏi Yes/No, nhập Yes để tiếp tục. Quá trình cài đặt gồm tải thư viện phụ thuộc, tạo bảng dữ liệu và tài khoản admin — chờ vài phút tới khi hoàn tất. Ghi lại đường dẫn quản trị bí mật mà trình cài đặt cấp (dạng tenmien.com/<chuoi-ngau-nhien>) — đây là cửa vào admin duy nhất, mất là phải đặt lại trong cấu hình, lộ là người lạ có cửa dò mật khẩu admin.
5. Bước 4 — Cấu hình rewrite và thư mục chạy
Vào Website → chọn site → URL Rewrite và dán cấu hình sau:
location /public {
}
location / {
try_files $uri $uri/ /index.php$is_args$query_string;
}
location ~ .*\.(js|css)?$ {
expires 1h;
error_log off;
access_log /dev/null;
}
Tiếp đó vào Website → Site Settings → Running Directory và chọn /public — đây là bước người mới hay quên nhất: Laravel phục vụ web từ thư mục public, để thư mục chạy ở gốc là trang web báo lỗi 500 hoặc lộ cấu trúc source.
Cuối cùng, phân quyền thư mục về đúng chủ sở hữu web:
chown -R www:www /www/wwwroot/<ten-mien-cua-ban>

6. Bước 5 — Cron mỗi phút và hàng đợi bằng PM2
V2Board cần hai tiến trình nền chạy liên tục:
Cron lập lịch — vào mục Cron của aaPanel, tạo tác vụ:
- Type of Task: Shell Script
- Chu kỳ: N Minutes — mỗi 1 phút
- Script (thay tên miền của bạn):
php /www/wwwroot/<ten-mien-cua-ban>/artisan schedule:run
Hàng đợi (queue/horizon) — cài ứng dụng PM2 Manager từ App Store của aaPanel, mở lên và thêm Project mới:
- Startup file: chọn file
pm2.yamltrong thư mục web. - Run dir: thư mục gốc của website.
- Name: đặt tên bất kỳ (ví dụ
v2board).
Thiếu cron hoặc PM2, panel vẫn mở được nhưng đơn hàng không tự xử lý, email không gửi, node không đồng bộ đúng hạn — đây là nhóm lỗi “cài xong tưởng chạy mà thực ra chưa” phổ biến nhất.
7. Bước 6 — Kiểm tra và việc cần làm ngay sau cài
- Truy cập tên miền panel: thấy trang chủ V2Board là web đã lên.
- Vào đường dẫn quản trị bí mật đã ghi ở bước 3, đăng nhập bằng tài khoản admin vừa tạo.
- Việc cần làm ngay:
- Bật SSL cho tên miền panel (Website → SSL → Let’s Encrypt) — panel chứa dữ liệu người dùng và thanh toán, chạy HTTP là không chấp nhận được.
- Đổi mật khẩu admin nếu bạn lỡ dùng mật khẩu yếu lúc cài.
- Lấy API key của panel trong phần cài đặt hệ thống — đây là thông tin dùng để đối tiếp các node về sau (xem bài cài soga lên V2Board); không chia sẻ key này công khai.
- Bật sao lưu database định kỳ trong aaPanel.

8. Lỗi thường gặp
- Trang báo 500 ngay sau cài: chưa đặt Running Directory là
/public, hoặc chưa phân quyềnwww:www, hoặc thiếu extension. Xem log lỗi của site trong aaPanel để biết dòng cụ thể. - Vào được trang chủ nhưng bấm đâu cũng 404: thiếu cấu hình rewrite ở bước 4.
- Cài đặt chạy giữa chừng thì lỗi đỏ: còn hàm bị cấm chưa gỡ (bước 1) hoặc sai thông tin database. Gỡ đủ hàm, kiểm tra DB rồi chạy lại
sh init.sh. - Đơn hàng/email không chạy: cron
schedule:runchưa tạo hoặc PM2 chưa chạy projectpm2.yaml. Kiểm tra cả hai ở bước 5. - Không vào được trang admin: bạn đang vào
/admin— V2Board cổ điển không dùng đường dẫn đó; admin nằm ở đường dẫn bí mật cấp lúc cài đặt. - Node đối tiếp về panel không được: kiểm tra API key, và chắc chắn tên miền panel đã có SSL hợp lệ (node gọi API qua HTTPS sẽ lỗi nếu chứng chỉ tự ký/hết hạn).
Kết luận
Cài đặt V2Board trên aaPanel gồm sáu bước: chuẩn bị môi trường (Nginx, MySQL, PHP, Redis + extension) → gỡ bốn hàm PHP bị cấm → tạo website + database → tải source và chạy init.sh → đặt rewrite và thư mục chạy /public → bật cron mỗi phút và PM2 cho hàng đợi. Làm đủ cả sáu, đặc biệt là hai tiến trình nền ở bước cuối, panel mới thật sự vận hành được. Và nhắc lại lời khuyên ở đầu bài: hệ thống cũ đang chạy V2Board thì cứ vận hành tiếp có sao lưu đầy đủ; hệ thống mới, hãy chọn fork còn được bảo trì.
Có thắc mắc khi làm theo bài, cứ nhắn qua Telegram hoặc Zalo.
Câu hỏi thường gặp
V2Board có còn dùng được không nếu đã ngừng phát triển? Chạy thì vẫn chạy — nhiều hệ thống cũ vẫn vận hành. Nhưng không còn vá bảo mật nghĩa là mỗi lỗ hổng mới phát hiện sẽ không bao giờ được sửa; với panel chứa dữ liệu người dùng và thanh toán, đó là rủi ro tăng dần theo thời gian.
XBoard khác gì V2Board, dữ liệu cũ chuyển sang được không? XBoard là fork phát triển tiếp từ mã nguồn V2Board, giữ tương thích phần lớn cấu trúc và API đối tiếp node. Việc di trú dữ liệu có hướng dẫn riêng theo từng phiên bản — hãy sao lưu toàn bộ database trước khi thử và đọc kỹ tài liệu của fork.
PM2 Manager có bắt buộc không? Panel mở lên được mà không cần PM2, nhưng hàng đợi xử lý đơn hàng/email/gửi thông báo sẽ không chạy. Muốn panel vận hành thật thì bắt buộc phải có tiến trình queue — bằng PM2 Manager là cách thuận tiện nhất trên aaPanel.
Quên đường dẫn quản trị bí mật thì sao? Đường dẫn này lưu trong cấu hình của V2Board trên máy chủ (file .env/cấu hình admin) — SSH vào đọc lại hoặc đặt lại theo tài liệu, sau đó đổi luôn nếu nghi ngờ đã lộ.
Có cài V2Board bằng Docker thay cho aaPanel được không? Được — dự án có hỗ trợ triển khai Docker. Nhưng nếu bạn đã quen aaPanel và muốn quản lý trực quan, cách trong bài này là đường ngắn nhất.

Bình luận (0)