aaPanel dan Deployment Aplikasi Node.js

aaPanel adalah control panel server berbasis web yang memudahkan pengelolaan website, database, SSL, dan aplikasi. Modul ini memandu deployment aplikasi Node.js dari nol.

Apa itu aaPanel?Copy Anchor Link

aaPanel menyediakan antarmuka untuk:

• Mengelola situs dan domain.
• Memasang Nginx/Apache, MySQL, PHP, Node.js.
• Mengatur SSL, firewall, cron, dan backup.
• Melihat log dan resource server.

1. Instalasi aaPanelCopy Anchor Link

Gunakan server Debian/Ubuntu yang bersih. Jalankan installer resmi dari aaPanel:

wget -O install.sh https://www.aapanel.com/script/install_7.0_en.sh
bash install.sh aapanel

Setelah selesai, installer menampilkan URL panel, username, dan password. Simpan informasi tersebut.

Amankan panelCopy Anchor Link

1. Buka URL panel dan login.
2. Segera ubah password.
3. Aktifkan SSL untuk panel.
4. Batasi akses port panel lewat firewall/Tailscale.
5. Aktifkan autentikasi dua faktor bila tersedia.

# Cek port panel yang terbuka
ss -tulpn | grep -E '8888|7800'

2. Memasang Node.jsCopy Anchor Link

Di aaPanel:

1. Buka App Store.
2. Cari Node.js Manager dan install.
3. Pilih versi LTS (mis. Node.js 20 atau 22).
4. Install.

Verifikasi lewat terminal:

node -v
npm -v

Jika node tidak ditemukan di PATH, cari lokasi instalasi:

which node
find /www/server -name node -type f 2>/dev/null | head

3. Menyiapkan aplikasi Node.jsCopy Anchor Link

Struktur direktoriCopy Anchor Link

Gunakan struktur yang rapi:

mkdir -p /www/wwwroot/app.example.com
cd /www/wwwroot/app.example.com

Upload atau clone projectCopy Anchor Link

git clone https://github.com/user/aplikasi.git .
npm ci
npm run build

Gunakan npm ci bila ada package-lock.json agar dependensi konsisten.

Konfigurasi environmentCopy Anchor Link

cat > .env <<'EOF'
NODE_ENV=production
PORT=3000
EOF
chmod 600 .env

Menjalankan aplikasiCopy Anchor Link

Untuk uji cepat:

node server.js

Untuk produksi, gunakan PM2:

npm install -g pm2
pm2 start server.js --name app-example
pm2 save
pm2 startup

PM2 dibahas lebih dalam di halaman berikutnya.

4. Membuat site dan reverse proxyCopy Anchor Link

1. Buka Website → Add Site.
2. Isi domain app.example.com.
3. Pilih Node Project bila tersedia, atau buat site statis kosong.
4. Setelah site dibuat, buka Settings → Reverse Proxy.
5. Tambahkan proxy:
   • Nama: app-example
   • Target URL: http://127.0.0.1:3000
6. Simpan.

Contoh konfigurasi Nginx yang dihasilkan:

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

Pastikan aplikasi listen dengan benarCopy Anchor Link

Aplikasi harus listen di 127.0.0.1:3000 atau 0.0.0.0:3000, bukan port lain yang tidak diproxy.

5. SSLCopy Anchor Link

1. Buka site → SSL.
2. Pilih Let's Encrypt.
3. Centang domain yang ingin diamankan.
4. Klik Apply.
5. Aktifkan Force HTTPS.

Jika memakai Cloudflare, pilih mode Full (strict) setelah origin memiliki sertifikat valid.

6. FirewallCopy Anchor Link

Buka hanya port yang dibutuhkan:

ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable
ufw status

Jangan membuka port aplikasi (3000) ke publik jika hanya diakses lewat reverse proxy.

7. Deployment pembaruanCopy Anchor Link

Alur sederhana:

cd /www/wwwroot/app.example.com
git pull
npm ci
npm run build
pm2 reload app-example

Untuk aplikasi dengan downtime minimal, gunakan pm2 reload pada mode cluster.

TroubleshootingCopy Anchor Link

Log:

pm2 logs app-example
journalctl -u nginx -n 50
tail -f /www/wwwlogs/app.example.com.error.log

RingkasanCopy Anchor Link

• aaPanel mempermudah pengelolaan situs, Node.js, SSL, dan reverse proxy.
• Aplikasi produksi dijalankan dengan PM2, bukan node di terminal.
• Reverse proxy meneruskan domain ke port aplikasi internal.
• Amankan panel, firewall, dan environment aplikasi.