Ringkasan

Smartproxy menyediakan endpoint proxy residensial dan datacenter melalui HTTP(S) dan SOCKS5 (65M+ IP di sisi residensial) dengan paket bulanan flat. Dua keputusan awal menentukan apakah pengaturan Anda berhasil pada percobaan pertama: mode autentikasi mana yang Anda gunakan, dan apakah sebuah permintaan harus mempertahankan IP keluar yang sama atau beralih ke IP baru.

Panduan ini mencakup kedua keputusan tersebut dan memverifikasinya dengan permintaan command-line nyata, sehingga Anda dapat memastikan endpoint berfungsi sebelum menghubungkannya ke scraper, rank tracker, atau profil browser.

Autentikasi: username/password atau whitelist IP

Kedua gaya autentikasi dikonfigurasi di dasbor:

Username/password — kredensial dikirim dengan setiap permintaan. Berfungsi dari mesin, container, atau CI runner mana pun, dan tetap berfungsi saat jaringan atau alamat ISP berubah.
Whitelist IP — tidak ada kredensial yang ikut dalam permintaan, tetapi IP publik Anda saat ini harus terdaftar. Ini berhenti bekerja begitu ISP Anda mengganti alamat Anda atau Anda berpindah ke jaringan lain.

Gunakan username/password kecuali Anda memiliki IP kantor tetap dan alat yang sama sekali tidak dapat mengirim kredensial proxy.

Jenis sesi: rotating atau sticky

Rotating — permintaan dapat keluar dari IP yang berbeda setiap kali. Ini adalah perilaku ketika tidak ada token sesi yang dilampirkan, dan inilah yang Anda inginkan untuk pengumpulan skala besar di mana jumlah permintaan per-IP harus tetap rendah.
Sticky — IP keluar yang sama dipertahankan selama masa hidup token sesi, yang menjaga alur stateful seperti login, add-to-cart, dan checkout pada satu alamat.

Smartproxy mengenkode detail sesi dan targeting di username proxy. Sintaks parameter yang tepat dihasilkan untuk Anda dan dapat berubah, jadi selalu salin string yang sudah jadi dari generator endpoint dasbor alih-alih mengetiknya dari ingatan. Contoh di bawah ini hanya menunjukkan bentuk umumnya.

Memilih antara endpoint residensial dan datacenter

	Residensial	Datacenter
Pool	65M+ IP	Rentang lebih kecil dan stabil
Kecepatan	Sedang	Cepat
Paling cocok untuk	Pengumpulan yang akurat secara geografis, verifikasi iklan, pengecekan harga	Crawling volume tinggi untuk target yang toleran, pengujian internal
Risiko pemblokiran	Lebih rendah, IP tersebar luas	Lebih tinggi, rentangnya sudah dikenal

Kedua jenis endpoint diakses dengan cara yang sama; hanya host, port, dan kredensial yang berbeda.

Langkah-langkah

Temukan endpoint dan kredensial Anda di dasbor.

Masuk, buka halaman pengaturan proxy untuk produk yang Anda beli, dan salin host dan port endpoint, username dan password proxy Anda, serta string sesi atau targeting apa pun yang disuntikkan generator ke dalam username.
```
export SP_USER='your-proxy-username'
export SP_PASS='your-proxy-password'
export SP_ENDPOINT='host:port'   # paste the exact value from the dashboard
```
Simpan kredensial dalam variabel lingkungan atau secrets manager daripada meng-commit-nya ke dalam skrip.
Pilih mode autentikasi Anda.

Username/password adalah rekomendasi default. Jika Anda lebih memilih whitelisting, catat IP publik Anda saat ini dan tambahkan di pengaturan autentikasi dasbor.
```
curl -sS https://ipinfo.io/ip
```
Periksa ulang dan tambahkan kembali alamat ini setiap kali ISP Anda mengubahnya; entri whitelist yang kedaluwarsa adalah penyebab paling umum dari error 407 yang tiba-tiba.
Verifikasi permintaan HTTP rotating.

Kirim permintaan melalui endpoint dan pastikan Anda melihat IP proxy, bukan IP Anda sendiri.
```
curl -sS -x "http://${SP_USER}:${SP_PASS}@${SP_ENDPOINT}" https://ipinfo.io/json
```
Jalankan beberapa kali dalam loop untuk memastikan IP keluar benar-benar berubah antar permintaan.
```
for i in 1 2 3; do
  curl -sS -x "http://${SP_USER}:${SP_PASS}@${SP_ENDPOINT}" https://ipinfo.io/ip
  echo
done
```
Jika alamat tidak pernah berubah, periksa apakah token sesi masih tertanam di username Anda.
Patok IP keluar dengan sesi sticky.

Salin username sesi sticky dari generator dasbor (ini adalah username Anda plus pengenal sesi) dan ekspor ke variabel terpisah sehingga Anda dapat beralih antara string rotating dan sticky tanpa mengedit kredensialnya sendiri.
```
export SP_USER_STICKY='your-username-with-session-parameters'   # copy from the dashboard

for i in 1 2 3; do
  curl -sS -x "http://${SP_USER_STICKY}:${SP_PASS}@${SP_ENDPOINT}" https://ipinfo.io/ip
  echo
done
```
Ketiga respons harus menunjukkan IP keluar yang sama selama masa hidup token sesi tersebut.
Uji geo-targeting.

Targeting country, city, dan state juga diteruskan melalui string username yang dihasilkan. Pastikan permintaan mendarat di tempat yang Anda harapkan sebelum Anda membangun alur kerja per-pasar di atasnya.
```
export SP_USER_DE='your-username-with-country-parameter'   # copy from the dashboard
curl -sS -x "http://${SP_USER_DE}:${SP_PASS}@${SP_ENDPOINT}" https://ipinfo.io/json
```
Field country dalam respons harus cocok dengan target yang Anda konfigurasi.
Uji endpoint SOCKS5.

Gunakan skema socks5h:// agar resolusi DNS terjadi di proxy, bukan secara lokal, yang mencegah kebocoran dan pemblokiran berbasis DNS.
```
curl -sS -x "socks5h://${SP_USER}:${SP_PASS}@${SP_ENDPOINT}" https://ipinfo.io/json
```
Jika klien Anda hanya mendukung socks5://, DNS diselesaikan secara lokal; utamakan socks5h dalam skrip.
Beralih ke endpoint datacenter saat throughput penting.

Kredensial dan host datacenter tercantum terpisah di dasbor. Jalankan ulang loop verifikasi terhadap host dan port datacenter; hanya nilai endpoint yang berubah, bukan format permintaannya.
```
export SP_DC_ENDPOINT='datacenter-host:port'
curl -sS -x "http://${SP_USER}:${SP_PASS}@${SP_DC_ENDPOINT}" https://ipinfo.io/ip
```

Gunakan endpoint dari Python.

Gunakan kembali variabel lingkungan yang sama sehingga tidak ada yang berubah saat Anda beralih dari shell ke skrip.

import os
import requests

auth = f"{os.environ['SP_USER']}:{os.environ['SP_PASS']}@"
endpoint = os.environ['SP_ENDPOINT']
proxies = {
    "http": f"http://{auth}{endpoint}",
    "https": f"http://{auth}{endpoint}",
}

response = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30)
response.raise_for_status()
print(response.json())

Untuk pekerjaan sticky, buat dictionary proxies kedua dari SP_USER_STICKY dan gunakan untuk seluruh sesi.

Tambahkan logika retry dan rotation.

Tangani respons 429 dan 5xx dengan exponential backoff singkat, dan biarkan sesi rotating menyediakan IP baru secara alami pada setiap percobaan alih-alih mencoba ulang sesi yang sama berulang kali.

import time

for attempt in range(4):
    try:
        response = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30)
        if response.status_code < 400:
            break
    except requests.RequestException:
        pass
    time.sleep(2 ** attempt)

Pemecahan Masalah

407 Proxy Authentication Required — username atau password salah, string sesi atau targeting ditempelkan ke field yang salah, atau IP whitelist Anda tidak lagi cocok dengan alamat Anda saat ini. Salin ulang string dari generator dasbor.
Kredensial ditolak setelah sebelumnya berfungsi — password yang mengandung @, :, /, atau # harus di-URL-encode di dalam URL proxy (@ menjadi %40, : menjadi %3A). Utamakan password tanpa karakter khusus jika alat Anda tidak dapat meng-encode-nya.
curl: (7) Failed to connect — host atau port salah, atau Anda menyalin endpoint residensial ke slot datacenter (atau sebaliknya). Setiap produk memiliki host dan port sendiri.
Setiap permintaan mengembalikan IP yang sama — token sesi sticky masih ada di username, atau Anda menggunakan set kredensial sticky alih-alih yang rotating.
Sesi sticky berubah IP di tengah alur kerja — masa hidup sesi berakhir. Mulai token sesi baru secara sengaja dan autentikasi ulang daripada mengasumsikan token lama tetap bertahan tanpa batas.
Permintaan timeout hanya pada SOCKS5 — klien mungkin tidak mendukung DNS remote. Beralih ke socks5h:// atau kembali ke endpoint HTTP untuk alat tersebut.
Autentikasi whitelist gagal secara intermiten — jaringan seluler dan koneksi rumah mengganti IP publik. Gunakan username/password untuk pekerjaan tanpa pengawasan.

Ringkasan

Orientasi Smartproxy bermuara pada dua pilihan dan satu kebiasaan. Pilih username/password kecuali Anda benar-benar memiliki IP statis, dan pilih sesi rotating untuk beban kerja pengumpulan atau sesi sticky untuk alur stateful. Kebiasaannya adalah menyalin endpoint dan string username langsung dari generator dasbor, karena parameter sesi dan geo-targeting berada di string tersebut. Verifikasi jalur rotating, jalur sticky, jalur SOCKS5, dan host datacenter dengan loop curl singkat di atas sebelum mengarahkan scraper atau rank tracker ke sana.