---
title: "Thêm, kiểm tra và thay proxy"
locale: vi
url: https://tlg.builera.app/docs/guides/proxies
verified: 2026-10-24
app_version: "2.0"
---

# Thêm, kiểm tra và thay proxy

Quản lý kho proxy, nhập nhiều dòng và gắn proxy riêng cho từng tài khoản Telegram.


Bạn quản lý proxy trong kho của workspace, kiểm tra kết nối rồi gắn cho tài khoản. Mỗi tài khoản dùng một proxy riêng; không dùng chung proxy giữa các tài khoản.

## Ai làm được

Chủ hoặc Quản lý workspace có thể thêm, sửa, kiểm tra và xoá proxy, hoặc thay proxy của tài khoản.

## Cần chuẩn bị

Chuẩn bị host, cổng, loại proxy và thông tin đăng nhập nếu nhà cung cấp yêu cầu. Dùng proxy có IP cố định; proxy bị đánh dấu xoay IP không được chọn khi thêm tài khoản.

Ứng dụng hỗ trợ **SOCKS5** và **HTTP**, có hoặc không có mật khẩu. Chọn đúng loại nhà cung cấp đã cấp; không đổi loại chỉ để thử vượt lỗi.

Cần có máy của workspace đang chạy để thực hiện kiểm tra. Proxy được kiểm từ máy, không phải từ trình duyệt web.

## Bắt đầu ở đâu

Mở **Proxy → Thêm proxy**.

## Các bước

### Thêm từng proxy

1. Chọn **Một proxy**.
2. Chọn **Loại**.
3. Điền **Máy chủ** và **Cổng**.
4. Điền **Tên đăng nhập** và **Mật khẩu** nếu cần.
5. Điền quốc gia khai, nhãn hoặc nhà cung cấp nếu bạn muốn lưu thông tin này.
6. Bấm **Thêm proxy**.

   ![Hộp thêm proxy với loại kết nối và các trường cấu hình](https://tlg.builera.app/docs-media/vi/proxy-add.webp "Chọn đúng loại nhà cung cấp")

### Nhập nhiều proxy

1. Chọn **Dán hàng loạt**.
2. Chọn loại mặc định cho các dòng không có tiền tố giao thức.
3. Dán mỗi proxy trên một dòng.

Bộ đọc hỗ trợ các dạng:

```text
proxy.example.com:1080
proxy.example.com:1080:demo_user:demo_password
demo_user:demo_password@proxy.example.com:1080
socks5://demo_user:demo_password@proxy.example.com:1080
http://demo_user:demo_password@proxy.example.com:8080
```

Đây chỉ là dữ liệu giả minh hoạ cấu trúc. Không dùng chúng như cấu hình kết nối thật.

4. Kiểm tra các dòng hợp lệ và lỗi được báo.
5. Bấm nút thêm theo số proxy hợp lệ.

Thông báo kết quả cho biết số đã thêm và các dòng trùng bị bỏ qua.

### Kiểm tra và gắn tài khoản

1. Đợi kiểm tra tự động sau khi thêm.
2. Chọn **Kiểm lại** nếu muốn yêu cầu một lần kiểm tra mới.
3. Đọc trạng thái và thông tin quan sát được.

| Hiển thị | Cách xử lý |
|---|---|
| **Đạt** | Có thể chọn nếu còn trống và không bị đánh dấu xoay IP |
| **Chậm** | Kiểm tra độ trễ; giao diện thêm tài khoản vẫn có thể cho chọn |
| **Lỗi** | Sửa thông tin hoặc xử lý kết nối trước khi gắn |
| **Lệch quốc gia** | So sánh quốc gia khai với quốc gia IP thực tế |
| **Chờ có máy** | Kết nối máy của workspace để kiểm tra |

**Lệch quốc gia** không đồng nghĩa proxy đã bị chặn. Giao diện có thể cho biết proxy vẫn chạy ở quốc gia thực tế. Hãy xác minh với nhà cung cấp trước khi dùng.

4. Khi thêm tài khoản, chọn proxy ở bước **Proxy** của cửa sổ thêm tài khoản.

### Thay hoặc xoá proxy

> [!WARNING]
> Thay proxy đổi đường kết nối của tài khoản. Kiểm tra quốc gia và trạng thái proxy mới; đọc cảnh báo trong ứng dụng trước khi xác nhận.

Để thay proxy, mở tài khoản → **Mạng & máy**, rồi thực hiện đổi proxy. Không xoá proxy đang gắn để thay thế; trang kho không cho xoá proxy đang dùng.

> [!WARNING]
> Xoá proxy xoá cả mật khẩu đã lưu và không hoàn tác được.

Với proxy còn trống, chọn xoá, đọc xác nhận rồi bấm **Xoá**.

## Kết quả

Proxy được lưu trong kho và có kết quả kiểm tra khi máy xử lý xong. Proxy hợp lệ còn trống có thể được chọn cho tài khoản.

## Kiểm tra

Đối chiếu loại, IP và quốc gia quan sát được. Sau khi thay proxy, kiểm tra lại tài khoản trong **Mạng & máy** và Nhật ký.

## Khi có lỗi

Nếu chưa có máy chạy, đừng sửa mật khẩu chỉ vì proxy chưa được kiểm. Nếu trạng thái Lỗi, đối chiếu host, cổng, loại và thông tin xác thực với nhà cung cấp.

Xem [khắc phục lỗi proxy](https://tlg.builera.app/docs/troubleshooting/proxy-failed).

## Làm bằng API hoặc MCP

Dùng [proxies.add](https://tlg.builera.app/docs/reference/rest/proxies.add), [proxies.recheck](https://tlg.builera.app/docs/reference/rest/proxies.recheck), [accounts.change_proxy](https://tlg.builera.app/docs/reference/rest/accounts.change_proxy) và [proxies.delete](https://tlg.builera.app/docs/reference/rest/proxies.delete).

Tên MCP: `proxies_add`, `proxies_recheck`, `accounts_change_proxy`, `proxies_delete`. Không đưa mật khẩu proxy vào nội dung trao đổi công khai.