1. Apa itu Tunnel SaaS v2?

Versi 2 dari Tunnel mengubah cara deploy: dari "upload semua file ke setiap domain" menjadi "upload 2 file proxy di client, semua logika di server pusat".

2. Beda v1 vs v2

📊 Tabel Perbandingan

3. Cara Kerja

Tiap request dari pengunjung di client domain akan di-proxy ke server pusat, lalu hasil HTML/gambar dikembalikan ke pengunjung:

⚙️ Detail Tiap Komponen

Client Domain (2 file)

• index.php — terima request, forward ke server pusat via cURL
• .htaccess — rewrite semua URL ke index.php

Server Pusat (lengkap)

• render.php — terima request dari client, validasi key, route ke template
• saas_config.php — daftar API key + host yang diizinkan
• Semua file project Tunnel (index, about, img, dst.) → render HTML
• list.txt, config.php → data sentral untuk semua client

4. Pasang Server Pusat (1×)

Server pusat cuma perlu dipasang sekali. Setelah itu bisa melayani banyak client.

📁 Yang Akan Di-Upload

Folder tunnel-saas/server/ berisi:

🚀 Langkah Setup

1. Zip folder server/ di komputer Klik kanan folder server/ → "Send to" → "Compressed (zipped) folder".
2. Upload ke hosting Login cPanel → File Manager → upload zip ke folder yang Anda mau. Bisa ke public_html/api/ (subfolder) atau bikin subdomain dulu.
3. Extract di server Klik kanan zip → Extract. Pastikan file render.php ada langsung di folder, bukan di sub-sub folder.
4. Edit saas_config.php Buka file via Editor cPanel. Set api_keys untuk client Anda (lihat section "Manajemen Key").
5. Test buka endpoint Akses https://api.mydomain.com/render.php di browser. Harus muncul: Invalid API key. Itu artinya server hidup ✓.

5. Pasang Client Proxy (Tiap Domain)

Untuk setiap domain client yang mau Anda hubungkan ke server pusat:

📁 Yang Di-Upload (Cuma 2 File)

🚀 Langkah Setup Per Client

1. Generate API key untuk client Di terminal:

   php -r "echo bin2hex(random_bytes(20));"

   Hasilnya 40 karakter random. Simpan dulu.

2. Tambahkan key ke saas_config.php server

   'api_keys' => [
       'a1b2c3d4...' => 'situs-client.com',
   ],

3. Owner client upload 2 file Beri tahu owner client untuk upload index.php + .htaccess dari folder client/ ke root domain mereka.
4. Owner client edit 2 baris Buka index.php di File Manager mereka:

   $SERVER_URL = 'https://api.mydomain.com/render.php';
   $API_KEY    = 'a1b2c3d4...';   // key dari Anda

5. Test Buka https://situs-client.com/. Halaman langsung tampil dari server pusat, dengan domain client di canonical & OG.

6. Deploy ke cPanel (Step-by-Step)

Panduan visual untuk pengguna shared hosting (Niagahoster, Hostinger, IDwebhost, dll).

🏢 Bagian A: Server Pusat di Subdomain

1. Buat Subdomain di cPanel cPanel → Domains → Subdomains
   • Subdomain: api
   • Domain: mydomain.com
   • Document Root: public_html/api
   Klik Create.
2. Aktifkan Ekstensi PHP cPanel → Select PHP Version
   • Pilih PHP 7.4 atau 8.x
   • Centang ekstensi: gd, curl, mbstring, json
   • Klik Save
3. Upload Folder Server cPanel → File Manager → public_html/api/
   • Zip folder server/ di komputer dulu
   • Klik Upload, pilih zip
   • Setelah upload, klik kanan zip → Extract
   • Hapus file zip-nya
4. Set Permission Folder cache/ Klik kanan folder cache → Permissions → CHMOD 755.
5. Edit saas_config.php Klik kanan saas_config.php → Edit

   'api_keys' => [
       'KEY-CLIENT-1' => 'client1.com',
       'KEY-CLIENT-2' => 'client2.com',
   ],

6. Test Endpoint Buka https://api.mydomain.com/render.php
   • Kalau muncul "Invalid API key" → ✓ berhasil
   • Kalau 500 / blank → cek error_log di cPanel

🌐 Bagian B: Client Domain

1. Login cPanel Client Buka cPanel hosting domain client (mis. cpanel.client.com).
2. Upload 2 File File Manager → public_html/
   • Upload index.php
   • Upload .htaccess (centang "Show hidden files" kalau tidak terlihat)
3. Edit index.php (2 baris)

   $SERVER_URL = 'https://api.mydomain.com/render.php';
   $API_KEY    = 'KEY-DARI-OWNER-SERVER';

4. Cek PHP cURL Aktif cPanel client → Select PHP Version → centang curl.
5. Test Buka https://client.com/ di browser. Halaman muncul = ✓.

💡 Bonus: Cron Auto-Update Keyword

Di server pusat, set cron job untuk update keyword tiap 6 jam:

1. cPanel → Cron Jobs Common Settings: Once per 6 hours
2. Command:

   /usr/bin/php /home/USERNAME/public_html/api/keyword_update.php

   Ganti USERNAME dengan username cPanel Anda.

7. Manajemen API Key

Setiap client domain dapat API key sendiri. Anda yang kontrol siapa boleh akses server.

🔑 Generate Key Baru

Cara 1: Via PHP CLI

php -r "echo bin2hex(random_bytes(20));"

Cara 2: Via Generator Online

Buka randomkeygen.com → ambil "Fort Knox Password" (40+ karakter).

📝 Format di saas_config.php

'api_keys' => [
    // Format: 'KEY' => 'host_yang_diizinkan'
    'a1b2c3d4e5f6...' => 'client1.com',
    '9z8y7x6w5v4u...' => 'client2.com',

    // Wildcard '*' = boleh dari host apapun (untuk testing saja)
    'test-key-XXX' => '*',
],

🛡️ Skenario Pemakaian Key

🔄 Cabut Akses Client

Kalau client tidak bayar / mau hentikan layanan:

1. Hapus baris key client dari saas_config.php
2. Save
3. Refresh — domain client langsung dapat 403

8. Update Sentral (Edit Sekali, Semua Kena)

Ini adalah keuntungan utama SaaS v2. Setiap perubahan di server pusat otomatis berlaku untuk semua client.

🎯 Apa yang Bisa Diubah Sentral?

⚙️ Apa yang TIDAK Otomatis Sync?

Yang harus diatur di tiap client (jarang):

• 2 baris di client index.php (URL server + API key)
• Tidak ada yang lain

9. Estimasi Biaya Hosting

🏢 Untuk Server Pusat (1× Bayar)

🌐 Untuk Tiap Client Domain

10. System Check (Cek Siap Deploy)

Admin punya halaman 🩺 System Check yang verifikasi semua requirement sebelum live.

📋 Yang Di-cek (20 item)

🎯 Cara Pakai

1. Login admin Setelah deploy, login ke admin panel.
2. Klik menu "🩺 System Check" Halaman otomatis run 20 check.
3. Lihat ringkasan di atas ✓ Siap deploy ATAU ⚠ N issue
4. Perbaiki yang FAIL Kolom "Fix" kasih panduan tiap item.
5. Re-run sampai semua hijau Setelah semua pass, server siap untuk client.

📍 Path Auto-Detection

System Check juga tampilkan path yang terdeteksi:

Admin Dir       : /home/user/public_html/manage
Server Dir      : /home/user/public_html/api
Data Dir        : /home/user/public_html/manage/data
Clients Dir     : /home/user/public_html/manage/data/clients
Endpoint URL    : https://api.mydomain.com/render.php

'admin_data_path' => '/home/user/public_html/manage/data',

10. Pertanyaan Umum