Cara Install 9Router di VPS dengan Docker (Panduan Lengkap 2026)

·

·

Gambar Cara Install 9Router di VPS dengan Docker (Panduan Lengkap 2026) by Komunitech AI

tl;dr: 9Router bisa dipasang di VPS pakai Docker dalam satu perintah, jalan di port 20128, dan datanya aman selama kamu mount volume dengan benar. Spesifikasi minimum: Ubuntu 22.04/24.04, 1 vCPU, RAM 2 GB. Estimasi waktu 15-20 menit. Satu hal yang paling sering dilewatkan tutorial lain: jangan pernah expose port 20128 langsung ke internet — siapa pun yang menemukannya bisa memakai API key kamu, dan tagihannya jadi tanggunganmu.

9Router adalah AI Gateway yang menyambungkan tool coding kamu (Claude Code, Cursor, Cline, Codex, Copilot) ke banyak penyedia model AI lewat satu endpoint, lengkap dengan fallback otomatis saat kuota satu penyedia habis. Kalau kamu belum kenal cara kerjanya atau masih membandingkan dengan opsi lain, baca dulu perbandingan OpenRouter vs 9Router. Panduan ini fokus ke satu hal: memasangnya di VPS supaya bisa diakses dari mana saja.

Kenapa Install di VPS, Bukan di Laptop

Secara default 9Router berjalan di localhost:20128 — artinya hanya bisa diakses dari komputer tempat ia dipasang. Untuk banyak orang, itu sudah cukup. VPS baru masuk akal kalau kamu menghadapi salah satu dari ini:

  • Butuh akses dari beberapa perangkat. Laptop kantor, PC rumah, dan laptop cadangan memakai satu konfigurasi yang sama tanpa setup ulang.
  • Dipakai bersama tim kecil. Satu gateway, beberapa developer, kuota provider terkelola terpusat.
  • Agent atau workflow harus jalan 24 jam. Kalau otomasimu berjalan di server lain (misalnya n8n di VPS terpisah), endpoint localhost di laptopmu tidak akan bisa dijangkau.
  • Laptop sering mati atau berpindah jaringan. Router yang mati ikut mematikan seluruh alur kerja.

[ANALISIS KOMUNITECH] Sebaliknya, kamu tidak perlu VPS kalau cuma pakai sendiri di satu mesin. Menambah VPS berarti menambah biaya bulanan dan satu komponen lagi yang harus kamu rawat — tanpa manfaat nyata kalau semua pekerjaan tetap terjadi di laptop yang sama. Jangan bayar server untuk masalah yang belum kamu punya.

Realita Provider “Gratis” di 2026

Sebelum masuk teknis, satu hal yang perlu diluruskan karena banyak tutorial lama masih menjanjikannya: klaim “AI coding gratis unlimited” sudah tidak seakurat dulu. Beberapa jalur gratis yang populer sudah ditutup atau dibatasi.

[FAKTA] Menurut catatan resmi di repositori 9Router: free tier iFlow, Qwen Code, dan Gemini CLI sudah dihentikan pada 2026. Kiro AI berpindah ke model berbayar sejak September 2025 — jatah gratisnya kini dibatasi 50 kredit per bulan (plus 500 kredit percobaan untuk akun baru selama 30 hari pertama), dengan tier berbayar Pro $20/bln (1.000 kredit) hingga Power $200/bln (10.000 kredit). Daftar model OpenCode Free berubah-ubah dan sebagian hanya gratis selama promo. Untuk Vertex AI, kredit $300 akun GCP baru masih berlaku, tetapi sejak Maret 2026 endpoint Gemini API tidak lagi memotong kredit tersebut — harus memakai endpoint Vertex AI Studio — sumber: 9Router — repositori resmi.

[ANALISIS KOMUNITECH] Jadi posisikan harapanmu dengan benar: 9Router itu alat efisiensi, bukan mesin gratisan. Nilai terbesarnya bukan “model gratis selamanya”, melainkan (1) memaksimalkan kuota langganan yang sudah kamu bayar sebelum jatuh ke opsi lain, dan (2) menghemat token lewat kompresi otomatis. Kalau kamu memasang VPS semata-mata mengejar model gratis tak terbatas, kemungkinan besar kamu akan kecewa.

Spesifikasi VPS dan Persiapan

1. Spesifikasi Minimum

[FAKTA] Kebutuhan minimum untuk menjalankan 9Router: OS Linux (Ubuntu 22.04 atau 24.04 direkomendasikan), Node.js 18+ atau 20+, npm, RAM minimal 2 GB, dan port 20128 terbuka di firewallsumber: Biznet Gio — Cara Install 9Router.

Komponen Minimum (personal / tim kecil) Jika menambah agent berat
Sistem operasi Ubuntu 22.04 / 24.04 LTS Sama
CPU 1 vCPU 1-2 vCPU
RAM 2 GB 4 GB
Storage 10-20 GB SSD/NVMe 20 GB+ NVMe
Port 20128 terbuka Sama
Kisaran biaya ±$4-6/bulan ±$6-12/bulan

[FAKTA] Angka 4 GB pada kolom kanan berlaku kalau kamu memasang framework agent di atas 9Router — misalnya Hermes Agent, yang dokumentasi instalasinya mensyaratkan RAM minimal 4 GB, Python 3.10+, dan 9Router yang sudah aktif lebih dulu — sumber: Biznet Gio — Install Agent Hermes pada 9Router. Untuk 9Router polos, 2 GB sudah memadai.

2. Pilih Lokasi Server Terdekat

Setiap request dari tool codingmu harus melewati VPS sebelum diteruskan ke penyedia model. Semakin jauh lokasi server, semakin besar tambahan latensi yang kamu rasakan di setiap permintaan. Untuk pengguna Indonesia, pilih region Singapura atau Jakarta kalau tersedia — bukan Amerika atau Eropa, walaupun harganya kadang lebih murah.

3. Siapkan Minimal Satu Akun Provider

9Router hanya meneruskan request; ia tidak menyediakan model sendiri. Siapkan minimal satu sumber sebelum instalasi: langganan yang sudah kamu punya (Claude, Codex, GitHub Copilot), API key berbayar murah (GLM, MiniMax, DeepSeek), atau opsi gratis terbatas (Kiro AI, OpenCode Free) dengan catatan keterbatasan yang sudah dijelaskan di atas.

Langkah Install 9Router di VPS

1. Install Node.js

[FAKTA] Jalankan perintah berikut untuk memasang Node.js 20.x di Ubuntu, sesuai panduan resmi:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Verifikasi instalasi berhasil:

node -v
npm -v

sumber: Biznet Gio — Cara Install 9Router.

2. Install 9Router Secara Global

npm install -g 9router

Tunggu sampai proses instalasi selesai. Ini memasang 9Router sebagai perintah global yang bisa dipanggil dari direktori mana pun di VPS-mu. Polanya mirip dengan tutorial instalasi tool serupa — kalau kamu pernah mengikuti cara install OpenClaw standalone, alurnya akan terasa familiar.

3. Jalankan 9Router dan Pilih Mode Akses

9router

Saat pertama kali dijalankan, kamu akan diminta memilih mode interface. Untuk penggunaan di VPS, pilih Web UI (Open in Browser) — mode ini menyalakan dashboard visual untuk menambah provider, mengatur fallback, dan memonitor request. Dashboard bisa diakses lewat http://IP-SERVER:20128/dashboard, dan ini adalah mode yang direkomendasikan khusus untuk VPS dan penggunaan administrasi jangka panjang.

4. Alternatif: Jalankan via Docker

[FAKTA] Kalau kamu lebih nyaman dengan container, 9Router juga tersedia sebagai image resmi multi-platform (linux/amd64 dan linux/arm64):

docker run -d 
  -p 20128:20128 
  -v "$HOME/.9router:/app/data" 
  -e DATA_DIR=/app/data 
  --name 9router 
  decolua/9router:latest

Perintah dasar untuk mengelola container: docker logs -f 9router (lihat log), docker stop 9router / docker start 9router (hentikan/nyalakan), docker rm -f 9router (hapus) — sumber: 9Router — dokumentasi Docker resmi.

5. Pahami Persistensi Data — Jangan Lewatkan Ini

[FAKTA] Baris -v "$HOME/.9router:/app/data" di atas bukan opsional secara praktik. Tanpa mount volume itu, data 9Router (termasuk database SQLite berisi konfigurasi provider dan API key yang kamu simpan) tersimpan di dalam container — dan hilang begitu container dihapus atau dibuat ulang. Dengan volume ter-mount, data disimpan di $DATA_DIR/db/data.sqlite beserta folder backup otomatis, dan tetap ada meski kamu update atau restart container.

6. Hubungkan Provider AI Pertama

Buka dashboard, masuk ke menu Providers, lalu hubungkan minimal satu sumber. Untuk mulai tanpa biaya, dashboard menyediakan opsi Kiro AI atau OpenCode Free yang tidak memerlukan pendaftaran tambahan — dengan catatan keterbatasan kuota yang sudah dijelaskan di bagian atas.

7. Sambungkan Tool Coding ke Endpoint VPS

Di pengaturan tool coding kamu (Claude Code, Cursor, Cline, Codex, atau CLI lain), arahkan endpoint ke alamat VPS-mu, bukan localhost:

Endpoint: http://IP-SERVER-KAMU:20128/v1
API Key: [salin dari dashboard 9Router]
Model: kr/nama-model (contoh: kr/claude-sonnet-4.5)

Konfigurasi Lanjutan

1. Mode Production dengan Environment Variables

[FAKTA] Kalau menjalankan dari source (bukan npm global atau Docker), gunakan mode production dengan variabel berikut agar bisa diakses dari luar server:

npm run build
PORT=20128 HOSTNAME=0.0.0.0 NEXT_PUBLIC_BASE_URL=http://IP-SERVER-KAMU:20128 npm run start

HOSTNAME=0.0.0.0 adalah kuncinya — tanpa ini, aplikasi hanya mendengarkan koneksi dari dalam server itu sendiri (localhost), persis seperti instalasi default di laptop, dan tidak akan bisa diakses dari perangkat lain sama sekali.

2. Update ke Versi Terbaru

Untuk pengguna Docker:

docker pull decolua/9router:latest
docker rm -f 9router

jalankan ulang perintah docker run di atas

Keamanan: Bagian yang Paling Sering Dilewatkan

[ANALISIS KOMUNITECH] Ini bagian yang jarang dibahas tutorial lain secara serius, padahal risikonya nyata. Begitu 9Router berjalan dengan HOSTNAME=0.0.0.0 di VPS dengan IP publik, port 20128 berpotensi diakses siapa saja di internet yang menemukannya — bukan cuma kamu. Kalau seseorang berhasil mengakses dashboard atau endpoint API-mu, mereka bisa memakai kuota providermu, dan tagihannya jatuh ke akunmu, bukan mereka.

Tiga opsi mitigasi yang wajar untuk VPS pribadi atau tim kecil, urut dari yang paling sederhana:

  • Batasi lewat firewall (paling mudah). Konfigurasi firewall VPS (ufw, iptables, atau firewall panel provider) supaya port 20128 hanya menerima koneksi dari IP tertentu — IP kantor, IP rumah, atau IP tim kamu. Bukan dibuka untuk semua orang (0.0.0.0/0).
  • Gunakan SSH tunnel. Alih-alih membuka port ke publik, akses 9Router lewat tunnel SSH (ssh -L 20128:localhost:20128 user@ip-server). Port tetap tertutup dari luar, kamu tetap bisa mengaksesnya seolah-olah lokal.
  • Pasang reverse proxy dengan autentikasi. Kalau kamu perlu akses dari banyak lokasi tanpa tunnel manual tiap kali, taruh Nginx atau Caddy di depan 9Router dengan basic auth atau lapisan autentikasi tambahan.

Jangan anggap remeh langkah ini hanya karena skala pemakaianmu kecil — API key yang bocor tetap bisa dipakai orang lain sampai kamu sadar dan mencabutnya.

Troubleshooting Dasar

Masalah Perintah / Cek
Ingin lihat log berjalan docker logs -f 9router
Dashboard tidak bisa diakses dari luar Cek HOSTNAME=0.0.0.0 sudah diset, dan port 20128 terbuka di firewall
Perlu restart layanan docker stop 9router && docker start 9router
Konfigurasi hilang setelah update Pastikan volume -v "$HOME/.9router:/app/data" ter-mount dengan benar sebelum update
Perlu install ulang bersih docker rm -f 9router, lalu jalankan ulang perintah instalasi

Pertanyaan yang Sering Ditanya

Berapa spesifikasi VPS minimum untuk 9Router?

Ubuntu 22.04 atau 24.04, 1 vCPU, RAM minimal 2 GB, dan storage 10-20 GB sudah cukup untuk pemakaian personal atau tim kecil. Kalau kamu berencana memasang agent tambahan yang lebih berat di atas 9Router, siapkan RAM minimal 4 GB.

Apakah data hilang kalau container di-restart atau diupdate?

Tidak, selama kamu memasang volume mount -v $HOME/.9router:/app/data sejak awal instalasi. Tanpa volume itu, konfigurasi dan API key yang tersimpan di dalam container akan hilang begitu container dihapus atau dibuat ulang.

Apakah aman mengakses 9Router dari luar VPS?

Aman selama kamu membatasi akses lewat firewall (hanya IP tertentu), SSH tunnel, atau reverse proxy dengan autentikasi. Membuka port 20128 ke seluruh internet tanpa proteksi berisiko — siapa pun yang menemukannya berpotensi memakai kuota providermu.

Apa bedanya install di VPS dibanding npm lokal di laptop?

Secara teknis prosesnya sama (npm install -g 9router). Bedanya di aksesibilitas: instalasi lokal hanya bisa diakses dari laptop itu sendiri (localhost), sedangkan instalasi VPS dengan HOSTNAME=0.0.0.0 bisa diakses dari perangkat mana pun yang kamu izinkan lewat IP publik server.

Apakah butuh domain dan SSL?

Tidak wajib untuk pemakaian dasar — kamu bisa langsung mengakses lewat http://IP-SERVER:20128. Domain dan SSL (HTTPS) jadi relevan kalau kamu memasang reverse proxy untuk keamanan tambahan atau ingin URL yang lebih mudah diingat oleh tim.

Apakah 9Router benar-benar gratis dan unlimited?

9Router sendiri gratis dipakai (kamu memakai API key/langganan sendiri, model BYOK). Tapi “unlimited free model” yang sering dijanjikan tutorial lama sudah tidak akurat — beberapa jalur gratis populer (iFlow, Qwen Code, Gemini CLI) sudah dihentikan di 2026, dan Kiro AI kini dibatasi 50 kredit/bulan setelah berpindah ke model berbayar.

Bisakah dipakai bersama satu tim?

Bisa. 9Router mendukung multi-akun dengan round-robin antar akun per provider, sehingga beberapa anggota tim bisa berbagi satu instance sambil kuotanya tetap terlacak terpisah. Untuk pemakaian tim, pastikan spesifikasi VPS naik ke level rekomendasi (2 vCPU, 4 GB RAM) dan akses dibatasi lewat firewall.

Kesimpulan

Memasang 9Router di VPS bukan proses yang rumit — inti instalasinya cuma dua atau tiga perintah, baik lewat npm maupun Docker. Yang justru sering terlewat adalah dua hal yang menentukan apakah instalasimu benar-benar berguna dalam jangka panjang: memastikan data ter-mount dengan benar supaya konfigurasimu tidak hilang, dan membatasi akses ke port 20128 supaya kuota providermu tidak dipakai orang lain.

Kalau kamu sedang menyusun infrastruktur AI yang lebih luas dari sekadar satu router — termasuk otomasi bisnis yang berjalan di atasnya — pertimbangan biaya server ini sebaiknya masuk ke perhitungan total, bukan cuma biaya API. Kami bahas komponen biaya lainnya di bot AI murah untuk bisnis online, dan kalau kamu ingin belajar menyusun sistem semacam ini dengan pendampingan langsung, gabung workshop KomuniTech (2 jam, langsung praktik bikin Karyawan AI sendiri, plus sertifikat sebagai peserta).

Referensi

Disclaimer: Artikel ini bersifat edukasi dan netral. 9Router adalah produk milik pihak ketiga (decolua); Komunitech tidak berafiliasi dan tidak menerima kompensasi dari pembuatnya. Detail harga, spesifikasi, dan kebijakan provider dapat berubah sewaktu-waktu — verifikasi ke dokumentasi resmi sebelum mengambil keputusan.

Artikel telah diupdate pada 27/08/2026 untuk memastikan artikel tetap sesuai kondisi terkini.



Tinggalkan Balasan

Alamat email Anda tidak akan dipublikasikan. Ruas yang wajib ditandai *