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
80dan443yang 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, danapp.example.combisa 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 kehttps://tanpa konfigurasi tambahan. - Konfigurasi ringkas: satu aplikasi cukup tiga baris di
Caddyfile. - Header proxy sudah benar dari awal: direktif
reverse_proxyotomatis mengirim headerX-Forwarded-For,X-Forwarded-Proto, danX-Forwarded-Hostke 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.comJika 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/udpPort 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 proxyNetwork 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/caddyLalu buat file Compose-nya:
nano compose.yamlSalin 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: trueSimpan 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, misalnyacaddy:2.11../conf:/etc/caddy: kita me-mount folder, bukan fileCaddyfilesecara langsung. Menurut dokumentasi image Caddy, editor sepertivimmengganti 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 imagetraefik/whoamiyang menampilkan informasi permintaan HTTP yang ia terima. Kita memakainya sebagai aplikasi uji. Perhatikan bahwa service ini tidak memiliki bagianports, jadi ia hanya bisa diakses lewat Caddy.external: true: memberi tahu Compose bahwa networkproxysudah ada (dibuat di langkah #3) dan tidak perlu dibuat lagi.
Langkah #5: Tulis Caddyfile
Sekarang buat file konfigurasi Caddy:
nano conf/CaddyfileIsikan 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. Opsiemaildipakai 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:80meneruskan semua permintaan ke containerwhoamipada port 80. Namawhoamidi sini adalah nama service dicompose.yaml, yang dikenali berkat networkproxy.
Tips: saat masih bereksperimen, tambahkan baris
acme_ca https://acme-staging-v02.api.letsencrypt.org/directorydi 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 -dBegitu 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.comOutputnya 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: httpsPerhatikan 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: trueAda tiga perubahan yang perlu diperhatikan:
- Bagian
portsdihapus: WordPress tidak perlu lagi membuka port8080, karena semua akses kini lewat Caddy. networksberisidefaultdanproxy: begitu anda menulisnetworkssecara eksplisit, service tidak lagi otomatis masuk ke networkdefault. Tanpa barisdefault, WordPress tidak bisa lagi menghubungi databasedb. Servicedbsendiri tidak perlu masuk ke networkproxy.WORDPRESS_CONFIG_EXTRA: WordPress menyimpan alamat situsnya di database. Bila sebelumnya WordPress di-install lewathttp://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 -dLangkah #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 validateJika 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 reloadKata 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 bernamaapp, Caddy bisa diarahkan ke container yang salah. Beri nama service yang spesifik (misalnyawordpress,uptime-kuma), atau pakai nama container lengkapnya sepertiwordpress-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-passwordSalin 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 menjadibasic_authsejak 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 --overwriteTroubleshooting: 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 caddyPenyebab 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:
- Container aplikasinya memang sedang berjalan (
docker compose psdi folder project-nya). - Container tersebut sudah bergabung ke network
proxy. Cek dengandocker network inspect proxy. - Nama service dan port internal di
reverse_proxysudah benar. Yang dipakai adalah port di dalam container (misalnya80), bukan port yang dulu di-publish ke host (misalnya8080).
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
/datadi named volume, karena di sanalah sertifikat disimpan. - Mount folder konfigurasi, bukan file
Caddyfilesecara langsung. - Aplikasi di belakang Caddy tidak perlu bagian
ports. Cukup bergabung ke networkproxy. - Pakai
caddy validatesebelumcaddy 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!
Resources dan Link Berguna
- Dokumentasi resmi Caddy
- Panduan Automatic HTTPS di Caddy
- Referensi direktif reverse_proxy
- Image resmi Caddy di Docker Hub
- Rate limit Let's Encrypt
Semoga artikel ini membantu.



