Panduan · Python

Menggunakan proxy dengan Python requests dan httpx

requests adalah library HTTP paling populer di Python dan menyertakan dukungan bawaan untuk proxy dengan autentikasi. Kesalahan yang paling sering terjadi adalah salah mendeklarasikan kunci https pada dictionary proxies serta membiarkan karakter khusus dalam password tanpa di-encode. Panduan ini membahas konfigurasi yang benar, termasuk timeout dan penanganan error untuk skrip yang berjalan lama.

Penulis: Bùi Toàn · Diperbarui: 19/11/2026

Konfigurasi dasar

  • Format string ip:port:user:pass menjadi sebuah URL: proxy_url = "http://user:pass@IP:PORT".
  • Deklarasikan kedua kunci: proxies = {"http": proxy_url, "https": proxy_url}. Kunci "https" tetap mengarah ke URL yang diawali dengan http:// karena proxy ONET adalah proxy HTTP; requests secara otomatis menggunakan CONNECT untuk situs HTTPS.
  • Kirim request: r = requests.get("https://api.ipify.org", proxies=proxies, timeout=(10, 30)); print(r.text). Hasilnya harus berupa IP proxy.
  • Jangan tulis "https": "https://IP:PORT". Proxy ONET tidak menerima koneksi TLS ke dirinya sendiri dan akan mengembalikan error SSL atau menutup koneksi.

Bagaimana cara menggunakan proxy dengan karakter khusus pada password di requests?

Lakukan URL-encode pada username dan password sebelum menyusunnya: from urllib.parse import quote; proxy_url = f"http://{quote(user, safe='')}:{quote(pw, safe='')}@{ip}:{port}". Tanpa langkah ini, karakter @ atau : pada password akan menyebabkan requests salah mem-parsing alamat proxy.

Menggunakan Session dan retry

  • Buat s = requests.Session(); s.proxies.update(proxies). Semua request yang dikirim melalui s menggunakan proxy yang sama dan menjaga koneksi tetap terbuka, yang mana lebih cepat daripada memanggil requests.get berulang kali.
  • Pasang HTTPAdapter dengan Retry(total=3, backoff_factor=1, status_forcelist=[429, 502, 503]) untuk mencoba ulang secara otomatis saat terjadi error sementara.
  • Selalu atur timeout. Tanpa timeout, koneksi yang menggantung dapat membuat program Anda macet tanpa batas waktu.
  • Environment variable HTTPS_PROXY juga dibaca oleh requests, kecuali jika Anda menyetel s.trust_env = False.

Dengan httpx

Mulai dari httpx 0.26, teruskan proxy menggunakan parameter proxy: httpx.Client(proxy="http://user:pass@IP:PORT", timeout=30). Versi yang lebih lama menggunakan proxies={"all://": url}. httpx mendukung async (httpx.AsyncClient) jika Anda perlu menjalankan request secara bersamaan.

Error proxy apa saja yang sering ditemui pada requests Python?

Tiga error umum adalah 407 akibat username atau password yang salah, timeout karena gagal menjangkau proxy, dan 429 dari pembatasan laju (rate limit) situs web target.

ProxyError … 407 Proxy Authentication Required

Username atau password salah, atau karakter khusus belum di-encode.

ConnectTimeout atau ProxyError … timed out

Tidak dapat menjangkau proxy: IP atau port salah, atau ada gangguan jaringan. Verifikasi menggunakan curl.

HTTP 429 dari situs tujuan

Terkena pembatasan frekuensi (rate limit) oleh situs tujuan. Kurangi request per IP, tambahkan jeda waktu, atau distribusikan beban ke beberapa proxy.

Belum punya proxy? Beli proxy dedicated dengan aktivasi otomatis

Proxy IPv4 dedicated di 9 negara mulai dari 20.000₫/IP/bulan untuk pembelian 2.000 IP atau lebih (39.000₫ untuk 1 IP), serta proxy ISP statis Vietnam dan US. HTTP(S) dan SOCKS5 dengan username dan password, bandwidth tanpa batas, aktif otomatis setelah pembayaran. Proxy Vietnam saat ini hanya mendukung HTTP(S), tanpa SOCKS5.

Beli proxy sekarang

Pertanyaan yang Sering Diajukan

Apakah proxy ONET memiliki batasan thread atau kuota data?+

Bandwidth tanpa batas. Jumlah request yang dapat Anda kirimkan ke situs tujuan dibatasi oleh situs tersebut; melampauinya akan memicu error 429.

Apakah saya bisa menggunakan aiohttp?+

Bisa. Sertakan proxy="http://IP:PORT" dan proxy_auth=aiohttp.BasicAuth(user, pass) pada setiap request.