CURLOPT_PROXYTYPE(3)

💅 CURLOPT_PROXYTYPE(3) — like, the proxy protocol type, bestie ✨

so this is a page from the Library Functions Manual (libcurl, obvi 🎀) and it's all about telling curl what kind of proxy it's talking to. let's get into it 🫶

---

✨ NAME ✨

CURLOPT_PROXYTYPE — the proxy protocol type, periodt 💅

---

🌸 SYNOPSIS 🌸

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYTYPE, long type);

that's the whole vibe check right there 👑

---

💖 DESCRIPTION 💖

okay so you literally just pass one of the values below and that sets the type of the proxy. that's it. that's the whole thing ✨

• CURLPROXY_HTTP — HTTP Proxy. and yeah, it's the default 💅
• CURLPROXY_HTTPS — HTTPS Proxy using HTTP/1. (added in 7.52.0 for OpenSSL and GnuTLS. and since 7.87.0, it also works for mbedTLS, Rustls, Schannel and wolfSSL — glow up fr 🌈)
• CURLPROXY_HTTPS2 — HTTPS Proxy AND it attempts to speak HTTP/2 over it. (added in 8.1.0, iconic behavior 🔥)
• CURLPROXY_HTTP_1_0 — HTTP 1.0 Proxy. this one's similar to CURLPROXY_HTTP except it uses HTTP/1.0 for any CONNECT tunneling. important: it does not change the HTTP version of the actual HTTP requests — that's controlled by CURLOPT_HTTP_VERSION(3) 🫶
• CURLPROXY_SOCKS4 — SOCKS4 Proxy.
• CURLPROXY_SOCKS4A — SOCKS4a Proxy. the proxy resolves the URL hostname 🧚
• CURLPROXY_SOCKS5 — SOCKS5 Proxy.
• CURLPROXY_SOCKS5_HOSTNAME — SOCKS5 Proxy. again, the proxy resolves the URL hostname 🧚

lowkey often it is way more convenient to specify the proxy type with the scheme part of the CURLOPT_PROXY(3) string. iykyk 💜

---

🎀 DEFAULT 🎀

CURLPROXY_HTTP

the classic. the main character. the default ⭐

---

🦋 PROTOCOLS 🦋

this functionality affects all supported protocols — yes, all of them, no cap 🌈

---

🌸 EXAMPLE 🌸

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
    curl_easy_setopt(curl, CURLOPT_PROXY, "local.example.com:1080");
    /* set the proxy type */
    curl_easy_setopt(curl, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS5);
    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

look at that. URL set, proxy set, type set, perform, cleanup. clean. ate. no crumbs 💅

---

💀 HISTORY 💀

the CURLPROXY_* enums became long types in 8.16.0. before that version, a long cast was necessary when passed to curl_easy_setopt(3) — so like, don't get caught slipping on old versions 🙈

---

💜 AVAILABILITY 💜

added in curl 7.10 ⭐

---

✨ RETURN VALUE ✨

curl_easy_setopt(3) returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK 🎉 — non-zero means an error occurred, see libcurl-errors(3) for the full tea 😭

---

🫶 SEE ALSO 🫶

• CURLOPT_PROXY(3)
• CURLOPT_PROXYPORT(3)

---

that's the whole page bestie, go configure some proxies responsibly 💖

libcurl · 2026-10-12 · mwah, luv u, bye 👋💅🎀