Cara Install 9Router di Ubuntu 24.04

Pengantar

Penggunaan berbagai layanan AI seperti Claude, Codex, Gemini, DeepSeek, dan layanan AI lainnya sering kali membuat pengguna harus mengelola banyak API atau provider secara terpisah. Salah satu solusi yang dapat digunakan untuk menyederhanakan pengelolaan tersebut adalah 9Router.

9Router merupakan AI gateway yang berfungsi meneruskan permintaan dari tool atau aplikasi ke provider AI yang digunakan. Dengan pendekatan ini, pengguna dapat mengelola beberapa provider melalui satu antarmuka dan endpoint.

9Router dapat dijalankan pada Linux, termasuk Ubuntu 24.04 LTS. Untuk penggunaan personal atau tim kecil, kebutuhan dasarnya relatif ringan, yaitu sekitar 1 vCPU, RAM minimal 2 GB, dan penyimpanan 10–20 GB. Port 20128 digunakan oleh 9Router untuk dashboard dan endpoint-nya.

Artikel ini membahas cara install 9Router di Ubuntu 24.04 menggunakan Node.js dan npm.

Persiapan Ubuntu 24.04

Sebelum memasang 9Router, pastikan server memenuhi spesifikasi minimal berikut:

OS: Ubuntu 24.04 LTS.
CPU: minimal 1 vCPU.
RAM: minimal 2 GB.
Storage: minimal 10 GB.
Akses: root atau pengguna dengan hak sudo.
Port: 20128 untuk dashboard dan endpoint 9Router.

Instalasi 9Router di Ubuntu 24.04

1. Instalasi 9Router

Perbarui repository dan paket sistem:
```
sudo apt update && sudo apt upgrade -y
```

Instal Node.js 20.x:

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

Periksa versi Node.js dan npm:
```
node -v
npm -v
```
Contohnya:
```
v20.20.2
10.8.2
```
Instal 9Router secara global menggunakan npm:
```
sudo npm install -g 9router
```
Setelah instalasi selesai, jalankan 9Router:
```
9router
```
Pada pilihan interface, pilih:
```
Web UI (Open in Browser)
```
Mode ini menyediakan dashboard untuk mengelola provider dan konfigurasi 9Router.
Secara default, 9Router menggunakan port:
```
20128
```
Periksa apakah port tersebut sudah aktif:
```
ss -lntp | grep 20128
```
Jika muncul:
```
LISTEN 0 511 0.0.0.0:20128
```
berarti 9Router sudah mendengarkan koneksi pada seluruh interface IPv4.
Dashboard dapat diakses melalui:
```
http://IP-SERVER:20128/dashboard
```

Menjalankan 9Router sebagai Service systemd

1. Menjalankan 9Router sebagai Systemd Service

Buat file service:

sudo nano /etc/systemd/system/9router.service

Masukkan konfigurasi berikut:

[Unit]
Description=9Router AI Gateway
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=root
Environment=NODE_ENV=production
Environment=PORT=20128
Environment=HOSTNAME=0.0.0.0
Environment="INITIAL_PASSWORD=PASSWORD_KUAT_ANDA"
ExecStart=/usr/local/bin/9router --host 0.0.0.0 --port 20128 --no-browser --skip-update
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Ganti PASSWORD_KUAT_ANDA dengan password yang digunakan untuk login ke dashboard.
```
Environment="INITIAL_PASSWORD=PasswordKuatAnda"
```
Gunakan password yang kuat dan jangan menggunakan contoh password tersebut pada server produksi.
Opsi --skip-update digunakan pada konfigurasi ini karena pada pengujian 9Router versi 0.5.81, proses yang dijalankan tanpa TTY dapat keluar ketika opsi tersebut tidak digunakan. Dengan opsi tersebut, service dapat berjalan di background pada VPS.

Validasi konfigurasi systemd:

sudo systemd-analyze verify /etc/systemd/system/9router.service

Jika tidak terdapat error, muat ulang konfigurasi systemd:
```
sudo systemctl daemon-reload
```
Aktifkan service agar otomatis berjalan ketika Ubuntu melakukan boot:
```
sudo systemctl enable 9router
```
Jalankan service:
```
sudo systemctl start 9router
```

Periksa status service:

sudo systemctl status 9router --no-pager

Jika berhasil, akan terlihat:

Active: active (running)

Pastikan port 20128 aktif:

ss -lntp | grep 20128

Contohnya:

LISTEN 0 511 0.0.0.0:20128 0.0.0.0:*

Dengan konfigurasi tersebut, 9Router tetap berjalan meskipun sesi SSH ditutup dan akan dijalankan kembali secara otomatis ketika server melakukan reboot.

Untuk melihat log service:

sudo journalctl -u 9router -n 50 --no-pager

Untuk mengikuti log secara realtime:
```
sudo journalctl -u 9router -f
```

Jika terdapat perubahan pada konfigurasi service, jalankan:

sudo systemctl daemon-reload
sudo systemctl restart 9router

Keamanan 9Router di VPS

1. Mengamankan Akses 9Router

Jika 9Router dipasang pada VPS dengan IP publik, akses ke port 20128 perlu diperhatikan.

Ketika 9Router berjalan pada:

0.0.0.0:20128

service akan mendengarkan koneksi dari seluruh interface IPv4. Pada server dengan IP publik, port tersebut berpotensi dapat diakses langsung dari internet.

Karena dashboard dapat digunakan untuk mengelola konfigurasi provider AI dan informasi autentikasi, akses sebaiknya tidak dibiarkan terbuka tanpa kebutuhan.

Firewall: membatasi port 20128 hanya dari alamat IP tertentu.
SSH tunnel: mengakses dashboard melalui koneksi SSH tanpa membuka port 20128 ke publik.
Reverse proxy: menggunakan Nginx atau Caddy sebagai lapisan akses tambahan.

Jika memang diperlukan untuk membuka port 20128 melalui UFW, gunakan:

sudo ufw allow 20128/tcp

Pada server dengan IP publik, sebaiknya aturan firewall dibuat lebih spesifik sesuai sumber akses yang memang diperlukan.

Peringatan:
Hindari membuka port 20128 ke seluruh internet apabila tidak diperlukan. Gunakan pembatasan IP, SSH tunnel, atau reverse proxy sesuai kebutuhan.

Kesimpulan

Instalasi 9Router di Ubuntu 24.04 dapat dilakukan menggunakan Node.js dan npm. Setelah Node.js terpasang, 9Router dapat diinstal menggunakan npm dan diakses melalui Web UI pada port 20128.

Untuk penggunaan pada VPS, menjalankan 9Router menggunakan systemd membuat pengelolaannya lebih praktis karena service dapat berjalan di background, dimonitor menggunakan systemctl dan journalctl, serta otomatis dijalankan kembali ketika server melakukan reboot.

Dengan konfigurasi tersebut, Ubuntu 24.04 dapat digunakan sebagai server 9Router yang menjadi gateway untuk mengelola berbagai provider AI melalui satu layanan.