Cara Pasang Nginx Proxy Manager di STB Armbian

Sahabat home server, panduan ini berbeda dari Tailscale 6 Nov yang membahas akses dari luar rumah melalui VPN. Nginx Proxy Manager (NPM) membantu merapikan akses ke layanan web lokal, sedangkan Portainer untuk STB Armbian yang dibahas pada 28 Okt dipakai untuk mengelola kontainer Docker. Jadi, fokusnya di sini adalah reverse proxy: mengarahkan nama yang mudah diingat ke layanan di jaringan rumah.

Sebelum memasang, kenali arsitektur STB. Ini penting karena tidak semua image NPM cocok untuk semua perangkat ARM. Pastikan Docker dan Docker Compose sudah tersedia; jika belum, ikuti dokumentasi resmi Armbian dan Docker untuk memasangnya lebih dahulu.

Periksa arsitektur sebelum memilih image

Jalankan pemeriksaan wajib

Di terminal Armbian, jalankan perintah berikut:

dpkg --print-architecture

Catat hasilnya sebelum membuat konfigurasi. Sejak v2.14, image resmi NPM mendukung amd64 dan arm64; keduanya dapat mengikuti jalur image modern. Ikuti contoh Docker Compose resmi dan pilih image yang sesuai; jangan menyalin konfigurasi dari tutorial lama tanpa memeriksa arsitektur dan tag-nya.

Jika hasilnya armv7

armv7 adalah arsitektur 32-bit dan tidak lagi didukung oleh image NPM mulai versi 2.14. Untuk perangkat seperti ini, peringatan resmi proyek menyarankan tag image 2.13.7, yang merupakan rilis terakhir yang mendukung armv7. Jangan memilih tag terbaru secara otomatis karena perangkat bisa gagal mengambil image yang kompatibel. Jika perintah menampilkan arsitektur lain atau hasilnya meragukan, berhenti dahulu dan cocokkan dengan dokumentasi resmi.

Pasang melalui Docker Compose

Setelah arsitektur dipastikan, gunakan contoh konfigurasi Docker Compose dari dokumentasi NPM. Konfigurasi menyiapkan layanan proxy, penyimpanan data dan sertifikat, serta pemetaan port yang diperlukan. Jangan menyalin perintah lengkap dari sumber yang belum diperiksa; pastikan nama image dan tag cocok dengan jalur arsitektur yang telah dipilih. Simpan berkas konfigurasi dan jalankan layanan memakai prosedur Docker Compose yang didokumentasikan untuk instalasi Anda.

Antarmuka web administrasi NPM disediakan melalui port 81 pada konfigurasi resmi. Akses panel tersebut dari jaringan lokal tepercaya, lalu buat pengaturan host proxy melalui antarmuka. Untuk contoh pemakaian, layanan foto dapat diarahkan dengan nama seperti foto.rumah, asalkan nama lokal tersebut juga dikenali oleh perangkat yang mengaksesnya melalui DNS lokal atau pengaturan jaringan yang sesuai.

Uji akses lokal dengan aman

Tambahkan satu layanan terlebih dahulu dan pastikan alamat tujuan benar-benar dapat diakses dari STB. Buat aturan proxy di panel, lalu uji nama yang dipakai dari perangkat lain di jaringan rumah. Reverse proxy meneruskan permintaan ke layanan yang dituju; ia tidak otomatis membuat nama lokal dikenal semua perangkat. Pengaturan DNS lokal tetap perlu disiapkan secara terpisah sesuai router atau layanan jaringan Anda.

Jangan membuka panel administrasi ke internet tanpa memahami pengamanan jaringan. Simpan salinan konfigurasi dan data penting sebelum mengubah layanan. Jika STB memakai armv7, pertimbangkan bahwa jalur 2.13.7 tidak mengikuti jalur image modern; periksa dokumentasi, pembaruan keamanan, dan keterbatasan yang relevan sebelum mengandalkannya untuk layanan penting.

Dengan memeriksa arsitektur lebih dulu, memilih tag yang cocok, dan menguji satu layanan lokal, proses pemasangan menjadi lebih mudah ditelusuri. Langkah paling penting adalah tidak melewati pemeriksaan dpkg --print-architecture: pilihan image yang salah dapat membuat instalasi tidak berjalan.