Chuyển đến nội dung chính
Hà Nội DC
Cloud247
29/09/2026 Cập nhật 11/11/2026 5 phút đọc

Tự động xoay IP & cập nhật danh sách IP cho phép của Proxy qua Cloud247 REST API v1

Phân biệt gói Proxy IPv4 tĩnh Việt Nam (giữ cố định IP) với các gói hỗ trợ xoay IP; mẫu lệnh chuẩn OpenAPI v1 cập nhật allowed_cidrs và kích hoạt xoay IP kèm Idempotency-Key.

Trọng tâm: GET/POST /v1/services/{id}/proxy/rotations + access-configurations
Chu trình kiểm thử kết nối và tự động xoay địa chỉ IPv4 cho Proxy qua Cloud247 REST API v1

1. Phân biệt gói Proxy IPv4 tĩnh và các gói Proxy hỗ trợ xoay IP

Trong vận hành đa tài khoản thương mại điện tử hoặc trình duyệt tự động hóa, nguyên tắc cốt lõi là giữ cố định một địa chỉ IPv4 suốt phiên làm việc (Sticky Static IP). Gói Proxy IPv4 tĩnh Việt Nam (10.000₫/tháng hoặc 429₫/ngày) có chính sách ip_change_policy: "disabled", giữ nguyên IP suốt chu kỳ và chỉ cập nhật tài khoản/mật khẩu hoặc dải IP cho phép.

Ngược lại, điểm cuối /proxy/rotations chỉ áp dụng cho các dòng sản phẩm Proxy cấu hình cho phép đổi IP (ip_change_policy != "disabled"). Khi worker thu thập dữ liệu gặp mã HTTP 429 trên gói hỗ trợ xoay, kịch bản có thể gọi REST API v1 để kiểm tra báo phí và kích hoạt cấp địa chỉ mới.

2. Cú pháp gọi điểm cuối cập nhật allowed_cidrs và xoay IP chuẩn OpenAPI v1

Khác với các đường dẫn truyền khóa trên URL dễ lộ trong nhật ký truy cập, Cloud247 API v1 xác thực qua Bearer Header (phân quyền services:control) và bắt buộc truyền Idempotency-Key cho mọi lệnh thay đổi cấu hình hoặc xoay IP:

Thiết lập chu kỳ tự động xoay địa chỉ IP từ 1 đến 10 phút và gắn nhiều mã Key qua API v1 trên giao diện Cloud247 Proxy
Cập nhật allowed_cidrs & gọi xoay IP Proxy chuẩn OpenAPI v1 trên api.cloud247.vn/v1
bash
# 1. Cập nhật tài khoản & dải CIDR IP cho phép (bỏ qua new_password nếu giữ mật khẩu cũ)
curl -s -X POST "https://api.cloud247.vn/v1/services/2048/proxy/access-configurations" \
  -H "Authorization: Bearer $CLOUD247_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acl-2048-$(date +%s)" \
  -d '{
    "username": "pxu_worker01",
    "allowed_cidrs": ["103.82.24.86/32"]
  }'

# 2. Kiểm tra báo phí xoay IP (theo tiền tệ gốc của dịch vụ; chỉ dành cho gói có ip_change_policy != "disabled")
curl -s -H "Authorization: Bearer $CLOUD247_API_TOKEN" \
  -H "Accept: application/json" \
  "https://api.cloud247.vn/v1/services/2048/proxy/rotations/quote"

# 3. Thực thi xoay IP: gửi JSON {} khi miễn phí hoặc {"accepted_quote":"<token>"} khi có phí
curl -s -X POST "https://api.cloud247.vn/v1/services/2048/proxy/rotations" \
  -H "Authorization: Bearer $CLOUD247_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: rot-2048-$(date +%s)" \
  -d '{}'

3. Lưu ý nhịp chờ (Cooldown) khi luân chuyển địa chỉ

Sau khi kích hoạt lệnh xoay IP, hãy thiết lập khoảng nghỉ 3–5 giây trong worker trước khi mở kết nối mới để các phiên TCP cũ kết thúc gọn gàng, tránh đứt gãy luồng dữ liệu đang tải dở.

Bài viết kỹ thuật liên quan

Tiếp tục tham khảo các hướng dẫn vận hành cùng chủ đề trên hệ thống Cloud247:

Tất cả 37 bài viết