9router tutorial

TUTORIAL INSTALL 9ROUTER DI VPS UBUNTU MENGGUNAKAN DOCKER

==================================================
1. LOGIN KE VPS
==================================================

Login melalui SSH:

ssh root@IP_VPS

Contoh:

ssh root@47.131.173.218


==================================================
2. INSTALL DOCKER
==================================================

Update paket Ubuntu:

sudo apt update

Install Docker:

sudo apt install -y docker.io

Aktifkan Docker dan jalankan otomatis setelah VPS reboot:

sudo systemctl enable --now docker

Cek versi dan status Docker:

sudo docker --version
sudo systemctl status docker

Tekan tombol q untuk keluar dari tampilan status.


==================================================
3. JALANKAN 9ROUTER DAN ATUR PASSWORD
==================================================

Ganti PASSWORD_KUAT_ANDA dengan password dashboard Anda:

sudo docker run -d \
  --name 9router \
  --restart unless-stopped \
  -p 20128:20128 \
  -v "$HOME/.9router:/app/data" \
  -e DATA_DIR=/app/data \
  -e INITIAL_PASSWORD='PASSWORD_KUAT_ANDA' \
  decolua/9router:latest

Contoh format password:

RouterKu9!Aman2026

Jangan gunakan password contoh secara langsung. Buat password sendiri
minimal 12 karakter yang mengandung huruf besar, huruf kecil, angka,
dan simbol.

Hindari karakter petik tunggal (') karena password pada perintah di atas
dibungkus dengan petik tunggal.


==================================================
4. CEK STATUS 9ROUTER
==================================================

Pastikan container berjalan:

sudo docker ps

Lihat log 9Router:

sudo docker logs --tail 100 9router

Pastikan port 20128 sedang listen:

sudo ss -lntp | grep 20128

Tes dashboard dari dalam VPS:

curl -I http://127.0.0.1:20128/dashboard


==================================================
5. BUKA PORT FIREWALL
==================================================

Jika UFW aktif, buka port TCP 20128:

sudo ufw allow 20128/tcp
sudo ufw reload
sudo ufw status

Jika muncul "Status: inactive", berarti UFW tidak aktif.

Periksa juga firewall atau Security Group pada panel provider VPS.
Tambahkan aturan inbound berikut jika diperlukan:

Protocol : TCP
Port     : 20128
Source   : IP komputer Anda

Jika tidak bisa membatasi berdasarkan IP, source dapat diatur menjadi:

0.0.0.0/0

Namun, aturan 0.0.0.0/0 membuat port dapat diakses dari seluruh internet.


==================================================
6. AKSES DASHBOARD
==================================================

Buka alamat berikut di browser:

http://IP_VPS:20128/dashboard

Contoh:

http://47.131.173.218:20128/dashboard

Login menggunakan password yang dimasukkan pada INITIAL_PASSWORD.

Jangan menggunakan password bawaan 123456. Login jarak jauh dengan
password bawaan dapat ditolak oleh 9Router karena alasan keamanan.


==================================================
7. PERINTAH PENGELOLAAN 9ROUTER
==================================================

Melihat container yang berjalan:

sudo docker ps

Melihat semua container:

sudo docker ps -a

Melihat log terbaru:

sudo docker logs --tail 100 9router

Melihat log secara langsung:

sudo docker logs -f 9router

Tekan Ctrl+C untuk keluar dari tampilan log.

Restart 9Router:

sudo docker restart 9router

Menghentikan 9Router:

sudo docker stop 9router

Menjalankan kembali 9Router:

sudo docker start 9router


==================================================
8. MENGGANTI PASSWORD
==================================================

Cara yang disarankan adalah mengganti password melalui menu pengaturan
di dashboard 9Router.

Jika instalasi masih baru dan password belum tersimpan, container dapat
dibuat ulang dengan password baru.

Hapus container lama:

sudo docker rm -f 9router

Jalankan kembali dengan password baru:

sudo docker run -d \
  --name 9router \
  --restart unless-stopped \
  -p 20128:20128 \
  -v "$HOME/.9router:/app/data" \
  -e DATA_DIR=/app/data \
  -e INITIAL_PASSWORD='PASSWORD_BARU_ANDA' \
  decolua/9router:latest

Data tetap tersimpan di folder:

$HOME/.9router

Menghapus container tidak menghapus folder data tersebut.

Jika password lama sudah tersimpan di database, INITIAL_PASSWORD mungkin
tidak menggantinya. Dalam kondisi tersebut, ubah password melalui
dashboard.


==================================================
9. UPDATE 9ROUTER
==================================================

Unduh image 9Router terbaru:

sudo docker pull decolua/9router:latest

Hapus container lama tanpa menghapus data:

sudo docker rm -f 9router

Jalankan container baru:

sudo docker run -d \
  --name 9router \
  --restart unless-stopped \
  -p 20128:20128 \
  -v "$HOME/.9router:/app/data" \
  -e DATA_DIR=/app/data \
  -e INITIAL_PASSWORD='PASSWORD_ANDA' \
  decolua/9router:latest

Periksa hasil update:

sudo docker ps
sudo docker logs --tail 100 9router


==================================================
10. UNINSTALL 9ROUTER
==================================================

Hentikan dan hapus container:

sudo docker rm -f 9router

Hapus image 9Router:

sudo docker image rm decolua/9router:latest

Jika ingin menghapus seluruh konfigurasi dan database juga:

sudo rm -rf "$HOME/.9router"

PERINGATAN:
Perintah tersebut akan menghapus seluruh data, konfigurasi, akun provider,
dan API key yang tersimpan. Jangan jalankan jika data masih dibutuhkan.


==================================================
CATATAN KEAMANAN
==================================================

1. Jangan gunakan password bawaan 123456.

2. Gunakan password unik minimal 12 karakter.

3. Jangan membagikan password dashboard atau API key.

4. Batasi akses port 20128 hanya ke IP pribadi jika memungkinkan.

5. Alamat http://IP_VPS:20128 belum menggunakan HTTPS.

6. Untuk pemakaian permanen, gunakan domain, reverse proxy Nginx,
   dan sertifikat SSL/HTTPS.

7. Backup folder berikut secara berkala:

$HOME/.9router

8. 9Router akan otomatis berjalan kembali setelah VPS reboot karena
   menggunakan opsi:

--restart unless-stopped