# Tiện ích mở rộng Chrome (Beta)

> URL: https://foura.ai/vi/docs/dashboard/chrome-extension
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

Tiện ích mở rộng FourA Chrome cung cấp hai công cụ ngay trong trình duyệt của bạn. **Popup** điều hướng Chrome qua một trong các proxy user của bạn trên [cổng proxy](https://foura.ai/docs/api/proxy-port). **Tab FourA trong DevTools** chuyển đổi mọi request mà trang web tạo ra thành một lệnh gọi API sẵn sàng sử dụng.

Tiện ích mở rộng này hiện là bản beta. Tiện ích chưa có trên Chrome Web Store, vì vậy Chrome sẽ cài đặt nó ở chế độ nhà phát triển, đồng thời giao diện cùng các cài đặt vẫn có thể thay đổi. Tiện ích yêu cầu Chrome phiên bản 116 trở lên và hoạt động trên mọi gói dịch vụ, bao gồm cả gói Miễn phí.

## Cài đặt

Tệp zip nằm trong trang tổng quan: mở **Extension** bên dưới mục **Tools** ở thanh bên và nhấp vào **Download**.

1. Tải xuống tệp zip và giải nén. Giữ lại thư mục này: Chrome sẽ tải tiện ích mở rộng từ đó.
2. Mở `chrome://extensions` và bật **Developer mode** ở góc trên bên phải.
3. Nhấp vào **Load unpacked** và chọn thư mục vừa giải nén.
4. Ghim FourA từ biểu tượng mảnh ghép trên thanh công cụ. Biểu tượng có màu xám khi FourA tắt và hiển thị dấu chấm xanh lá khi đang định tuyến.

### Cập nhật

Tiện ích mở rộng sẽ kiểm tra phiên bản mới mỗi giờ một lần và khi bạn mở popup, ngoài ra nút **Check now** trong mục **Version** ở Cài đặt của popup sẽ kiểm tra ngay lập tức. Khi có phiên bản mới, popup sẽ hiển thị phiên bản đó cùng nút **Download**. Hãy giải nén phiên bản mới và chọn thư mục của nó bằng **Load unpacked**. FourA sẽ tự thay thế và giữ nguyên các cài đặt của bạn, bất kể phiên bản mới đến từ thư mục nào. Nếu bạn giải nén đè lên thư mục hiện tại, chỉ cần nhấn **Reload FourA**. Nếu nâng cấp từ bản 0.3.1 trở về trước, tiện ích sẽ cài đặt một lần dưới dạng thẻ mới: hãy chọn lại proxy user của bạn và xóa thẻ cũ.

## Trước khi bắt đầu

- Một proxy user. Tạo người dùng này trên trang **Proxy** của trang tổng quan: xem [Proxy](https://foura.ai/docs/dashboard/proxy).
- Trang tổng quan đã đăng nhập, trên cùng một trình duyệt Chrome. Tiện ích mở rộng chỉ đọc các proxy user của bạn từ trang tổng quan và không từ nơi nào khác. Khi không có tab trang tổng quan nào mở, tiện ích sẽ mở một tab trong nền để đọc dữ liệu rồi đóng lại.

## Duyệt web qua FourA

Popup có ba trang: **Connect**, **Location** và **Settings**.

### Connect

1. Mở FourA từ thanh công cụ và chọn proxy user mà trình duyệt này sử dụng.
2. Nhấn vào công tắc lớn.
3. Đọc **Address sites see**. FourA đo địa chỉ đó qua đường hầm thay vì phỏng đoán từ cài đặt của bạn, đồng thời hiển thị **Your address** bên cạnh để so sánh.

**Traffic this period** hiển thị dung lượng lưu lượng proxy trong gói mà bạn đã sử dụng.

### Location

- **Mạng:** **Shared** (pool của chúng tôi, lưu lượng gói) hoặc **Premium** (địa chỉ dân cư, lấy từ lưu lượng premium của gói bạn). Ở chế độ Shared, tùy chọn **Dùng premium khi shared không thể tải trang** sẽ chuyển sang cổng ra premium khi mạng shared không thể xử lý request. Tùy chọn này chỉ hoạt động khi gói của bạn bao gồm lưu lượng premium và hạn mức vẫn còn.
- **Quốc gia:** mặc định là bất kỳ quốc gia nào. Các quốc gia bạn đã dùng gần đây chỉ cần một cú nhấp chuột.
- **Vùng**, **Thành phố** và **Nhà mạng:** chỉ dành cho premium, sau khi bạn chọn một quốc gia.
- **Địa chỉ:** **Giữ một** sẽ duy trì cùng một cổng ra, **Mới mỗi request** sẽ thay đổi sau mỗi request, và **Địa chỉ mới** sẽ lấy ngay một địa chỉ mới. Trên premium với tùy chọn **Giữ một**, mục **Giữ trong** sẽ thiết lập thời gian giữ địa chỉ, tính bằng phút hoặc giờ.

Các tùy chọn này tương ứng với các thiết lập cổng proxy được ghi chép trong [Proxy Port](https://foura.ai/docs/api/proxy-port).

### Cài đặt

- **Dữ liệu đi qua tunnel:** **Tất cả ngoại trừ** một danh sách, hoặc **Chỉ các mục này**. `example.com` bao gồm các subdomain của nó, `*` hoạt động như một wildcard, và `203.0.113.0/24` là một dải mạng.
- **Không bao giờ tunnel mạng nội bộ hoặc máy này:** các tên miền không có dấu chấm, `localhost`, `.local` và các dải địa chỉ riêng luôn đi qua kết nối gốc của bạn, bất kể danh sách quy định thế nào.
- **Cho phép các trang http:// thông thường dùng kết nối gốc:** cổng proxy chỉ truyền tải các kết nối mã hóa. Khi tắt, một trang `http://` thông thường sẽ không tải được. Khi bật, trang sẽ tải qua kết nối gốc của bạn và website sẽ thấy địa chỉ thật của bạn.
- **Chặn WebRTC đi vòng qua proxy:** đóng đường dẫn mà trang có thể dùng để đọc địa chỉ thật của bạn khi tunnel đang bật.
- **Cửa sổ ẩn danh:** chúng cũng sử dụng tunnel. FourA chỉ có thể tự điền mật khẩu proxy tại đây khi bạn cho phép: `chrome://extensions`, FourA, **Chi tiết**, **Cho phép ở chế độ ẩn danh**. Cho đến lúc đó, Chrome sẽ hỏi mật khẩu của bạn khi duyệt web ẩn danh.
- **Giao diện:** **Hệ thống**, **Sáng** hoặc **Tối** cho cửa sổ popup.
- **Địa chỉ proxy cho các công cụ khác:** người dùng proxy đã chọn dưới dạng URL proxy, kèm mật khẩu, để dán vào bất kỳ client nào hỗ trợ. Hãy bảo mật thông tin này như mật khẩu.
- **Người dùng proxy:** **Tải lại từ dashboard** sẽ cập nhật các proxy user bạn đã tạo hoặc chỉnh sửa. **Quên trên máy tính này** sẽ xóa chúng khỏi trình duyệt này.

### Khi biểu tượng chuyển sang màu đỏ

Biểu tượng màu đỏ kèm số biểu thị proxy đã từ chối bấy nhiêu kết nối trong phút vừa qua. Mở FourA để kiểm tra nguyên nhân. Những lý do phổ biến nhất:

- **Quá nhiều kết nối cùng lúc:** giới hạn của gói đăng ký về số lượng tunnel đang mở. Một số phần của trang sẽ tải lại khi các kết nối đóng bớt.
- **Quá nhiều kết nối mới trong phút này:** giới hạn của gói đăng ký về số lượng tunnel mới mỗi phút. Hãy đợi một phút trước khi tải lại, vì mỗi lần thử lại cũng được tính.
- **Lưu lượng proxy của chu kỳ này đã hết** hoặc **Lưu lượng Premium đã hết:** mua thêm lưu lượng trên trang **Thanh toán** hoặc đợi chu kỳ tiếp theo.
- **Proxy không có trong gói của bạn:** xem các gói dịch vụ trên trang **Thanh toán**.
- **Proxy không chấp nhận mật khẩu:** người dùng proxy có thể đã được đổi mới hoặc bị xóa trong dashboard. Hãy chọn lại.
- **Tiện ích mở rộng khác đang kiểm soát proxy:** khi một tiện ích mở rộng khác nắm quyền cài đặt proxy của Chrome, FourA sẽ không định tuyến lưu lượng nào. Hãy tắt tiện ích đó, sau đó tắt và bật lại công tắc.

Các giới hạn hiện tại của gói đăng ký nằm trên trang [Sử dụng và Giới hạn](https://foura.ai/docs/dashboard/quota).

## Chuyển đổi Request thành API Call

1. Mở DevTools trên bất kỳ trang nào và chọn tab **FourA**, bên cạnh Network (nằm sau `»` khi cửa sổ DevTools bị thu hẹp). Nếu DevTools đang mở khi bạn cài đặt FourA, hãy đóng và mở lại.
2. Tải lại trang. Tab này sẽ liệt kê các request của trang tương tự như tab Network. Tùy chọn **Ẩn quảng cáo và phân tích** được bật theo mặc định, và **Chỉ trang này** sẽ chỉ giữ lại các request của chính trang đó.
3. Nhập đoạn văn bản bạn thấy trên trang vào ô **Tìm trong phản hồi** để tìm request chứa nội dung đó. Chọn request để xem **Headers**, **Payload** và **Response**.
4. Trong mục **FourA call**, chọn engine (Single, Proxy Finder hoặc Browser) và với Proxy Finder có thể chọn thêm **Quốc gia xuất khẩu**, sau đó sao chép lệnh gọi dưới dạng curl, Python, Node hoặc MCP. Lệnh gọi sẽ giữ nguyên header và cookie mà trang đã sử dụng. Tùy chọn **Mô phỏng cùng trình duyệt và hệ thống như cửa sổ này** được bật theo mặc định: lệnh gọi sẽ yêu cầu hồ sơ trình duyệt khớp với bản Chrome này, hoặc trên Browser nó sẽ gửi user agent của cửa sổ này.
5. Nhấp vào **Mở trong playground** để tải lệnh gọi vào [Playground](https://foura.ai/docs/dashboard/playground) trên dashboard, hoặc chọn **Chạy qua FourA** để thực thi. Sau khi chạy, **Trình duyệt nhận được** và **FourA nhận được** sẽ hiển thị câu trả lời của trang và phản hồi của chúng tôi cạnh nhau.

Nhấp chuột phải vào một request sẽ hiển thị các tùy chọn sao chép tương tự, kèm theo **Sao chép URL**, **Sao chép phản hồi** và **Mở trong tab mới**.

### API Key để Chạy

**Chạy qua FourA** sử dụng một API key và số credit của nó. Thiết lập khóa này trong mục **Cài đặt** của tab:

1. Nhấp vào **Chọn từ dashboard của bạn** và chọn một khóa, hoặc dán khóa vào ô **Hoặc dán API key**.
2. Đánh dấu vào **Lưu khóa trên máy tính này** để duy trì khóa sau khi đóng Chrome. Nếu không, khóa sẽ bị xóa khi Chrome đóng lại.
3. **Quên khóa** sẽ xóa bỏ khóa đã lưu.

Playground sẽ mở với cùng API key đã chọn nếu khóa đó thuộc tài khoản của bạn. Nếu không, nó sẽ yêu cầu bạn chọn một khóa.

## Chi phí

Tiện ích mở rộng này miễn phí. Lưu lượng truy cập được gửi qua các cổng thoát của chúng tôi sẽ tính vào dung lượng proxy trong gói của bạn, tương tự như bất kỳ client nào khác kết nối tới cổng proxy. Các lệnh gọi bạn thực hiện từ DevTools tính phí theo giá API. Xem [Gói cước và Đo lường lưu lượng](https://foura.ai/docs/guides/plans-and-metering).

## Dữ liệu lưu trữ và gửi đi

- Tên người dùng proxy và mật khẩu bạn đã chọn được lưu trên máy tính này.
- Khóa API bạn chọn trong tab DevTools sẽ được giữ lại cho đến khi đóng Chrome, hoặc lưu trên máy tính này khi bạn yêu cầu.
- Không có thông tin nào về các trang bạn truy cập được lưu trữ hoặc gửi tới chúng tôi.
- Tiện ích mở rộng tự động truy vấn ipinfo.io (hoặc Cloudflare và sau đó là api.ipify.org khi dịch vụ trước bận) để kiểm tra địa chỉ IP mà trang web nhìn thấy, truy vấn foura.ai mỗi giờ một lần và mỗi khi bạn mở tiện ích để kiểm tra phiên bản hiện tại, đọc danh sách người dùng proxy và danh sách quốc gia từ trang tổng quan của bạn, cũng như tra cứu địa chỉ của proxy từ dns.google hoặc Cloudflare. Mọi thao tác khác chỉ diễn ra khi bạn bấm nút.
- Lệnh gọi được sao chép kèm cookie sẽ phát lại phiên bạn đang đăng nhập. Hãy xử lý nó như mật khẩu và không dán vào bất kỳ nơi công khai nào.
- Khi bạn thay đổi một cài đặt trong lúc công tắc đang bật, FourA sẽ xóa thông tin xác thực proxy đã lưu của Chrome để cấu hình mới được áp dụng tới proxy. Việc xóa này chỉ áp dụng riêng cho địa chỉ của proxy: cookie của bạn vẫn được giữ nguyên, và phiên đăng nhập trang tổng quan của bạn cũng vậy.

## Giới hạn

- Trình duyệt của bạn tự tạo kết nối mã hóa riêng qua đường hầm, do đó trang web sẽ thấy địa chỉ của chúng tôi và trình duyệt của bạn. Các trang kiểm tra thông tin người gửi yêu cầu, cũng như kết xuất toàn bộ trình duyệt, được xử lý bởi API: xem [Kiểm tra trang web](https://foura.ai/docs/api/site-checks).
- Chrome là trình duyệt duy nhất mà tiện ích mở rộng được phát triển và kiểm thử.
