vGo.codes
Login Sign up
vGocms Core Detailed Installation Guide
vGocms Featured Free

vGocms Core Detailed Installation Guide

Live preview URL

Open live demo

https://github.com/vgocms-dev/vGocms/blob/main/vGocms_Installation_Guide_Detailed_Admin.pdf

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

Tiếng Việt (Vietnamese)

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.

vGocms Core Detailed Installation Guide

English

System Requirements

  • VPS/Server running Ubuntu 20.04 or 22.04.
  • aaPanel installed.
  • Software on aaPanel: Nginx, MariaDB, Redis, and Supervisor Manager.
  • Latest MariaDB version is recommended over MySQL.

Step 1: Download Source Code & Permissions

Access Files in aaPanel. Create the root directory:

/www/wwwroot/vgocms.com

Download and extract the latest build via the link below: Download Zip.

Grant execute permission 755 to vgocms_linux_amd64:

  • aaPanel UI: Right-click the file -> Permission. Check Execute. Set Owner to www. Apply.
  • Terminal/SSH:

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

Step 2: Install Node.js (Required for Theme)

Node.js is required to compile frontend resources. Install Node.js version manager from the App Store.

Install a Stable Version, v20 or higher. Set it as default in Command line version.

Step 3: Initialize MariaDB Database & Check Redis

For optimal vGocms performance, use the latest version of MariaDB instead of MySQL. You can run MariaDB and MySQL in parallel on the same server if needed.

Go to Databases -> Add database.

Security note: Do not use the root account or simple passwords. Create a specific database and user with a strong password.

Example:

  • DB Name: vgocms_db or your choice.
  • User: vgocms_user.
  • Password: use a strong auto-generated password.

Check that Redis runs on port 6379. Note the password if any.

Step 4: Environment Variables (.env)

Edit the .env file. The values provided in the template, such as root or 123456, are examples only. Replace them with the actual credentials created in Step 3.

Important:

  • SESSION_SECRET: Must be changed to a long random string.
  • APP_PORT: Internal port, default is 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

Step 5: Run Service via Supervisor Manager

Open 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

Step 6: Configure Reverse Proxy (Nginx)

Add a website on aaPanel. Go to Reverse proxy -> Add reverse proxy.

Target URL:

http://localhost:8000

Install Let's Encrypt SSL.

Step 7: Admin Login & Security

After installation, access the admin panel at:

http://yourdomain.com/admin/login

Default Account: [email protected]

Password: admin123

Security Recommendation: Change the admin email and password immediately after the first login. You can also change the /admin URL path in the settings to protect against brute-force attacks.

vGocms Core 详细安装指南

中文 (Chinese)

系统要求

  • 运行 Ubuntu 20.04 或 22.04 的 VPS/服务器。
  • 已安装 aaPanel。
  • aaPanel 上的软件：Nginx、MariaDB、Redis、Supervisor 管理器。
  • 推荐使用最新版 MariaDB 代替 MySQL。

步骤 1：下载源码与权限设置

访问 aaPanel 的文件管理。创建根目录：

/www/wwwroot/vgocms.com

通过以下链接下载并解压最新版本：Download Zip。

为 vgocms_linux_amd64 授予执行权限 755：

  • aaPanel 界面：右键文件 -> 权限。勾选“执行”。所有者设为 www。应用。
  • 终端/SSH：

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

步骤 2：安装 Node.js（主题必需）

编译前端资源需要 Node.js。在软件商店安装 Node.js 版本管理器。

安装 Stable Version，版本 v20 或更高，并在“命令行版本”中将其设为默认。

步骤 3：初始化 MariaDB 数据库与检查 Redis

为了优化 vGocms 性能，请使用最新版本的 MariaDB 代替旧版 MySQL。如果需要，您可以在同一台服务器上同时运行 MariaDB 和 MySQL。

进入 Databases -> Add database。

安全提示：不要使用 root 账户或简单密码。请创建专门的数据库和用户，并使用强密码。

例如：

  • 数据库名称：vgocms_db。
  • 用户：vgocms_user。
  • 密码：使用强密码。

确保 Redis 在端口 6379 运行。如有密码，请记录。

步骤 4：环境变量 (.env)

编辑 .env 文件。模板中提供的值，例如 root 或 123456，仅为示例。请用您在步骤 3 中创建的实际凭据替换。

重要提示：

  • SESSION_SECRET：必须改为长随机字符串。
  • APP_PORT：内部端口，默认 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

步骤 5：使用 Supervisor 管理器运行服务

打开 Supervisor 管理器 -> 添加守护进程。

  • 名称：vgocms_core
  • 运行用户：www
  • 运行目录：/www/wwwroot/vgocms.com
  • 启动命令：/www/wwwroot/vgocms.com/vgocms_linux_amd64

步骤 6：配置反向代理 (Nginx)

在 aaPanel 添加网站。进入 反向代理 -> 添加。

目标 URL：

http://localhost:8000

安装 Let's Encrypt SSL。

步骤 7：管理员登录与安全

安装完成后，通过以下地址访问后台：

http://yourdomain.com/admin/login

默认账号：[email protected]

密码：admin123

安全建议：首次登录后，请立即修改管理员邮箱和密码。您还可以在设置中更改 /admin 路径，以防止暴力破解。

Detalyadong Gabay sa Pag-install ng vGocms Core

Filipino

Mga Kinakailangan sa System

  • VPS/Server na gumagamit ng Ubuntu 20.04 o 22.04.
  • Naka-install ang aaPanel.
  • Mga software sa aaPanel: Nginx, MariaDB, Redis, at Supervisor Manager.
  • Inirerekomenda ang pinakabagong bersyon ng MariaDB kaysa MySQL.

Hakbang 1: I-download ang Source Code at Permissions

Pumunta sa Files sa aaPanel. Gumawa ng root directory:

/www/wwwroot/vgocms.com

I-download at i-extract ang pinakabagong build gamit ang link sa ibaba: Download Zip.

Magbigay ng execute permission 755 sa vgocms_linux_amd64:

  • aaPanel UI: Right-click sa file -> Permission. I-check ang Execute. Set ang Owner sa www. Apply.
  • Terminal/SSH:

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

Hakbang 2: I-install ang Node.js (Kailangan para sa Theme)

Kailangan ang Node.js para mag-compile ng frontend resources. I-install ang Node.js version manager sa App Store.

Mag-install ng Stable Version, v20 pataas, at i-set ito bilang default sa Command line version.

Hakbang 3: I-setup ang MariaDB Database at I-check ang Redis

Para sa mas magandang performance, gamitin ang pinakabagong bersyon ng MariaDB. Maaari mong patakbuhin nang sabay ang MariaDB at MySQL sa iisang server kung kailangan.

Pumunta sa Databases -> Add database.

Paalala sa seguridad: Huwag gamitin ang root account o simpleng password. Gumawa ng sariling database at user na may malakas na password.

Halimbawa:

  • DB Name: vgocms_db.
  • User: vgocms_user.
  • Password: gumamit ng malakas na password.

Siguraduhing tumatakbo ang Redis sa port 6379. Tandaan ang password kung mayroon.

Hakbang 4: Environment Variables (.env)

I-edit ang .env file. Ang mga value sa template, tulad ng root o 123456, ay mga halimbawa lamang. Palitan ang mga ito ng aktwal na credentials na ginawa sa Hakbang 3.

Mahalaga:

  • SESSION_SECRET: Dapat palitan ng mahabang random string.
  • APP_PORT: Internal port, default ay 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

Hakbang 5: Patakbuhin ang Service gamit ang Supervisor Manager

Buksan ang 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

Hakbang 6: I-configure ang Reverse Proxy (Nginx)

Magdagdag ng website sa aaPanel. Pumunta sa Reverse proxy -> Add.

Target URL:

http://localhost:8000

Mag-install ng Let's Encrypt SSL.

Hakbang 7: Admin Login at Seguridad

Pagkatapos ma-install, i-access ang admin panel sa:

http://yourdomain.com/admin/login

Default na Account: [email protected]

Password: admin123

Rekomendasyon sa Seguridad: Palitan agad ang admin email at password pagkatapos ng unang login. Maaari mo ring palitan ang /admin path URL para makaiwas sa brute-force attacks.

คู่มือการติดตั้ง vGocms Core แบบละเอียด

ไทย (Thai)

ความต้องการของระบบ

  • VPS/Server ที่ใช้ Ubuntu 20.04 หรือ 22.04
  • ติดตั้ง aaPanel แล้ว
  • ซอฟต์แวร์บน aaPanel: Nginx, MariaDB, Redis และ Supervisor Manager
  • แนะนำให้ใช้ MariaDB เวอร์ชันล่าสุดแทน MySQL

ขั้นตอนที่ 1: ดาวน์โหลด Source Code และกำหนดสิทธิ์

ไปที่ Files บน aaPanel สร้างไดเรกทอรีหลัก:

/www/wwwroot/vgocms.com

ดาวน์โหลดและแตกไฟล์เวอร์ชันล่าสุดผ่านลิงก์ด้านล่าง: Download Zip

ให้สิทธิ์การประมวลผล 755 แก่ vgocms_linux_amd64:

  • ผ่าน aaPanel: คลิกขวาที่ไฟล์ -> Permission เลือก Execute กำหนด Owner เป็น www แล้วกด Apply
  • ผ่าน Terminal/SSH:

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

ขั้นตอนที่ 2: ติดตั้ง Node.js (จำเป็นสำหรับ Theme)

จำเป็นต้องใช้ Node.js เพื่อคอมไพล์ทรัพยากร frontend ติดตั้ง Node.js version manager จาก App Store

ติดตั้ง Stable Version v20 ขึ้นไป และตั้งเป็นค่าเริ่มต้นใน Command line version

ขั้นตอนที่ 3: สร้าง Database MariaDB และตรวจสอบ Redis

เพื่อประสิทธิภาพสูงสุด แนะนำให้ใช้ MariaDB เวอร์ชันล่าสุดแทน MySQL คุณสามารถรัน MariaDB และ MySQL ควบคู่กันบนเซิร์ฟเวอร์เดียวกันได้หากต้องการ

ไปที่ Databases -> Add database

คำเตือนด้านความปลอดภัย: ไม่ควรใช้บัญชี root หรือรหัสผ่านที่เดาง่าย ให้สร้าง database และ user เฉพาะพร้อมรหัสผ่านที่รัดกุม

ตัวอย่าง:

  • DB Name: vgocms_db
  • User: vgocms_user
  • Password: ใช้รหัสผ่านที่รัดกุม

ตรวจสอบให้แน่ใจว่า Redis รันบนพอร์ต 6379 และบันทึกรหัสผ่านหากมี

ขั้นตอนที่ 4: ตัวแปรสภาพแวดล้อม (.env)

แก้ไขไฟล์ .env ข้อมูลในเทมเพลต เช่น root หรือ 123456 เป็นเพียงตัวอย่าง โปรดแทนที่ด้วยข้อมูลจริงที่คุณสร้างในขั้นตอนที่ 3

สำคัญ:

  • SESSION_SECRET: ต้องเปลี่ยนเป็นสตริงสุ่มที่ยาว
  • APP_PORT: พอร์ตภายใน ค่าเริ่มต้น 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

ขั้นตอนที่ 5: รัน Service ด้วย Supervisor Manager

เปิด 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

ขั้นตอนที่ 6: กำหนดค่า Reverse Proxy (Nginx)

เพิ่ม website บน aaPanel ไปที่ Reverse proxy -> Add reverse proxy

Target URL:

http://localhost:8000

ติดตั้ง Let's Encrypt SSL

ขั้นตอนที่ 7: การเข้าสู่ระบบ Admin และความปลอดภัย

หลังจากติดตั้งเสร็จ ให้เข้าสู่ระบบหลังบ้านได้ที่:

http://yourdomain.com/admin/login

บัญชีเริ่มต้น: [email protected]

รหัสผ่าน: admin123

คำแนะนำด้านความปลอดภัย: โปรดเปลี่ยนอีเมลและรหัสผ่านของผู้ดูแลระบบทันทีหลังจากการเข้าสู่ระบบครั้งแรก คุณยังสามารถเปลี่ยนเส้นทาง URL /admin เพื่อป้องกันการโจมตีแบบสุ่มรหัสผ่าน Brute-force

Changelog

No changelog entries yet.