快速入门

在不到一分钟的时间内发出你的第一个代理请求。

1. 创建账户并选择套餐

   在 shifter.io/order 注册并选择一个套餐。

2. 获取你的凭证

   打开客户端仪表盘，复制你的代理用户名和密码（若使用 Scraping/SERP API，则复制 API 密钥）。它们看起来是这样的：

   Username: customer-USERNAME
   Password: 5f8a9c2b1d3e4f6g7h8i
   Gateway:  p.shifter.io:443

3. 发送你的第一个请求

   通过网关路由任意 HTTP 调用。用户名中编码了你的定向信息：

   curl

   curl -x customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
     https://ipinfo.io/json

   Python

   import requests
   
   proxy = "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443"
   proxies = {"http": proxy, "https": proxy}
   
   r = requests.get("https://ipinfo.io/json", proxies=proxies)
   print(r.text)

   Node.js

   import fetch from 'node-fetch';
   import { HttpsProxyAgent } from 'https-proxy-agent';
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   const res = await fetch('https://ipinfo.io/json', { agent });
   console.log(await res.text());

   TypeScript

   import axios from 'axios';
   import { HttpsProxyAgent } from 'https-proxy-agent';
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   const { data } = await axios.get<string>('https://ipinfo.io/json', {
     httpAgent: agent,
     httpsAgent: agent,
   });
   
   console.log(data);

   JavaScript

   const fetch = require('node-fetch');
   const { HttpsProxyAgent } = require('https-proxy-agent');
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   fetch('https://ipinfo.io/json', { agent })
     .then((r) => r.text())
     .then(console.log);

   Go

   package main
   
   import (
     "fmt"
     "io"
     "net/http"
     "net/url"
   )
   
   func main() {
     proxyURL, _ := url.Parse("customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443")
     client := &http.Client{
       Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
     }
   
     resp, _ := client.Get("https://ipinfo.io/json")
     defer resp.Body.Close()
     body, _ := io.ReadAll(resp.Body)
     fmt.Println(string(body))
   }

   Rust

   use reqwest::blocking::Client;
   use reqwest::Proxy;
   
   fn main() -> Result<(), Box<dyn std::error::Error>> {
       let proxy = Proxy::all("http://p.shifter.io:443")?
           .basic_auth("customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600", "PASSWORD");
   
       let client = Client::builder().proxy(proxy).build()?;
       let body = client.get("https://ipinfo.io/json").send()?.text()?;
       println!("{body}");
       Ok(())
   }

   Java

   import java.net.*;
   import java.net.http.*;
   
   public class Main {
       public static void main(String[] args) throws Exception {
           HttpClient client = HttpClient.newBuilder()
               .proxy(ProxySelector.of(new InetSocketAddress("p.shifter.io", 443)))
               .authenticator(new Authenticator() {
                   protected PasswordAuthentication getPasswordAuthentication() {
                       return new PasswordAuthentication(
                           "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600",
                           "PASSWORD".toCharArray()
                       );
                   }
               })
               .build();
   
           HttpRequest req = HttpRequest.newBuilder(URI.create("https://ipinfo.io/json")).build();
           HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
           System.out.println(res.body());
       }
   }

   C#

   using System.Net;
   using System.Net.Http;
   
   var handler = new HttpClientHandler
   {
       Proxy = new WebProxy("http://p.shifter.io:443")
       {
           Credentials = new NetworkCredential(
               "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600",
               "PASSWORD"
           )
       },
       UseProxy = true
   };
   
   using var client = new HttpClient(handler);
   var ip = await client.GetStringAsync("https://ipinfo.io/json");
   Console.WriteLine(ip);

   PHP

   <?php
   require 'vendor/autoload.php';
   
   $client = new GuzzleHttp\Client([
       'proxy' => 'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443',
   ]);
   
   $res = $client->get('https://ipinfo.io/json');
   echo $res->getBody();

4. 定向到某个国家、会话或 ISP

   使用参数来控制地理位置、会话和路由：

   Parameter	Example	Effect
   country-XX	customer-USERNAME-country-de	通过德国路由
   region-NAME	customer-USERNAME-region-california	定向到特定地区/州
   city-NAME	customer-USERNAME-city-new_york	定向到特定城市
   asn-NUMBER	customer-USERNAME-asn-7922	定向到特定 ASN
   sid-ID	customer-USERNAME-sid-abc	粘性会话（同一 IP 在默认 TTL 120 秒内保持不变）
   ttl-SECONDS	customer-USERNAME-sid-abc-ttl-600	为粘性会话自定义以秒为单位的 TTL（需要 sid）
   strict-true	customer-USERNAME-country-us-strict-true	直接返回 502 失败，而不是回退到更大的 IP 池

What’s next

• 身份验证 - API 密钥与用户名/密码的对比
• 选择产品 - 选择合适的 Shifter 产品
• API 参考 - 全部 REST 端点，全部参数