Mengapa menggunakan NGINX?#

Alasan saya pribadi menggunakan NGINX karena konfigurasinya yang cukup mudah dipahami, dibandingkan dengan kompetitornya webserver Apache. Selain itu, menurut saya NGINX lebih cepat dan ringan.

Step 1 - Connect ke VPS#

Teman-teman silahkan membuka command prompt atau terminal favoritnya, lalu mengetik perintah sebagai berikut,

ssh [USERNAME VPS]@[IP VPS]

NOTE

Jangan lupa untuk mengganti [USERNAME VPS] dan [IP VPS] dengan username serta IP VPS-nya teman-teman. Tanpa [ dan ] yaa!

Step 2 - Verifikasi Fingerprint dan Password#

Setelah teman-teman mengetik perintah diatas, akan ada permintaan fingerprint verification, silahkan teman-teman ketik yes atau enter saja. Seperti berikut,

Kemudian, ketika permintaan password telah muncul seperti diatas, maka silahkan input password VPS yang sesuai.

IMPORTANT

Jangan khawatir, jika password yang diketik tidak muncul, password tersamarkan secara otomatis sebagai bentuk keamanan.

Step 3 - Install NGINX dan Update Dependencies#

Apabila teman-teman telah mengikuti step 2, maka teman-teman akan mendapati home screen seperti berikut,

Silahkan teman-teman jalankan perintah dibawah ini,

1
sudo apt update
2
sudo apt upgrade
3

4
sudo apt install git nginx -y

• sudo apt update: Memperbarui daftar paket untuk pembaruan dan penginstallan.
• sudo apt upgrade: Memperbarui semua paket yang terinstal pada sistem ke versi terbaru.
• sudo apt install git nginx -y: Menginstall Git & NGINX. Flag -y secara otomatis mengkonfirmasi prompt penginstallan (yes/no).

Step 4 - Install Node.js#

Untuk instalasi Node.js, kita akan menggunakan Node Version Manager (NVM), karena dengan tool ini akan memudahkan kita untuk switch version Node.js tanpa ribet-ribet lagi kedepannya.

Silahkan copy perintah dibawah untuk menginstall nvm,

1
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
2

3
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
4
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

Kurang lebih jika sudah terinstall, akan seperti gambar berikut apabila kita mengeceknya dengan mengetik perintah nvm,

Apabila sudah terlihat seperti gambar diatas, silahkan jalankan perintah dibawah,

1
nvm install 21

NOTE

21 bisa diganti dengan versi Node.js lainnya, seperti 18, 12, 20, 14 atau pun versi spesifiknya seperti 20.17.0

Jika proses instalasi sudah selesai, silahkan verifikasi dengan perintah node -v, apabila jika sudah sesuai dengan versi Node.js yang kalian request, maka proses instalasi sudah berjalan dengan sempurna 😎

Step 5 - Konfigurasi Project Node.js#

Selamat datang di step ke-5, kali ini kita akan membahas bagaimana kita mengkonfigurasi project node.js kita di dalam VPS ini.

Disini, saya akan menjalankan project Bookshelf API berikut dengan Node.js v21.7.3.

Hal yang harus dilakukan adalah melakukan cloning repository tersebut ke VPS kita, dengan cara sebagai berikut,

1
git clone https://github.com/hansputera/bookshelf-api
2
cd bookshelf-api # masuk ke directory project tersebut dengan nama bookshelf-api

selanjutnya, kita akan melakukan instalasi dependencies project tersebut dengan perintah npm i.

Apabila instalasi dependencies sukses, kurang lebih akan muncul sebagai gambar dibawah,

Selanjutnya, kita coba lihat dan ubah jika diperlukan dalam kode atau konfigurasi project Node.js kita, saran dari saya lebih baik apabila teman-teman mengakses environment dari Node.js NODE_ENV untuk mengecek apakah berstatus production atau development untuk menentukan binding server address ke localhost atau 0.0.0.0

Step 6 - Menjalankan Node.js App#

Apabila teman-teman telah mengikuti step 5, maka teman-teman dipersilahkan mengikuti step ini.

Tentunya kita tidak selalu membuka server atau VPS selama 24 jam ⏰ bukan? Sama aja boong kalau punya VPS, namun kita selalu buka device kita untuk mengonlinekan appnya 😂

Caranya gampang banget, kita bisa menggunakan tool PM2 untuk menjalankan program atau app Node.js kita di background. Gimana? Simak dibawah.

Cara installnya gampang banget, perintahnya seperti dibawah ya

1
npm i -g pm2

Untuk verifikasi instalasi dapat mengetik perintah pm2, apabila muncul help info dari pm2, maka dipastikan instalasi sukses.

Selanjutnya gimana? Masih di direktori project yang sama, kita jalankan perintah sebagai berikut,

1
pm2 start src/index.js --name "Nama Project"
2
pm2 save
3

4
pm2 startup

NOTE

Nama Project bisa diganti dengan nama app sesuka hati kalian. Dan, src/index.js juga bisa diganti dengan lokasi file program Node.js yang akan dijalankan (misal program yang ingin dijalankan adalah index.js, maka ganti saja dengan index.js)

Command pm2 save berfungsi untuk menyimpan state app yang kalian buat.

Sedangkan pm2 startup berfungsi untuk memberikan command kepada kita untuk dijalankan sehingga pm2 akan berjalan otomatis walaupun VM di reboot.

Apabila sukses, akan muncul output seperti gambar dibawah

Udah selesai? Iya udah 😎 EH-nggak dong WKWK, kita belum setup NGINX nya loh 🤩😋

Step 7 - NGINX Setup#

Untuk konfigurasi NGINX-nya kita akan bagi menjadi dua, yaitu:,

1. Direct IP dengan SSL
2. Domain dengan/tanpa SSL

1
sudo mkdir -p /var/www/well-known/pki-validation

1
sudo nano /var/www/well-known/pki-validation/NAMA_FILE_DICOPY

1
 location /.well-known {
2
    autoindex on;
3
    alias /var/www/well-known;
4
 }

1
nano /etc/nginx/sites-available/default

1
location / {
2
    ....
3
}
4

5
# isi disini

1
server {
2
        listen 80;
3
        listen [::]:80;
4

5
        server_name IP_VPS;
6
        return 301 https://$host$request_uri;
7
}
8

9
server {
10
        listen 443 ssl;
11
        listen [::]:443 ssl;
12

13
        server_name IP_VPS;
14

15
        ssl_certificate /etc/ssl/certs/certificate.pem;
16
        ssl_certificate_key /etc/ssl/certs/private.key;
17

18
        location / {
19
                proxy_pass http://127.0.0.1:5000/;
20
                proxy_set_header Host $host;
21
                proxy_set_header X-Real-IP $remote_addr;
22
        }
23
}

1
sudo ln -s /etc/nginx/sites-available/app-reverse /etc/nginx/sites-enabled/app-reverse
2
sudo systemctl restart nginx

1
server {
2
    listen 80;
3
    listen [::]:80;
4

5
    server_name domain_kalian.id;
6

7
    location / {
8
        proxy_pass http://127.0.0.1:5000/;
9
        proxy_set_header Host $host;
10
        proxy_set_header X-Real-IP $remote_addr;
11
    }
12
}

1
sudo ln -s /etc/nginx/sites-available/app-reverse-http /etc/nginx/sites-enabled/app-reverse-http
2
sudo systemctl restart nginx

1
server {
2
    listen 80;
3
    listen [::]:80;
4

5
    server_name domain_kalian.id;
6
    return 301 https://$host$request_uri;
7
}
8

9
server {
10
    listen 443 ssl;
11
    listen [::]:443 ssl;
12

13
    server_name domain_kalian.id;
14

15
    ssl_certificate /etc/ssl/certs/certificate.pem;
16
    ssl_certificate_key /etc/ssl/certs/private.key;
17

18
    location / {
19
        proxy_pass http://127.0.0.1:5000/;
20
        proxy_set_header Host $host;
21
        proxy_set_header X-Real-IP $remote_addr;
22
    }
23
}