Bạn có thể triển khai Apidog Request Proxy Agent trên một máy có môi trường mạng phù hợp. Điều này cho phép các yêu cầu endpoint từ Apidog client, web hoặc tài liệu được chia sẻ được định tuyến qua agent này đến endpoint đích.Tính năng này đặc biệt hữu ích để gỡ lỗi endpoint trên các tài liệu được chia sẻ, vì nó giúp giải quyết các vấn đề chia sẻ tài nguyên khác nguồn gốc (CORS). Tính năng này lý tưởng cho các trường hợp trong đó các môi trường khác nhau có các yêu cầu mạng cụ thể, khiến việc gỡ lỗi trực tiếp từ môi trường cục bộ là không thể.Điều kiện tiên quyết#
Một máy chủ, tốt nhất là chạy Linux.
Đã cài đặt Docker trên máy chủ (Phiên bản tối thiểu bắt buộc: 20.10.0. Phiên bản được khuyến nghị: 20.10.13). Triển khai Request Proxy Agent#
Request proxy agent là một tài nguyên cấp nhóm/tổ chức. Sau khi được triển khai, nó có thể được sử dụng trên tất cả dự án trong nhóm hoặc tổ chức của bạn. Để triển khai agent trên máy chủ đã bật Docker, hãy chạy lệnh sau:Bạn có thể cấu hình các thiết lập cơ bản bằng biến môi trường trong quá trình triển khai. Sử dụng các tùy chọn sau khi cần:| Biến môi trường | Mô tả | Ví dụ |
|---|
| SOURCE_IP_WHITELIST | Danh sách các IP nguồn được phép, được phân tách bằng dấu phẩy (Do hạn chế của hệ điều hành, biến này chỉ có thể được sử dụng trên Linux và phải được sử dụng cùng với --network=host.) | --network=host
-e SOURCE_IP_WHITELIST=134.34.4.3,123.333.33.0/24 |
| SOURCE_IP_BLACKLIST | Danh sách các IP nguồn bị chặn, được phân tách bằng dấu phẩy (Do hạn chế của hệ điều hành, biến này chỉ có thể được sử dụng trên Linux và phải được sử dụng cùng với --network=host.) | --network=host
-e SOURCE_IP_BLACKLIST=134.34.4.3,123.333.33.0/24 |
| DESTINATION_DOMAIN_WHITELIST | Danh sách các tên miền đích được phép, được phân tách bằng dấu phẩy | -e DESTINATION_DOMAIN_WHITELIST=xxx.yyy.com,*.yyy.com |
| DESTINATION_DOMAIN_BLACKLIST | Danh sách các tên miền đích bị chặn, được phân tách bằng dấu phẩy | -e DESTINATION_DOMAIN_BLACKLIST=xxx.yyy.com,*.yyy.com |
| DESTINATION_IP_WHITELIST | Danh sách các IP đích được phép, được phân tách bằng dấu phẩy | -e DESTINATION_IP_WHITELIST=134.34.4.3,123.333.33.0/24 |
| DESTINATION_IP_BLACKLIST | Danh sách các IP đích bị chặn, được phân tách bằng dấu phẩy | -e DESTINATION_IP_BLACKLIST=134.34.4.3,123.333.33.0/24 |
| ALLOW_PRIVATE_IP | Cho phép các yêu cầu đến IP nội bộ (boolean, mặc định là false) | -e ALLOW_PRIVATE_IP=false |
Apidog Request Proxy Agent là mã nguồn mở, cho phép bạn tùy chỉnh thêm để đáp ứng nhu cầu của mình (ví dụ: thêm các tham số header tùy chỉnh). Truy cập mã nguồn tại đây.
Thêm Request Proxy Agent trong Apidog#
Sau khi Apidog request proxy agent đang chạy trên Docker, bạn có thể thêm nó vào tài nguyên nhóm trong Apidog. Nhập thông tin host của máy chủ (cổng mặc định là 9159) trong cửa sổ bật lên và nhấp lưu. Sau đó, Apidog sẽ cố gắng kết nối.Nếu kết nối thất bại, bạn sẽ thấy một thông báo và việc tạo sẽ không được cho phép.
Nếu kết nối thành công, request proxy agent sẽ được tạo thành công trong nhóm của bạn.
