TeknoTUT

Reverse Proxy Caddy dengan Docker Compose: HTTPS Otomatis

Panduan memasang Caddy sebagai reverse proxy dengan Docker Compose: HTTPS otomatis dari Let's Encrypt, banyak domain, cukup satu Caddyfile ringkas.

Ditulis oleh 14 menit bacaEnglish
Ilustrasi reverse proxy dengan gembok HTTPS yang meneruskan lalu lintas ke beberapa container
Daftar Isi

Jika anda sudah menjalankan aplikasi dengan Docker di VPS, tentu anda sudah tidak asing dengan alamat seperti http://IP-SERVER:8080. Untuk mencoba-coba, alamat seperti ini memang cukup. Tetapi untuk dipakai sungguhan? Alamatnya sulit diingat, browser menampilkan peringatan "Not Secure", dan setiap aplikasi baru berarti satu port lagi yang terbuka ke internet.

Yang kita inginkan tentu alamat yang rapi seperti https://blog.example.com, lengkap dengan gembok HTTPS. Cara klasiknya adalah memasang Nginx, menulis konfigurasi server block untuk setiap aplikasi, lalu mengurus sertifikat SSL dengan Certbot. Bisa, tetapi langkahnya cukup banyak, dan harus diulang setiap kali ada aplikasi baru.

Di sinilah Caddy berperan. Caddy adalah web server yang mengurus sertifikat HTTPS secara otomatis: cukup tulis nama domain dan tujuan proxy-nya dalam dua atau tiga baris, sisanya dikerjakan sendiri oleh Caddy.

Dalam artikel kali ini, kita akan membahas tuntas cara memasang Caddy sebagai reverse proxy dengan Docker Compose, mulai dari pengertian reverse proxy, menyiapkan DNS dan network Docker, menulis Caddyfile, menambahkan aplikasi dari project Compose lain, hingga mengatasi masalah yang paling sering muncul. Mari kita mulai!

Apa itu Reverse Proxy?

Reverse proxy adalah server yang berdiri di depan aplikasi anda dan menerima semua permintaan dari internet, lalu meneruskannya ke aplikasi yang tepat di belakangnya.

Bayangkan sebuah gedung perkantoran dengan satu resepsionis di lobi. Tamu tidak perlu tahu ruangan mana yang harus dituju. Mereka cukup menyebut nama perusahaan, lalu resepsionis yang mengantarkan ke ruangan yang benar. Reverse proxy bekerja persis seperti itu: pengunjung menyebut nama domain, dan reverse proxy meneruskannya ke container yang sesuai.

Dengan reverse proxy, anda mendapatkan beberapa hal sekaligus:

  • Satu pintu masuk: hanya port 80 dan 443 yang terbuka ke internet, berapa pun jumlah aplikasi anda.
  • HTTPS di satu tempat: sertifikat SSL diurus oleh reverse proxy, sehingga aplikasi di belakangnya tidak perlu tahu apa-apa soal HTTPS.
  • Banyak domain di satu server: blog.example.com, status.example.com, dan app.example.com bisa berjalan di satu VPS yang sama.

Apa itu Caddy?

Caddy adalah web server open source yang ditulis dengan bahasa Go dan dirilis dengan lisensi Apache 2.0. Fitur yang membuatnya terkenal adalah Automatic HTTPS: Caddy otomatis meminta sertifikat dari certificate authority publik seperti Let's Encrypt, memasangnya, lalu memperpanjangnya sebelum kedaluwarsa, tanpa perlu Certbot maupun cron job.

Saat artikel ini ditulis, versi stabil Caddy berada di seri 2.11. Konfigurasinya ditulis dalam sebuah file bernama Caddyfile, yang formatnya jauh lebih ringkas dibandingkan konfigurasi Nginx. Sebagai gambaran, inilah konfigurasi reverse proxy lengkap dengan HTTPS untuk satu domain:

blog.example.com {
	reverse_proxy wordpress:80
}

Hanya tiga baris. Menarik bukan?

Mengapa Memilih Caddy sebagai Reverse Proxy?

Berikut beberapa alasan kenapa Caddy cocok untuk self-hosting di VPS:

  • HTTPS otomatis: sertifikat diminta, dipasang, dan diperpanjang sendiri. Menurut dokumentasi Automatic HTTPS, bila Let's Encrypt gagal, Caddy bahkan mencoba CA lain (ZeroSSL) secara otomatis.
  • Redirect HTTP ke HTTPS bawaan: pengunjung yang membuka http:// langsung dialihkan ke https:// tanpa konfigurasi tambahan.
  • Konfigurasi ringkas: satu aplikasi cukup tiga baris di Caddyfile.
  • Header proxy sudah benar dari awal: direktif reverse_proxy otomatis mengirim header X-Forwarded-For, X-Forwarded-Proto, dan X-Forwarded-Host ke aplikasi, serta mendukung koneksi WebSocket tanpa pengaturan khusus.
  • HTTP/3 aktif secara default: cukup buka port 443/udp.
  • Reload tanpa downtime: perubahan konfigurasi diterapkan tanpa memutus koneksi yang sedang berjalan.

Kekurangan Caddy

Supaya adil, Caddy juga punya beberapa keterbatasan:

  • Komunitas dan tutorialnya belum sebanyak Nginx: untuk kasus yang tidak umum, contoh konfigurasinya lebih sulit ditemukan.
  • Fitur tambahan butuh build khusus: beberapa fitur, misalnya DNS challenge untuk sertifikat wildcard, tersedia sebagai plugin yang harus di-build sendiri ke dalam Caddy.
  • Tidak mendeteksi container secara otomatis: berbeda dengan Traefik yang membaca label Docker, pada Caddy standar setiap aplikasi baru tetap perlu ditambahkan ke Caddyfile.

Sebagai perbandingan singkat dengan pilihan lain yang populer:

Caddy Nginx + Certbot Traefik Nginx Proxy Manager
Sertifikat HTTPS ✅ Otomatis, bawaan ⚠️ Lewat Certbot ✅ Otomatis, perlu dikonfigurasi ✅ Lewat antarmuka web
Cara konfigurasi Satu file Caddyfile File konfigurasi per situs Label di setiap container Antarmuka web
Cocok untuk Pemula hingga menengah Yang butuh kontrol penuh Banyak container yang sering berubah Yang tidak suka terminal

Jika anda lebih suka cara klasik tanpa Docker, panduan Nginx dan Certbot ada di artikel Cara Deploy Next.js ke VPS dengan PM2 dan Nginx.

Persiapan

Sebelum memulai, pastikan anda sudah memiliki:

  • VPS dengan Ubuntu 24.04 LTS atau 26.04 LTS dan alamat IP publik. Perintah di artikel ini ditujukan untuk kedua versi tersebut.
  • Docker Engine dan plugin Docker Compose yang sudah terpasang. Bila belum, ikuti dulu artikel Belajar Docker Compose.
  • Nama domain yang bisa anda atur DNS-nya.
  • Port 80 dan 443 yang masih kosong di VPS. Bila sebelumnya anda memasang Nginx atau Apache langsung di server, layanan itu harus dihentikan dulu.

Untuk memeriksa apakah port 80 dan 443 sedang dipakai, jalankan perintah berikut:

sudo ss -tlnp | grep -E ':(80|443)\s'

Jika tidak ada output sama sekali, berarti kedua port masih kosong dan siap dipakai Caddy.

Pada contoh di artikel ini, kita akan memakai alamat IP 203.0.113.10 serta domain whoami.example.com dan blog.example.com. Silakan ganti dengan IP dan domain anda sendiri.

Cara Memasang Caddy sebagai Reverse Proxy dengan Docker Compose

Gambaran susunan yang akan kita buat seperti ini: Caddy berjalan sebagai satu container yang membuka port 80 dan 443. Aplikasi lain tidak membuka port apa pun ke internet. Mereka cukup bergabung ke sebuah network Docker bersama bernama proxy, dan Caddy memanggil mereka lewat nama container-nya.

Langkah #1: Arahkan Domain ke IP VPS

Masuk ke panel DNS tempat domain anda dikelola, lalu buat A record untuk setiap subdomain yang akan dipakai:

Tipe Nama Nilai
A whoami 203.0.113.10
A blog 203.0.113.10

Langkah ini harus dilakukan sebelum Caddy dijalankan, karena Let's Encrypt akan memeriksa apakah domain tersebut benar-benar mengarah ke server anda.

Untuk memastikan DNS sudah aktif, periksa dengan perintah dig berikut. Bila perintahnya belum tersedia, pasang dulu dengan sudo apt install bind9-dnsutils -y.

dig +short whoami.example.com

Jika outputnya menampilkan alamat IP VPS anda, berarti DNS sudah siap. Bila masih kosong, tunggu beberapa menit lalu coba lagi.

Catatan: jika anda memakai Cloudflare, atur record tersebut ke mode DNS only (awan abu-abu) terlebih dahulu, agar permintaan dari Let's Encrypt langsung sampai ke Caddy.

Langkah #2: Buka Port 80 dan 443

Caddy membutuhkan port 80 dan 443 yang bisa diakses dari internet, baik untuk proses verifikasi sertifikat maupun untuk melayani pengunjung. Jika anda memakai UFW seperti di artikel Cara Mengamankan VPS Linux Baru, izinkan port tersebut dengan perintah berikut:

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp

Port 443/udp dipakai oleh HTTP/3. Port ini opsional, tetapi sayang bila tidak dibuka karena HTTP/3 sudah aktif secara default di Caddy.

Penting: banyak penyedia VPS memiliki firewall sendiri di dashboard mereka (sering disebut security group atau cloud firewall). Pastikan port 80 dan 443 juga diizinkan di sana.

Langkah #3: Buat Network Docker Bersama

Secara default, setiap project Compose memiliki network sendiri yang terisolasi. Agar Caddy bisa menjangkau aplikasi dari project lain, kita buat satu network bersama dengan perintah berikut:

docker network create proxy

Network ini cukup dibuat sekali. Nantinya, setiap aplikasi yang ingin dilayani Caddy tinggal bergabung ke network proxy.

Langkah #4: Tulis File compose.yaml untuk Caddy

Buat folder project untuk Caddy, lengkap dengan subfolder conf untuk menyimpan Caddyfile:

mkdir -p ~/apps/caddy/conf
cd ~/apps/caddy

Lalu buat file Compose-nya:

nano compose.yaml

Salin konfigurasi berikut:

services:
  caddy:
    image: caddy:2
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./conf:/etc/caddy
      - caddy_data:/data
      - caddy_config:/config
    networks:
      - proxy
 
  whoami:
    image: traefik/whoami
    restart: unless-stopped
    networks:
      - proxy
 
volumes:
  caddy_data:
  caddy_config:
 
networks:
  proxy:
    external: true

Simpan file dengan menekan Ctrl+X, lalu Y, dan Enter. Ada beberapa hal penting di file ini:

  • image: caddy:2: memakai image resmi Caddy versi 2 terbaru. Untuk server produksi, anda bisa mengunci ke versi minor, misalnya caddy:2.11.
  • ./conf:/etc/caddy: kita me-mount folder, bukan file Caddyfile secara langsung. Menurut dokumentasi image Caddy, editor seperti vim mengganti inode file saat menyimpan, sehingga perubahan pada file yang di-mount langsung tidak terbaca oleh container sampai container dibuat ulang.
  • caddy_data:/data: di sinilah Caddy menyimpan sertifikat dan private key. Volume ini wajib permanen. Jika hilang, Caddy harus meminta ulang semua sertifikat dan anda bisa terkena batas permintaan dari Let's Encrypt.
  • whoami: aplikasi kecil dari image traefik/whoami yang menampilkan informasi permintaan HTTP yang ia terima. Kita memakainya sebagai aplikasi uji. Perhatikan bahwa service ini tidak memiliki bagian ports, jadi ia hanya bisa diakses lewat Caddy.
  • external: true: memberi tahu Compose bahwa network proxy sudah ada (dibuat di langkah #3) dan tidak perlu dibuat lagi.

Langkah #5: Tulis Caddyfile

Sekarang buat file konfigurasi Caddy:

nano conf/Caddyfile

Isikan konfigurasi berikut, lalu ganti alamat email dan domainnya:

{
	email [email protected]
}
 
whoami.example.com {
	reverse_proxy whoami:80
}

Penjelasan singkatnya:

  • Blok paling atas tanpa nama adalah global options. Blok ini harus menjadi blok pertama di Caddyfile. Opsi email dipakai saat membuat akun di CA, dan sangat disarankan diisi agar anda bisa dihubungi bila ada masalah dengan sertifikat.
  • whoami.example.com { … } adalah blok situs. Karena alamatnya berupa nama domain publik, Caddy otomatis mengaktifkan HTTPS untuk domain tersebut.
  • reverse_proxy whoami:80 meneruskan semua permintaan ke container whoami pada port 80. Nama whoami di sini adalah nama service di compose.yaml, yang dikenali berkat network proxy.

Tips: saat masih bereksperimen, tambahkan baris acme_ca https://acme-staging-v02.api.letsencrypt.org/directory di dalam blok global options. Dengan begitu Caddy memakai server staging Let's Encrypt yang batasnya jauh lebih longgar. Sertifikat staging tidak dipercaya browser, jadi hapus baris itu dan lakukan reload setelah semuanya berjalan benar.

Langkah #6: Jalankan Caddy dan Uji HTTPS

Jalankan Caddy dan aplikasi uji di background dengan perintah berikut:

docker compose up -d

Begitu menyala, Caddy langsung meminta sertifikat untuk domain di Caddyfile. Proses ini biasanya hanya memakan waktu beberapa detik. Pantau prosesnya lewat log:

docker compose logs caddy | grep -i "certificate obtained"

Jika muncul baris yang berisi certificate obtained successfully beserta nama domain anda, berarti sertifikat sudah terpasang. Sekarang uji dari komputer mana pun dengan perintah berikut:

curl https://whoami.example.com

Outputnya kira-kira seperti ini:

Hostname: 3f2a9c1b7d4e
IP: 127.0.0.1
IP: 172.18.0.3
RemoteAddr: 172.18.0.2:41234
GET / HTTP/1.1
Host: whoami.example.com
User-Agent: curl/8.5.0
Accept: */*
Accept-Encoding: gzip
X-Forwarded-For: 198.51.100.25
X-Forwarded-Host: whoami.example.com
X-Forwarded-Proto: https

Perhatikan tiga baris terakhir. Itulah header yang ditambahkan Caddy secara otomatis, sehingga aplikasi di belakangnya tetap tahu alamat IP pengunjung yang asli dan tahu bahwa koneksinya memakai HTTPS. Coba juga buka http://whoami.example.com di browser, dan anda akan langsung dialihkan ke versi https://. Selesai!

Menambahkan Aplikasi dari Project Compose Lain

Aplikasi uji sudah berjalan. Sekarang pertanyaannya: bagaimana dengan aplikasi sungguhan yang berada di project Compose lain? Sebagai contoh, kita akan menghubungkan WordPress dari artikel Belajar Docker Compose ke Caddy.

Langkah #1: Hubungkan Aplikasi ke Network proxy

Buka compose.yaml milik project WordPress, lalu ubah service wordpress dan tambahkan bagian networks di paling bawah. Contoh di bawah ini hanya menampilkan bagian yang berubah. Baris lain yang sudah ada (variabel database, depends_on, volumes, serta service db) jangan dihapus:

services:
  wordpress:
    image: wordpress:latest
    restart: unless-stopped
    environment:
      WORDPRESS_CONFIG_EXTRA: |
        define('WP_HOME', 'https://blog.example.com');
        define('WP_SITEURL', 'https://blog.example.com');
    networks:
      - default
      - proxy
 
networks:
  proxy:
    external: true

Ada tiga perubahan yang perlu diperhatikan:

  • Bagian ports dihapus: WordPress tidak perlu lagi membuka port 8080, karena semua akses kini lewat Caddy.
  • networks berisi default dan proxy: begitu anda menulis networks secara eksplisit, service tidak lagi otomatis masuk ke network default. Tanpa baris default, WordPress tidak bisa lagi menghubungi database db. Service db sendiri tidak perlu masuk ke network proxy.
  • WORDPRESS_CONFIG_EXTRA: WordPress menyimpan alamat situsnya di database. Bila sebelumnya WordPress di-install lewat http://IP-SERVER:8080, dua baris ini memaksanya memakai alamat domain yang baru. Variabel ini didukung oleh image resmi WordPress.

Terapkan perubahan dari folder project WordPress dengan perintah berikut:

docker compose up -d

Langkah #2: Tambahkan Blok Situs di Caddyfile

Kembali ke folder ~/apps/caddy, buka conf/Caddyfile, lalu tambahkan blok baru di bagian bawah:

blog.example.com {
	reverse_proxy wordpress:80
}

Sebelum diterapkan, periksa dulu apakah ada kesalahan penulisan dengan perintah berikut:

docker compose exec -w /etc/caddy caddy caddy validate

Jika baris terakhir outputnya adalah Valid configuration, konfigurasi aman untuk diterapkan.

Langkah #3: Reload Caddy Tanpa Downtime

Terapkan konfigurasi baru dengan perintah reload berikut:

docker compose exec -w /etc/caddy caddy caddy reload

Kata caddy memang ditulis dua kali: yang pertama adalah nama service di Compose, yang kedua adalah perintah caddy di dalam container. Opsi -w /etc/caddy membuat perintah dijalankan dari folder tempat Caddyfile berada, sehingga Caddy langsung menemukannya.

Caddy akan meminta sertifikat untuk blog.example.com, dan dalam beberapa detik WordPress anda sudah bisa dibuka lewat https://blog.example.com. Situs lain yang sedang dilayani tidak terganggu sama sekali.

Untuk aplikasi berikutnya, polanya selalu sama: buat A record, hubungkan container ke network proxy, tambahkan tiga baris di Caddyfile, lalu reload.

Catatan: nama service harus unik di dalam network proxy. Jika dua project sama-sama memiliki service bernama app, Caddy bisa diarahkan ke container yang salah. Beri nama service yang spesifik (misalnya wordpress, uptime-kuma), atau pakai nama container lengkapnya seperti wordpress-compose-wordpress-1.

Tips Konfigurasi Caddyfile

Tip #1: Lindungi Aplikasi dengan Basic Auth

Beberapa aplikasi internal tidak memiliki halaman login sendiri. Anda bisa menambahkan lapisan password di Caddy dengan direktif basic_auth. Pertama, buat hash password dengan perintah berikut, lalu ketik password anda saat diminta:

docker compose exec caddy caddy hash-password

Salin hash yang dihasilkan (diawali $2a$), lalu pakai di blok situs seperti ini:

whoami.example.com {
	basic_auth {
		budi $2a$14$GANTI-DENGAN-HASH-ANDA
	}
	reverse_proxy whoami:80
}

Caddy tidak menerima password dalam bentuk teks biasa, jadi langkah hash di atas wajib dilakukan.

Catatan: pada tutorial lama, direktif ini ditulis basicauth (tanpa garis bawah). Namanya diubah menjadi basic_auth sejak Caddy v2.8.0.

Tip #2: Aktifkan Kompresi

Agar halaman dikirim lebih cepat, aktifkan kompresi dengan menambahkan satu baris encode di blok situs:

blog.example.com {
	encode zstd gzip
	reverse_proxy wordpress:80
}

Tip #3: Alihkan www ke Domain Utama

Bila anda ingin www.example.com otomatis dialihkan ke example.com, tambahkan blok terpisah dengan direktif redir:

www.example.com {
	redir https://example.com{uri} permanent
}

Jangan lupa membuat A record untuk www juga, karena Caddy tetap perlu sertifikat untuk domain tersebut.

Tip #4: Rapikan Caddyfile dengan caddy fmt

Jika log Caddy menampilkan peringatan Caddyfile input is not formatted, itu bukan error. Caddy hanya menyarankan format penulisan yang baku. Rapikan secara otomatis dengan perintah berikut:

docker compose exec -w /etc/caddy caddy caddy fmt --overwrite

Troubleshooting: Masalah yang Sering Muncul

Sertifikat Gagal Diterbitkan

Ini masalah yang paling sering terjadi. Lihat pesan error-nya di log dengan perintah berikut:

docker compose logs --tail 50 caddy

Penyebab yang umum:

  • DNS belum mengarah ke VPS: periksa lagi dengan dig +short.
  • Ada AAAA record (IPv6) yang salah: jika domain memiliki AAAA record yang tidak mengarah ke VPS anda, verifikasi bisa gagal walaupun A record-nya sudah benar. Hapus atau perbaiki record tersebut.
  • Port 80 atau 443 tertutup: periksa UFW dan firewall di dashboard penyedia VPS.
  • Proxy Cloudflare masih aktif: ubah ke DNS only terlebih dahulu.

Jangan terus-menerus me-restart Caddy saat sertifikat gagal. Menurut dokumentasi rate limit Let's Encrypt, saat artikel ini ditulis batasnya adalah 5 kali gagal validasi per domain per jam dan 5 sertifikat untuk kumpulan domain yang sama per 7 hari. Perbaiki dulu penyebabnya, atau pakai server staging seperti pada tips di langkah #5.

Muncul 502 Bad Gateway

Artinya Caddy berjalan, tetapi tidak bisa menghubungi aplikasi di belakangnya. Periksa tiga hal berikut:

  1. Container aplikasinya memang sedang berjalan (docker compose ps di folder project-nya).
  2. Container tersebut sudah bergabung ke network proxy. Cek dengan docker network inspect proxy.
  3. Nama service dan port internal di reverse_proxy sudah benar. Yang dipakai adalah port di dalam container (misalnya 80), bukan port yang dulu di-publish ke host (misalnya 8080).

reverse_proxy ke localhost Tidak Berfungsi

Di dalam container, localhost berarti container Caddy itu sendiri, bukan VPS anda. Jadi reverse_proxy localhost:3000 tidak akan menemukan aplikasi yang berjalan langsung di host.

Cara termudah adalah menjalankan aplikasinya sebagai container di network proxy. Bila aplikasi harus tetap berjalan di host, tambahkan baris berikut pada service caddy di compose.yaml, lalu pakai reverse_proxy host.docker.internal:3000:

    extra_hosts:
      - "host.docker.internal:host-gateway"

Perlu diingat, aplikasi di host harus menerima koneksi dari network Docker (tidak hanya dari 127.0.0.1), dan firewall harus mengizinkannya. Untuk aplikasi yang sepenuhnya berjalan di host, reverse proxy yang juga dipasang langsung di host biasanya lebih sederhana.

Port 80 atau 443 Sudah Dipakai

Jika docker compose up -d gagal dengan pesan address already in use, berarti ada layanan lain yang memakai port tersebut, biasanya Nginx atau Apache. Cari tahu dengan perintah ss di bagian Persiapan, lalu hentikan layanan itu, misalnya dengan sudo systemctl disable --now nginx.

Kesimpulan

Dari artikel ini, kita dapat menyimpulkan bahwa Caddy adalah salah satu cara termudah untuk memasang reverse proxy dengan HTTPS di depan aplikasi Docker. Cukup satu container, satu network bersama, dan tiga baris Caddyfile untuk setiap aplikasi. Urusan sertifikat, perpanjangan, dan redirect ke HTTPS dikerjakan sendiri oleh Caddy.

Yang Perlu Diingat

  • Arahkan DNS ke VPS dan buka port 80 serta 443 sebelum menjalankan Caddy.
  • Simpan folder /data di named volume, karena di sanalah sertifikat disimpan.
  • Mount folder konfigurasi, bukan file Caddyfile secara langsung.
  • Aplikasi di belakang Caddy tidak perlu bagian ports. Cukup bergabung ke network proxy.
  • Pakai caddy validate sebelum caddy reload.
  • Saat bereksperimen, pakai server staging Let's Encrypt agar tidak terkena rate limit.

Siapa yang Cocok Menggunakan?

Caddy cocok untuk anda yang menjalankan beberapa aplikasi self-hosted di satu VPS dan ingin HTTPS yang "tinggal jalan" tanpa banyak perawatan. Jika anda membutuhkan konfigurasi yang sangat spesifik atau sudah terbiasa dengan Nginx, tetap memakai Nginx juga bukan pilihan yang salah.

Punya pertanyaan atau kendala saat mencoba? Jangan ragu untuk bertanya. Tetap pantau terus web Teknotut!


Semoga artikel ini membantu.

Bacaan Selanjutnya

Artikel lain yang mungkin menarik buatmu.