Deploy, kelola, dan integrasikan ZenRadius.

Arsitektur Deployment

ZenRadius berjalan sebagai satu proses Node.js di 127.0.0.1:3001 yang dikelola PM2, lalu diteruskan ke pengguna melalui Nginx atau Cloudflare Tunnel. Dalam satu aplikasi Anda mendapatkan billing ISP, RADIUS server, ACS TR-069, WhatsApp gateway, PPOB, dan monitoring operasional.

Spesifikasi Server

Gunakan rekomendasi berikut sebagai baseline. Kebutuhan bertambah mengikuti jumlah pelanggan, sesi RADIUS, perangkat ONT, dan trafik WhatsApp.

Software & Sistem Operasi

Domain & DNS

Siapkan domain/subdomain sebelum instalasi, misal billing.isp-anda.com. Lisensi ZenRadius terikat pada domain ini beserta Kode Instalasi server (instalasi tanpa domain via IP lokal juga didukung).

Mode Normal (IP publik)

Type : A
Name : billing        (atau @ untuk root domain)
Value: <IP_PUBLIK_VPS>
TTL  : Auto / 300
Proxy: DNS only (awan abu-abu) saat Certbot berjalan pertama kali

Mode Cloudflare Tunnel

Tidak perlu A-record manual — record CNAME dibuat otomatis oleh perintah cloudflared tunnel route dns. Domain wajib sudah menggunakan nameserver Cloudflare.

dig +short billing.isp-anda.com
nslookup billing.isp-anda.com 1.1.1.1

Persiapan Server

ssh root@<IP_VPS>
apt update && apt upgrade -y
apt install -y git curl ufw
timedatectl set-timezone Asia/Jakarta
timedatectl set-ntp true

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
free -h

ufw default deny incoming
ufw default allow outgoing
ufw allow 22/tcp
# Mode normal (Nginx). Lewati dua baris ini jika memakai Cloudflare Tunnel
ufw allow 80/tcp
ufw allow 443/tcp
# RADIUS: ganti 10.0.0.0/8 dengan subnet router MikroTik Anda
ufw allow from 10.0.0.0/8 to any port 1812 proto udp
ufw allow from 10.0.0.0/8 to any port 1813 proto udp
# ACS TR-069 (ONT inform ke http://IP:3001/acs) — batasi ke subnet ONT
ufw allow from 10.0.0.0/8 to any port 3001 proto tcp
ufw enable
ufw status verbose

cd /opt
git clone https://github.com/zenradius/zenradius.git
cd zenradius

Instalasi via install.sh

Skrip resmi memasang Node.js 20, build tools, PM2, (Nginx + Certbot pada mode normal), dependensi aplikasi, menyiapkan .env & settings.json, menginisialisasi database, lalu menjalankan aplikasi lewat PM2 dengan auto-start saat reboot. Aman dijalankan ulang (idempoten).

Pilihan 1 — Mode Normal (IP publik, Nginx + SSL otomatis)

cd /opt/zenradius
chmod +x install.sh
sudo ./install.sh billing.isp-anda.com

Pilihan 2 — Mode Cloudflare Tunnel (VPS NAT / tanpa IP publik)

cd /opt/zenradius
chmod +x install.sh
sudo ./install.sh --cloudflare

pm2 status
pm2 logs zenradius --lines 30
curl -s http://127.0.0.1:3001/health
# Harus: {"status":"ok","version":"ZenRadius V.x","database":"ok",...}

Konfigurasi .env

Berkas .env berisi rahasia sistem dan kredensial bootstrap admin. Pada NODE_ENV=production aplikasi menolak start jika SESSION_SECRET atau SETTINGS_MASTER_KEY kosong/placeholder.

# ZenRadius — Konfigurasi Environment (/opt/zenradius/.env)
PORT=3001
NODE_ENV=production
LOG_LEVEL=info

# Login Admin Bootstrap
MASTER_ADMIN_USERNAME=<USERNAME_ADMIN>
MASTER_ADMIN_PASSWORD=<PASSWORD_KUAT>

# Rahasia Sistem (Wajib Unik & Acak)
SESSION_SECRET=ganti-dengan-string-acak-64-karakter
SETTINGS_MASTER_KEY=ganti-dengan-string-acak-64-karakter

# Webhook Pembayaran
MY_WEBHOOK_SECRET=ganti-dengan-string-acak-64-karakter

# GenieACS (Opsional)
GENIEACS_URL=http://localhost:7557
GENIEACS_USERNAME=
GENIEACS_PASSWORD=

# Path Data (Opsional)
ZENRADIUS_DB_PATH=
ZENRADIUS_SETTINGS_PATH=

# Lisensi & Status
ZENRADIUS_HEARTBEAT=on
HEALTH_CHECK_URL=http://127.0.0.1:3001/health

cd /opt/zenradius
sudo nano .env

sudo chmod 600 /opt/zenradius/.env
sudo chown root:root /opt/zenradius/.env
pm2 restart zenradius --update-env
pm2 status
curl -s http://127.0.0.1:3001/health

Cloudflare Tunnel (VPS NAT / IP private)

cloudflared memungkinkan VPS diakses aman dari publik dengan SSL gratis — tanpa IP publik statis, tanpa port forwarding, tanpa Certbot. Aplikasi tetap berjalan di localhost:3001.

sudo cloudflared service install <TOKEN_KHUSUS_DARI_DASHBOARD>

curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cloudflared.list
sudo apt update && sudo apt install -y cloudflared
cloudflared --version

cloudflared tunnel login
cloudflared tunnel create zenradius
cloudflared tunnel list        # Catat UUID tunnel yang muncul

sudo mkdir -p /etc/cloudflared
sudo tee /etc/cloudflared/config.yml >/dev/null <<'EOF'
tunnel: <GANTI_DENGAN_UUID_TUNNEL>
credentials-file: /root/.cloudflared/<GANTI_DENGAN_UUID_TUNNEL>.json

ingress:
  - hostname: billing.isp-anda.com
    service: http://127.0.0.1:3001
    originRequest:
      noTLSVerify: true
      httpHostHeader: billing.isp-anda.com
  - service: http_status:404
EOF

cloudflared tunnel route dns zenradius billing.isp-anda.com
sudo cloudflared service install
sudo systemctl enable --now cloudflared
sudo systemctl status cloudflared --no-pager
curl -I https://billing.isp-anda.com/health

Alternatif: Docker Compose

Untuk yang lebih nyaman dengan container. Data persisten di-bind ke folder host sehingga aman saat rebuild.

curl -fsSL https://get.docker.com | sh
git clone https://github.com/zenradius/zenradius.git /opt/zenradius && cd /opt/zenradius
cp .env.example .env
sed -i "s|^SESSION_SECRET=.*|SESSION_SECRET=$(openssl rand -hex 32)|" .env
sed -i "s|^SETTINGS_MASTER_KEY=.*|SETTINGS_MASTER_KEY=$(openssl rand -hex 32)|" .env
# settings.json WAJIB dibuat lebih dulu (kalau tidak, Docker membuat DIREKTORI kosong bernama settings.json)
echo '{"server_port": 3001}' > settings.json
mkdir -p database data public/uploads auth_info_baileys backups logs
chown -R 1000:1000 database data public/uploads auth_info_baileys backups logs settings.json
docker compose up -d --build
docker compose ps
docker compose logs -f zenradius

Container mem-bind 127.0.0.1:3001. Expose ke publik tetap lewat Nginx + Certbot (mode normal) atau Cloudflare Tunnel yang mengarah ke http://127.0.0.1:3001.

Troubleshooting & Operasional

Checklist Go-Live

Login & Setup Awal

Lisensi Instalasi

ZenRadius memverifikasi lisensi secara offline menggunakan token bertanda tangan digital (Ed25519) yang terikat pada domain/IP dan Kode Instalasi server Anda, lalu mengirim heartbeat harian ke server lisensi. Tanpa token yang valid aplikasi berjalan dalam masa tenggang 30 hari, kemudian akses dikunci penuh.

Integrasi MikroTik

Buat user & group khusus di RouterOS dengan policy minimal, lalu daftarkan router di panel ZenRadius.

/user group add name=zenradius policy=api,read,write,test,policy,!local,!telnet,!ssh,!ftp,!reboot,!password,!web,!sniff,!sensitive,!romon
/user add name=zenradius group=zenradius password=<PASSWORD_KUAT> address=<IP_SERVER_ZENRADIUS>/32
/ip service set api address=<IP_SERVER_ZENRADIUS>/32 disabled=no port=8728

Panel: MikroTik → Tambah Router (host, port 8728, user, password) → Test Koneksi. Buat Paket dengan profile PPPoE normal & profile isolir (default isolir).

RADIUS Server Built-in

Panel: RADIUS Server → aktifkan (port 1812/1813), tambah NAS (IP router + secret). Di MikroTik:

/radius add service=ppp,hotspot address=<IP_SERVER_ZENRADIUS> secret=<SECRET_NAS> timeout=3s
/ppp aaa set use-radius=yes accounting=yes interim-update=5m
/radius incoming set accept=yes port=3799

ss -lunp | grep -E '1812|1813'
pm2 logs zenradius --lines 50 | grep -i radius

ACS TR-069 Built-in (ONT/ONU)

Endpoint CWMP: http://<IP_SERVER>:3001/acs (POST). Buka GET /acs di browser untuk melihat status. Set di ONT: ACS URL = URL di atas, Periodic Inform = 300 s. Perangkat yang inform muncul di menu ACS. Anda juga bisa menambah GenieACS eksternal di menu GenieACS jika sudah ada.

WhatsApp Gateway

Telegram Bot

Buat bot via @BotFather, isi token & chat ID admin di Pengaturan → Telegram. Bot menerima perintah monitoring dan menerima file backup harian otomatis.

Payment Gateway & QRIS

Pengaturan → Pembayaran: Tripay / Midtrans / Xendit / Duitku (API key), atau QRIS statis + notifikasi via webhook mutasi. URL callback: https://domain/webhook/<gateway>. Pastikan MY_WEBHOOK_SECRET di .env sama dengan yang disetel di aplikasi notifikasi.

Digiflazz (PPOB)

Pengaturan → Digiflazz: username, API key (production), sinkronkan produk. Webhook: https://domain/webhook/digiflazz.

OLT & ODP

Menu OLT: tambah OLT (ZTE/Huawei/VSOL/HSGQ) dengan SNMP community/telnet. Menu ODP untuk pemetaan port & peta lokasi pelanggan.

Keamanan Production

• Ganti password admin bootstrap dan semua password default (RADIUS secret, MikroTik).
• Nginx/Cloudflare hanya meneruskan ke 127.0.0.1:3001; port 3001 tidak dibuka ke internet (kecuali dibatasi ke subnet ONT untuk ACS).
• Nonaktifkan login root SSH & gunakan SSH key.
• Rate limiter login sudah aktif (middleware/rateLimiter.js); cookie HttpOnly, Secure, SameSite=Lax.
• Backup otomatis aktif + salin ke luar server (Telegram/rclone).

apt install -y fail2ban
systemctl enable --now fail2ban
sed -i 's/^#\?PasswordAuthentication .*/PasswordAuthentication no/' /etc/ssh/sshd_config
sed -i 's/^#\?PermitRootLogin .*/PermitRootLogin prohibit-password/' /etc/ssh/sshd_config
systemctl restart ssh
chmod 600 /opt/zenradius/.env /opt/zenradius/settings.json

apt install -y unattended-upgrades
dpkg-reconfigure -plow unattended-upgrades

Backup & Restore

Menu Backup di panel admin membuat snapshot database (SQLite Backup API, diverifikasi integrity_check) dan settings.json ke folder backups/. Aktifkan Auto Backup di Pengaturan (default jadwal 0 2 * * * = 02:00).

cd /opt/zenradius
tar -czf /root/zenradius-full-$(date +%F).tar.gz .env settings.json database backups public/uploads auth_info_baileys data
# salin ke komputer lokal:
scp root@<IP_VPS>:/root/zenradius-full-*.tar.gz .

# Via panel: Backup → Restore (atau Upload & Restore) → lalu WAJIB restart:
pm2 restart zenradius

# Manual (server baru):
cd /opt/zenradius && pm2 stop zenradius
tar -xzf /root/zenradius-full-YYYY-MM-DD.tar.gz -C /opt/zenradius
pm2 start zenradius

Update Aplikasi

Cara resmi: panel admin → Update GitHub (/admin/update). Alternatif manual:

cd /opt/zenradius
git pull
npm ci --omit=dev --no-audit --no-fund
node scripts/verify-database.js
pm2 reload zenradius
pm2 logs zenradius --lines 30

Migrasi skema database berjalan otomatis & idempoten saat aplikasi start. .env, settings.json, database/, dan upload tidak tersentuh oleh update.

Perintah Operasional Harian