Tag Archives: proxy

Install NGINX Proxy Manager (NPM)

Leave a reply
NGINX Proxy Manager

NGINX Proxy Manager (NPM) ini adalah salah satu reverse proxy dari beberapa reverse proxy lainnya yang lebih terkenal di internet seperti traefik, haproxy, dan lain-lain. Tapi menurut saya NPM ini adalah yang paling mudah dideploy. Tampilannya sederhana dan menarik, dengan fitur-fitur yang straight to the point dan tidak membingungkan.

Beberapa fitur yang paling sering dipakai antara lain:

  1. Proxy Host
    Proxy Host ini akan menjadi entry point setiap web service yang akan diforward. Di sini kita bisa menambahkan SSL secara otomatis untuk semua domain web service menggunakan Letsencrypt, dan mengaktifkan NGINX caching.
  2. Redirection Host
    Redirection Host akan melakukan redirect seluruh request yang datang untuk suatu domain, dan melakukan forward ke domain yang lainnya. Fitur ini berguna misal kita punya domain lama yang masih ada indexnya di Google, dan kita ingin agar seluruh pengunjung yang menuju domain lama tersebut ke domain yang baru.
  3. Stream
    Salah satu fitur yang relatif baru dari NGINX. Stream akan melakukan forward secara langsung untuk protokol TCP atau UDP ke komputer yang lain. Kalau misal kita punya server dengan DDOS protected IP, akan sangat berguna sekali. Misal untuk melindungi game servers, atau FTP dan SSH server.

NPM berbasiskan Docker container. Jadi, bagi orang yang sangat awam dengan Docker seperti saya, catatan yang dibuat ini akan membantu saya dan (semoga) juga orang lain untuk memulai dan mengingatnya.

Tutorial ini menggunakan distribusi Linux Ubuntu 18.04. Tapi karena Docker-based, jadi seharusnya bisa menggunakan Distro linux apa saja.

Prerequisite yang harus diinstall adalah Docker dan Docker-Compose. Cara menginstall Docker ada di sini, sedangkan cara menginstall Docker-Compose ada di sini.

Setelah semua diinstall lalu update dan bersihkan distro dengan cara ini (asumsi semua command dilakukan dengan user root):

apt update
apt upgrade
reboot
apt autoremove

Sekarang saatnya kita menginstall NPM.

mkdir npm
cd npm

Buat dua file konfigurasi, yaitu config.json dan docker-compose.yml

touch config.json
touch docker-compose.yml

Jadi, isi dalam folder npm akan ada dua file ini:

root@scylla:~/npm# ls -lh
total 16K
-rw-r--r-- 1 root root 2.3K Jun 1 22:52 config.json
-rw-r--r-- 1 root root 637 Jun 2 16:03 docker-compose.yml

Edit kedua file itu dengan vim atau nano atau terserah, untuk config.json isinya seperti ini:

{
"database": {
"engine": "mysql",
"host": "db",
"name": "npm",
"user": "npm",
"password": "npm",
"port": 3306
}
}

sedangkan docker-compose.yml isinya seperti ini:

version: "3"
services:
   app:
      image: jc21/nginx-proxy-manager:latest
      restart: always
      ports:
         - 80:80
         - 81:81
         - 443:443
      volumes:
         - ./config.json:/app/config/production.json
         - ./data:/data
         - ./letsencrypt:/etc/letsencrypt
      depends_on:
         - db
      environment:
      # if you want pretty colors in your docker logs:
      - FORCE_COLOR=1
db:
   image: mariadb:latest
   restart: always
   environment:
      MYSQL_ROOT_PASSWORD: "npm"
      MYSQL_DATABASE: "npm"
      MYSQL_USER: "npm"
      MYSQL_PASSWORD: "npm"
   volumes:
      - ./data/mysql:/var/lib/mysql

Masih di dalam folder npm, ketikkan perintah ini untuk mendownload dan membuat containernya:

docker-compose up -d

Setelah satu atau dua menit, kita akan punya fully working NGINX manager. Bisa diakses di alamat http://ala.mat.ip.address:81 atau http://hostname:81.

Login dengan username admin@example.com dan password changeme

Developers site – https://github.com/jc21/nginx-proxy-manager – all credit goes to him.