开发者文档

快速集成指南

兼容任意编程语言与框架,几分钟即可完成集成。支持HTTP、HTTPS、SOCKS5协议,提供完整REST API与详细文档。

选择您的编程语言

Python — requests
import requests

# ── Basic usage ──────────────────────────────────────────────────
USERNAME = "your_username"
PASSWORD = "your_password"
ENDPOINT = "server.iphtml.biz:15000"

proxies = {
    "http":  f"http://{USERNAME}:{PASSWORD}@{ENDPOINT}",
    "https": f"http://{USERNAME}:{PASSWORD}@{ENDPOINT}",
}

# ── Country targeting ─────────────────────────────────────────────
user_us = f"{USERNAME}-country-US"
proxies_us = {"https": f"http://{user_us}:{PASSWORD}@{ENDPOINT}"}

resp = requests.get("https://ipinfo.io",
                     proxies=proxies_us, timeout=30)
print(resp.json())  # {"ip": "104.x.x.x"}

# ── City targeting ────────────────────────────────────────────────
user_nyc = f"{USERNAME}-country-US-city-NewYork"
proxies_nyc = {"https": f"http://{user_nyc}:{PASSWORD}@{ENDPOINT}"}
Node.js — axios
const axios        = require('axios');
const HttpsProxy   = require('https-proxy-agent');

const USERNAME = 'your_username';
const PASSWORD = 'your_password';
const ENDPOINT = 'server.iphtml.biz:15000';

// Basic usage
const agent = new HttpsProxyAgent(
  `http://${USERNAME}:${PASSWORD}@${ENDPOINT}`
);

const response = await axios.get('https://ipinfo.io', {
  httpsAgent: agent,
});
console.log(response.data);  // { ip: '104.x.x.x' }

// Country targeting
const agentUS = new HttpsProxyAgent(
  `http://${USERNAME}-country-US:${PASSWORD}@${ENDPOINT}`
);
Java — HttpURLConnection
import java.net.*;
import java.io.*;

public class ProxyExample {
    public static void main(String[] args) throws Exception {
        String host     = "server.iphtml.biz";
        int    port     = 15000;
        String username = "your_username-country-US";
        String password = "your_password";

        Proxy proxy = new Proxy(Proxy.Type.HTTP,
            new InetSocketAddress(host, port));

        Authenticator.setDefault(new Authenticator() {
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(
                    username, password.toCharArray());
            }
        });

        URL url = new URL("https://ipinfo.io");
        HttpURLConnection conn =
            (HttpURLConnection) url.openConnection(proxy);
        // conn.getResponseCode() → 200
    }
}
PHP — cURL
$username = 'your_username';
$password = 'your_password';
$endpoint = 'server.iphtml.biz:15000';

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL            => 'https://ipinfo.io',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_PROXY          => "http://{$endpoint}",
    CURLOPT_PROXYUSERPWD   => "{$username}-country-US:{$password}",
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_SSL_VERIFYPEER => false,
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;  // {"ip":"104.x.x.x"}
Go — net/http
package main

import (
    "fmt"
    "net/http"
    "net/url"
)

func main() {
    proxyURL, _ := url.Parse(
        "http://your_username-country-US:[email protected]:15000",
    )

    transport := &http.Transport{Proxy: http.ProxyURL(proxyURL)}
    client    := &http.Client{Transport: transport}

    resp, err := client.Get("https://ipinfo.io")
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    fmt.Println(resp.StatusCode)  // 200
}
cURL
# Basic usage
curl -x http://your_username:[email protected]:15000 \
     https://ipinfo.io

# Country targeting (US)
curl -x http://your_username-country-US:[email protected]:15000 \
     https://ipinfo.io

# City targeting (New York)
curl -x "http://your_username-country-US-city-NewYork:[email protected]:15000" \
     https://ipinfo.io

# SOCKS5
curl --socks5 your_username:[email protected]:15001 \
     https://ipinfo.io

精准地理定向

在用户名中附加参数即可实现国家、城市、ISP级别的精准定向。

-country-XX
使用ISO两字母代码定向特定国家。
user-country-CN:pass
-city-CityName
定向特定城市(需先设置国家前缀)。
user-country-CN-city-Shanghai:pass
-session-ID
粘性会话——在会话期间保持使用同一IP。
user-session-abc123:pass
-rotate
强制每次请求轮换IP(轮换代理的默认行为)。
user-rotate:pass

代理端点

所有端点均支持HTTP和SOCKS5协议。

端点 端口 协议 说明
server.iphtml.biz15000HTTP / HTTPS 住宅代理(动态轮换)
server.iphtml.biz15001SOCKS5 住宅代理(SOCKS5动态轮换)

为开发者精心设计

🔌

无需额外SDK

兼容任意HTTP客户端库,无需安装或维护专有SDK。

📡

REST API

通过REST API完全以编程方式管理代理、查看用量及账号设置。

📊

实时数据分析

控制台提供请求日志、流量统计与成功率实时监控。

🔄

自动轮换

无需修改代码,可配置逐请求或间隔轮换。

🌐

全语言支持

Python、Node.js、Java、Go、PHP、Ruby、cURL——涵盖所有主流语言的示例代码。

🛡️

99.9%可用性SLA

企业级可靠性,自动故障切换保障业务管道持续运行。

立即获取API凭据

注册免费账号,即刻获得代理凭据,几分钟内完成集成。