Python中的urllib3.contrib.socks模块使用指南

urllib3是Python中一个非常强大的HTTP库，它通过urllib3.contrib.socks模块提供了对SOCKS代理的支持。使用SOCKS代理可以实现隐藏真实IP地址、绕过网络限制等功能。本指南将介绍urllib3.contrib.socks模块的使用方法，并提供一些示例代码来帮助您更好地理解。

1. 安装urllib3库

在开始之前，请确保您已经安装了urllib3库。您可以通过在终端中运行以下命令来安装urllib3：

pip install urllib3

2. 引入urllib3.contrib.socks模块

在您的Python脚本中，您需要使用以下代码行来引入urllib3.contrib.socks模块：

import urllib3.contrib.socks as socks

3. 创建一个SOCKS代理连接

使用以下代码创建一个SOCKS代理连接：

http = urllib3.PoolManager(
    cert_reqs='CERT_REQUIRED',
    ca_certs=certifi.where(),
    socks_version=socks.SOCKS5,
    timeout=urllib3.Timeout(connect=5.0, read=5.0)
)

response = http.request(
    'GET',
    'https://www.example.com',
    socks_port=1080,
    socks_host='127.0.0.1'
)

print(response.data)

在上面的代码中，我们创建了一个PoolManager对象，指定了代理类型为SOCKS5，并设置了超时时间。然后，使用request方法发送一个GET请求到URL 'https://www.example.com'。注意，我们还指定了SOCKS代理的端口和主机地址。

4. 使用用户名和密码进行身份验证

如果您的SOCKS代理服务器要求身份验证，您可以使用如下代码提供用户名和密码：

import base64

http = urllib3.PoolManager(
    cert_reqs='CERT_REQUIRED',
    ca_certs=certifi.where(),
    socks_version=socks.SOCKS5,
    timeout=urllib3.Timeout(connect=5.0, read=5.0)
)

socks_username = 'your_username'
socks_password = 'your_password'

proxies = {
    'http': f'socks5h://{socks_username}:{socks_password}@127.0.0.1:1080',
    'https': f'socks5h://{socks_username}:{socks_password}@127.0.0.1:1080'
}

response = http.request(
    'GET',
    'https://www.example.com',
    proxies=proxies
)

print(response.data)

在上面的代码中，我们使用base64模块将用户名和密码进行了编码，并将其添加到代理URL的前缀中。

这就是urllib3.contrib.socks模块的基本使用方法。您可以根据您的具体需求进行调整和扩展。请注意，如果您的SOCKS代理服务器是在本机上运行，那么socks_host应该设置为'127.0.0.1'。

希望这个指南对您有帮助！