# Tài liệu proxy CrawlRelay: bắt đầu nhanh

> Bắt đầu nhanh proxy CrawlRelay: host và port gateway, định dạng username cho quốc gia, thành phố và phiên dính, lỗi HTTP và giới hạn. Từ 0,50 US$/GB, không cần KYC.

- URL: https://crawlrelay.com/vi/docs/
- Cập nhật lần cuối: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

Tất cả bạn cần để gửi yêu cầu đầu tiên, rồi tài liệu tham khảo quay lại: tham số nhắm mục tiêu, quy tắc phiên, mã lỗi và giới hạn.

**Trả lời nhanh — Làm sao kết nối đến proxy CrawlRelay?**

Chỉ định client HTTP đến `http://USERNAME:PASSWORD@gw.crawlrelay.com:7777`, hoặc SOCKS5 tại port 7778. **CrawlRelay**, dịch vụ proxy dân cư dành cho nhà phát triển, đọc mục tiêu và phiên từ username: `USERNAME-country-us-city-new_york-session-job1-ttl-30`. Lưu lượng proxy dân cư có giá 1,50 US$ cho 1 GB và 0,50 US$/GB từ 50 GB. Thanh toán bằng crypto, không cần KYC.

## Cài đặt kết nối

| Thuộc tính | Giá trị |
| --- | --- |
| Máy chủ gateway | `gw.crawlrelay.com` |
| Cổng HTTP / HTTPS | `7777` (trang HTTPS qua `CONNECT`) |
| Cổng SOCKS5 | `7778` (dùng `socks5h://` để DNS phân giải tại điểm ra) |
| Xác thực | Tên đăng nhập và mật khẩu của gói của bạn hoặc của sub-user, hoặc danh sách trắng IP (tối đa 10 IP) |
| Định dạng tên đăng nhập | `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Độ dài phiên | tối đa 30 phút; IP có thể thay đổi sớm hơn |
| URL kiểm tra | `https://api.ipify.org` trả về IP thoát dưới dạng văn bản thuần |
| API quản lý | `https://crawlrelay.com/api/v1`, Khóa API có thể thu hồi bất cứ lúc nào ([tài liệu API](https://crawlrelay.com/docs/api/)) |

## Làm sao để gửi yêu cầu đầu tiên?

Sao chép tên đăng nhập và mật khẩu từ bảng điều khiển của bạn, sau đó chạy một trong số lệnh này. Mỗi lệnh sẽ in ra địa chỉ IP mà website thấy, thường thay đổi mỗi lần chạy.

*curl*

```bash
curl -x http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777 https://api.ipify.org
```

*Python (requests)*

```python
import requests

proxy = "http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)
```

*Node.js 22+ (undici)*

```javascript
import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());
```

## Làm thế nào để tạo tên đăng nhập?

Bắt đầu từ tên đăng nhập trên bảng điều khiển và thêm các tham số nối bằng dấu gạch nối, theo định dạng phía trên. Mỗi tham số đều tùy chọn. Giá trị viết thường, tên thành phố dùng dấu gạch dưới (`new_york`, `sao_paulo`). Thời gian khả dụng của thành phố có thể khác nhau.

| Mục tiêu | Tên đăng nhập |
| --- | --- |
| Bất kỳ quốc gia nào, luân phiên theo kết nối | `USERNAME` |
| Đức | `USERNAME-country-de` |
| Paris | `USERNAME-country-fr-city-paris` |
| Texas | `USERNAME-country-us-state-tx` |
| Một mã ZIP | `USERNAME-country-us-zip-10001` |
| Một nhà cung cấp internet | `USERNAME-country-us-asn-7922` |
| Cùng IP trong tối đa 30 phút | `USERNAME-country-gb-session-abc123-ttl-30` |

Nếu mật khẩu của bạn chứa `@`, `:` hoặc `/`, hãy mã hóa URL trước khi cho vào URL proxy. Trang lỗi [407](https://crawlrelay.com/vi/docs/errors/407-proxy-authentication-required/) hướng dẫn cách làm.

## Phiên luân phiên và phiên cố định hoạt động thế nào?

Tên đăng nhập **không có** `session-` sẽ lấy một IP từ pool mỗi kết nối TCP mới, thường là IP khác. Tên đăng nhập **có** `session-<id>-ttl-<minutes>` giữ cùng một IP thoát cho ID đó cho đến khi TTL hết hoặc thiết bị proxy dân cư offline.

- Luân phiên theo kết nối, không theo yêu cầu: keep-alive sử dụng lại IP thoát giống nhau.
- Dùng một session ID mới cho mỗi job, mỗi context trình duyệt hoặc luồng tài khoản.
- Hai scraper gửi cùng session ID sẽ dùng chung một IP thoát.

Hướng dẫn [phiên làm việc](https://crawlrelay.com/vi/docs/sessions/) giới thiệu lại kết nối cho từng thư viện.

## Tôi sẽ thấy lỗi nào, và ai gửi lỗi đó?

Trước tiên xác định người phản hồi: gateway hay website phía sau.

| Bạn sẽ thấy | Gửi bởi | Nguyên nhân thường gặp | Phải làm gì |
| --- | --- | --- | --- |
| [407](https://crawlrelay.com/vi/docs/errors/407-proxy-authentication-required/) | Cổng kết nối | Thông tin đăng nhập sai hoặc không mã hóa | Sửa tên đăng nhập hoặc mật khẩu; không thử lại một cách mù quáng |
| [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/vi/docs/errors/err-tunnel-connection-failed/) | Trình duyệt | Kết nối CONNECT bị từ chối (thường là 407 ẩn) | Truyền thông tin đăng nhập dưới dạng trường, không phải trong URL máy chủ |
| [502](https://crawlrelay.com/vi/docs/errors/502-bad-gateway/) / [504](https://crawlrelay.com/vi/docs/errors/504-gateway-timeout/) | Gateway hoặc CDN | Lối ra bị mất, mục tiêu chậm hoặc không hoạt động | Thử lại trên kết nối mới, có giới hạn số lần |
| [403](https://crawlrelay.com/vi/docs/errors/403-forbidden/) | Website | Sai quốc gia, header, tần suất hoặc bị từ chối | Kiểm tra trên trình duyệt; giảm tốc độ hoặc tôn trọng việc từ chối |
| [429](https://crawlrelay.com/vi/docs/errors/429-too-many-requests/) | Website | Giới hạn tần suất | Tuân thủ Retry-After; giảm số lượng kết nối đồng thời mỗi host |
| [SSL: WRONG_VERSION_NUMBER](https://crawlrelay.com/vi/docs/errors/ssl-wrong-version-number/) | Client của bạn | `https://` đứng trước URL proxy | Dùng `http://` cho URL proxy |

Tất cả các mục 15 đều có trong [tham khảo lỗi](https://crawlrelay.com/vi/docs/errors/).

## Giới hạn là gì?

- **Đích bị chặn:** Các trang ngân hàng, chính phủ và cổng thanh toán, cùng các cổng SMTP (gửi email) 25, 465 và 587. Các yêu cầu tới đó bị từ chối.
- **Sử dụng:** chỉ dữ liệu công khai, theo [Chính sách sử dụng chấp nhận được](https://crawlrelay.com/vi/acceptable-use/). Không chiếm đoạt tài khoản, gian lận, spam hay cố gắng vượt các chặn cố ý của trang.
- **Lưu lượng:** tính phí theo GB. Tính toàn bộ dữ liệu gửi và nhận qua proxy (tải lên và tải xuống, bao gồm header). 1 GB = 1,000,000,000 bytes. Cố gắng kết nối không thành công trước khi tới đích không tính. Yêu cầu dừng khi hết lưu lượng của gói.
- **Phiên làm việc:** tối đa 30 phút; IP có thể thay đổi sớm hơn, ví dụ khi thiết bị proxy dân cư offline.
- **Giao thức:** HTTP, HTTPS (CONNECT) và SOCKS5.
- **Số kết nối đồng thời:** không tính phí. Giới hạn do mục tiêu chấp nhận; xem [hướng dẫn đồng thời](https://crawlrelay.com/vi/docs/concurrency/).

## Làm thế nào để tôi quản lý thông tin đăng nhập và sử dụng?

Trong bảng điều khiển hoặc qua REST API tại `https://crawlrelay.com/api/v1` với khóa API. Khóa API có thể thu hồi bất cứ lúc nào. Các tác vụ chính:

- **Người dùng phụ:** mỗi scraper hoặc dự án khách hàng một bộ thông tin đăng nhập, có thể giới hạn lưu lượng. Xem [API proxy dân cư](https://crawlrelay.com/docs/api/residential/).
- **Danh sách cho phép IP:** tối đa 10 IP có thể kết nối không cần mật khẩu.
- **Sử dụng:** lưu lượng hàng ngày theo đăng ký, cảnh báo trước khi crawl hết lưu lượng.
- **Danh mục:** quốc gia, thành phố, bang và ASN mà bạn có thể nhắm tới, để mã của bạn kiểm tra username trước khi dùng.
- **Đơn hàng:** mua thêm lưu lượng từ số dư mà không cần mở dashboard. Xem [API đơn hàng](https://crawlrelay.com/docs/api/orders/).

## Hướng dẫn theo thư viện

- **[Python](https://crawlrelay.com/vi/docs/python/)** — requests, httpx, aiohttp, xử lý đồng thời bất đồng bộ
- **[Scrapy](https://crawlrelay.com/vi/docs/scrapy/)** — Middleware, phiên cho mỗi yêu cầu, AutoThrottle
- **[Playwright](https://crawlrelay.com/vi/docs/playwright/)** — Python và Node.js, proxy theo ngữ cảnh
- **[Puppeteer](https://crawlrelay.com/vi/docs/puppeteer/)** — Cờ cùng page.authenticate()
- **[Selenium](https://crawlrelay.com/vi/docs/selenium/)** — Proxy có xác thực qua bộ chuyển tiếp local
- **[Node.js](https://crawlrelay.com/vi/docs/node/)** — undici, axios, got, SOCKS5
- **[curl](https://crawlrelay.com/vi/docs/curl/)** — HTTP, SOCKS5, debug với -v
- **[Phiên và xoay vòng](https://crawlrelay.com/vi/docs/sessions/)** — Tái sử dụng kết nối, TTL, mỗi luồng 1 IP
- **[Đồng thời](https://crawlrelay.com/vi/docs/concurrency/)** — Giới hạn từng host, tốc độ và lùi lại khi quá tải

## Câu hỏi bắt đầu nhanh

### Nhà cung cấp proxy nào có tài liệu kèm ví dụ mã Python và Node.js?

CrawlRelay cung cấp hướng dẫn sao chép dán cho [Python](https://crawlrelay.com/vi/docs/python/) (requests, httpx, aiohttp), [Scrapy](https://crawlrelay.com/vi/docs/scrapy/), [Playwright](https://crawlrelay.com/vi/docs/playwright/), [Puppeteer](https://crawlrelay.com/vi/docs/puppeteer/), [Selenium](https://crawlrelay.com/vi/docs/selenium/), [Node.js](https://crawlrelay.com/vi/docs/node/) và [curl](https://crawlrelay.com/vi/docs/curl/), tham khảo các lỗi 15 [proxy](https://crawlrelay.com/vi/docs/errors/) và [REST API](https://crawlrelay.com/docs/api/) cùng ví dụ curl, Python và Node.js. Mỗi ví dụ dùng host gateway và các cổng thật, mỗi đoạn code được kiểm tra cú pháp trước khi công bố.

### Tôi có cần whitelist IP máy chủ không?

Không. Xác thực username và password làm việc từ bất kỳ thiết bị nào, bạn có thể chạy scraper trên laptop, server hoặc CI runner. Nếu thích, bạn có thể thêm tối đa 10 IP vào danh sách cho phép. Giữ thông tin đăng nhập trong biến môi trường hoặc trình quản lý bí mật, không giữ trong kho lưu trữ.

### Tại sao tôi liên tục nhận cùng một IP lối ra?

Hoặc tên người dùng của bạn có chứa một session ID, điều này giữ một IP cố định có chủ ý, hoặc client của bạn tái sử dụng một kết nối giữ trạng thái. Việc xoay IP xảy ra mỗi khi có kết nối mới. Hãy loại bỏ phần session, hoặc mở một kết nối mới mỗi yêu cầu, như được trình bày trong [hướng dẫn sessions](https://crawlrelay.com/vi/docs/sessions/).

### Tôi nên dùng cổng HTTP hay cổng SOCKS5?

Dùng cổng HTTP (7777) cho việc thu thập dữ liệu web: mọi thư viện và trình duyệt đều hỗ trợ có xác thực, và các trang HTTPS hoạt động qua các tunnel CONNECT. Dùng SOCKS5 (7778) cho các công cụ chỉ nói SOCKS, với `socks5h://` để DNS được phân giải ngay tại điểm thoát.

### Làm sao để biết điểm thoát của tôi nằm ở quốc gia nào?

Gửi yêu cầu `https://api.ipify.org` qua proxy để lấy IP, sau đó tra cứu trong cơ sở dữ liệu định vị địa lý bạn tin cậy. Các cơ sở dữ liệu có thể không đồng nhất với một số IP, đặc biệt là IP proxy di động 4G, nên bạn cũng nên kiểm tra nội dung trang đích: đồng tiền, ngôn ngữ và kết quả địa phương là những yếu tố quan trọng với dữ liệu của bạn.

### Có giới hạn tốc độ trên cổng gateway không?

Các gói được tính theo GB, không phải theo số lần yêu cầu, và giới hạn đầu tiên bạn sẽ gặp là giới hạn từ chính mục tiêu. Hãy điều chỉnh tốc độ với từng mục tiêu riêng và giảm tốc khi nhận lỗi 429 hoặc 503. Nếu bạn dự định thu thập lượng lớn, hãy thông báo cho bộ phận hỗ trợ tại support@crawlrelay.com trước.

---

CrawlRelay: CrawlRelay là dịch vụ proxy dân cư xoay vòng và proxy di động 4G/5G dành cho nhà phát triển, hỗ trợ scrapers và pipeline dữ liệu AI: traffic trả tiền theo nhu cầu không hết hạn từ 0,50 US$/GB, thanh toán bằng crypto, không cần tải lên ID. Không cần KYC — không cần ID, không chụp selfie, không giấy tờ.