Truyền cấu hình MantaProxy cho từng yêu cầu Python tới trang web hoặc API. Ví dụ dùng Requests để kiểm tra một proxy trước, sau đó tái sử dụng cấu hình trong ứng dụng. Cấu hình chỉ áp dụng cho chương trình, không thay đổi proxy hệ thống.
1. Chuẩn bị thông tin kết nối và Python
Trong quản lý proxy tĩnh, nhấp IP đầu ra để mở bảng chi tiết và lấy máy chủ kết nối, cổng, tên người dùng và mật khẩu proxy. Chuẩn bị Python 3. Các lệnh dưới đây tạo môi trường riêng và cài Requests với hỗ trợ SOCKS.
macOS / Linux
python3 -m venv .venv
.venv/bin/python -m pip install "requests[socks]"
Windows PowerShell
py -m venv .venv
.\.venv\Scripts\python.exe -m pip install "requests[socks]"
2. Cấu hình HTTP hoặc SOCKS5
Thay ba giá trị YOUR_PROXY bằng thông tin thật của cùng một tài nguyên, rồi chạy ví dụ trong chính cửa sổ lệnh đó. Máy chủ chỉ gồm IP hoặc tên miền, không có giao thức, cổng hay thông tin xác thực. Chương trình hỏi mật khẩu riêng; ký tự nhập không hiển thị.
macOS / Linux
export MANTA_PROXY_HOST="YOUR_PROXY_HOST"
export MANTA_PROXY_PORT="YOUR_PROXY_PORT"
export MANTA_PROXY_USERNAME="YOUR_PROXY_USERNAME"
export MANTA_PROXY_SCHEME="http"
Windows PowerShell
$env:MANTA_PROXY_HOST="YOUR_PROXY_HOST"
$env:MANTA_PROXY_PORT="YOUR_PROXY_PORT"
$env:MANTA_PROXY_USERNAME="YOUR_PROXY_USERNAME"
$env:MANTA_PROXY_SCHEME="http"
Giữ MANTA_PROXY_SCHEME=http cho proxy HTTP; đổi thành socks5h cho SOCKS5. Khóa http và https trong từ điển mô tả URL đích, còn giá trị dùng giao thức của proxy. Truy cập trang HTTPS không yêu cầu đổi URL proxy HTTP thành https://. socks5h phân giải tên miền qua proxy; socks5 phân giải tại máy cục bộ.
Ví dụ đầy đủ: proxy_example.py
Lưu mã thành proxy_example.py hoặc tải tệp. Ký tự đặc biệt trong tên người dùng và mật khẩu được mã hóa URL tự động. Chương trình chỉ in IP đầu ra, không ghi toàn bộ URL proxy.
"""Test one MantaProxy resource with Requests. Install: requests[socks]."""
import os
from getpass import getpass
from urllib.parse import quote
import requests
def build_proxies():
required = ("MANTA_PROXY_HOST", "MANTA_PROXY_PORT", "MANTA_PROXY_USERNAME")
missing = [name for name in required if not os.environ.get(name)]
if missing:
raise SystemExit("Set these variables first: " + ", ".join(missing))
scheme = os.environ.get("MANTA_PROXY_SCHEME", "http").strip().lower()
if scheme not in ("http", "socks5h"):
raise SystemExit("MANTA_PROXY_SCHEME must be http or socks5h.")
host = os.environ["MANTA_PROXY_HOST"].strip()
if "://" in host or "/" in host or "@" in host:
raise SystemExit("Use the host only, without a URL, port or credentials.")
try:
port = int(os.environ["MANTA_PROXY_PORT"])
if not 1 <= port <= 65535:
raise ValueError
except ValueError:
raise SystemExit("MANTA_PROXY_PORT must be a number from 1 to 65535.")
username = os.environ["MANTA_PROXY_USERNAME"]
password = os.environ.get("MANTA_PROXY_PASSWORD") or getpass("Proxy password: ")
if not password:
raise SystemExit("A proxy password is required.")
if ":" in host and not host.startswith("["):
host = "[" + host + "]"
auth = quote(username, safe="") + ":" + quote(password, safe="")
proxy_url = f"{scheme}://{auth}@{host}:{port}"
return {"http": proxy_url, "https": proxy_url}
def main():
proxies = build_proxies()
with requests.Session() as session:
session.trust_env = False
try:
response = session.get(
"https://api.ipify.org?format=json",
proxies=proxies,
timeout=(10, 30),
)
response.raise_for_status()
exit_ip = response.json()["ip"]
except requests.exceptions.ProxyError:
raise SystemExit("Proxy error: check host, port, protocol and credentials.")
except requests.exceptions.Timeout:
raise SystemExit("Timeout: check proxy reachability and the target site.")
except requests.exceptions.SSLError:
raise SystemExit("TLS error: check system time and trusted CA certificates.")
except requests.exceptions.HTTPError as error:
raise SystemExit(f"HTTP error: {error.response.status_code}")
except requests.exceptions.RequestException:
raise SystemExit("Request failed. Check the configuration and network.")
except (ValueError, KeyError):
raise SystemExit("The IP check did not return the expected JSON result.")
print("Exit IP:", exit_ip)
if __name__ == "__main__":
main()
trust_env=False ngăn cấu hình proxy từ môi trường ảnh hưởng đến phép thử, đồng thời vẫn xác minh chứng chỉ HTTPS. Nếu mạng tổ chức yêu cầu CA riêng, hãy đặt rõ đường dẫn chứng chỉ tin cậy trên Session. Dịch vụ không tương tác có thể nhận MANTA_PROXY_PASSWORD qua cơ chế quản lý bí mật; khi thử cục bộ, dùng lời nhắc mật khẩu.
Dùng lại cấu hình trong yêu cầu của bạn
Đặt mã dưới đây cùng thư mục với proxy_example.py và thay URL đích. Giữ cách xử lý ngoại lệ của ví dụ đầy đủ trong ứng dụng. Requests nhận phản hồi HTTP và không thực thi JavaScript của trang.
import requests
from proxy_example import build_proxies
with requests.Session() as session:
session.trust_env = False
response = session.get(
"https://example.com/",
proxies=build_proxies(),
timeout=(10, 30),
)
response.raise_for_status()
print(response.status_code)
3. Chạy ví dụ và kiểm tra đầu ra
Sau khi đặt tham số, chạy lệnh trong thư mục chứa tệp:
macOS / Linux
.venv/bin/python proxy_example.py
Windows PowerShell
.\.venv\Scripts\python.exe proxy_example.py
- Nhập mật khẩu của proxy đã chọn. Khi thành công, chương trình in Exit IP và địa chỉ thực tế. IP minh họa trong tài liệu không dùng để kết nối.
- So sánh với đầu ra dự kiến của tài nguyên, rồi thử URL thực tế với cùng cấu hình. Kiểm tra IP và truy cập ứng dụng là hai bước riêng.
- timeout=(10, 30) đặt thời gian chờ kết nối và đọc, không phải giới hạn tổng cộng 30 giây. Thử một tài nguyên và một yêu cầu trước, rồi điều chỉnh tải theo gói và yêu cầu của dịch vụ đích.
4. Xử lý sự cố
- Thiếu biến MANTA_PROXY hoặc cổng không hợp lệ: Đặt biến trong cửa sổ lệnh chạy chương trình. Cổng chỉ là số lấy từ bảng điều khiển. Trình soạn thảo và tác vụ định kỳ có môi trường riêng, cần cấu hình tương ứng.
- HTTP 407, lỗi xác thực hoặc Proxy error: Kiểm tra máy chủ, cổng, giao thức và thông tin xác thực của đúng tài nguyên. Không dùng mật khẩu trang web hoặc proxy khác. Lỗi 407 trong đường hầm HTTPS cũng có thể hiện thành ProxyError.
- Missing dependencies for SOCKS support: Cài requests[socks] bằng đúng Python chạy chương trình; xác nhận IDE chọn cùng môi trường ảo.
- Hết thời gian chờ hoặc Read timed out: Kiểm tra tài nguyên còn hiệu lực và mạng truy cập được máy chủ, cổng, rồi kiểm tra trang đích. Chỉ tăng thời gian chờ hoặc số lần thử lại không xác định được nguyên nhân.
- Xác minh chứng chỉ thất bại: Kiểm tra giờ hệ thống, CA của Python và yêu cầu của mạng tổ chức. Cung cấp rõ tệp CA tin cậy khi cần. Không dùng verify=False để xử lý lỗi xác thực hay kết nối.
- IP đầu ra không như dự kiến: Xác nhận chạy đúng tệp hiện tại và truyền proxies trong yêu cầu. Kiểm tra riêng tài nguyên, đầu ra, khu vực và truy cập đích, rồi gửi chẩn đoán đã che thông tin nhạy cảm cho hỗ trợ.
5. Tài liệu chính thức và hướng dẫn liên quan
Requests: proxies / SOCKS · Requests: timeouts / errors · Python: urllib.parse.quote
Đọc thêm: Xem và sao chép thông tin kết nối · FAQ giao thức và cấu hình · FAQ xử lý sự cố kết nối · Liên hệ hỗ trợ kỹ thuật