Hướng Dẫn Cài Đặt vGocms Core Chi Tiết

Yêu Cầu Hệ Thống

VPS/Server chạy Ubuntu 20.04 hoặc 22.04.
Đã cài đặt aaPanel.
Các software trên aaPanel: Nginx, MariaDB, Redis và Supervisor Manager.
Khuyến nghị sử dụng MariaDB bản mới nhất thay cho MySQL.

Bước 1: Tải Source Code & Phân Quyền

Truy cập Files trên aaPanel. Tạo thư mục gốc:

/www/wwwroot/vgocms.com

Tải bản build mới nhất trực tiếp vào thư mục vừa tạo thông qua link sau và giải nén: Download Zip.

Cấp quyền thực thi 755 cho file binary vgocms_linux_amd64:

Giao diện aaPanel: Click chuột phải vào file -> chọn Permission. Tích vào ô Execute tương đương quyền 755. Mục Owner chọn www. Nhấn Apply.
Terminal/SSH:

chmod +x /www/wwwroot/vgocms.com/vgocms_linux_amd64

Bước 2: Cài Đặt Node.js (Bắt buộc cho Theme)

Hệ thống yêu cầu Node.js để biên dịch tài nguyên frontend. Mở App Store trên aaPanel, cài đặt Node.js version manager.

Cài đặt phiên bản Stable Version từ v20 trở lên. Chọn phiên bản này ở mục Command line version để làm mặc định.

Bước 3: Khởi Tạo Database MariaDB & Kiểm Tra Redis

Để tối ưu cho vGocms, hãy sử dụng MariaDB bản mới nhất thay vì MySQL cũ. Bạn vẫn có thể cài đặt chạy song song MariaDB và MySQL trên cùng một server nếu cần.

Vào mục Databases -> Add database.

Lưu ý bảo mật: Không nên sử dụng tài khoản root hoặc mật khẩu dễ đoán. Hãy tạo database và user riêng biệt với mật khẩu mạnh.

Ví dụ:

DB Name: vgocms_db hoặc tên tùy chọn.
User: vgocms_user.
Password: sử dụng mật khẩu mạnh được tạo tự động.

Vào mục App Store -> mở cài đặt Redis. Kiểm tra đảm bảo service đang chạy ở port 6379. Ghi nhớ mật khẩu nếu có thiết lập.

Bước 4: Cấu Hình Biến Môi Trường (.env)

Mở file .env và cấu hình theo mẫu dưới đây. Các giá trị trong mẫu như root hoặc 123456 chỉ là ví dụ. Hãy thay thế bằng thông tin thực tế bạn vừa tạo ở Bước 3.

Lưu ý quan trọng:

SESSION_SECRET: Bắt buộc đổi thành chuỗi ngẫu nhiên dài.
APP_PORT: Port chạy nội bộ, mặc định là 8000.

# --- Database (TEMPLATE ONLY - DO NOT USE root/123456 in production) ---
DB_HOST=localhost
DB_PORT=3306
DB_USER=your_secure_db_user
DB_PASS=your_secure_password
DB_NAME=your_db_name

# --- Redis ---
REDIS_ADDR=localhost:6379
REDIS_PASS=
REDIS_DB=0

# --- User Microservice Integration ---
USER_SERVICE_BASE_URL=http://localhost:8081
USER_SERVICE_WEBHOOK_ENABLED=1
USER_SERVICE_WEBHOOK_SECRET=123456

# --- Session ---
SESSION_SECRET=change_this_to_a_very_long_random_string_in_production

# --- Application ---
APP_PORT=8000
GIN_MODE=release

Bước 5: Chạy Service Bằng Supervisor Manager

Mở Supervisor Manager -> Add Daemon.

Name: vgocms_core
Run User: www
Run Directory: /www/wwwroot/vgocms.com
Start Command: /www/wwwroot/vgocms.com/vgocms_linux_amd64

Bước 6: Cấu Hình Reverse Proxy (Nginx)

Tạo website trên aaPanel, ví dụ vgocms.com. Vào Reverse proxy -> Add reverse proxy.

Target URL:

http://localhost:8000

Sang tab SSL và cài Let's Encrypt.

Bước 7: Đăng Nhập Admin & Bảo Mật

Sau khi cài đặt và cấu hình tên miền thành công, truy cập trang quản trị tại:

http://yourdomain.com/admin/login

Tài khoản mặc định: [email protected]

Mật khẩu mặc định: admin123

Khuyến nghị bảo mật: Ngay sau khi đăng nhập, hãy đổi ngay email và mật khẩu quản trị viên. Bạn cũng có thể đổi đường dẫn /admin trong cấu hình hệ thống để tăng cường bảo mật chống lại các tool dò quét.

Hướng Dẫn Cài Đặt vGocms Core Chi Tiết trên VPS Ubuntu