Hướng dẫn one-page từ lúc tải file, cấu hình MariaDB/MySQL và Redis, chỉnh sửa .env đến khi đăng nhập được trang quản trị vGocms.
Máy Windows cần chạy được MariaDB hoặc MySQL, đồng thời Redis phải được bật trước khi khởi động vGocms.
Tải trực tiếp file ZIP chính thức từ kho phát hành.
Nhấn nút bên dưới để tải file vGocms-windows.zip. Nên tạo một thư mục riêng, ví dụ C:/vgocms, để dễ quản lý dữ liệu và bản sao lưu.
Thư mục sau giải nén phải có file cấu hình và file chạy.
Sau khi giải nén, hãy xác nhận có đúng hai file chính:
.envFile cấu hình kết nối database, Redis, cổng chạy và các khóa bảo mật.vgocms_windows_amd64.exeỨng dụng vGocms đã biên dịch cho Windows 64-bit.
Database và Redis phải hoạt động trước khi mở vGocms.
Mở Laragon, bật MariaDB hoặc MySQL. vGocms ưu tiên MariaDB. Tạo database tên videogo.
Bật dịch vụ Redis trong Laragon và giữ địa chỉ mặc định localhost:6379. Redis là thành phần bắt buộc.
Kết quả đúng: PONG.
Cập nhật tài khoản database, Redis, cổng chạy và khóa bảo mật.
Mở file .env bằng Notepad hoặc VS Code. Ít nhất phải kiểm tra lại các biến sau:
DB_USER / DB_PASSTài khoản và mật khẩu MariaDB/MySQL trên máy.DB_NAME=videogoTên database vừa tạo.REDIS_ADDRMặc định localhost:6379.SESSION_SECRETPhải đổi sang chuỗi mạnh, không giữ giá trị mẫu.INTEGRATION_ENCRYPTION_KEYTạo một lần rồi giữ nguyên sau khi lưu thông tin Cloudflare/GSC.APP_PORT=8000Cổng truy cập trang quản trị.# --- Database --- DB_HOST=localhost DB_PORT=3306 DB_USER=root DB_PASS=123456 DB_NAME=videogo # --- Redis --- REDIS_ADDR=localhost:6379 REDIS_PASS= REDIS_DB=0 USER_SERVICE_BASE_URL=http://localhost:8081 USER_SERVICE_WEBHOOK_ENABLED=1 USER_SERVICE_WEBHOOK_SECRET=vui-long-doi # --- Session --- SESSION_SECRET=vui-long-doi # --- Application --- APP_PORT=8000 # release mode: release, debug mode: debug GIN_MODE=release ENABLE_HSTS=1 # --- Cloud integrations security --- # Generate once with: openssl rand -base64 48 # IMPORTANT: Do not change this after saving Cloudflare/Google credentials. INTEGRATION_ENCRYPTION_KEY= # --- Portable & secure database backup --- # auto: prefer mariadb-dump/mysqldump, otherwise use the built-in Go exporter # native: require mariadb-dump/mysqldump # go: always use the built-in Go exporter # BACKUP_METHOD=auto # Optional absolute path when the dump tool is not in PATH, especially on Windows. DB_DUMP_PATH= # Keep backups outside the public ./static directory. BACKUP_DIR=./data/backups BACKUP_TIMEOUT_MINUTES=120 # ISP/network reachability monitor NETWORK_CHECK_SCHEDULER=1 NETWORK_CHECK_HISTORY_DAYS=30 # --- Performance and security --- # Exact public/admin hostnames, comma separated. Required in production. # ALLOWED_HOSTS=admin.example.com,api.example.com # Only reverse proxies allowed to supply X-Forwarded-* / client IP headers. TRUSTED_PROXIES=127.0.0.1,::1 CSRF_ENABLED=1 # Enable when the admin panel is served through HTTPS. SESSION_SECURE=0 # MariaDB driver timeout and connection pool. DB_CONNECT_TIMEOUT=5s DB_READ_TIMEOUT=10s DB_WRITE_TIMEOUT=10s DB_MAX_OPEN_CONNS=40 DB_MAX_IDLE_CONNS=10 DB_CONN_MAX_LIFETIME=30m DB_CONN_MAX_IDLE_TIME=5m # Redis fail-soft cache/pool settings. REDIS_DIAL_TIMEOUT=3s REDIS_READ_TIMEOUT=2s REDIS_WRITE_TIMEOUT=2s REDIS_POOL_SIZE=20 REDIS_MIN_IDLE_CONNS=2 # HTTP server protection. HTTP_READ_HEADER_TIMEOUT=10s HTTP_READ_TIMEOUT=30s HTTP_WRITE_TIMEOUT=60s HTTP_IDLE_TIMEOUT=120s ADMIN_REQUEST_MAX_BYTES=134217728 # Upload and remote-image safety limits (bytes/pixels). FILE_UPLOAD_MAX_BYTES=52428800 FILE_IMAGE_MAX_BYTES=15728640 REMOTE_IMAGE_MAX_BYTES=15728640 REMOTE_IMAGE_MAX_PIXELS=40000000
Khởi động ứng dụng sau khi database và Redis đã sẵn sàng.
Nhấp đúp vào vgocms_windows_amd64.exe. Bạn cũng có thể mở PowerShell ngay tại thư mục vGocms để xem log rõ hơn:
Mở trình duyệt, đăng nhập bằng tài khoản mặc định.
Truy cập địa chỉ:
Sau khi đăng nhập, bạn sẽ thấy Dashboard hệ thống, khu vực quản lý nội dung và các công cụ vận hành của vGocms.
Kiểm tra lần lượt các mục dưới đây trước khi gửi log lên nhóm hỗ trợ.
Mở PowerShell tại thư mục vGocms và chạy ./vgocms_windows_amd64.exe để đọc lỗi. Thường do sai thông tin database, database chưa chạy hoặc Redis chưa bật.
Kiểm tra DB_HOST, DB_PORT, DB_USER, DB_PASS và đảm bảo database videogo đã được tạo.
Bật Redis trong Laragon, kiểm tra cổng 6379 và chạy redis-cli ping. Phải nhận được kết quả PONG.
Kiểm tra ứng dụng còn chạy, APP_PORT=8000 không bị ứng dụng khác chiếm và thử địa chỉ đầy đủ http://127.0.0.1:8000/admin/login.
Bật hiển thị phần mở rộng tên file trong File Explorer, sau đó đổi đúng tên thành .env và đảm bảo file nằm cùng thư mục với EXE.
Chạy local qua HTTP thì dùng SESSION_SECURE=0. Chỉ đặt thành 1 khi trang quản trị được phục vụ thực sự qua HTTPS.
Tải bộ cài chính thức, làm đúng 6 bước và gửi ảnh log vào nhóm Telegram khi cần hỗ trợ kỹ thuật.