Gemini Config Checker – Google AI Studio·Gemini 접속을 위한 프록시 테스트 도구

Google이 제공하는 AI Studio와 Gemini는 지역별 접근 제한이 존재합니다. 실제 사용자가 로그인한 브라우저에서만 정확히 접속 가능 여부를 확인할 수 있기 때문에, 프록시 설정을 한 번에 검증해 주는 도구가 필요합니다. 바로 “Gemini Config Checker”입니다. 이 프로그램은 Windows(현재 테스트 완료), macOS, Linux 등 다양한 플랫폼에서 실행되며, 사용자 인증이 필요한 Google 서비스에 접속하여 실제로 접근 가능한지 여부를 자동으로 판단합니다.
주요 기능
- Simple / Advanced 모드 : Simple 모드는 사용자가 가진 프록시 설정을 바로 테스트하고, Advanced 모드는 Cloudflare 기반 기본 설정 뒤에서 다른 무료 프록시를 체인화해 Google이 허용하는지를 검사합니다.
- Signed‑in 브라우저 검증 : Chrome/Edge/Brave 등 별도 프로필로 로그인한 상태에서 AI Studio와 Gemini에 접속, 지역 차단 여부를 정확히 판별합니다.
- Export 기능 : 테스트가 성공한 프록시의 링크, Base64 문자열 또는 Xray-core 설정 파일을 한 번에 내보낼 수 있어 다른 클라이언트(2dust/v2rayN 등)로 바로 가져갈 수 있습니다.

YellowLaborerMarket/Gemini-Config-Checker- 주요 기능 요약
기술적인 특징
- 프록시 엔진 : Xray‑core를 기반으로 하여, PattNG와 유사한 anti‑DPI 레시피 및 Finalmask 프래그먼트를 사용합니다.
- UI 플랫폼 : Wails 프레임워크로 제작된 네이티브 데스크톱 앱(Windows/macOS/Linux)과 웹 서버 버전이 제공됩니다.
- 지원 환경 : Windows 10/11 (WebView2 포함), macOS universal, Linux GTK3+WebKitGTK4.1 등에서 실행 가능하며 Android는 연결성만 지원합니다.
설치 방법
# Windows 예시(amd64)
1. gemini-config-checker-desktop_0.1.0_windows_amd64.zip 다운로드 후 압축 해제
2. GeminiConfigChecker.exe 실행 (SmartScreen 경고 시 'More info → Run anyway' 선택)
# macOS 예시(universal)
1. gemini-config-checker-macos_universal.zip 다운로드 및 unzip
2. .app 파일을 Applications 폴더에 이동
3. 첫 실행 시 우클릭 → Open, 필요 시 xattr 명령어로 quarantine 해제
# Linux 예시(amd64)
sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 # 런타임 라이브러리 설치
tar -xzf gemini-config-checker-desktop_0.1.0_linux_amd64.tar.gz
./GeminiConfigChecker
# Web server (모든 OS)
./gemini-config-checker # http://localhost:8787 에 UI 제공

GitHub YellowLaborerMarket/Gemini-Config-Checker- 공식 페이지 화면
활용법
- 프록시 설정 검증 : 이미 확보한 프록시 리스트를 Simple 모드에 입력해 바로 테스트하고, 정상 동작하는 것만 남겨 두어 신뢰성 있는 프로필을 구성합니다.
- 지역별 차단 우회 체인 구축 : Cloudflare 기반 기본 설정이 Google에서 차단될 경우 Advanced 모드를 이용해 다른 무료 프록시를 뒤에 연결하여 지역 제한을 회피할 수 있습니다.
- 다른 클라이언트와 연동 : Export 기능으로 Xray‑core 형식의 설정 파일을 생성하면, v2rayN이나 PattNG 같은 기존 클라이언트에서 바로 가져와 사용할 수 있어 운영 효율이 높아집니다.
정리
Gemini Config Checker는 실제 로그인된 브라우저를 통해 Google AI Studio·Gemini 접속 여부를 정확히 판단해 주는 유틸리티입니다. 프록시 설정 검증과 체인 구축을 한 번에 수행할 수 있어, 개인 사용자부터 기업 IT 운영자까지 활용도가 높습니다. 다만 아직 macOS, Linux, Android에서 완전 테스트가 진행되지 않았으므로, Windows 사용자가 가장 안정적인 환경이라고 할 수 있습니다. 프록시를 자주 교체하거나 지역 제한을 우회해야 하는 분들에게 적극 추천합니다.
참고 링크
'지식 공유 > IT, 인공지능 정보' 카테고리의 다른 글
| 창의적 작업에서 평균을 벗어난 아이디어를 찾는 AI 기능 소개 (0) | 2026.11.21 |
|---|---|
| Qwen3.8 기반 pi 어댑터로 코드 에이전트 효율 극대화, 토큰 줄이면서 정확도 높임 (0) | 2026.11.20 |
| springrep – 정확한 CAD 기하학을 위한 Rust 기반 B‑rep 커널 (0) | 2026.11.20 |
| mcp‑for‑blender‑pro – 블렌더에 AI 챗봇을 넣어 창작 속도 두 배로 (0) | 2026.11.20 |
| gpucanvas로 수천 개의 화면 한곳에 담아서 GPU 렌더링하기 (0) | 2026.11.20 |



