Chuyển đến nội dung chính
Hướng dẫn AI

Cách kiểm tra cấu hình proxy Gemini và Google AI Studio bằng Gemini Config Checker

Tìm hiểu cách cài đặt Gemini Config Checker, quét cấu hình proxy ở chế độ Đơn giản hoặc Nâng cao, xác minh quyền truy cập Google AI Studio và Gemini, áp dụng cài đặt chống DPI, diễn giải kết quả và xuất các tuyến hoạt động cho ứng dụng khách tương thích với Xray.

Thời gian đọc khoảng 29 phút
Cách kiểm tra cấu hình proxy Gemini và Google AI Studio bằng Gemini Config Checker

Gemini Config Checker thực hiện những gì

Gemini Config Checker kiểm tra các cấu hình proxy để xác định liệu chúng có thể truy cập Google AI Studio và Gemini hay không. Khác với phép kiểm tra HTTP cơ bản, chế độ kiểm tra khu vực mở các dịch vụ trong trình duyệt dựa trên Chromium đã đăng nhập và đọc kết luận mà Google hiển thị cho tài khoản.

Điểm khác biệt này quan trọng vì Google xác định khả dụng theo khu vực sau khi trang đã đăng nhập được tải. Một tuyến có thể truy cập Google thành công nhưng vẫn bị chặn khỏi AI Studio, Gemini hoặc cả hai. Cùng một điểm thoát proxy cũng có thể nhận các kết quả khác nhau theo thời gian.

Phiên bản 0.1.0 là bản phát hành thử nghiệm sớm. Quy trình đầy đủ đã được kiểm thử trên Windows. Các gói cho macOS, Linux và Android được CI tạo ra, nhưng README lưu ý rằng chúng chưa được chạy thử trên thiết bị thực tế.

Tính năng chính

  • Xác minh khu vực khi đã đăng nhập: Kiểm tra các thông báo và chuyển hướng do Google AI Studio và Gemini hiển thị.
  • Kiểm tra chỉ kết nối: Xác nhận tuyến có thể truy cập Google và đo độ trễ mà không yêu cầu đăng nhập trình duyệt.
  • Chế độ đơn giản: Kiểm tra trực tiếp các cấu hình proxy từ thiết bị của bạn.
  • Chế độ nâng cao: Nối các cấu hình miễn phí phía sau một cấu hình cơ sở đang hoạt động để tìm các điểm thoát thay thế.
  • Nhiều định dạng đầu vào: Chấp nhận các liên kết chia sẻ được hỗ trợ, URL đăng ký, nội dung đăng ký base64 và, khi phù hợp, các cấu hình Xray JSON hoàn chỉnh.
  • Hồ sơ chống DPI: Áp dụng các thiết lập phân mảnh, dấu vân tay, ALPN, bộ mật mã và IP sạch có thể chỉnh sửa.
  • Lọc và xuất kết quả: Sao chép liên kết, tạo gói đăng ký base64 và tạo cấu hình Xray.
  • Gói đa nền tảng: Bản phát hành bao gồm các biến thể dành cho máy tính để bàn, máy chủ web và Android, tùy thuộc vào các giới hạn riêng của từng nền tảng.

Tìm hiểu chế độ đơn giản và nâng cao

Chế độ đơn giản

Sử dụng chế độ Đơn giản khi bạn đã có một tập hợp cấu hình và muốn xác định cấu hình nào hoạt động. Tuyến được kiểm tra là:

you -> config -> AI Studio or Gemini

Bạn có thể cung cấp các liên kết vless://, vmess://, trojan:// hoặc ss://, một URL đăng ký hoặc văn bản đăng ký base64. Bạn cũng có thể để trống đầu vào và chọn một danh sách miễn phí có sẵn.

Chế độ nâng cao

Sử dụng chế độ Nâng cao khi bạn có một cấu hình cơ sở kết nối thành công nhưng cần một điểm thoát khác được Google chấp nhận. Tuyến sẽ trở thành:

you -> base config -> free config -> AI Studio or Gemini

Cấu hình cơ sở có thể là một liên kết chia sẻ, một cấu hình Xray JSON hoàn chỉnh hoặc một chuỗi nhiều chặng. Trước khi quét các ứng viên, ứng dụng kiểm tra tuyến cơ sở và dừng lại nếu tuyến này không thể truy cập Google.

Trong chế độ này, các thiết lập chống DPI ảnh hưởng đến chặng đầu tiên của cấu hình cơ sở. Các cấu hình Xray được xuất vẫn giữ nguyên chuỗi base -> free.

Cài đặt và thiết lập

Tải xuống và xác minh bản phát hành

  1. Mở trang Releases của dự án.
  2. Tải xuống gói tương ứng với hệ điều hành và kiến trúc của bạn.
  3. Khi có thể, sử dụng tệp SHA256SUMS.txt đi kèm để xác minh bản tải xuống.

Windows

  1. Tải xuống tệp ZIP ứng dụng máy tính để bàn Windows dành cho amd64 hoặc arm64.
  2. Giải nén vào thư mục tùy chọn.
  3. Chạy GeminiConfigChecker.exe.
  4. Nếu SmartScreen cảnh báo về bản dựng chưa được ký, hãy chọn More info, sau đó chọn Run anyway nếu bạn tin cậy bản phát hành đã tải xuống.

Việc kiểm tra khu vực yêu cầu Chrome, Edge hoặc Brave. WebView2 được tích hợp trong Windows 10 và Windows 11.

macOS

  1. Tải xuống và giải nén gói macOS phổ quát.
  2. Di chuyển ứng dụng vào Applications.
  3. Trong lần khởi chạy đầu tiên, nhấp chuột phải vào ứng dụng và chọn Open.

Nếu macOS tiếp tục chặn ứng dụng, README cung cấp lệnh sau:

xattr -dr com.apple.quarantine "/Applications/GeminiConfigChecker.app"

Linux

Trên Debian hoặc Ubuntu, cài đặt các thư viện runtime dành cho máy tính để bàn:

sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0

Giải nén kho lưu trữ và khởi động ứng dụng máy tính để bàn:

tar -xzf gemini-config-checker-desktop_<version>_linux_amd64.tar.gz
./GeminiConfigChecker

Sử dụng bản dựng máy chủ web trên máy không có môi trường máy tính để bàn:

./gemini-config-checker

Sau đó mở http://localhost:8787. Việc kiểm tra khu vực trên Linux yêu cầu Chrome, Chromium, Edge hoặc Brave và một phiên đồ họa.

Android

  1. Tải tệp APK arm64-v8a trên thiết bị Android 8 hoặc mới hơn.
  2. Cho phép cài đặt từ trình duyệt hoặc trình quản lý tệp được dùng để mở tệp.
  3. Cài đặt và khởi chạy ứng dụng.

Android hỗ trợ quét chỉ kết nối, không hỗ trợ kiểm tra khu vực khi đã đăng nhập. Thông báo cố định giúp engine quét tiếp tục hoạt động khi màn hình tắt. Sử dụng thao tác Stop trong thông báo để tắt engine.

Nếu APK mới hơn sử dụng khóa ký khác, nó không thể cập nhật bản cài đặt hiện có tại chỗ. Hãy gỡ cài đặt bản dựng cũ trước khi cài đặt bản mới.

An toàn máy chủ web

Máy chủ web chấp nhận các tùy chọn như:

./gemini-config-checker -addr 127.0.0.1:8787
./gemini-config-checker -no-open
./gemini-config-checker -version

Giao diện không có xác thực. Hãy giữ máy chủ chỉ liên kết với localhost. Để truy cập từ xa, hãy tạo đường hầm thay vì công khai máy chủ:

ssh -L 8787:localhost:8787 your-server

Kết nối tài khoản Google để kiểm tra khu vực

Ứng dụng có các tab Quét, Kết quả và Xuất. Trước khi thực hiện kiểm tra khu vực chính xác, hãy kết nối tài khoản Google:

  1. Chọn Đăng nhập bằng Google.
  2. Chờ Chrome, Edge hoặc Brave mở một cửa sổ với hồ sơ riêng được ứng dụng sử dụng.
  3. Đăng nhập như bình thường. Ứng dụng không nhận mật khẩu của bạn.
  4. Chờ trình duyệt tự động đóng và giao diện thông báo tài khoản Google đã được kết nối.

Nên sử dụng tài khoản phụ vì các yêu cầu có thể xuất phát từ nhiều địa chỉ IP, khiến Google cảnh báo đăng nhập đáng ngờ. Chọn Xóa tài khoản khỏi ứng dụng sẽ xóa hồ sơ riêng của ứng dụng mà không thay đổi hồ sơ trình duyệt thông thường của bạn.

Nếu không có trình duyệt được hỗ trợ, hãy đổi loại kiểm tra thành chỉ kết nối. Tùy chọn này không yêu cầu đăng nhập, nhưng không thể cho biết Google có cho phép khu vực thoát hay không.

Sử dụng cơ bản: Quét cấu hình ở chế độ đơn giản

  1. Đặt công tắc tiêu đề thành Đơn giản.
  2. Dán mỗi dòng một liên kết proxy được hỗ trợ. Bạn cũng có thể dán URL đăng ký hoặc gói đăng ký base64.
  3. Nếu muốn quét danh sách miễn phí tích hợp sẵn, hãy để trống ô nhập và chọn một trong các danh sách có sẵn.
  4. Bật Anti-DPI nếu các cấu hình dựa trên Cloudflare thông thường không thể kết nối qua mạng của bạn.
  5. Chọn Khu vực với trình duyệt đã đăng nhập để có kết luận về khả năng truy cập hoặc Chỉ kết nối để kiểm tra khả năng tiếp cận nhanh hơn.
  6. Chọn Bắt đầu quét hoặc nhấn Ctrl và Enter.
  7. Mở tab Kết quả để theo dõi các mục xuất hiện.

Một dữ liệu đầu vào cơ bản có thể trông như sau:

vless://...
vmess://...
trojan://...
ss://...

Trình quét trước tiên loại bỏ các cấu hình không thể kết nối trong quá trình kiểm tra kết nối. Ở chế độ khu vực, các tuyến còn hoạt động sẽ tiếp tục được kiểm tra bằng trình duyệt đối với AI Studio và Gemini.

Sử dụng cơ bản: Tạo chuỗi ở chế độ nâng cao

  1. Chuyển sang Nâng cao.
  2. Dán một cấu hình cơ sở đang hoạt động. Đây có thể là liên kết chia sẻ, JSON Xray đầy đủ hoặc chuỗi nhiều chặng hiện có.
  3. Bật anti-DPI khi kết nối đầu tiên rời khỏi máy của bạn cần tính năng này.
  4. Chọn nguồn cấu hình miễn phí. README đề xuất danh sách verified, còn custom chấp nhận URL đăng ký.
  5. Bạn cũng có thể tự dán các cấu hình miễn phí cần kiểm tra.
  6. Xác nhận loại kiểm tra và cài đặt đăng nhập trình duyệt.
  7. Bắt đầu quét.

Ứng dụng xác thực cấu hình cơ sở trước khi kiểm tra các tuyến miễn phí phía sau nó. Nếu cấu hình cơ sở không thể kết nối đến Google, hãy sửa cấu hình trước khi tiếp tục.

Cấu hình hồ sơ Anti-DPI

Hồ sơ anti-DPI được thiết kế cho các mạng bị lọc, nơi cấu hình Cloudflare thuần túy không hoạt động. Các giá trị mặc định được đề xuất gồm hai mặt nạ phân mảnh, dấu vân tay unsafe, ALPN http/1.1, danh sách mật mã gồm 13 bộ được xác định trước và một IP sạch tùy chọn.

  • Finalmask: Chia TLS ClientHello theo các mặt nạ phân mảnh của công thức.
  • Fingerprint: Mặc định là unsafe, sử dụng TLS Go gốc để áp dụng danh sách mật mã đã cấu hình.
  • ALPN: Mặc định là http/1.1.
  • Các bộ mật mã: Sử dụng danh sách được xác định bởi công thức anti-DPI được tham chiếu.
  • IP sạch: Thay thế địa chỉ kết nối nhưng giữ lại miền gốc cho SNI và Host.

Chọn Đọc từ cấu hình để nhập các giá trị tương thích từ các trường JSON như finalmask, cipherSuites và alpn, hoặc từ các tham số liên kết như fm, ciphers, alpn và fp. Chọn Giá trị đề xuất để khôi phục các giá trị mặc định.

Trình chuyển tiếp cục bộ của ứng dụng tái tạo hành vi lengths và delays theo từng phân đoạn được PattN Xray fork sử dụng. Chỉ hỗ trợ các mặt nạ fragment. Hãy tắt hồ sơ này bên ngoài các mạng bị lọc vì nó làm tăng độ trễ.

Chọn cài đặt quét phù hợp

  • Loại kiểm tra: Chế độ khu vực chính xác nhưng mất khoảng 20 đến 40 giây cho mỗi cấu hình. Chế độ kết nối nhanh hơn nhưng không xác minh quyền truy cập theo khu vực.
  • Được xem là hoạt động khi: Yêu cầu cả hai sản phẩm, chỉ AI Studio hoặc chỉ Gemini.
  • Số cấu hình tối đa: Mặc định là 60, danh sách ứng viên được xáo trộn trước khi kiểm tra.
  • Số lượt kiểm tra trình duyệt đồng thời: Mặc định là bốn. Mỗi lượt kiểm tra trình duyệt sử dụng khoảng 200 MB bộ nhớ, vì vậy hãy giảm số này trên các hệ thống nhỏ hơn.
  • Số lượt kiểm tra kết nối đồng thời: Mặc định là 20.
  • Thời gian chờ kết nối: Mặc định là 10 giây và có thể tăng lên cho các tuyến chậm hơn.
  • Ghi nhớ: Lưu cấu hình và cài đặt vào bộ nhớ cục bộ trên thiết bị. Hãy tắt tùy chọn này trên máy tính dùng chung.

Diễn giải kết quả

  • Hoạt động: Ở chế độ khu vực, tuyến đã vượt qua quy tắc sản phẩm được chọn.
  • Đã kết nối: Ở chế độ kết nối, tuyến đã kết nối đến Google nhưng khu vực chưa được xác minh.
  • Bị chặn theo khu vực: Ít nhất một sản phẩm bắt buộc đã hiển thị giới hạn theo khu vực.
  • Lỗi: Cấu hình không thể truy cập, đã hết thời gian chờ hoặc gặp sự cố với trình duyệt. Di chuột lên nhãn để xem lý do được báo cáo.
  • Ping: Đo một yêu cầu thông qua toàn bộ tuyến.

Các cột AI Studio và Gemini hiển thị kết quả riêng biệt vì các sản phẩm có thể áp dụng những quy tắc khu vực khác nhau. Bạn có thể lọc theo trạng thái, tìm kiếm theo tên hoặc địa chỉ, sắp xếp theo ping hoặc tên, và chọn nhiều mục để sao chép hàng loạt.

Kết quả đạt yêu cầu chỉ là kết quả kiểm tra mẫu, không phải sự bảo đảm vĩnh viễn. Các điểm thoát của Cloudflare Worker có thể thay đổi giữa các lần kết nối, vì vậy hãy kiểm tra lại tuyến mà bạn định sử dụng lâu dài.

Xuất cấu hình hoạt động

Dùng Copy để sao chép liên kết chia sẻ vào bộ nhớ tạm. Bạn có thể dán liên kết này vào các ứng dụng như v2rayN, Hiddify hoặc PattN, hoặc vào trường Chain Proxy của BPB.

Ở chế độ Simple, Copy full config tạo cấu hình Xray cho tuyến đã chọn. Ở chế độ Advanced, Copy with chain tạo chuỗi hoàn chỉnh từ base đến free. Thẻ Export cũng có thể tạo đầu ra mỗi liên kết trên một dòng, gói đăng ký base64 hoặc tệp JSON đã lưu.

Hãy chọn đích xuất cẩn thận:

  • PattN hoặc PattNG: Chọn tùy chọn có finalmask.
  • Xray gốc hoặc v2rayN: Chọn tùy chọn tiêu chuẩn, tùy chọn này loại bỏ finalmask vì các core gốc không thể phân tích schema riêng của bản fork.

Các tệp được tạo sử dụng inbound hỗn hợp trên các cổng 10808 và 10809, DNS được cố định và một khối UDP trên cổng 443. Trong v2rayN, chọn Servers, sau đó chọn Add custom configuration server. Bạn cũng có thể kiểm tra trực tiếp một tệp đã tạo:

xray run -c file.json

Mẹo nâng cao và xử lý sự cố

Sử dụng đúng quy tắc kiểm tra trạng thái

Nếu AI Studio hoạt động nhưng Gemini bị chặn, hoặc ngược lại, hãy thay đổi Healthy means để phù hợp với sản phẩm bạn thực sự cần. Hai dịch vụ có thể trả về kết luận khu vực khác nhau.

Giảm mức sử dụng bộ nhớ

Giảm số lần kiểm tra trình duyệt đồng thời trên các máy có bộ nhớ hạn chế. Kiểm tra kết nối tốn ít tài nguyên hơn và có thể duy trì mức đồng thời cao hơn, trừ khi mạng bị quá tải.

Khắc phục lỗi phát hiện trình duyệt

Nếu không tìm thấy trình duyệt được hỗ trợ, hãy cài đặt Chrome, Edge, Brave hoặc một biến thể Chromium được hỗ trợ. Với trình duyệt ở vị trí không chuẩn, hãy đặt GCC_BROWSER hoặc CHROME_BIN thành đường dẫn đến tệp thực thi của trình duyệt. Ứng dụng không thể điều khiển các trình duyệt Flatpak.

Xử lý tình trạng hết thời gian chờ trên diện rộng

Nếu mọi tuyến đều hết thời gian chờ, hãy xác minh các cấu hình trong ứng dụng proxy thông thường của bạn. Ở chế độ Advanced, hãy xác nhận rằng cấu hình base hoạt động. Trên các mạng bị lọc, hãy bật cấu hình chống DPI và thử một IP sạch.

Khôi phục phiên đã hết hạn

Nếu ứng dụng thông báo phiên Google đã hết hạn, hãy đăng nhập lại. Các yêu cầu lặp lại từ những địa chỉ IP thay đổi có thể khiến Google yêu cầu kiểm tra bảo mật lần nữa.

Đặt lại ứng dụng

Trước tiên, hãy xóa tài khoản khỏi ứng dụng, sau đó xóa dữ liệu cục bộ nếu cần:

  • Windows: %AppData%\GeminiConfigChecker
  • macOS: ~/Library/Application Support/GeminiConfigChecker
  • Linux: ~/.config/GeminiConfigChecker

Xây dựng từ mã nguồn

Việc xây dựng yêu cầu phiên bản Go được chỉ định trong go.mod. Bản dựng cho máy tính để bàn cũng yêu cầu Wails v2 và các phần phụ thuộc webview của nền tảng. Bản dựng Android yêu cầu Android SDK, JDK 17 trở lên và Gradle 8.10.

make test
make web
make desktop
make android
make dist VERSION=0.1.0

make test chạy vet và các bài kiểm tra đơn vị. Các lệnh còn lại xây dựng máy chủ web, ứng dụng máy tính để bàn gốc, APK Android hoặc các tệp nhị phân phân phối được biên dịch chéo.

Cân nhắc về quyền riêng tư và bảo mật

  • Đăng nhập Google diễn ra trong một hồ sơ trình duyệt riêng thay vì bên trong ứng dụng.
  • Ứng dụng không nhận mật khẩu Google của bạn.
  • Cấu hình và cài đặt được lưu trong bộ nhớ cục bộ và chỉ được lưu khi bật Remember.
  • Lưu lượng đến Google vẫn được bảo vệ bằng TLS đầu cuối, nhưng nhà vận hành proxy miễn phí vẫn có thể quan sát các đích truy cập.
  • Không gửi lưu lượng nhạy cảm qua các cấu hình miễn phí do những bên không rõ danh tính vận hành.
  • Không để lộ giao diện web chưa xác thực trên mạng công cộng.

Kết luận

Gemini Config Checker cung cấp một cách thiết thực để phân biệt khả năng kết nối đơn giản với khả năng truy cập Google AI Studio và Gemini thực tế theo khu vực. Hãy bắt đầu với chế độ Simple để kiểm tra trực tiếp, sử dụng chế độ Advanced khi cần một điểm thoát thay thế phía sau tuyến base đáng tin cậy, và xuất các kết quả thành công theo định dạng mà ứng dụng của bạn hỗ trợ. Vì các tuyến và kết luận khu vực có thể thay đổi, hãy luôn kiểm tra lại cấu hình trước khi tin cậy sử dụng.