Jika Anda pernah mencoba menjalankan Chrome melalui Selenium dengan proxy seperti
--proxy-server=http://user:password@ip:port,
maka Anda pasti mengalami bahwa browser terbuka tanpa proxy sama sekali, atau menampilkan jendela otorisasi sistem,
yang menghalangi seluruh skrip. Ini bukan bug pada kode Anda — ini adalah batasan arsitektur Chromium, yang tidak
diselesaikan langsung oleh Selenium. Dalam artikel ini, kita akan membahas mengapa ini terjadi, dan memberikan 4 cara
yang efektif untuk mengirimkan login dan password proxy ke Chrome tanpa input manual.
Mengapa --proxy-server tidak menerima user:pass
Flag --proxy-server
di Chromium awalnya dirancang hanya untuk menunjukkan protokol, alamat IP, dan port server proxy.
Sintaks dengan kredensial seperti user:password@host:port
bekerja di curl, wget, dan banyak utilitas lainnya, tetapi Chromium mengabaikan bagian URL ini saat mem-parsing flag.
Ini adalah perilaku yang terkonfirmasi, yang telah dijelaskan dalam bug tracker Chromium sejak versi 50-an, dan selama bertahun-tahun para pengembang
belum menambahkan dukungan untuk otorisasi melalui command line — karena alasan keamanan: password dalam argumen
proses terlihat melalui ps aux
atau task manager, yang dianggap sebagai kebocoran.
Akibatnya, Chrome dengan jujur terhubung ke server proxy, tetapi begitu server merespons dengan kode
407 Proxy Authentication Required,
browser menampilkan jendela dialog asli dengan kolom "Nama Pengguna" dan "Password". Selenium tidak dapat bekerja
dengan dialog sistem OS — ia hanya mengelola pohon DOM halaman, sehingga tidak mungkin untuk menutup atau mengisi
jendela ini secara otomatis melalui standar WebDriver API. Skrip hanya terjebak menunggu hingga seseorang secara manual
memasukkan data atau hingga waktu habis.
Penting untuk dipahami: masalah ini berlaku khusus untuk proxy HTTP/HTTPS dan SOCKS5 dengan otorisasi berdasarkan login dan password.
Jika proxy dilindungi oleh IP-whitelist (tanpa login), dialog otorisasi tidak muncul sama sekali, dan flag
--proxy-server berfungsi normal.
Oleh karena itu, untuk pengambilan data dan otomatisasi melalui proxy data center
banyak pengembang awalnya memilih tarif dengan pengikatan berdasarkan IP, bukan password — ini menghilangkan masalah sejak awal.
Namun, jika Anda memiliki kumpulan proxy residential yang berotasi,
pengikatan berdasarkan IP sering kali tidak nyaman, dan Anda harus menyelesaikan masalah secara programatik.
Cara 1: Ekstensi Chrome dengan otorisasi proxy
Cara yang paling dapat diandalkan dan tahan lama adalah dengan menghasilkan mini-ekstensi Chrome (Manifest V2 atau V3), yang
menangkap peristiwa onAuthRequired
dan secara otomatis memasukkan login dan password, melewati dialog sistem. Ekstensi dibuat secara dinamis dalam kode Python
dan terhubung ke Chrome melalui opsi add_extension.
import zipfile
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
def create_proxy_extension(proxy_host, proxy_port, proxy_user, proxy_pass, plugin_path="proxy_auth.zip"):
manifest_json = """
{
"version": "1.0.0",
"manifest_version": 2,
"name": "Chrome Proxy Auth",
"permissions": [
"proxy", "tabs", "unlimitedStorage", "storage",
"<all_urls>", "webRequest", "webRequestBlocking"
],
"background": {"scripts": ["background.js"]},
"minimum_chrome_version":"22.0.0"
}
"""
background_js = f"""
var config = {{
mode: "fixed_servers",
rules: {{
singleProxy: {{
scheme: "http",
host: "{proxy_host}",
port: parseInt({proxy_port})
}},
bypassList: ["localhost"]
}}
}};
chrome.proxy.settings.set({{value: config, scope: "regular"}}, function() {{}});
chrome.webRequest.onAuthRequired.addListener(
function(details) {{
return {{
authCredentials: {{username: "{proxy_user}", password: "{proxy_pass}"}}
}};
}},
{{urls: ["<all_urls>"]}},
["blocking"]
);
"""
with zipfile.ZipFile(plugin_path, "w") as zp:
zp.writestr("manifest.json", manifest_json)
zp.writestr("background.js", background_js)
return plugin_path
plugin = create_proxy_extension("gate.example.com", 7000, "login123", "pass456")
options = Options()
options.add_extension(plugin)
driver = webdriver.Chrome(options=options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()
Metode ini sepenuhnya menghilangkan dialog otorisasi — Chrome secara otomatis memasukkan kredensial pada setiap permintaan 407. Kekurangan dari pendekatan ini: ia hanya berfungsi dengan browser yang terlihat (mode headless pada versi Chrome lama dengan ekstensi terkadang tidak stabil), dan untuk setiap proxy baru, Anda perlu membuat ulang arsip zip. Untuk menjalankan 20-50 profil dengan proxy yang berbeda secara massal, ini diselesaikan dengan menghasilkan plugin unik untuk setiap profil dalam siklus.
Cara 2: Selenium Wire
Jika Anda tidak ingin repot dengan pembuatan ekstensi, Anda bisa menggunakan pustaka
selenium-wire —
ini membungkus Selenium biasa dan menambahkan lapisan proxy sendiri antara browser dan server target.
Login dan password dikirim langsung dalam opsi, tanpa dialog dan ekstensi.
from seleniumwire import webdriver
proxy_options = {
'proxy': {
'http': 'http://login123:[email protected]:7000',
'https': 'http://login123:[email protected]:7000',
'no_proxy': 'localhost,127.0.0.1'
}
}
driver = webdriver.Chrome(seleniumwire_options=proxy_options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()
Kelebihan: sedikit kode, dukungan SOCKS5, mudah untuk mengganti proxy secara dinamis antara permintaan — ini penting jika Anda melakukan rotasi IP di setiap halaman ke-N saat mengumpulkan data dari Wildberries atau Ozon. Kekurangan: Selenium Wire menambahkan proxy MITM lokalnya sendiri, yang sedikit memperlambat pemuatan halaman dan kadang-kadang bertentangan dengan situs yang menggunakan HSTS ketat dan pengetatan sertifikat. Proyek ini juga tidak diperbarui seaktif Selenium utama, jadi kompatibilitas dengan versi Chrome baru perlu diperiksa sebelum digunakan di produksi.
Cara 3: CDP dan Network.setBasicAuth (Selenium 4 BiDi)
Mulai dari Selenium 4, ada kemungkinan untuk bekerja langsung melalui Chrome DevTools Protocol (CDP), yang memungkinkan
untuk menangkap permintaan otorisasi tanpa pustaka pihak ketiga. Chrome mendukung peristiwa
Fetch.authRequired,
yang dapat Anda langgani melalui sesi DevTools dan merespons secara programatik dengan kredensial.
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
options = Options()
options.add_argument("--proxy-server=gate.example.com:7000")
driver = webdriver.Chrome(options=options)
# Mengaktifkan penangkapan peristiwa jaringan melalui CDP
driver.execute_cdp_cmd("Network.enable", {})
driver.execute_cdp_cmd("Network.setExtraHTTPHeaders", {"headers": {}})
# Di Selenium 4.10+ API otorisasi yang disederhanakan tersedia
driver.execute_cdp_cmd("Fetch.enable", {
"handleAuthRequests": True,
"patterns": [{"urlPattern": "*"}]
})
# Contoh handler (dalam kode nyata, diperlukan pendengar melalui sesi websockets CDP)
# driver.on_auth_required(lambda: {"username": "login123", "password": "pass456"})
driver.get("https://httpbin.org/ip")
driver.quit()
Dalam praktiknya, implementasi penuh dari handler ini memerlukan kerja dengan koneksi WebSocket CDP tingkat rendah
(pustaka pycdp atau
klien BiDi bawaan Selenium 4.10+), yang lebih mendekati tugas rekayasa daripada skrip cepat. Cara ini
sebaiknya dipilih jika Anda membangun kerangka otomatisasi sendiri dan ingin menghindari ketergantungan
selenium-wire atau pembuatan ekstensi. Untuk sebagian besar tugas otomatisasi SMM dan pengambilan data dari marketplace,
lebih mudah menggunakan cara 1 atau 2.
Cara 4: Proxy tanpa password melalui IP-whitelist
Cara paling sederhana adalah dengan tidak mengirimkan login dan password ke Chrome sama sekali. Banyak penyedia proxy, termasuk
proxy seluler, mendukung
otorisasi berdasarkan alamat IP server atau mesin dari mana permintaan dilakukan. Anda menambahkan IP eksternal Anda ke whitelist
di akun penyedia, dan setelah itu flag
--proxy-server=http://ip:port
berfungsi tanpa dialog otorisasi sama sekali — karena server proxy sendiri menentukan bahwa permintaan datang dari IP yang diizinkan,
dan tidak mengirimkan kode 407.
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
options = Options()
options.add_argument("--proxy-server=http://45.12.34.56:7000") # proxy tanpa login, IP sudah dalam whitelist
driver = webdriver.Chrome(options=options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()
Pendekatan ini sangat cocok untuk skenario server — ketika skrip berjalan di VPS khusus dengan IP eksternal tetap, dan Anda hanya perlu menulisnya sekali di whitelist. Kekurangan muncul di mana IP mesin sering berubah (misalnya, internet rumah dengan IP dinamis atau fungsi cloud dengan alamat ephemeral) — maka whitelist harus diperbarui secara manual setiap kali dijalankan, yang tidak nyaman untuk otomatisasi.
Perbandingan cara
| Cara | Kesulitan | Mode Headless | Kapan digunakan |
|---|---|---|---|
| Ekstensi Chrome | Sedang | Terbatas | Farming akun, otomatisasi visual |
| Selenium Wire | Rendah | Ya | Pengambilan data, rotasi proxy cepat |
| CDP / Fetch.authRequired | Tinggi | Ya | Kerangka otomatisasi sendiri |
| IP-whitelist tanpa password | Minimal | Ya | Server dengan IP tetap |
Checklist untuk debugging masalah otorisasi proxy
- Periksa apakah dialog sistem muncul saat dijalankan tanpa mode headless — ini adalah tanda 100% adanya masalah dengan 407.
- Pastikan port proxy ditentukan dengan benar: HTTP dan SOCKS5 sering kali bekerja pada port yang berbeda dari penyedia yang sama.
- Jika menggunakan Selenium Wire, periksa versi — rilis lama dapat bertentangan dengan Chrome 115+.
- Untuk ekstensi Chrome, pastikan arsip zip dibangun ulang setiap kali login/password proxy berubah.
- Ketika bekerja dengan otorisasi SOCKS5, ingatlah: SOCKS5 asli di Chrome tidak mendukung login/password sama sekali — diperlukan HTTP tunnel atau Selenium Wire.
- Periksa log penyedia proxy: terkadang 407 muncul bukan karena kode, tetapi karena tarif yang telah kedaluwarsa atau format login yang salah (dengan sufiks sesi/geo).
Kesimpulan
Flag --proxy-server di Chrome
tidak pernah mendukung pengiriman login dan password secara langsung dalam string — ini adalah fitur arsitektur Chromium,
bukan kesalahan Selenium. Ada empat cara yang berfungsi: ekstensi buatan sendiri dengan penangkapan
onAuthRequired,
pustaka Selenium Wire, kerja tingkat rendah melalui CDP, atau sepenuhnya menghindari password dengan menggunakan IP-whitelist.
Untuk sebagian besar tugas pengambilan data dan otomatisasi pengujian, cukup menggunakan Selenium Wire; untuk pekerjaan visual dengan
profil anti-deteksi, lebih nyaman menggunakan ekstensi Chrome.
Jika Anda mengatur otomatisasi di server dengan IP tetap, pertimbangkan proxy data center dengan pengikatan berdasarkan whitelist — ini sepenuhnya menghilangkan masalah otorisasi di Chrome. Dan untuk tugas yang memerlukan perubahan login dan password secara dinamis dengan rotasi geo, proxy residential lebih cocok digunakan bersama dengan Selenium Wire — sehingga Anda mendapatkan fleksibilitas dan stabilitas koneksi tanpa jendela dialog otorisasi.