Mesin dan browser

Tujuan

Membuat mesin dan instance browser, serta mengelola versi paket runtime browser untuk akses browser jarak jauh, login situs, dan menjalankan workspace.

Prasyarat

• Sudah login ke konsol admin.
• Akun saat ini memiliki izin terkait "Manajemen Browser".
• Node mesin atau lingkungan runtime browser yang tersedia sudah disiapkan.
• Layanan admin sudah mengonfigurasi app.keeperbase untuk menyimpan paket browser client dan engine.

Langkah operasi

1. Masuk ke "Manajemen Browser > Daftar Mesin".

2. Klik "Tambah Mesin", isi alamat mesin dan nomor port.

   • Alamat mesin: isi alamat layanan keeper. Secara default keeper berada di server instalasi; gunakan alamat intranet server.
   • Nomor port: default 7000.
   • Versi bawaan: saat mesin ditambahkan atau diperbarui, sistem memanggil interface bind keeper untuk mengambil dan menyimpannya otomatis. Nilai ini tidak diisi manual di halaman.

3. Setelah disimpan, pastikan record mesin ada dan layanan keeper dapat diakses serta dijadwalkan.

4. Masuk ke "Manajemen Browser > Daftar Browser".

5. Buat instance browser, pilih mesin, isi nomor browser, dan pilih versi browser.

   • Mesin: browser yang dibuat akan berjalan pada mesin yang dipilih.
   • Nomor browser: gunakan nilai yang mudah diingat, unik, terdiri dari huruf/karakter tanpa spasi, misalnya chrome100.
   • Versi browser: pilih versi dari manajemen versi, atau pilih "Versi Bawaan". Jika dipilih, sistem memakai versi bawaan yang tersimpan pada mesin terkait.
   • Mode jaringan:
     • Jaringan normal: menggunakan jaringan browser reguler. Proxy HTTP/SOCKS5 dapat dikonfigurasi dan cocok untuk skenario umum.
     • Jaringan terisolasi: membuat lingkungan jaringan independen untuk browser, mengambil alih traffic jaringan browser sepenuhnya, serta mendukung isolasi DNS, UDP, WebRTC, dan perilaku jaringan lain secara lebih lengkap. Gunakan untuk skenario yang membutuhkan isolasi lebih kuat.
   • Slot jaringan: wajib hanya untuk Jaringan terisolasi. Masukkan angka unik yang lebih besar dari 0.
   • Konfigurasi DNS: wajib hanya untuk Jaringan terisolasi. Pilih tcp atau udp, masukkan IP dan port DNS, lalu pilih apakah DNS memakai proxy dengan direct atau proxy. direct mengirim permintaan DNS langsung; proxy mengirim permintaan DNS melalui proxy.
   • Konfigurasi proxy: wajib hanya untuk Jaringan terisolasi. Pilih socks5 atau http, lalu masukkan host dan port proxy. Username dan password opsional.

6. Setelah browser dibuat, Anda dapat mengedit mode jaringan dan konfigurasi jaringan terisolasi dari daftar browser.

7. Klik tombol "Mulai" untuk menjalankan browser hingga status berubah menjadi running.

Konfigurasi browser

Dari daftar browser, klik aksi konfigurasi pada sebuah instance browser untuk menyesuaikan cara browser dijalankan dan dikenali oleh lingkungan.

• Konfigurasi dasar:
  • Versi kernel: pilih versi runtime Chromium yang digunakan instance browser. Gunakan "Edit" di samping field untuk mengelola versi Chromium yang tersedia.
  • OS: pilih profil sistem operasi. Gunakan "Edit" untuk mengelola daftar OS.
  • Brand dan versi brand: pilih brand browser seperti Google Chrome, Microsoft Edge, Opera, atau Vivaldi, lalu pilih versi brand yang sesuai. Mengubah brand akan mengosongkan versi brand yang sudah dipilih.
  • Model mobile: pilih profil perangkat mobile ketika browser perlu meniru lingkungan mobile. Gunakan "Edit" untuk mengelola pilihan model.
  • Zona waktu: cari dan pilih zona waktu browser, atau reset ke zona waktu lokal.
• Konfigurasi lanjutan:
  • Opsi boot: tambah, edit, atau hapus argumen peluncuran Chromium sebagai pasangan key-value. Default umum mencakup disable-gpu, no-sandbox, ignore-certificate-errors, lang, dan autoplay-policy. Untuk switch command line Chromium lainnya, lihat List of Chromium Command Line Switches.
  • Direktori temp dan direktori cache: tentukan lokasi browser menulis file sementara dan data cache.
  • Ukuran maksimum gambar: tentukan ukuran maksimum gambar, dalam piksel, yang digunakan saat browser mengambil gambar.
  • Akselerasi hardware: aktifkan hanya ketika lingkungan runtime mendukung akselerasi GPU yang stabil.
  • Bersihkan data pengguna: bersihkan data pengguna browser ketika sesi bersih diperlukan.

Klik "Simpan" setelah mengubah konfigurasi browser. Restart instance browser jika perubahan perlu berlaku pada proses browser baru.

Manajemen versi browser

Di "Manajemen Browser > Daftar Browser", klik "Manajemen Versi" untuk membuka halaman manajemen versi browser.

Halaman menampilkan nama versi, status engine, status client, dan aksi unduh.

Status	Arti
Belum diunduh	Layanan lisensi mengembalikan versi ini, tetapi paket tipe tersebut tidak ada di app.keeperbase
Ada pembaruan	Paket lokal ada, tetapi layanan lisensi memiliki buildVersion yang lebih tinggi
Sudah terbaru	Build lokal lebih besar atau sama dengan build layanan lisensi, atau versi lokal tidak ada dalam respons layanan

Unduhan berjalan di background dan halaman menampilkan progres. Unduhan mendukung resume dengan HTTP Range. File ditulis dulu ke direktori sementara; setelah selesai dipindahkan ke app.keeperbase/<version>/, lalu paket lama dengan tipe sama dihapus.

Format nama file:

client_<version>_<buildVersion>.tar.gz
engine_<version>_<buildVersion>.tar.gz

API internal Keeper

Layanan admin menyediakan API internal agar node engine dan client dapat mengecek versi dan mengunduh paket otomatis. API ini memerlukan JWT token internal.

API	Deskripsi
GET /internal/navi/keepers	Mengumpulkan paket lokal dari app.keeperbase dan mengembalikan version, type, buildVersion, dan fileName
GET /internal/navi/downKeeper?version=<version>&type=<type>	Mengunduh paket lokal untuk version dan type tertentu, dengan dukungan HTTP Range

Node engine dan client memanggil /internal/navi/keepers secara berkala, membandingkan file BUILD pada versi lokal, lalu memanggil /internal/navi/downKeeper jika versi belum ada atau build lokal lebih rendah.

Validasi hasil

• Daftar mesin menampilkan mesin baru.
• Daftar mesin menampilkan versi bawaan dari keeper bind.
• Daftar browser menampilkan instance browser baru.
• Daftar browser menampilkan versi browser. Jika memakai "Versi Bawaan", versi bawaan mesin terkait juga ditampilkan.
• Daftar browser menampilkan mode jaringan dan slot jaringan. Untuk browser jaringan terisolasi, klik "Detail Jaringan" untuk memeriksa DNS, apakah DNS memakai proxy, dan detail proxy.
• Manajemen versi menampilkan status client dan engine setelah membandingkan paket lokal dengan layanan lisensi.
• Saat pengguna mengakses situs atau workspace, sistem dapat mengalokasikan lingkungan browser yang tersedia.

Masalah umum

• Instance browser harus cocok dengan node mesin; mesin atau keeper yang tidak tersedia akan memengaruhi akses jarak jauh.
• Versi browser, versi brand, dan konfigurasi OS memengaruhi identifikasi dan kompatibilitas situs.
• Jika halaman versi terus menampilkan "Belum diunduh", periksa izin app.keeperbase, koneksi layanan lisensi, dan status tugas unduh.
• Jika pembaruan otomatis tidak berjalan, pastikan node dapat mengakses /internal/navi/keepers dan /internal/navi/downKeeper, serta JWT token sudah benar.
• Daftar jendela digunakan untuk mengamati jendela browser yang sedang berjalan dan memeriksa pemakaian.