Cara Install Wg-Easy UI Web Open Source WireGuard VPN di Ubuntu 24.04

Pengantar

Wg-Easy adalah aplikasi berbasis Docker untuk mempermudah pengelolaan VPN WireGuard melalui antarmuka web (Web UI). Dengan Wg-Easy, Anda bisa menambah, menghapus, atau mengatur client (peer) tanpa perlu menulis konfigurasi manual.

Pada panduan ini, Wg-Easy akan dijalankan langsung dengan IP server dan port, tanpa menggunakan domain.

Prasyarat

Sebelum memulai, pastikan hal berikut sudah siap:

  1. Server Ubuntu 24.04 atau setara dengan akses root atau sudo.

  2. SSH ke server aktif.

Langkah - Langkah Instalasi Wg-Easy

  1. Pastikan Docker Berjalan
    • Periksa status Docker:
      sudo service docker status
      

    • Jika Docker belum terpasang atau tidak aktif:
      sudo apt install docker.io docker-compose -y
      sudo service docker start
      
    • Tambahkan user aktif ke grup Docker:
      sudo usermod -aG docker $USER
      exec su - $USER
      
  2. Install Apache Utils
    • Gunakan perintah berikut:
      sudo apt install apache2-utils -y
  3. Buat Password hash untuk Wg-Easy
    Wg-Easy tidak menggunakan username, hanya password untuk login. Password harus di-hash sebelum dimasukkan ke konfigurasi Docker.
    • Contoh membuat hash untuk password Admin123!:
      htpasswd -nbB '' 'Admin123!' | cut -d ':' -f2
      

      Ganti Admin123! dengan password yang akan digunakan.

    • Outputnya akan mirip dengan:

      $2y$05$2dVmxc5QjP.lzPXgQ80fc.Xq.jobmJ.0Hm2pcBDzu0bi6M7jP7qgS
      

      Simpan hash tersebut. Password login yang dipakai nanti adalah Admin123!, bukan hash.

  4. Jalankan Wg-Easy
    Kemudian Masukkan ip pada wg_host dan password_hash sesuaikan dengan ip server dan password hash kita
    docker run --detach \
      --name wg-easy \
      --env LANG=en \
      --env WG_HOST=103.121.156.177 \
      --env PASSWORD_HASH='$2y$05$2dVmxc5QjP.lzPXgQ80fc.Xq.jobmJ.0Hm2pcBDzu0bi6M7jP7qgS' \
      --env PORT=51821 \
      --env WG_PORT=51820 \
      --volume ~/.wg-easy:/etc/wireguard \
      --publish 51820:51820/udp \
      --publish 51821:51821/tcp \
      --cap-add NET_ADMIN \
      --cap-add SYS_MODULE \
      --sysctl 'net.ipv4.conf.all.src_valid_mark=1' \
      --sysctl 'net.ipv4.ip_forward=1' \
      --restart unless-stopped \
      ghcr.io/wg-easy/wg-easy
    
    
    Verifikasi container berjalan:
    docker ps
    
  5. Akses UI Wg-Easy
    Buka browser:
    http://Ip-Address:51821
    
    Login menggunakan password yang telah di-hash tadi.

Kesimpulan

Dengan langkah-langkah di atas, Anda sudah berhasil menjalankan Wg-Easy di Ubuntu 24.04 menggunakan IP publik tanpa domain, membuat hash password untuk login, dan mengakses Web UI untuk mengelola client WireGuard VPN, login hanya memakai password, dan untuk penggunaan produksi disarankan menggunakan domain + SSL agar lebih aman.


Artikel Lain

WhatsApp Kami

Support : +6282138153600

Admin Finance : +6285191239466