Panduan Lengkap Kode Kesalahan Proxy dan Cara Mengatasinya

Setiap engineer yang menjalankan platform SaaS, alur kerja e-commerce, atau tumpukan analitik di AS pasti pernah menemui kendala di titik tertentu — permintaan gagal, lalu lintas turun, dan log menampilkan kode tiga digit yang membingungkan. Memahami arti dari setiap kode adalah perbedaan antara perbaikan lima menit dan pemadaman tiga jam. Panduan ini membahas diagnosis kesalahan proxy dari prinsip dasar, sehingga infrastruktur Anda tetap stabil dan tim Anda tidak perlu lagi menebak-nebak.

Apa arti kode kesalahan proxy

Kesalahan proxy adalah kode respons yang dihasilkan ketika permintaan melewati server perantara — proxy — dan sesuatu rusak di sepanjang jalur tersebut. Kode proxy ini mengikuti konvensi kode status HTTP yang sama yang digunakan di seluruh web, tetapi membawa konteks tambahan: kode tersebut memberi tahu Anda di mana dalam siklus hidup permintaan kegagalan itu terjadi, bukan hanya bahwa kegagalan itu terjadi.

Arti kesalahan proxy menjadi lebih jelas ketika Anda memetakannya ke aliran permintaan. Klien mengirim permintaan → proxy mencegatnya → proxy meneruskan ke server hulu (upstream) → respons kembali. Setiap lompatan dapat gagal secara independen, dan setiap jenis kegagalan menghasilkan kode yang berbeda.

Ikhtisar siklus hidup permintaan:

• Klien memulai permintaan
• Proxy menerima dan memvalidasi permintaan
• Proxy mengautentikasi dan menerapkan aturan akses
• Proxy meneruskan ke server target
• Server hulu merespons
• Proxy mengembalikan respons ke klien

Klasifikasi kesalahan proxy

Tidak semua kegagalan itu sama. Beberapa ada di sisi klien — header buruk, kredensial salah, token hilang. Yang lain menunjuk ke server hulu Anda, topologi jaringan Anda, atau protokol yang tidak cocok. Mengelompokkannya dengan benar adalah langkah pertama menuju resolusi yang lebih cepat.

Jika kesalahan proxy yang sama berulang di beberapa endpoint, masalahnya hampir pasti berada di tingkat konfigurasi atau perutean.

Memahami lapisan mana yang memiliki masalah menghemat waktu diagnosis yang signifikan. Kesalahan koneksi proxy terlihat sangat berbeda dari kesalahan autentikasi proxy, dan memperlakukan satu sebagai yang lain hanya membuang waktu selama berjam-jam.

Penjelasan kesalahan proxy 4xx

Rentang 4xx merujuk pada masalah yang berasal dari lapisan klien atau lapisan kontrol akses. Kode ini biasanya paling cepat didiagnosis dan diperbaiki, karena tidak memerlukan penyentuhan infrastruktur server Anda — hanya konfigurasi permintaan atau pengaturan autentikasi Anda.

Memahami arti kesalahan proxy membantu engineer membedakan antara kesalahan konfigurasi klien dan kegagalan hulu yang sebenarnya.

Kesalahan 400 dan 401

Kesalahan 400 — permintaan buruk (bad request) — berarti proxy menerima sesuatu yang tidak dapat diuraikan (parse). Pemicu umum termasuk header yang cacat, pengkodean (encoding) yang salah, atau versi HTTP yang tidak didukung. Permintaan itu sendiri adalah masalahnya, bukan servernya.

Kesalahan proxy berarti server perantara mengalami masalah saat memproses atau meneruskan permintaan Anda.

Kesalahan 401 menandakan kredensial hilang atau tidak valid. Proxy atau server hulu memerlukan autentikasi, dan apa yang dikirim entah tidak ada atau tidak lulus validasi. Ini adalah kesalahan autentikasi proxy dalam pengertian luas — sesi tidak memiliki identitas yang dikenali yang melekat padanya.

Jika Anda bertanya apa itu kesalahan proxy, jawaban singkatnya adalah: ini adalah kode status yang dibuat ketika server proxy gagal menyelesaikan permintaan atas nama klien.

Kesalahan 403 dan 407

403 berarti akses ditolak — identitas dikenali tetapi tidak memiliki izin. Ini biasanya mencerminkan kebijakan akses yang ditetapkan di tingkat proxy: daftar putih IP, pembatasan geografis, atau aturan berbasis peran. Permintaan mencapai proxy, autentikasi mungkin telah lolos, tetapi kebijakan memblokirnya.

407 secara khusus adalah kesalahan autentikasi proxy diperlukan. Berbeda dengan 401, yang berlaku untuk server asal, 407 memberi tahu klien bahwa proxy itu sendiri memerlukan kredensial sebelum meneruskan apa pun. Ini umum terjadi di lingkungan perusahaan dan pengaturan jaringan korporat di mana proxy bertindak sebagai gerbang.

Kesalahan proxy terbagi dalam dua kategori besar — yang disebabkan oleh konfigurasi klien yang buruk dan yang disebabkan oleh masalah infrastruktur hulu.

Cara memperbaiki kesalahan 4xx

Mulailah dengan permintaan itu sendiri sebelum menyentuh konfigurasi server apa pun. Sebagian besar masalah 4xx terselesaikan di tingkat klien atau kredensial.

Daftar periksa diagnosis:

• Verifikasi bahwa header permintaan diformat dengan benar dan lengkap
• Konfirmasikan token autentikasi ada, valid, dan tidak kedaluwarsa
• Periksa apakah IP klien ada di daftar putih yang diotorisasi
• Tinjau kebijakan akses proxy untuk pembatasan peran atau geografis
• Uji endpoint secara langsung, dengan melewati proxy, untuk mengisolasi lapisan kegagalan
• Untuk kesalahan 407, pastikan kredensial proxy diteruskan secara terpisah dari kredensial asal

Penjelasan kesalahan proxy 5xx

Kelas 5xx adalah tempat keadaan menjadi lebih serius. Kode-kode ini menunjukkan bahwa proxy atau server hulu mengalami kegagalan yang tidak dapat ditanganinya. Klien mengirim permintaan yang valid — masalahnya terletak di sisi infrastruktur.

Sebagian besar kesalahan proxy di lingkungan produksi dapat dicegah dengan pengaturan autentikasi dan konfigurasi DNS yang benar.

Kesalahan 500 dan 502

500 adalah kesalahan server internal umum. Server hulu menerima permintaan tetapi gagal memprosesnya. Ini bisa berupa proses yang crash, pengecualian yang tidak tertangani, atau aplikasi yang salah dikonfigurasi. Log di server hulu adalah alat diagnostik utama di sini.

Kesalahan proxy berulang pada endpoint yang sama biasanya menunjukkan masalah struktural daripada gangguan sementara.

Kesalahan gerbang buruk (bad gateway) 502 berarti proxy menerima respons dari server hulu, tetapi respons tersebut tidak valid atau tidak lengkap. Ini adalah kesalahan gerbang proxy klasik — server hulu mungkin kelebihan beban, mati sebagian, atau mengembalikan data yang cacat. Jika hulu Anda berupa kluster, 502 sering kali menunjukkan satu atau lebih node tidak sehat.

Apa itu kesalahan proxy, tepatnya? Ini adalah sinyal dari lapisan proxy bahwa sesuatu rusak antara permintaan klien dan respons server — dan selalu menunjuk ke lapisan tumpukan tertentu.

Kesalahan 503 dan 504

Layanan 503 tidak tersedia berarti server hulu untuk sementara tidak dapat menangani permintaan — biasanya karena kelebihan beban atau jendela pemeliharaan terjadwal. Server dapat dijangkau tetapi menolak koneksi karena kapasitas sudah habis.

Kesalahan proxy dapat muncul di titik mana pun dalam rantai permintaan — dari resolusi DNS hingga pengiriman respons hulu.

Waktu tunggu gerbang 504 terjadi ketika proxy meneruskan permintaan tetapi server hulu membutuhkan waktu terlalu lama untuk merespons. Ini adalah kesalahan waktu tunggu (timeout) proxy: proxy berhenti menunggu dan mengembalikan 504 ke klien. Latensi tinggi, kueri basis data yang lambat, atau kemacetan jaringan antara proxy dan hulu adalah penyebab umum.

Perbaikan infrastruktur untuk kesalahan 5xx

Memperbaiki kesalahan 5xx memerlukan melihat ke luar proxy itu sendiri. Proxy biasanya hanya kurir — akar masalahnya ada pada perutean, distribusi beban, atau kapasitas hulu.

Langkah-langkah resolusi:

• Periksa log server hulu segera untuk pengecualian atau kegagalan proses
• Tinjau pemeriksaan kesehatan penyeimbang beban (load balancer) — hapus node yang tidak sehat dari rotasi
• Ukur waktu respons antara proxy dan hulu di baseline vs. selama insiden
• Skalakan kapasitas hulu secara horizontal jika beban adalah pemicunya
• Sesuaikan ambang batas waktu tunggu proxy jika proses hulu benar-benar lambat

Kesalahan terkait jaringan dan DNS

Tidak semua kegagalan proxy muncul sebagai kode HTTP yang bersih. Beberapa terjadi bahkan sebelum HTTP memasuki gambaran — di tingkat jaringan atau DNS. Ini sering kali paling sulit dilacak karena tidak menghasilkan respons status standar.

Langkah pertama saat Anda mengalami kesalahan proxy adalah memeriksa apakah masalahnya ada di sisi klien atau sisi infrastruktur.

Daftar periksa diagnosis jaringan:

• ✅ Periksa konfigurasi DNS — konfirmasikan nama host hulu dapat diselesaikan dengan benar dari lingkungan proxy
• ✅ Verifikasi ketersediaan port — pastikan port target terbuka dan tidak diblokir oleh aturan firewall
• ✅ Pantau kehilangan paket — kehilangan paket yang berkelanjutan antara proxy dan hulu menyebabkan waktu tunggu berantai
• ❌ Abaikan lonjakan latensi — peningkatan latensi singkat sekalipun dapat memicu 504 hilir dan reset koneksi
• 💡 Gunakan traceroute dan dig dari host proxy itu sendiri, bukan dari mesin lokal Anda — jalur jaringan berbeda

Masalah autentikasi dan otorisasi IP

Sebagian besar kesalahan proxy yang berulang melacak kembali ke konfigurasi autentikasi dan otorisasi, bukan kegagalan server. Token kedaluwarsa, kredensial salah, atau alamat IP yang belum ditambahkan ke daftar terotorisasi semuanya menghasilkan kesalahan yang terlihat seperti masalah akses tetapi sebenarnya adalah masalah pengaturan.

Kesalahan akses proxy ditolak akibat kegagalan otorisasi IP sangat umum terjadi dalam alur kerja otomatis. Penyebaran baru mungkin berjalan dari IP yang berbeda, atau instans cloud ditetapkan ulang — dan tiba-tiba permintaan yang berhasil kemarin diblokir hari ini.

Mencatat setiap kesalahan proxy dengan stempel waktu dan metadata permintaan membuat diagnosis masa depan jauh lebih cepat.

Daftar periksa pemecahan masalah autentikasi langkah demi langkah:

• Verifikasi kredensial — konfirmasikan nama pengguna, kata sandi, atau kunci API cocok dengan apa yang diharapkan oleh proxy
• Konfirmasikan otorisasi IP — periksa bahwa IP asal ada di daftar putih proxy
• Mulai ulang sesi — beberapa status autentikasi kedaluwarsa secara senyap; sesi baru menyelesaikannya
• Tinjau log akses — log proxy akan menunjukkan apakah permintaan mencapai lapisan otentikasi atau diblokir sebelumnya

Masalah waktu tunggu dan latensi proxy

Waktu tunggu tidak selalu disebabkan oleh kegagalan server. Terkadang permintaan proxy gagal karena hulu terlalu lambat — bukan mati. Hubungan antara latensi dan tingkat kesalahan bersifat langsung: saat waktu respons meningkat, kesalahan waktu tunggu berlipat ganda.

Memahami profil latensi Anda membantu Anda membedakan perlambatan sementara dari hambatan struktural.

Kesalahan konfigurasi umum

Banyak kesalahan proxy yang terlihat seperti masalah infrastruktur sebenarnya adalah kesalahan konfigurasi yang dibuat selama pengaturan atau penyebaran. Masalah ini dapat diulang, diprediksi, dan dihindari setelah Anda mengetahui polanya.

Masalah yang paling sering terjadi termasuk menggunakan port yang salah — mengirim lalu lintas HTTPS ke port 80, misalnya, atau HTTP ke 443. Ketidakcocokan protokol adalah pemicu umum lainnya: proxy yang dikonfigurasi untuk HTTP/1.1 menerima permintaan HTTP/2 tanpa negosiasi. Kebingungan proxy SOCKS vs. HTTP sangat umum terjadi di lingkungan campuran di mana alat yang berbeda mengharapkan jenis proxy yang berbeda.

Cakupan autentikasi yang salah juga layak diperiksa. Beberapa konfigurasi meneruskan kredensial proxy ke server asal dan kredensial asal ke proxy — keduanya gagal secara senyap dengan cara yang terlihat seperti kesalahan yang tidak terkait.

Satu kesalahan proxy selama jendela lalu lintas tinggi dapat memicu kegagalan berantai di seluruh layanan yang bergantung.

Perbandingan kesalahan sementara vs struktural

Mengetahui apakah suatu kesalahan bersifat sementara atau struktural akan mengubah respons Anda sepenuhnya. Kesalahan sementara terselesaikan dengan sendirinya atau dengan percobaan ulang yang sederhana. Kesalahan struktural akan terus berulang sampai penyebab utamanya diatasi.

Praktik terbaik logging dan pemantauan

Anda tidak dapat memperbaiki apa yang tidak dapat Anda lihat. Diagnosis kesalahan proxy tanpa log yang tepat hanyalah tebakan. Pemantauan yang baik tidak hanya memberi tahu Anda saat ada sesuatu yang rusak — tetapi juga memberi Anda konteks untuk memahami alasannya.

Tangkap metadata permintaan di lapisan proxy: stempel waktu, IP klien, target hulu, kode respons, dan latensi. Simpan ini dalam format terstruktur yang dapat Anda kueri. Korelasikan log proxy dengan log server hulu — 502 di sisi proxy harus memetakan ke entri yang sesuai di hulu.

Tidak setiap kesalahan proxy memerlukan perubahan infrastruktur — beberapa dapat diselesaikan hanya dengan memperbaiki header permintaan.

"Pemadaman paling mahal adalah yang Anda ketahui dari pelanggan. Yang kedua paling mahal adalah yang di mana Anda memiliki log tetapi tidak dapat membacanya cukup cepat." — sentimen yang dibagikan oleh sebagian besar tim infrastruktur yang pernah mengalami insiden serius.

💡 Rekomendasi pemantauan:

• Atur peringatan pada ambang batas tingkat 5xx, bukan hanya hitungan absolut — lonjakan tiba-tiba lebih penting daripada angka mentah
• Lacak persentil latensi (P95, P99), bukan hanya rata-rata — rata-rata menyembunyikan kasus terburuk
• Catat kegagalan autentikasi secara terpisah dari kesalahan 4xx lainnya — semuanya menunjukkan masalah yang berbeda
• Simpan log proxy setidaknya selama 30 hari untuk retrospektif insiden

Kerangka kerja pemecahan masalah langkah demi langkah

Saat kesalahan muncul, pendekatan terstruktur mengalahkan investigasi acak. Kerjakan langkah-langkah ini secara berurutan dan berhenti saat Anda mengidentifikasi akar masalahnya.

• Identifikasi kodenya — catat kode kesalahan dan stempel waktu yang tepat; periksa apakah itu terisolasi atau meluas
• Periksa konfigurasi — tinjau pengaturan proxy: port, protokol, kredensial, dan daftar putih IP
• Uji endpoint — kirim permintaan langsung ke hulu, melewati proxy, untuk mengonfirmasi bahwa endpoint dapat dijangkau dan merespons dengan benar
• Ukur latensi — bandingkan waktu respons saat ini dengan baseline Anda; lonjakan latensi tanpa perubahan kode menunjuk ke masalah hulu atau jaringan
• Eskalasi jika persisten — jika kesalahan berulang setelah pemeriksaan konfigurasi dan tinjauan latensi, eskalasikan ke infrastruktur atau tim dukungan penyedia proxy dengan log terlampir

Studi kasus: mengurangi kesalahan proxy yang berulang di platform SaaS AS

Masalah: Perusahaan SaaS menengah yang menjalankan alur kerja analitik di AS melihat lonjakan berulang kesalahan 502 dan 504 setiap hari kerja antara jam 9 pagi dan 11 pagi Waktu Timur. Tingkat kesalahan naik hingga 12% selama jam sibuk, menyebabkan penundaan alur data dan kegagalan dasbor yang menghadap pelanggan.

Analisis: Tinjauan log mengungkapkan bahwa proxy meneruskan permintaan ke satu node hulu yang secara konsisten lambat selama beban puncak. DNS mengembalikan IP yang sama setiap saat karena TTL yang lama, melewati penyeimbang beban. Secara terpisah, token autentikasi di-cache tanpa pemeriksaan kedaluwarsa, menyebabkan respons 401 terputus-putus saat token kedaluwarsa secara senyap dalam semalam.

Perbaikan: Tim memperpendek TTL DNS menjadi 30 detik, memungkinkan distribusi beban yang tepat di seluruh kluster hulu. Mereka menambahkan logika penyegaran token ke klien alur kerja. Ambang batas waktu tunggu proxy disetel dari 10 detik menjadi 25 detik untuk kueri yang berjalan lama.

Hasil: Kesalahan 502 turun sebesar 94% dalam 48 jam. Kesalahan 504 turun hingga mendekati nol. Kesalahan 401 terkait token dihilangkan sepenuhnya. Pemantauan ditambahkan untuk memberi peringatan pada waktu resolusi DNS dan usia token, mencegah kekambuhan.

Tabel referensi master kesalahan proxy

Menggunakan proxy Nsocks untuk meminimalkan kesalahan infrastruktur

Penyedia proxy yang andal mengurangi frekuensi kesalahan di tingkat infrastruktur — sebelum tim Anda harus mengatasinya. Nsocks dibangun berdasarkan perutean yang stabil, infrastruktur transparan, dan waktu aktif (uptime) yang konsisten di pasar AS, menjadikannya pilihan praktis untuk beban kerja SaaS dan analitik yang tidak dapat menoleransi kegagalan proxy yang tidak terduga.

Alat pemantauan yang melacak tingkat kesalahan proxy berdasarkan jenis kode memberi tim gambaran yang jauh lebih jelas tentang di mana kegagalan terkonsentrasi.

Arsitektur perutean platform meminimalkan kondisi yang menghasilkan kesalahan gerbang proxy dan kegagalan koneksi proxy ditolak. Ketika infrastruktur di bawahnya kokoh, tingkat kesalahan turun secara signifikan — bukan karena masalah disembunyikan, tetapi karena masalah tersebut tidak sering terjadi.

"Kualitas infrastruktur proxy Anda menentukan tingkat kesalahan dasar Anda. Anda dapat mengoptimalkan selamanya di lapisan aplikasi, tetapi penyedia berkualitas rendah akan selalu memperkenalkan derau yang tidak dapat Anda kendalikan."

Keunggulan utama:

• ✅ Perutean stabil — jalur yang konsisten mengurangi kegagalan sesekali
• ✅ Uptime tinggi — keandalan infrastruktur mengurangi tingkat kesalahan dasar
• ✅ Autentikasi andal — tidak ada token kedaluwarsa senyap atau ketidakcocokan kredensial
• ✅ Dukungan teknis — bantuan nyata saat ada yang tidak beres, bukan hanya dokumentasi

Pertanyaan yang sering diajukan

Apa itu kesalahan proxy 407?

407 berarti proxy itu sendiri memerlukan autentikasi sebelum dapat meneruskan permintaan Anda. Berbeda dengan 401, yang berasal dari server asal. Tambahkan kredensial proxy Anda ke header permintaan untuk menyelesaikannya.

Mengapa kesalahan 502 sering terjadi?

Kesalahan 502 yang sering biasanya berarti satu atau beberapa node hulu tidak sehat atau mengembalikan respons yang tidak valid. Periksa pemeriksaan kesehatan penyeimbang beban dan log server hulu. Jika berkorelasi dengan waktu, lihat lonjakan lalu lintas dan batas kapasitas.

Bisakah latensi menyebabkan waktu tunggu 504?

Ya, secara langsung. 504 terjadi ketika proxy berhenti menunggu respons hulu setelah periode waktu tunggu yang dikonfigurasi. Jika latensi hulu naik di atas ambang batas tersebut — meskipun sebentar — proxy mengembalikan 504. Menyesuaikan nilai waktu tunggu atau mengurangi latensi hulu keduanya membantu.

Bagaimana saya mengidentifikasi kesalahan konfigurasi?

Mulailah dengan membandingkan pengaturan proxy Anda saat ini dengan baseline yang diketahui baik. Periksa nomor port, versi protokol, cakupan autentikasi, dan entri daftar putih IP. Uji setiap lapisan secara independen: bisakah Anda mencapai hulu secara langsung? Apakah proxy menerima kredensial Anda sendiri?

Kapan saya harus menghubungi dukungan?

Hubungi dukungan ketika kesalahan terus berlanjut setelah Anda mengonfirmasi konfigurasi yang benar, memverifikasi kredensial, menguji endpoint secara langsung, dan meninjau log tanpa menemukan penyebab yang jelas. Lampirkan kutipan log dengan stempel waktu dan langkah-langkah yang telah Anda ambil — ini secara signifikan mempercepat resolusi.