# HƯỚNG DẪN TRIỂN KHAI TOÀN DIỆN LÊN SHARED HOSTING (PRODUCTION DEPLOYMENT GUIDE)

Tài liệu này hướng dẫn từng bước đưa toàn bộ mã nguồn website lên hosting dùng chung (cPanel / DirectAdmin), cấu hình cơ sở dữ liệu MariaDB/MySQL, kích hoạt xác thực hai yếu tố, và thiết lập lá chắn Cloudflare WAF.

---

## BƯỚC 1: CHUẨN BỊ MÔI TRƯỜNG TRÊN CPANEL

### 1.1. Kiểm tra phiên bản PHP
1. Đăng nhập vào cPanel, tìm mục **Select PHP Version** hoặc **MultiPHP Manager**.
2. Chọn phiên bản **PHP 8.4** trở lên (tối ưu nhất là PHP 8.4 hoặc 8.5).
3. Bật đầy đủ các phần mở rộng (extensions) bắt buộc:
   - `pdo`, `pdo_mysql`
   - `openssl` (xác thực WebAuthn / FIDO2)
   - `gd` hoặc `imagick` (xử lý ảnh WebP và dọn dẹp EXIF)
   - `zip` (nén sao lưu tự động)
   - `json`, `mbstring`

### 1.2. Tạo Cơ sở dữ liệu MariaDB / MySQL
1. Vào mục **MySQL Databases** trên cPanel.
2. Tạo CSDL mới, ví dụ: `u12345_knowledge`.
3. Tạo người dùng CSDL mới với mật khẩu ngẫu nhiên độ dài tối thiểu 24 ký tự: ví dụ `u12345_dbuser`.
4. Gán quyền cho người dùng vừa tạo vào CSDL với tùy chọn **ALL PRIVILEGES**.

---

## BƯỚC 2: TẢI MÃ NGUỒN VÀ TỔ CHỨC CÂY THƯ MỤC

Nguyên tắc an ninh tối cao: **Không bao giờ đưa toàn bộ mã nguồn vào `public_html/`**.

1. Mở **File Manager** trong cPanel, chuyển đến thư mục gốc của tài khoản hosting (ngang hàng với `public_html/`, thường là `/home/u12345/`).
2. Nén toàn bộ thư mục `G:\wed` ở máy tính của bạn thành file `wed.zip` và tải lên thư mục gốc hosting.
3. Giải nén trên cPanel và sắp xếp đúng như sau:
   ```text
   /home/u12345/
   ├── app/                      <-- Nằm ngoài webroot (an toàn tuyệt đối)
   ├── storage/                  <-- Nằm ngoài webroot (chứa CSDL, log, backup)
   └── public_html/              <-- CHỈ CHỨA các file công khai
       ├── .htaccess
       ├── index.php
       ├── assets/
       ├── cache/
       └── uploads/
   ```
4. Phân quyền thư mục (Permissions):
   - Thư mục thông thường: `755`
   - Thư mục ghi dữ liệu (`~/storage/`, `~/public_html/cache/`, `~/public_html/uploads/`): `750` hoặc `755`
   - File thông thường: `644`
   - File cấu hình bảo mật `~/storage/app_config.secure.php`: `600` hoặc `640`

---

## BƯỚC 3: CẤU HÌNH THÔNG SỐ BẢO MẬT BAN ĐẦU

Chỉnh sửa file `/home/u12345/storage/app_config.secure.php` bằng trình biên tập file của cPanel:

```php
<?php
declare(strict_types=1);

return [
    'db' => [
        'host' => '127.0.0.1',
        'database' => 'u12345_knowledge',
        'username' => 'u12345_dbuser',
        'password' => 'MAT_KHAU_CSDL_VUA_TAO_O_BUOC_1',
        'charset' => 'utf8mb4',
    ],
    'app' => [
        'name' => 'Góc Kiến Thức Cá Nhân',
        'url' => 'https://tenmiencuaban.com',
        'admin_path' => 'cp_' . bin2hex(random_bytes(10)), // Đường dẫn ngẫu nhiên bảo mật, ví dụ: cp_a8b9c1d2e3f4
        'admin_email' => 'admin@tenmiencuaban.com',
    ],
    'security' => [
        'app_key' => bin2hex(random_bytes(32)), // 64 ký tự hex ngẫu nhiên
        'allowed_country' => 'VN',              // Giới hạn khu quản trị cho Việt Nam
        'trusted_proxies' => [],                // Sẽ tự động nạp dải IP Cloudflare
    ],
];
```

---

## BƯỚC 4: CHẠY TRÌNH CÀI ĐẶT AN TOÀN (ONE-TIME SECURE INSTALLER)

1. Mở file `app/bin/installer.php`, tạo một mã Token bí mật tạm thời (hoặc sinh ngẫu nhiên).
2. Nếu hosting có **SSH/Terminal**: Chạy trực tiếp qua lệnh:
   ```bash
   php app/bin/installer.php --token=TOKEN_BI_MAT
   ```
3. Nếu hosting không có SSH:
   - Truy cập qua trình duyệt: `https://tenmiencuaban.com/installer.php?token=TOKEN_BI_MAT`
   - Nhập email quản trị, mật khẩu chính.
   - Trình cài đặt sẽ:
     1. Chạy toàn bộ file Migration CSDL (`001`, `002`, `003`).
     2. Băm mật khẩu bằng thuật toán **Argon2id**.
     3. Tạo mã bí mật **TOTP (RFC 6238)** và hiển thị QR Code để quét vào Google Authenticator.
     4. Cung cấp **8 mã khôi phục dự phòng (Recovery Codes)** dạng `XXXX-XXXX`. **Hãy chép lại vào nơi an toàn!**
     5. Tự động sinh file khóa `storage/installer.lock` và **tự hủy file installer** để ngăn chặn cài đặt lại.

---

## BƯỚC 5: THIẾT LẬP LỊCH TỰ ĐỘNG (CRON JOBS TRÊN CPANEL)

Vào mục **Cron Jobs** trên cPanel, thêm 3 tác vụ tự động quan trọng sau:

| Tần suất | Thời gian cron | Câu lệnh thực thi (Command) | Mục đích |
|:---|:---:|:---|:---|
| **Hàng ngày (02:00 sáng)** | `0 2 * * *` | `/usr/local/bin/php /home/u12345/app/bin/backup.php >/dev/null 2>&1` | Tự động xuất CSDL, nén media, tính mã SHA256 và giữ 7 bản sao lưu gần nhất |
| **Hàng ngày (03:30 sáng)** | `30 3 * * *` | `/usr/local/bin/php /home/u12345/app/bin/cron_maintenance.php >/dev/null 2>&1` | Xóa rate limit hết hạn, xóa audit log cũ hơn 90 ngày, xoay vòng log |
| **Hàng tuần (Chủ nhật)** | `0 0 * * 0` | `/usr/local/bin/php /home/u12345/app/bin/cron_update_cf_ips.php >/dev/null 2>&1` | Tải dải IP mới nhất của Cloudflare để origin chỉ nhận kết nối từ Cloudflare |

*(Lưu ý: Thay thế `/home/u12345/` bằng đường dẫn tuyệt đối tài khoản hosting của bạn).*

---

## BƯỚC 6: CẤU HÌNH CLOUDFLARE WAF & EDGE CACHE (GÓI FREE)

Sau khi trỏ Nameservers của tên miền về Cloudflare:

### 6.1. Bật SSL/TLS Strict
- Vào **SSL/TLS** -> Chọn chế độ **Full (Strict)**.

### 6.2. Tạo WAF Rule bảo vệ khu quản trị
- Vào **Security** -> **WAF** -> **Custom Rules** -> Bấm **Create Rule**:
  - Rule Name: `Protect Admin Panel`
  - Field: `URI Path` -> Operator: `contains` -> Value: `/cp_` (đường dẫn admin của bạn)
  - And: `Country` -> Operator: `does not equal` -> Value: `Vietnam`
  - Action: `Block`
  *(Ngăn chặn 100% mọi kết nối từ các quốc gia khác dò quét trang quản trị của bạn).*

### 6.3. Bật Bot Fight Mode
- Vào **Security** -> **Bots** -> Bật **Bot Fight Mode** sang `On`.

### 6.4. Tạo Cache Rule tối ưu hóa Static-First
- Vào **Caching** -> **Cache Rules** -> Bấm **Create Rule**:
  - Rule Name: `Cache Everything Static-First`
  - Expression: `(http.request.uri.path ne "/cp_*") and not (http.request.uri.path contains "/api/")`
  - Cache Eligibility: **Eligible for cache**
  - Edge Cache TTL: **7 days**
  *(Đảm bảo 99% lượt truy cập bài viết công khai được trả ngay từ mạng máy chủ Cloudflare toàn cầu, tải về Shared Hosting gần như bằng 0).*
