Cara Install 9router di Termux Android, Anti Error

Termux membuat Android dapat dipakai sebagai lingkungan Linux ringan untuk menjalankan proyek Node.js. Jika kamu ingin mencoba 9router tanpa laptop atau VPS, pendekatan ini cukup praktis untuk belajar, menguji konfigurasi, dan memastikan server lokal dapat berjalan.

Tetap ada batas yang perlu dipahami. Instalasi dari ponsel bisa terganggu oleh versi Node.js yang tidak cocok, dependency npm yang gagal dipasang, port yang sudah dipakai, atau proses yang dihentikan penghemat baterai Android. Prosesnya akan jauh lebih aman jika kamu memeriksa hasil setiap tahap, bukan menyalin seluruh perintah sekaligus.

Panduan ini membahas:

• persiapan Termux dan package dasar
• instalasi Node.js, Git, dan alat build
• pengambilan repository 9router
• pemeriksaan script serta konfigurasi .env
• pengujian endpoint lokal dan troubleshooting umum

Termux cocok untuk uji lokal 9router

Termux adalah aplikasi terminal Android yang menyediakan lingkungan Linux tanpa perlu root. Dari Termux, kamu dapat memasang Git, Node.js, npm, curl, Python, dan compiler. Lingkungan ini cukup untuk menjalankan banyak proyek JavaScript atau TypeScript dalam skala ringan.

9router adalah gateway AI yang menghubungkan tool coding dengan provider model melalui endpoint yang kompatibel dengan pola OpenAI. Karena struktur proyek, script, dan konfigurasi dapat berubah, repositori resmi 9router harus menjadi acuan utama sebelum menjalankan perintah tertentu.

Termux cocok untuk beberapa kebutuhan berikut:

• mencoba instalasi dan membaca struktur proyek
• menguji server pada perangkat sendiri
• memeriksa konfigurasi environment
• menguji endpoint dengan curl
• belajar workflow Git, Node.js, dan npm dari Android

Termux bukan pilihan ideal untuk server produksi. Android dapat menghentikan proses di latar belakang, perangkat memiliki resource terbatas, dan pengelolaan keamanan tidak sefleksibel server Linux.

Gunakan Termux untuk validasi awal dan eksperimen. Untuk layanan yang aktif terus atau dipakai banyak orang, pindahkan 9router ke VPS atau server Linux.

Persiapan sebelum mulai

Siapkan ruang penyimpanan yang cukup dan koneksi stabil. Dependency Node.js dapat memakai ruang lebih besar daripada repository karena adanya node_modules, cache npm, hasil build, serta file log.

Gunakan Termux yang masih diperbarui. Dokumentasi di situs resmi Termux menjelaskan fungsi aplikasi sebagai lingkungan terminal Linux di Android tanpa root. Hindari APK modifikasi karena masalah repository, package, dan keamanan sering muncul dari aplikasi yang tidak jelas sumbernya.

Tips: Simpan kode proyek di direktori home Termux, misalnya ~/projects/9router. Jangan menjalankan proyek dari /sdcard, folder Download, atau shared storage Android.

Cara install 9router di Termux Android

1. Perbarui package Termux

Buka Termux lalu jalankan:

pkg update && pkg upgrade -y

Perintah ini memperbarui daftar package dan memasang pembaruan yang tersedia. Jika unduhan lambat atau repository gagal diakses, ganti mirror dengan:

termux-change-repo

Pilih mirror yang responsif, lalu ulangi proses update. Jangan menghapus Termux hanya karena satu error jaringan. Periksa koneksi dan mirror terlebih dahulu.

2. Aktifkan akses penyimpanan bila diperlukan

Akses storage tidak wajib untuk menjalankan 9router. Fitur ini berguna jika kamu ingin memindahkan backup atau file konfigurasi dari folder Download.

termux-setup-storage

Setujui dialog izin dari Android. Setelah berhasil, biasanya tersedia shortcut seperti:

~/storage/downloads
~/storage/shared

Peringatan: Folder ~/storage/downloads cocok untuk backup, bukan workspace aktif. Simpan node_modules, source code, dan file build di home Termux agar tidak terkena batasan izin Android.

3. Pasang Node.js, Git, curl, dan editor

Pasang kebutuhan utama:

pkg install git nodejs-lts curl nano -y

Jika nodejs-lts tidak tersedia, gunakan:

pkg install git nodejs curl nano -y

Verifikasi setiap tool:

node -v
npm -v
git --version
curl --version

Nomor versi tidak harus sama dengan contoh di tutorial lain. Yang penting, Node.js dan npm dapat dijalankan, lalu versi tersebut sesuai kebutuhan yang tertulis pada repository.

Baca juga Cara Menjalankan Kimi K3 Lokal: Panduan Jujur (2026)

4. Buat folder kerja

Buat folder proyek di home Termux:

mkdir -p ~/projects
cd ~/projects
pwd

Folder ini memisahkan source code dari file pribadi Android. Kamu juga lebih mudah memperbarui project atau menghapus instalasi tanpa risiko menyentuh file lain.

flowchart TD
	A["Buka Termux"] --> B["Update package"]
	B --> C["Pasang Node.js dan Git"]
	C --> D["Buat folder proyek"]
	D --> E["Clone repository"]
	E --> F["Pasang dependency"]
	F --> G["Cek script proyek"]
	G --> H["Jalankan server"]
	H --> I["Uji endpoint"]

5. Clone repository 9router

Dari folder ~/projects, jalankan:

git clone https://github.com/decolua/9router.git
cd 9router

Lihat struktur folder:

ls -la

Perhatikan file berikut:

Jangan berasumsi semua repository Node.js dijalankan dengan npm start. Perintah yang benar harus mengikuti script yang benar-benar tersedia.

6. Cek script dan package manager

Tampilkan script proyek:

npm run

Kamu mungkin melihat script seperti dev, build, start, atau test. Nama dan urutannya bisa berubah di setiap versi project.

Jika terdapat package-lock.json, gunakan npm:

npm install

Bila instalasi harus mengikuti lockfile secara ketat:

npm ci

Jika terdapat pnpm-lock.yaml, pasang pnpm lalu gunakan:

npm install -g pnpm
pnpm install

Catatan: Jangan mencampur npm, pnpm, dan Yarn dalam satu folder proyek tanpa alasan jelas. Package manager yang berbeda dapat menghasilkan struktur dependency yang berbeda.

7. Pasang dependency

Untuk proyek npm biasa:

npm install

Proses ini dapat berlangsung cukup lama di Android. Jangan berpindah aplikasi terlalu lama atau mematikan Termux saat instalasi berjalan.

Jika koneksi terputus dan instalasi terlihat tidak lengkap:

rm -rf node_modules
npm install

Jika muncul error seperti make: not found, clang: not found, atau gyp ERR! find Python, pasang build tools:

pkg install python make clang -y
npm install

Sebagian package npm memiliki modul native yang perlu dikompilasi. Modul semacam ini lebih rentan bermasalah di Android daripada di laptop atau server Linux.

Atur file .env dengan aman

Cari file environment contoh:

ls -la

Jika tersedia .env.example, salin menjadi .env:

cp.env.example.env
nano.env

Contoh bentuk file environment:

HOST=127.0.0.1
PORT=20128

OPENAI_API_KEY=
ANTHROPIC_API_KEY=

Nama variabel harus mengikuti dokumentasi repository. Jangan menambah provider, model, atau variabel hanya berdasarkan tutorial lain.

Baca juga Panduan Dasar Adobe XD untuk Desain UI/UX Pemula

Pastikan .env tidak ikut masuk Git:

grep -n "^\.env".gitignore

Jika belum ada:

echo ".env" >>.gitignore

API key harus diperlakukan seperti kata sandi. Jangan menaruhnya dalam source code, screenshot, chat publik, atau repository.

Jika token sudah telanjur terekspos, segera rotasi token tersebut dari dashboard provider. Menghapus pesan atau commit tidak selalu cukup karena kredensial bisa tersimpan pada riwayat.

Jalankan server sesuai script proyek

Setelah dependency dan .env siap, tampilkan lagi script:

npm run

Jika tersedia script dev, gunakan:

npm run dev

Jika proyek perlu build sebelum start:

npm run build
npm start

Jangan menganggap port selalu 3000. Ikuti output terminal atau konfigurasi pada .env. Bila log menunjukkan server aktif di port 20128, uji dari sesi Termux lain:

curl http://127.0.0.1:20128

Untuk endpoint yang membutuhkan path tertentu, cek README repository. Server yang hidup belum berarti provider atau API key telah dikonfigurasi dengan benar.

flowchart LR
	A["Jalankan server"] --> B{"Muncul error?"}
	B -->|Ya| C["Baca error terakhir"]
	C --> D["Periksa dependency dan env"]
	D --> A
	B -->|Tidak| E["Tes dengan curl"]
	E --> F{"Ada respons?"}
	F -->|Ya| G["Periksa konfigurasi provider"]
	F -->|Tidak| H["Cek port dan log"]
	H --> A

Error yang sering muncul dan cara menanganinya

node: command not found

Node.js belum terpasang atau instalasi belum selesai.

pkg install nodejs-lts -y
node -v

Jika package LTS tidak tersedia, gunakan nodejs. Buka ulang Termux bila command masih tidak dikenali.

npm ERR! network timeout

Masalah ini umumnya terkait jaringan tidak stabil. Coba gunakan Wi-Fi, lalu tingkatkan toleransi npm:

npm config set fetch-retries 5
npm config set fetch-timeout 120000
npm install

Jika proses sebelumnya putus di tengah jalan, hapus node_modules lalu install ulang. Jangan terus mengulang perintah di folder dependency yang mungkin sudah tidak konsisten.

EADDRINUSE

Error ini berarti port sudah dipakai proses lain. Cari proses Node.js:

ps aux | grep node

Jika tidak ada proses penting:

pkill node

Atau ubah port di file .env:

PORT=20129

permission denied

Biasanya proyek berada di shared storage Android. Pastikan folder kerja berada di:

~/projects/9router

Bukan di /sdcard, ~/storage/shared, atau folder Download. Jika yang gagal adalah script shell, cek permission:

chmod +x nama-script.sh

Cannot find module

Dependency belum terpasang lengkap atau instalasi sebelumnya rusak.

rm -rf node_modules
npm install

Jangan menghapus lockfile tanpa memahami dampaknya. Lockfile membantu menjaga dependency sesuai versi yang sudah diuji proyek.

Baca juga Panduan Google Looker BI untuk Analisis Data Bisnis

Browser tidak bisa membuka dashboard

Uji server dari terminal lebih dulu:

curl http://127.0.0.1:PORT

Ganti PORT sesuai output aplikasi. Jika curl berhasil tetapi browser gagal, periksa apakah URL memakai http, bukan https, serta pastikan proses server masih aktif.

Tips: Mulai troubleshooting dari curl. Jika curl berhasil, server inti biasanya sudah berjalan. Fokus berikutnya adalah path dashboard, browser, atau konfigurasi frontend.

Akses dari laptop dan keamanan jaringan

Gunakan 127.0.0.1 untuk pengujian pada ponsel yang sama. Binding ini membatasi server agar tidak dapat diakses dari perangkat lain.

Jika kamu ingin mengakses dashboard dari laptop satu Wi-Fi, beberapa konfigurasi dapat memakai:

HOST=0.0.0.0

Cari alamat IP perangkat:

ip addr show wlan0

Lalu buka dari laptop:

http://192.168.1.25:20128

Alamat tersebut hanya contoh. Gunakan IP yang benar dari perangkatmu.

Peringatan: Jangan membuka endpoint 9router di Wi-Fi publik atau meneruskan port ke internet tanpa autentikasi. Dashboard dan konfigurasi router AI bisa menyimpan informasi sensitif.

Menjaga proses tetap hidup di Android

Android dapat menutup proses saat layar terkunci atau baterai dihemat. Untuk pengujian yang cukup lama, gunakan wakelock:

termux-wake-lock

Lepaskan setelah selesai:

termux-wake-unlock

Gunakan tmux agar sesi terminal lebih mudah dikelola:

pkg install tmux -y
tmux new -s 9router

Jalankan server di dalam sesi itu:

npm run dev

Keluar dari sesi tanpa menghentikan server dengan Ctrl + B, lalu D. Untuk masuk kembali:

tmux attach -t 9router

tmux tidak menjamin Android tidak akan menutup proses, tetapi sangat membantu saat kamu berpindah aplikasi atau perlu membuka sesi terminal baru.

Kelebihan & Kekurangan Menjalankan 9router di Termux

Kelebihan

• Tidak memerlukan root: Termux dapat menjalankan tool command-line tanpa mengubah sistem Android.
• Praktis untuk validasi awal: Kamu bisa menguji Node.js dan konfigurasi 9router dari ponsel.
• Biaya awal rendah: Tidak perlu langsung menyewa VPS hanya untuk uji dasar.
• Mendukung tool penting: Git, npm, curl, nano, dan tmux tersedia lewat package manager.
• Cocok untuk belajar: Workflow Node.js, environment variable, serta log server dapat dipraktikkan langsung.

Kekurangan

• Resource perangkat terbatas: Build besar dan dependency berat dapat membebani RAM, baterai, serta penyimpanan.
• Proses mudah dibatasi Android: Penghemat baterai dapat menghentikan server di latar belakang.
• Modul native dapat bermasalah: Tidak semua package npm mudah dikompilasi di Android.
• Kurang ideal untuk produksi: Uptime, monitoring, dan kontrol keamanan tidak setara server Linux.
• Troubleshooting lebih lambat: Membaca log panjang dan mengedit konfigurasi lebih nyaman dari laptop.

Kapan perlu pindah ke laptop atau VPS

Termux cukup untuk mengecek apakah proyek bisa berjalan, mempelajari konfigurasi dasar, dan menguji endpoint lokal. Saat penggunaan sudah rutin atau melibatkan akses pengguna lain, pindahkan pekerjaan ke lingkungan yang lebih stabil.

Gunakan laptop jika kamu sering mengubah kode, menjalankan test, memeriksa log panjang, atau melakukan build berulang. Gunakan VPS jika service harus aktif terus, memiliki trafik, menyimpan API key bernilai penting, atau memerlukan monitoring yang lebih rapi.

Untuk workflow mobile, kombinasi yang nyaman adalah menjalankan Termux di ponsel lalu mengaksesnya dari laptop melalui SSH dalam jaringan privat. Ponsel tetap dapat dipakai untuk eksperimen, tetapi konfigurasi dan troubleshooting tidak terbatas oleh layar kecil.

Server Lokal di Genggaman

• Mulai dari Termux yang benar: Gunakan versi resmi agar package dan repository tetap kompatibel.
• Simpan proyek di home: Hindari folder Download atau shared storage untuk workspace Node.js.
• Ikuti script proyek: Periksa package.json sebelum menjalankan npm start, build, atau mode pengembangan.
• Jaga API key dengan ketat: Simpan kredensial di .env dan pastikan file tersebut masuk .gitignore.
• Uji dari terminal lebih dulu: Gunakan curl untuk memastikan server dan port merespons dengan benar.
• Siapkan build tools bila perlu: Python, make, dan clang membantu menangani dependency npm dengan modul native.
• Kenali batas Android: Termux cocok untuk uji lokal, bukan server produksi yang perlu aktif terus-menerus.

Instalasi 9router di Termux akan jauh lebih lancar jika kamu mengikuti urutan setup, membaca output terminal, dan tidak menebak konfigurasi proyek. Setelah server lokal stabil, tentukan apakah kebutuhanmu masih cocok dijalankan dari ponsel atau sudah perlu dipindahkan ke laptop maupun VPS.

Sumber terkait: id.scribd.com · kapanlagi.com.

Checklist

• Setup: Perbarui package Termux sebelum memasang Node.js dan Git.
• Folder: Buat workspace proyek di direktori ~/projects Termux.
• Clone: Ambil repository 9router dari GitHub lalu buka foldernya.
• Config: Periksa package.json untuk menentukan script dan package manager.
• Install: Pasang dependency proyek sesuai lockfile yang tersedia.
• Secure: Buat .env dan pastikan API key tidak masuk Git.
• Verify: Jalankan server lalu cek respons lokal memakai curl.
• Test: Tangani error port, dependency, atau izin sebelum memakai provider.
• Stabilize: Gunakan tmux dan wakelock saat server diuji lebih lama.