Apa yang bisa kami bantu?

A. Pendahuluan

OPNsense merupakan platform firewall dan routing berbasis perangkat lunak yang dapat dijalankan pada Virtual Machine (VM). OPNsense dapat digunakan untuk mengatur lalu lintas jaringan, firewall, serta port forwarding menuju VM lain yang berada pada jaringan internal.

Pada layanan Gio Enterprise Cloud (GEC), OPNsense dapat diinstal menggunakan ISO installer atau dibuat menggunakan image template yang telah tersedia. Panduan ini menggunakan ISO installer agar proses instalasi dan konfigurasi awal OPNsense dapat dilakukan secara langsung melalui console VM.

Pada panduan ini, OPNsense digunakan sebagai VM router dengan dua interface jaringan, yaitu WAN dan LAN. Public IP GEC digunakan untuk mengakses Web GUI OPNsense dan meneruskan koneksi SSH menuju VM target yang berada pada jaringan LAN. Dengan skema ini, VM target tidak memerlukan Public IP tersendiri.
 

B. Langkah-Langkah Instalasi

1. Menyiapkan ISO OPNsense

1.1. Unduh ISO installer OPNsense melalui situs resmi berikut:

https://opnsense.org/download/

Pilih arsitektur amd64 dan tipe image DVD ISO. Apabila file yang diunduh masih dalam format terkompresi, ekstrak terlebih dahulu hingga tersedia file ISO yang dapat digunakan.

 

Gambar 1. Halaman download ISO OPNsense dari situs resmi.

 

1.2. Unggah ISO ke portal GEC. Untuk panduan pengunggahan image atau template, silakan merujuk pada dokumentasi berikut:

https://kb.biznetgio.com/gio-enterprise-cloud/cara-upload-dan-menggunakan-image-template-di-gio-enterprise-cloud?from_search=243010459

1.3. Setelah proses pengunggahan atau registrasi selesai, pastikan ISO OPNsense sudah tersedia dan dapat dipilih ketika membuat instance.

 

Gambar 2. ISO OPNsense yang telah tersedia pada portal GEC.

 

2. Menyiapkan Guest Network

2.1. Sebelum membuat VM OPNsense, siapkan dua Guest Network dalam VPC yang sama, yaitu:

WAN Network, sebagai jaringan yang terhubung ke interface WAN OPNsense.

LAN Network, sebagai jaringan internal yang terhubung ke interface LAN OPNsense dan VM target.

Pembuatan Guest Network dapat mengikuti panduan berikut:

https://kb.biznetgio.com/id_ID/gio-enterprise-cloud/cara-membuat-guest-network-untuk-instance-di-gio-enterprise-cloud

2.2. Pastikan kedua Guest Network menggunakan CIDR yang berbeda, tidak saling tumpang tindih, dan masih berada dalam rentang CIDR VPC yang digunakan.

Sebagai contoh, berikut skema IP untuk pengujian:

Komponen Contoh konfigurasi
VPC 192.168.0.0/16
WAN Network 192.168.11.0/24
LAN Network 192.168.100.0/24
IP WAN OPNsense 192.168.11.121/24
IP LAN OPNsense 192.168.100.20/24
IP VM target 192.168.100.31/24

Alamat IP di atas merupakan contoh konfigurasi lab. Sesuaikan dengan alokasi IP dan CIDR yang tersedia pada environment GEC.

 

Gambar 3. Guest Network WAN dan LAN yang digunakan pada VPC.

 

Image preview
Gambar 4. Diagram topologi VM router OPNsense pada GEC.



3. Membuat VM OPNsense

3.1. Login ke portal GEC melalui:

https://ec.biznetgio.com/

3.2. Masuk ke menu Instances, kemudian pilih opsi untuk membuat instance baru.

Pilih ISO OPNsense yang telah disiapkan pada tahap sebelumnya.

Gambar 5. Pemilihan ISO OPNsense pada proses pembuatan instance.

 

3.3. Tentukan Compute Offering, CPU, Memory, dan kapasitas disk sesuai kebutuhan. Pastikan resource yang dipilih memadai untuk menjalankan OPNsense dan fitur jaringan yang digunakan.

3.4. Pada bagian konfigurasi network, pilih WAN Network sebagai jaringan awal VM OPNsense.

Pada tahap awal, cukup gunakan satu interface WAN. Interface LAN akan ditambahkan setelah instalasi selesai dan akses administrasi WAN disiapkan.

3.5. Lengkapi konfigurasi instance, kemudian klik Launch Instance dan tunggu hingga VM berstatus Running.

Panduan pembuatan dan pengaksesan instance dapat dilihat pada dokumentasi berikut:

https://kb.biznetgio.com/gio-enterprise-cloud/cara-membuat-mengakses-menghapus-dan-memulihkan-instance-di-gio-enterprise-cloud?from_search=243010955

 

Gambar 6. Detail konfigurasi instance OPNsense sebelum diluncurkan.

 

4. Melakukan Instalasi OPNsense melalui Console

4.1. Setelah VM berstatus Running, buka detail instance OPNsense kemudian pilih Console untuk mengakses tampilan instalasi.

4.2. Ketika prompt login installer muncul, masukkan kredensial berikut:

Username: installer

Password: opnsense

Kredensial tersebut digunakan untuk masuk ke lingkungan installer OPNsense.

 

Gambar 7. Login installer OPNsense melalui console.

 

4.3. Ikuti instruksi instalasi yang ditampilkan pada console. Pilih konfigurasi keyboard, filesystem, dan virtual disk yang akan digunakan.

Pastikan disk yang dipilih benar karena proses instalasi akan memformat disk tersebut dan menghapus data yang ada di dalamnya.

 

 

Gambar 8. Pemilihan disk dan filesystem pada proses instalasi OPNsense.

 

4.4. Tetapkan password baru untuk akun root, kemudian lanjutkan proses instalasi hingga selesai.

Simpan password tersebut karena akan digunakan untuk login ke OPNsense setelah instalasi selesai.

 

Gambar 9. Pengaturan password root dan proses instalasi OPNsense.

 

4.5. Setelah instalasi selesai, matikan VM melalui portal GEC. Lepaskan atau detach ISO installer dari instance, kemudian jalankan kembali VM agar melakukan boot dari virtual disk hasil instalasi.

4.6. Setelah VM berhasil boot, login melalui console menggunakan kredensial berikut:

Username: root

Password: password yang telah ditetapkan pada proses instalasi.

 

Gambar 10. Console OPNsense setelah instalasi selesai.

 

5. Mengonfigurasi Public IP dan Akses Web GUI

5.1. Pastikan VM OPNsense memiliki alamat IP WAN yang sesuai dengan alokasi pada GEC. Pada contoh pengujian ini, interface WAN menggunakan vtnet0 dengan alamat 192.168.11.121/24.

5.2. Siapkan Public IP GEC yang akan digunakan untuk mengakses Web GUI OPNsense. Tambahkan konfigurasi port forwarding melalui portal GEC dengan parameter berikut:

Parameter Nilai
Protocol TCP
Public Port 443
Private Port 443
Target Instance VM OPNsense
Target IP IP private WAN OPNsense

Port TCP 443 digunakan untuk mengakses Web GUI melalui HTTPS. Port TCP 80 tidak diperlukan untuk skenario ini karena Web GUI OPNsense menggunakan HTTPS secara default.

 

Gambar 11. Port forwarding TCP 443 pada Public IP GEC menuju VM OPNsense.

 

5.3. Pastikan ACL pada GEC mengizinkan trafik yang diperlukan. Untuk pengujian awal di lingkungan lab, ACL dapat dibuka sementara sesuai kebutuhan pengujian. Setelah berhasil, batasi akses hanya dari sumber IP yang diperlukan.

5.4. Akses Web GUI OPNsense melalui browser menggunakan alamat berikut:

https://<IP-PUBLIK-GEC>/

Ganti placeholder dengan Public IP yang digunakan. Apabila muncul peringatan sertifikat self-signed, pastikan alamat yang diakses sesuai dengan Public IP OPNsense yang dikonfigurasi.

Gambar 12. Akses Web GUI OPNsense melalui Public IP GEC.

 

5.5. Sebelum menambahkan interface LAN, siapkan izin akses Web GUI melalui WAN agar akses administrasi tetap tersedia setelah konfigurasi interface selesai.

Buka menu Firewall → Rules → WAN, kemudian tambahkan rule dengan parameter berikut:

Parameter Nilai
Action Pass
Interface WAN
Protocol TCP
Source IP publik administrator /32
Destination WAN address
Destination Port HTTPS (443)
Description Allow Web GUI from Admin IP

Gunakan IP publik koneksi administrator, bukan IP lokal perangkat seperti 192.168.x.x. Klik Save, kemudian Apply Changes.

 

Gambar 13. Firewall rule WAN untuk mengizinkan akses Web GUI.

 

5.6. Apabila muncul pesan The HTTP_REFERER does not match the predefined settings, buka menu System → Settings → Administration, kemudian tambahkan Public IP atau hostname yang digunakan pada bagian Alternate Hostnames.

Masukkan alamat tanpa https:// dan tanpa garis miring di akhir. Simpan perubahan, lalu coba akses kembali Web GUI.

 

Gambar 14. Pengaturan Alternate Hostnames pada OPNsense.

 

6. Menambahkan Interface LAN pada VM OPNsense

6.1. Setelah konfigurasi WAN dan akses administrasi selesai disiapkan, matikan VM OPNsense untuk menambahkan interface jaringan kedua.

6.2. Buka detail instance di portal GEC, masuk ke bagian NICs, lalu tambahkan NIC kedua dan hubungkan ke LAN Network yang telah dibuat pada tahap 2.

6.3. Jalankan kembali VM dan buka console OPNsense. Pilih menu berikut:

1) Assign interfaces

Lakukan assignment berdasarkan interface yang terdeteksi. Pada contoh pengujian ini, pemetaannya adalah:

WAN: vtnet0

LAN: vtnet1

Nama interface dapat berbeda pada lingkungan lain. Cocokkan dengan detail NIC dan MAC address pada portal GEC. Apabila tidak menggunakan VLAN atau LAGG, pilih tidak saat ditanyakan mengenai konfigurasi tersebut.

 

Gambar 15. Assignment interface WAN dan LAN pada console OPNsense.

 

6.4. Setelah assignment selesai, pilih menu:

2) Set interface IP address

Pilih interface LAN, kemudian konfigurasi IPv4 statis sesuai alamat yang dialokasikan pada GEC.

Contoh konfigurasi:

IPv4 address: 192.168.100.20

Prefix: /24

Pastikan IP tersebut belum digunakan oleh instance lain dan sesuai dengan CIDR LAN Network pada GEC.

Pertahankan default gateway pada sisi WAN. Jangan menetapkan default gateway kedua pada interface LAN.

Gambar 16. Konfigurasi IP address interface LAN.

 

6.5. Pastikan kedua interface telah aktif dan terhubung ke Guest Network yang sesuai.

Pada konfigurasi ini, NIC LAN OPNsense dan NIC VM target harus berada pada LAN Network yang sama. Pastikan pula tidak terdapat layanan DHCP ganda yang saling bertentangan pada jaringan tersebut.

Gambar 17. Detail instance OPNsense setelah memiliki dua NIC.

 

7. Membuat VM Target pada LAN Network

7.1. Buat VM target menggunakan template sistem operasi yang diperlukan, misalnya Ubuntu 22.04 LTS.

7.2. Pada bagian konfigurasi network, pilih LAN Network yang sama dengan interface LAN OPNsense.

VM target cukup menggunakan satu NIC pada LAN Network. Pada skenario ini, VM target tidak memerlukan Public IP tersendiri karena koneksi dari luar akan diteruskan melalui Public IP GEC yang digunakan oleh OPNsense.

 

Gambar 18. Pembuatan VM Ubuntu dengan satu NIC pada LAN Network.

 

7.3. Pastikan IP VM target sesuai dengan alokasi pada GEC. Sebagai contoh, VM target menggunakan IP 192.168.100.31/24, sedangkan IP LAN OPNsense adalah 192.168.100.20/24.

Pastikan layanan SSH berjalan pada VM target. Untuk Ubuntu, status layanan dapat diperiksa melalui console dengan perintah berikut:

sudo systemctl status ssh
sudo ss -lntp | grep ':22'

 

Gambar 19. Detail NIC dan IP address VM target pada GEC.

 

8. Membuat Port Forwarding SSH pada GEC

8.1. Pada Public IP GEC yang sama, tambahkan port forwarding untuk koneksi SSH menuju VM target melalui OPNsense.

Gunakan parameter berikut:

Parameter Nilai
Protocol TCP
Public Port 2222
Private Port 2222
Target Instance VM OPNsense
Target IP IP private WAN OPNsense, contoh 192.168.11.121

Dengan konfigurasi tersebut, trafik dari Public IP GEC pada port TCP 2222 akan diteruskan ke port TCP 2222 pada WAN OPNsense.

 

Gambar 20. Port forwarding TCP 2222 pada GEC menuju WAN OPNsense.

 

8.2. Pastikan ACL GEC mengizinkan trafik yang diperlukan untuk pengujian SSH. Untuk penggunaan di luar lab, batasi source ke IP publik administrator atau sumber yang memang memerlukan akses.
 

9. Membuat DNAT Port Forwarding pada OPNsense

9.1. Login ke Web GUI OPNsense, kemudian buka menu:

Firewall → NAT → Destination NAT (Port Forward)


9.2. Tambahkan rule baru untuk meneruskan koneksi SSH ke VM target.

Gunakan parameter berikut:

Parameter Nilai
Interface WAN
Version IPv4
Protocol TCP
Source IP publik administrator /32 atau sumber yang diizinkan
Destination WAN address
Destination Port 2222
Redirect Target IP 192.168.100.31
Redirect Target Port SSH (22)
Filter rule association Register rule
Description Port Forward SSH to Ubuntu


Sesuaikan IP tujuan dengan alamat VM target yang sebenarnya.

 

Gambar 21. Konfigurasi DNAT port forwarding SSH pada OPNsense.

 

9.3. Klik Save, kemudian Apply Changes. Pastikan rule aktif setelah perubahan diterapkan.

Dengan memilih Register rule, OPNsense akan membuat rule firewall terkait secara otomatis. Pastikan tidak terdapat rule lain yang menolak trafik sebelum rule yang mengizinkan koneksi tersebut.
 

10. Mengonfigurasi Soruce NAT untuk Jalur Balik SSH

Pada topologi pengujian ini, VM target menggunakan default gateway 192.168.100.1 dari Virtual Router CloudStack, bukan OPNsense. Kondisi tersebut dapat menyebabkan routing asimetris karena koneksi masuk melewati OPNsense, sedangkan trafik balasan keluar melalui gateway lain.

Untuk menangani kondisi tersebut, konfigurasi pengujian ini menggunakan rule SNAT spesifik pada OPNsense. Rule ini merupakan bagian dari studi kasus dan tidak wajib diterapkan pada setiap topologi OPNsense.

10.1. Buka menu:

Firewall → NAT → Source NAT

10.2. Ubah mode Source NAT dari Automatic menjadi Hybrid outbound NAT rule generation, kemudian simpan perubahan.

Mode Hybrid mempertahankan aturan NAT otomatis sekaligus memungkinkan penambahan rule manual.

 

Gambar 22. Pengaturan Outbound NAT ke mode Hybrid.

 

10.3. Tambahkan rule Source NAT dengan parameter berikut:

Parameter Nilai
Interface LAN
Version IPv4
Protocol TCP
Source Any
Destination 192.168.100.31/32
Destination Port SSH (22)
Translation / Target Interface address
Description SNAT Port Forward SSH to Ubuntu

Pastikan rule hanya mencakup trafik TCP menuju IP target pada port 22, bukan seluruh trafik LAN.

 

Gambar 23. Rule SNAT untuk VM target pada Outbound NAT.

 

10.4. Klik Save, kemudian Apply Changes. Pastikan rule manual yang baru telah aktif dan aturan NAT otomatis yang sudah ada tetap dipertahankan.

Dengan konfigurasi ini, source address koneksi yang diteruskan ke VM target akan diterjemahkan menjadi alamat LAN OPNsense, yaitu 192.168.100.20. VM target kemudian mengirimkan balasan melalui OPNsense sehingga jalur koneksi menjadi konsisten.

Perlu diperhatikan bahwa VM target akan melihat alamat source koneksi sebagai 192.168.100.20, bukan IP asli client internet.
 

11. Melakukan Pengujian SSH

11.1. Pastikan seluruh konfigurasi telah diterapkan dan layanan SSH pada VM target berjalan.

11.2. Dari komputer administrator di luar jaringan LAN, buka PowerShell dan jalankan perintah berikut:

Test-NetConnection <IP-PUBLIK-GEC> -Port 2222

Ganti placeholder dengan Public IP GEC yang digunakan.

Pastikan nilai TcpTestSucceeded menunjukkan True sebelum melanjutkan pengujian SSH.

 

Gambar 24. Hasil Test-NetConnection dengan TcpTestSucceeded bernilai True.

 

11.3. Apabila koneksi TCP berhasil, lakukan pengujian SSH dengan perintah berikut:

ssh -p 2222 username@<IP-PUBLIK-GEC>

Ganti username dengan akun Linux pada VM target dan <IP-PUBLIK-GEC> dengan Public IP GEC yang digunakan.

 

Gambar 25. Pengujian SSH ke VM Ubuntu melalui Public IP GEC dan OPNsense.

 

11.4. Apabila koneksi belum berhasil, lakukan pemeriksaan secara berurutan terhadap port forwarding GEC, rule DNAT dan firewall OPNsense, Outbound NAT untuk jalur balik, status layanan SSH pada VM target, serta ACL dan routing yang digunakan.

Setelah pengujian berhasil, batasi kembali ACL dan rule firewall agar hanya mengizinkan akses sesuai kebutuhan.
 

C. Kesimpulan

Dengan mengikuti panduan ini, VM OPNsense dapat dibuat pada GEC menggunakan ISO installer, dikonfigurasi dengan interface WAN dan LAN, serta digunakan untuk meneruskan koneksi SSH menuju VM target melalui Public IP GEC.

Pada contoh ini, VM target hanya menggunakan satu NIC pada LAN Network dan tidak memerlukan Public IP tersendiri. Koneksi dari luar diteruskan melalui port forwarding pada GEC dan DNAT pada OPNsense. Rule Outbound NAT Hybrid dengan SNAT spesifik digunakan untuk menangani jalur balik koneksi SSH pada topologi pengujian ini. Pastikan konfigurasi network, NAT, firewall, dan ACL telah sesuai dengan kebutuhan, serta akses administrasi dibatasi sebelum konfigurasi diterapkan pada lingkungan produksi. 

Semoga artikel ini dapat membantu Anda. Temukan bantuan lainnya melalui Knowledge Base Biznet Gio. Jika Anda masih memiliki kendala silakan hubungi Support Biznet GIO melalui email support@biznetgio.com atau live chat maupun WA melalui website www.biznetgio.com dan bisa juga melalui telepon ke nomor (021) 5714567.