ip2vn

SDK Python chính thức của IP2.VN — điều khiển proxy xoay IP dân cư Viettel cho bên làm tool tích hợp. Không phụ thuộc thư viện ngoài (chỉ dùng urllib chuẩn), cần Python 3.8+.

pip install ip2vn

Mô hình giới thiệu (hoa hồng 10%)

Tool của bạn nhúng mã giới thiệu công khai của bạn và đưa người dùng đăng ký qua IP2.ref_link('MÃ'). Người dùng tự mua proxy, tự tạo key theo từng cổng rồi dán vào tool; bạn ăn 10% chi tiêu của họ.

An toàn: chỉ nhúng mã giới thiệu (công khai). TUYỆT ĐỐI không nhúng key, mật khẩu hay token vào tool phát đi — tool nào cũng bung xem được. Key là của chính người dùng cuối, không phải của bạn.

Dùng

from ip2vn import IP2, IP2Error

# Link đưa cho người dùng để họ gắn với bạn:
print(IP2.ref_link("MÃ_GIỚI_THIỆU_CỦA_BẠN"))   # https://ip2.vn/?ref=...

# Người dùng dán key cổng của họ vào tool của bạn:
cong = IP2("ip2_xxxxxxxxxxxx")

tin = cong.info()        # host, port, ip, cooldown, expire_at, ...
kq  = cong.rotate()      # { ip, previous_ip, took, next_allowed_in }
cong.auto(300)           # hẹn tự xoay mỗi 300s (0 để tắt, thấp nhất 180)
ls  = cong.history(limit=20)
cong.renew(30)           # gia hạn 1/7/30 ngày, trừ ví người dùng

# Chuỗi proxy sẵn dùng (user/pass proxy do người dùng nhập):
px = cong.proxy("u", "p")
print(px["url"])   # http://u:p@host:port
print(px["tho"])   # host:port:u:p

try:
    cong.rotate()
except IP2Error as e:
    print(e.code, e.message, e.retry_after)

Khoá theo mã giới thiệu (tuỳ chọn)

Muốn tool chỉ chạy cho khách đã đăng ký qua bạn? Truyền ref là mã giới thiệu của bạn — SDK hỏi máy chủ xem chủ key có phải khách của bạn không, không phải thì mọi lệnh ném IP2Error code sai_ref:

cong = IP2(key_nguoi_dung, ref="MÃ_GIỚI_THIỆU_CỦA_BẠN")
cong.rotate()   # chỉ chạy nếu key thuộc khách bạn giới thiệu

Không truyền ref thì không khoá gì. Lưu ý: đây là khoá mềm — phép kiểm đúng ở máy chủ, nhưng quyết định khoá nằm trong SDK nên người bẻ khoá tool vẫn qua được, và chỉ chặn lệnh đi qua SDK, không chặn ai cắm thẳng host:port:user:pass.

Phương thức

Lỗi ném ra IP2Error với .code (máy đọc), .message (tiếng Việt), .status (HTTP), .retry_after (giây, khi dính cooldown).

Cổng nghe cả HTTP lẫn SOCKS5 trên cùng một port — chọn giao thức chỉ đổi cách viết chuỗi, không đổi port.

MIT © IP2.VN