RoProxy
Quay lại danh sách
Tích hợp proxy vào GitHub Actions để kiểm thử toàn cầu
proxy github-actions cicd testing

Tích hợp proxy vào GitHub Actions để kiểm thử toàn cầu

30 tháng 7, 2026

Tại sao dùng proxy trong pipeline CI/CD?

Trong quá trình phát triển phần mềm, việc kiểm thử ứng dụng chỉ từ một máy chủ hoặc một địa chỉ IP có thể bỏ qua những vấn đề liên quan đến vị trí địa lý, giới hạn tốc độ hoặc cơ chế chặn IP. Khi triển khai ứng dụng trên toàn cầu, bạn cần chắc chắn rằng dịch vụ phản hồi đúng cho người dùng từ các khu vực khác nhau và không bị đánh dấu là bot do quá nhiều request từ cùng một IP.

Proxy cho phép bạn thay đổi địa chỉ IP nguồn của mỗi request, mô phỏng truy cập từ các quốc gia, nhà cung cấp internet hoặc loại kết nối khác nhau. Khi tích hợp proxy vào workflow CI/CD, mỗi lần build hoặc test sẽ tự động sử dụng một tập hợp IP đa dạng, giúp phát hiện sớm các lỗi liên quan đến geo‑blocking, rate limiting hoặc xử lý header dựa trên IP.

Chuẩn bị môi trường

Tạo tài khoản RoProxy và lấy danh sách endpoint

Trước hết, bạn cần đăng ký tài khoản tại RoProxy và chọn gói proxy phù hợp (residential rotating hoặc static ISP tùy thuộc vào trường hợp sử dụng). Sau khi kích hoạt, RoProxy cung cấp một danh sách endpoint dưới dạng host:port cùng với thông tin xác thực (username/password) hoặc token.

Lưu trữ thông tin nhạy cảm dưới dạng secret

Không nên hard‑code credential vào repository. Trong GitHub Actions, bạn có thể lưu trữ chúng dưới dạng secret:

  • PROXY_HOST – địa chỉ host proxy
  • PROXY_PORT – cổng kết nối
  • PROXY_USER – tên người dùng (nếu có)
  • PROXY_PASS – mật khẩu hoặc token

Bạn có thể thêm secret qua Settings → Secrets and variables → Actions → New repository secret.

Cấu hình workflow GitHub Actions

File workflow mẫu

Dưới đây là một file .github/workflows/proxy-test.yml đơn giản chạy trên mỗi push tới nhánh main. Nó cài đặt các Dependencies, thiết lập biến môi trường proxy và chạy script kiểm thử Python.

name: Global Proxy Test

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  test-with-proxy:
    runs-on: ubuntu-latest
    env:
      PROXY_HOST: ${{ secrets.PROXY_HOST }}
      PROXY_PORT: ${{ secrets.PROXY_PORT }}
      PROXY_USER: ${{ secrets.PROXY_USER }}
      PROXY_PASS: ${{ secrets.PROXY_PASS }}
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.11"

      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install requests

      - name: Run proxy test script
        run: |
          python test_proxy.py

Biến môi trường và secret

Trong job trên, chúng ta export bốn biến môi trường từ secret. Script Python sẽ đọc những biến này để xây dựng URL proxy cho thư viện requests. Nếu bạn sử dụng SOCKS5, chỉ cần thay đổi scheme trong URL (xem phần dưới).

Ví dụ script test (Python)

Script kiểm tra endpoint với proxy xoay

Script dưới đây gửi request tới một dịch vụ echo IP (ví dụ: https://ipinfo.io/json) qua proxy xoay. Mỗi lần lặp, chúng ta thay đổi session bằng cách tạo kết nối mới – nhờ RoProxy tự động xoay IP sau mỗi kết nối mới.

import os
import requests
import time

# Đọc cấu hình proxy từ env
proxy_host = os.getenv("PROXY_HOST
)
proxy_port = os.getenv("PROXY_PORT
PROXY_USER
os.getenv("PROXY_PASS
)

# Xây dựng URL proxy HTTP
proxy_url = f"http://{proxy_user}:{proxy_pass}@{proxy_host}:{proxy_port}"n
proxies = {
    "http": proxy_url,
    "https": proxy_url,
}

def test_ip():
    try:
        resp = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=10)
        resp.raise_for_status()
        data = resp.json()
        print(f"IP: {data.get('ip')}, Country: {data.get('country')}, City: {data.get('city')}
)
        return data
    except Exception as e:
        print(f"Lỗi: {e}
)
        return None

if __name__ == "__main__":
    for i in range(5):
        print(f"\nLần thử {i+1}:
)
        test_ip()
        time.sleep(2)  # nghỉ ngắn để tránh kích hoạt rate limit

Lưu ý: Đoạn code trên sử dụng f‑string và các hàm mùi chuẩn của Python. Đảm bảo không có ký tự quote trùm lặp bên trong chuỗi để tránh lỗi khi chạy.

Script kiểm tra với sticky session

Một số trường hợp (ví dụ: đăng nhập, giữ cookies) cần giữ cùng một IP trong một phiên làm việc. RoProxy cung cấp khả năng sticky session bằng cách giữ cùng một endpoint trong một khoảng thời gian nhất định (thường là 10‑30 phút). Để sử dụng sticky, bạn chỉ cần sử dụng cùng một proxy URL cho toàn bộ luồng request mà không thay đổi session.

import os
import requests

proxy_host = os.getenv("PROXY_HOST
)
proxy_port = os.getenv("PROXY_PORT
)
proxy_user = os.getenv("PROXY_USER
)
proxy_pass = os.getenv("PROXY_PASS
)

proxy_url = f"http://{proxy_user}:{proxy_pass}@{proxy_host}:{proxy_port}"n
proxies = {
    "http": proxy_url,
    "https": proxy_url,
}

session = requests.Session()
session.proxies.update(proxies)

# Bước 1: lấy trang login
login_page = session.get("https://example.com/login", timeout=10)
# ... xử lý form, gửi credentials ...

# Bước 2: gửi request sau khi đã login, vẫn dùng cùng IP
profile = session.get("https://example.com/me", timeout=10)
print(profile.json())

Trong ví dụ trên, đối tượng Session sẽ tái sử dụng kết nối TCP và do đó giữ cùng một IP finché session không bị đóng hoặc hết thời gian sticky mà RoProxy cấu hình.

Xử lý lỗi và tối ưu

Giới hạn tốc độ và CAPTCHA

Khi sử dụng proxy xoay, bạn vẫn có thể gặp giới hạn tốc độ nếu quá nhiều request được gửi từ cùng một IP trong thời gian ngắn. Để giảm nguy cơ:

  • Tăng thời gian chờ giữa các request (ví dụ: 2‑5 giây).
  • Sử dụng exponential backoff khi nhận được status 429 hoặc 403.
  • Nếu phát hiện CAPTCHA (trang trả về chứa hình ảnh hoặc JavaScript challenge), dừng luồng và thông báo qua stepGitHub Actions để con người can thiệp.

Debug connection errors

Các lỗi phổ biến khi làm việc với proxy trong CI/CD:

  • ProxyConnectionError: thường do sai host/port hoặc credential. Kiểm tra lại secret và đảm bảo rằng máy runner có thể kết nối tới cổng proxy (thường là 80, 443 hoặc các cổng tùy chỉnh).
  • Timeout: có thể do mạng yếu hoặc proxy過載. Thử tăng timeout trong request hoặc chọnendpoint proxy khác từ danh sách RoProxy.
  • 407 Proxy Authentication Required: chứng thực thất bại. Đảm bảo rằng username/password không có khoảng trắng thừa và được mã hoá đúng trong URL (nếu dùng ký tự đặc biệt, hãy percent‑encode).

Bạn có thể thêm bước debug trong workflow:

- name: Test proxy connectivity
  run: |
    curl -v -x http://$PROXY_USER:$PROXY_PASS@$PROXY_HOST:$PROXY_PORT https://ipinfo.io/ip

Lệnh này sẽ in ra chi tiết handshake và giúp bạn xác định ngay điểm failure.

Kết luận

Việc tích hợp proxy vào pipeline CI/CD không chỉ giúp bạn mô phỏng truy cập từ nhiều vị trí mà còn tăng độ tin cậy của quá trình kiểm thử bằng cách giảm nguy cơ bị chặn IP do rate limiting hoặc cơ chế chống bot. Với RoProxy, bạn có thể dễ dàng xoay IP hoặc giữ sticky session tùy thuộc vào nhu cầu test, tất cả đều được quản lý thông qua secret an toàn trong GitHub Actions.

Bằng cách áp dụng các bước trên – từ việc tạo secret, cấu hình workflow, viết script test sử dụng requests (hoặc bất kỳ thư viện HTTP nào bạn thích), tới việc xử lý lỗi và tối ưu thời gian chờ – bạn sẽ có một hệ thống kiểm thử toàn cầu tự động, phát hiện sớm các vấn đề liên quan đến địa lý và bảo mật trước khi code достигает produzione.

Nếu bạn còn thắc mắc về việc chọn loại proxy (residential vs datacenter vs mobile) hoặc cần hỗ trợ cấu hình cho các ngôn ngữ khác như Node.js, Go hoặc Java, hãy tham khảo tài liệu chi tiết của RoProxy hoặc liên hệ đội ngũ hỗ trợ để được tư vấn cụ thể.