Sử dụng proxy xoay để kiểm thử hiệu năng API với k6
13 tháng 11, 2026
Tại sao cần proxy xoay cho kiểm thử hiệu năng
Khi chạy thử tải (load testing) lên API công khai hoặc nội bộ, việc gửi hàng nghìn request từ cùng một IP thường dẫn đến giới hạn tốc độ (rate limit), mã trạng thái 429 hoặc thậm chí bị chặn tạm thời. Proxy xoay giải quyết vấn đề này bằng cách thay đổi địa chỉ IP xuất hiện cho mỗi batch request hoặc khi phát hiện lỗi 429, giúp mô phỏng hành vi người dùng thực từ nhiều vị trí địa lý.
Kiến trúc tổng quan
- k6 chạy script thử tải và gửi traffic qua proxy HTTP/HTTPS.
- Proxy được cung cấp bởi dịch vụ xoay (ví dụ: RoProxy) với chế độ timed hoặc sticky.
- Khi k6 nhận được phản hồi 429, một bước xử lý gọi API xoay IP ngay lập tức.
- Quá trình lặp lại cho đến khi đạt mức tải mục tiêu.
Cấu hình proxy cho k6
k6 hỗ trợ proxy qua biến môi trường K6_PROXY hoặc cờ dòng lệnh --proxy. Sử dụng định dạng chuẩn http://USERNAME:PASSWORD@GATEWAY_HOST:HTTP_PORT.
export K6_PROXY=http://USERNAME:PASSWORD@GATEWAY_HOST:HTTP_PORT
k6 run script.js
Nếu gói Pro/Business cung cấp cổng SOCKS5, bạn có thể dùng:
export K6_PROXY=socks5://USERNAME:PASSWORD@GATEWAY_HOST:SOCKS5_PORT
Lưu ý: Thay thế các placeholder bằng thông tin thực tế từ bảng điều khiển của bạn.
Script k6 cơ bản với xử lý 429
Dưới đây là script minh hoạ: gửi request GET đến endpoint /api/items, kiểm tra mã trạng thái, nếu là 429 thì gọi API xoay IP và thử lại sau một khoảng nghỉ ngắn.
// script.js
import http from 'k6/http';
import { check, sleep } from 'k6';
import { Counter } from 'k6/metrics';
const rotateIpCounter = new Counter('rotate_ip_calls');
// Cấu hình API xoay IP (chỉ dùng cho gói Pro/Business)
const ROTATE_ENDPOINT = `https://backend-api.ro-proxy.com/api/session/${__ENV.SESSION_ID}/rotate`;
const API_KEY = __ENV.API_KEY;
function rotateIp() {
const params = {
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json',
},
};
const res = http.post(ROTATE_ENDPOINT, null, params);
rotateIpCounter.add(1);
if (res.status !== 200) {
console.error(`Xoay IP thất bại: ${res.status} ${res.body}`);
} else {
console.log('Đã xoay IP thành công');
}
}
export const options = {
stages: [
{ duration: '30s', target: 50 }, // ramp-up
{ duration: '1m', target: 200 }, // tải ổn định
{ duration: '30s', target: 0 }, // ramp-down
],
thresholds: {
http_req_failed: ['rate<0.01'],
http_req_duration: ['p(95)<500'],
},
};
export default function () {
const url = 'https://api.example.com/api/items';
const params = {
headers: { 'Accept': 'application/json' },
};
let res = http.get(url, params);
// Kiểm tra rate limit
if (res.status === 429) {
console.warn('Nhận 429 -> xoay IP và retry');
rotateIp();
sleep(2); // chờ IP mới ổn định
res = http.get(url, params); // retry một lần
}
check(res, {
'status là 200': (r) => r.status === 200,
'thời gian < 500ms': (r) => r.timings.duration < 500,
});
sleep(1); // giả lập think time
}
Giải thích các phần quan trọng
- Biến môi trường
SESSION_IDvàAPI_KEYđược truyền khi chạy k6 (k6 run -e SESSION_ID=... -e API_KEY=... script.js). Điều này tránh hard‑code secret. - Hàm
rotateIp()gọi endpointPOST /api/session/SESSION_ID/rotatevới headerAuthorization: Bearer API_KEY. Chỉ tài khoản Pro/Business mới có quyền này. Counterghi số lần xoay IP để bạn theo dõi trong báo cáo k6.options.stagesđịnh nghĩa profile tải; bạn có thể điều chỉnh theo kịch bản thực tế.
Tự động xoay IP dựa trên ngưỡng lỗi
Thay vì xoay mỗi lần gặp 429, bạn có thể xoay khi tỷ lệ lỗi vượt ngưỡng (ví dụ >5% trong 10 giây). k6 cung cấp exec và metrics để tính toán, nhưng cách đơn giản là dùng một threshold tùy chỉnh và một setup/teardown script bên ngoài. Ví dụ: chạy một tiến trình giám sát song song đọc file JSON xuất ra từ k6 (--summary-export=summary.json) và gọi API xoay khi cần.
Kiểm soát độ trễ và jitter
Để mô phỏng người dùng thực từ nhiều khu vực, bạn nên thêm độ trễ ngẫu nhiên (jitter) giữa các request. Trong k6:
import { randomIntBetween } from 'https://jslib.k6.io/k6-utils/1.2.0/index.js';
// ... bên trong default function
sleep(randomIntBetween(500, 1500) / 1000); // 0.5‑1.5 giây
Kết hợp với proxy xoay theo chế độ timed (đổi IP sau khoảng thời gian cố định) hoặc sticky (giữ IP cho một session), bạn có thể điều chỉnh options.stages để phù hợp với chu kỳ xoay của proxy.
Xác minh IP xuất hiện
Sau khi chạy thử, hãy kiểm tra IP thực tế mà k6 sử dụng bằng cách request đến dịch vụ echo IP:
curl -x http://USERNAME:PASSWORD@GATEWAY_HOST:HTTP_PORT https://api.ipify.org?format=json
Kết quả trả về JSON chứa ip là địa chỉ IP exit của proxy. Lặp lại vài lần để thấy sự thay đổi khi xoay.
Xử lý lỗi thường gặp
| Lỗi | Nguyên nhân | Khắc phục |
|---|---|---|
ECONNRESET / ETIMEDOUT |
Proxy hết hạn hoặc IP bị chặn | Gọi API xoay IP ngay, tăng sleep trước retry |
407 Proxy Authentication Required |
Sai USERNAME/PASSWORD |
Kiểm tra lại thông tin xác thực trong bảng điều khiển |
502 Bad Gateway / 504 Gateway Timeout |
Cổng proxy quá tải | Giảm độ song song (target), hoặc chuyển sang chế độ sticky để giảm luân phiên |
Tích hợp vào pipeline CI/CD
Trong GitHub Actions, GitLab CI hoặc Jenkins, bạn có thể thêm step chạy k6 với biến môi trường an toàn:
- name: Run k6 load test
env:
K6_PROXY: http://USERNAME:PASSWORD@GATEWAY_HOST:HTTP_PORT
SESSION_ID: ${{ secrets.ROPROXY_SESSION_ID }}
API_KEY: ${{ secrets.ROPROXY_API_KEY }}
run: k6 run script.js --summary-export=summary.json
Sau đó, một step tiếp theo có thể phân tích summary.json và cảnh báo nếu tỷ lệ 429 vượt ngưỡng.
Kết luận
Việc kết hợp k6 với proxy xoay cho phép bạn tái tạo tải thực tế từ nhiều IP, tránh rate limit và thu thập số liệu độ trễ chính xác. Cấu hình đơn giản qua biến môi trường, xử lý 429 bằng API xoay IP, và thêm jitter giúp mô phỏng hành vi người dùng đa dạng. RoProxy cung cấp proxy xoay phù hợp cho kịch bản này.