Reverse proxy dengan Caddy dan HTTPS otomatis
Memasang Caddy sebagai reverse proxy di depan aplikasi web, mendapatkan sertifikat Let's Encrypt otomatis, mengarahkan domain kedua, menambahkan header keamanan, dan meneruskan IP asli klien.
- published
- reading time
- 3 min
Hampir setiap aplikasi web yang di-deploy di VPS butuh reverse proxy: komponen di depan aplikasi yang menerima koneksi HTTPS dari internet, mengurus sertifikat TLS, lalu meneruskan permintaan ke aplikasi yang berjalan di port lokal. Selama bertahun-tahun, pilihan standarnya adalah Nginx dengan Certbot.
Caddy menawarkan pendekatan yang lebih sederhana. HTTPS aktif secara otomatis tanpa konfigurasi tambahan, sertifikat diperbarui sendiri, dan file konfigurasinya sering hanya beberapa baris. Artikel ini membahas cara memakai Caddy untuk skenario paling umum: satu VPS, satu atau beberapa domain, aplikasi berjalan di Docker atau langsung di host.
Prasyarat
- VPS dengan IP publik dan port 80 serta 443 terbuka.
- Domain dengan record DNS
A(danAAAAjika memakai IPv6) yang mengarah ke IP VPS. - Aplikasi yang sudah berjalan di port lokal, misalnya
127.0.0.1:3000.
Port 80 tetap dibutuhkan meskipun semua trafik akan memakai HTTPS. Let's Encrypt memakai port 80 untuk verifikasi kepemilikan domain (HTTP-01 challenge), dan Caddy memakainya untuk mengarahkan pengunjung HTTP ke HTTPS.
Instalasi
Caddy tersedia sebagai paket resmi untuk Debian dan Ubuntu melalui repository yang dijelaskan di halaman instalasi dokumentasi Caddy. Ikuti perintah di sana agar Anda mendapat versi terbaru dan update otomatis lewat apt. Setelah terpasang, Caddy berjalan sebagai layanan systemd dan membaca konfigurasi dari /etc/caddy/Caddyfile.
Periksa statusnya:
systemctl status caddy
caddy versionKonfigurasi paling sederhana
contoh.com {
reverse_proxy 127.0.0.1:3000
}Dua baris itu sudah cukup untuk:
- Mendapatkan sertifikat TLS dari Let's Encrypt (atau ZeroSSL sebagai cadangan).
- Memperbarui sertifikat otomatis sebelum kedaluwarsa.
- Mengarahkan semua permintaan HTTP ke HTTPS.
- Meneruskan permintaan ke aplikasi di port 3000.
- Mengaktifkan HTTP/2 dan HTTP/3.
Terapkan perubahan:
caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddySelalu jalankan validate terlebih dahulu. Kesalahan ketik yang lolos ke reload tidak akan mematikan Caddy, tapi konfigurasi baru juga tidak diterapkan, dan Anda mungkin tidak menyadarinya.
Mengarahkan domain kedua dan www
Banyak situs punya beberapa domain, misalnya .com dan .id, plus varian www. Pilih satu sebagai domain utama (canonical) dan arahkan sisanya dengan redirect permanen. Ini penting untuk SEO, agar mesin pencari tidak menganggapnya sebagai konten duplikat.
contoh.com {
reverse_proxy 127.0.0.1:3000
}
www.contoh.com, contoh.id, www.contoh.id {
redir https://contoh.com{uri} permanent
}Placeholder {uri} mempertahankan path dan query string, sehingga contoh.id/blog/artikel?x=1 diarahkan ke contoh.com/blog/artikel?x=1. Caddy tetap mengambil sertifikat untuk setiap domain di blok redirect, karena pengunjung bisa saja mengakses https://contoh.id secara langsung.
Kompresi dan header keamanan
contoh.com {
encode zstd gzip
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
Referrer-Policy "strict-origin-when-cross-origin"
X-Frame-Options "SAMEORIGIN"
-Server
}
reverse_proxy 127.0.0.1:3000
}encodemengompresi respons teks, menghemat bandwidth dan mempercepat halaman.Strict-Transport-Security(HSTS) memberi tahu browser untuk selalu memakai HTTPS. Aktifkan hanya setelah yakin semua subdomain mendukung HTTPS, karena browser akan mengingatnya selama satu tahun.-Servermenghapus header yang menyebut nama software server.
Jika situs menampilkan iklan atau konten pihak ketiga, hati-hati menambahkan Content-Security-Policy. CSP yang terlalu ketat bisa memblokir script iklan dan analitik. Mulailah dengan mode Content-Security-Policy-Report-Only jika ingin menerapkannya.
IP asli klien
Saat berada di belakang reverse proxy, aplikasi melihat semua permintaan berasal dari 127.0.0.1. Caddy otomatis menambahkan header X-Forwarded-For, X-Forwarded-Proto, dan X-Forwarded-Host saat meneruskan permintaan. Aplikasi perlu dikonfigurasi untuk mempercayai header tersebut hanya dari proxy.
Ini penting untuk keamanan. Jika aplikasi bisa diakses langsung tanpa melalui Caddy, siapa pun bisa memalsukan X-Forwarded-For dan, misalnya, menghindari pembatasan login per IP. Karena itu, pastikan aplikasi hanya mendengarkan di 127.0.0.1 atau jaringan internal yang tidak bisa dijangkau dari luar.
Jika Caddy sendiri berada di belakang CDN seperti Cloudflare, atur trusted_proxies di blok opsi global agar Caddy mengambil IP asli dari header yang dikirim CDN, bukan IP server CDN.
Beberapa aplikasi di satu server
contoh.com {
reverse_proxy 127.0.0.1:3000
}
api.contoh.com {
reverse_proxy 127.0.0.1:8080
}
status.contoh.com {
reverse_proxy 127.0.0.1:3001
}Setiap subdomain mendapat sertifikat sendiri secara otomatis. Anda juga bisa memakai path, misalnya handle_path /api/* untuk meneruskan sebagian path ke layanan berbeda, tapi subdomain biasanya lebih mudah dikelola.
Caddy di Docker
Jika semua layanan berjalan di Docker Compose, Caddy bisa ikut menjadi salah satu layanan. Hal yang wajib diperhatikan: direktori data Caddy (/data) harus disimpan di volume. Di sana sertifikat dan akun ACME disimpan. Tanpa volume, setiap kali container dibuat ulang, Caddy meminta sertifikat baru, dan Anda bisa terkena rate limit Let's Encrypt.
caddy:
image: caddy:2
restart: unless-stopped
ports:
- "80:80"
- "443:443"
- "443:443/udp"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
- caddy_config:/configDi dalam jaringan Compose, gunakan nama layanan sebagai tujuan, misalnya reverse_proxy app:3000.
Diagnosis masalah sertifikat
Jika situs tidak bisa diakses lewat HTTPS, periksa log:
journalctl -u caddy --since "10 min ago"Penyebab paling umum:
- DNS belum mengarah ke server. Periksa dengan
dig +short contoh.com. - Port 80 atau 443 diblokir oleh firewall VPS atau security group penyedia cloud.
- Proxy CDN aktif dengan mode SSL yang tidak sesuai. Untuk Cloudflare, gunakan mode Full (strict).
- Terkena rate limit karena terlalu sering mencoba. Tunggu, lalu gunakan endpoint staging Let's Encrypt saat bereksperimen.
Penutup
Caddy menghilangkan sebagian besar pekerjaan rutin seputar HTTPS. Tidak ada cron untuk memperbarui sertifikat, tidak ada konfigurasi TLS yang harus disalin dari blog lain, dan tidak ada risiko sertifikat kedaluwarsa karena lupa. Waktu yang tersisa bisa dipakai untuk hal yang lebih penting: memastikan aplikasi di belakangnya aman dan berjalan dengan baik.