Instal Nginx Proxy Manager - Panduan Pengaturan 2 Menit

Yang Anda Butuhkan Sebelum Memulai

Ada tiga hal yang harus ada sebelum Nginx Proxy Manager (NPM) dapat berfungsi. Pertama, server Linux atau PC dengan Docker dan Docker Compose sudah terinstal dan berfungsi - NPM berjalan sebagai container, bukan sebagai program normal. Kedua, nama domain yang DNS-nya bisa Anda edit, karena setiap layanan mendapat subdomainnya masing-masing. Ketiga, router atau firewall cloud Anda harus dapat meneruskan port 80 dan 443 ke mesin ini.

Arahkan DNS Domain Anda ke Server Terlebih Dahulu

NPM merutekan lalu lintas berdasarkan nama, dan Lets Encrypt mengeluarkan sertifikat hanya untuk nama yang terbukti mengarah ke mesin Anda - jadi nama tersebut harus diselesaikan sebelum Anda membuat apa pun di dalamnya. Di registrar atau host DNS Anda, tambahkan Catatan A: Nama hanyalah kata subdomain (misalnya aplikasi) dan Nilai adalah alamat IP publik server Anda. Setiap layanan mendapatkan catatannya sendiri, dan semuanya dapat menunjuk pada IP yang sama - NPM kemudian memisahkan layanan berdasarkan nama. Tetapkan TTL singkat seperti 300 detik saat pengujian, sehingga kesalahan hilang dalam hitungan menit, bukan jam.

Buktikan sebelum melanjutkan: periksa apakah nama tersebut ditetapkan ke IP publik Anda dari jaringan luar (misalnya dari ponsel Anda dengan Wi-Fi mati). Meminta sertifikat terhadap DNS yang rusak menyia-nyiakan upaya Lets Encrypt, dan kegagalan yang berulang dapat membatasi kecepatan Anda selama berjam-jam. Urutannya penting: DNS pertama, host proxy kedua, sertifikat ketiga.

Buat Folder dan File Tulis

Buat folder untuk NPM di server dan simpan file di bawah ini di dalamnya sebagai docker-compose.yml. File tunggal ini adalah instalasi lengkap. Nama gambar adalah gambar resmi komunitas. Port 80 dan 443 adalah pintu publik, port 81 adalah panel admin, dan dua volume adalah tempat seluruh pengaturan Anda berada: ./data menyimpan database dengan semua host proxy Anda, dan ./letsencrypt menyimpan sertifikat Anda. Kehilangan kedua folder itu dan Anda kehilangan seluruh pengaturan - buat cadangannya setelah semuanya berjalan.

services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    restart: unless-stopped
    ports:
      - '80:80'
      - '443:443'
      - '81:81'
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt

Baris restart: kecuali-berhenti mengembalikan NPM secara otomatis setelah reboot.

Mulai Manajer Proksi Nginx

Dari dalam folder itu, jalankan perintah start. Docker mengunduh image dan memulai container di latar belakang.

docker compose up -d

Periksa apakah sedang berjalan:

docker ps

Anda akan melihat kontainer terdaftar dengan port 80, 443 dan 81. Pada server kecil, permulaan pertama memerlukan satu atau dua menit saat database dibuat. Jika penampung terus dimulai ulang, log menunjukkan alasannya dalam bahasa sederhana:

docker compose logs

Sembilan dari sepuluh loop restart adalah port yang sudah digunakan oleh sesuatu yang lain di host - biasanya server web lama masih berjalan.

Login Pertama - Segera Amankan Akun Admin

Buka panel admin di browser di jaringan Anda sendiri:

http://your-server-ip:81

Lakukan ini pada menit pertama. Tergantung pada versinya, NPM akan meminta Anda untuk mengganti rincian administrator login pertama dengan email Anda sendiri dan kata sandi yang kuat, atau - pada versi yang lebih baru tanpa akun default - orang pertama yang membuka halaman admin akan membuat administrator. Aturannya tetap sama: siapkan akun admin Anda sendiri saat kontainer dimulai, sebelum membuat apa pun, dan gunakan kotak surat asli - email NPM yang membahas masalah sertifikat.

Buat Host Proksi Pertama Anda

Di NPM, buka Host → Host Proxy → Tambahkan Host Proxy dan isi formulir sebagai satu kalimat - "nama ini masuk ke layanan internal itu":

Nama Domain: app.domainanda.com - nama publik persis dari Langkah 2, yang harus sudah ditetapkan ke server Anda.
Skema: http untuk sebagian besar aplikasi rumah dan kantor. Skema menggambarkan hubungan antara NPM dan layanan internal, bukan apa yang digunakan pengunjung - NPM menangani enkripsi publik di pintu. Pilih https di sini hanya jika aplikasi internal itu sendiri melayani HTTPS.
Teruskan Nama Host/IP: alamat internal layanan, misalnya 192.168.1.50.
Port Teruskan: port yang benar-benar didengarkan oleh layanan, misalnya 8080 - bukan 80 atau 443; itu adalah pintu NPM, bukan pintu layanan.

Aktifkan Blokir Eksploitasi Umum, lalu Simpan. Uji segera dengan membuka nama di browser - idealnya dari ponsel Anda dengan Wi-Fi mati, sehingga Anda menguji jalur publik sebenarnya.

Dapatkan Sertifikat HTTPS Lets Encrypt Gratis

Hanya lakukan ini setelah host biasa dari Langkah 6 sudah berfungsi - HTTPS pada host yang rusak memberi Anda host yang rusak dengan sertifikat, dan dua kali lebih banyak tempat untuk mencari kesalahan. Buka host proxy yang sama, buka tab SSL, setel Sertifikat SSL ke Minta Sertifikat SSL baru, aktifkan Paksa SSL dan Dukungan HTTP/2, setujui Persyaratan Layanan Lets Encrypt, dan Simpan. Muat ulang situs - browser sekarang akan menampilkan gembok di https.

Cara kerjanya: Lets Encrypt membuktikan Anda mengontrol nama dengan meminta server Anda, melalui internet publik pada port 80, untuk menampilkan token satu kali (tantangan HTTP-01). Itulah sebabnya DNS yang menunjuk ke Anda dan port 80 yang dapat dijangkau tidak dapat dinegosiasikan - gagal salah satunya dan permintaan gagal, dan kesalahan ada pada pengaturan, tidak pernah pada Lets Encrypt. Paksa SSL mengalihkan setiap pengunjung http ke https secara otomatis; tanpanya pintu yang tidak terenkripsi akan tetap terbuka di samping pintu yang terenkripsi.