주요 콘텐츠로 건너뛰기
AI 튜토리얼

Gemini Config Checker로 Gemini 및 Google AI Studio 프록시 설정 테스트하기

Gemini Config Checker 설치, Simple 또는 Advanced 모드에서 프록시 설정 검사, Google AI Studio 및 Gemini 액세스 확인, 안티 DPI 설정 적용, 결과 해석, Xray 호환 클라이언트용 작동 경로 내보내기 방법을 알아보세요.

약 18분 소요
Gemini Config Checker로 Gemini 및 Google AI Studio 프록시 설정 테스트하기

Gemini Config Checker의 기능

Gemini Config Checker는 프록시 구성을 테스트하여 Google AI Studio와 Gemini에 연결할 수 있는지 확인합니다. 기본적인 HTTP 프로브와 달리 지역 확인 모드는 로그인된 Chromium 기반 브라우저에서 서비스를 열고, Google이 해당 계정에 표시하는 판정 결과를 읽습니다.

이 차이가 중요한 이유는 Google이 로그인된 페이지가 로드된 후 지역별 이용 가능 여부를 결정하기 때문입니다. 경로가 Google에는 정상적으로 연결되더라도 AI Studio, Gemini 또는 두 서비스 모두에서 차단될 수 있습니다. 동일한 프록시 출구가 시간에 따라 다른 결과를 받을 수도 있습니다.

버전 0.1.0은 초기 프리릴리스입니다. 전체 워크플로는 Windows에서 테스트되었습니다. macOS, Linux, Android 패키지는 CI에서 생성되지만, README에 따르면 아직 실제 기기에서는 테스트되지 않았습니다.

주요 기능

  • 로그인 기반 지역 확인: Google AI Studio와 Gemini에 표시되는 메시지 및 리디렉션을 확인합니다.
  • 연결만 테스트: 브라우저 로그인 없이 경로가 Google에 연결되는지 확인하고 지연 시간을 측정합니다.
  • Simple 모드: 기기에서 직접 프록시 구성을 테스트합니다.
  • Advanced 모드: 작동하는 기본 구성 뒤에 무료 구성을 연결하여 대체 출구를 찾습니다.
  • 다양한 입력 형식: 지원되는 공유 링크, 구독 URL, base64 구독 및 해당되는 경우 전체 Xray JSON 구성을 허용합니다.
  • Anti-DPI 프로필: 편집 가능한 fragmentation, fingerprint, ALPN, cipher-suite 및 clean-IP 설정을 적용합니다.
  • 결과 필터링 및 내보내기: 링크를 복사하고 base64 구독을 생성하며 Xray 구성을 만듭니다.
  • 크로스 플랫폼 패키지: 릴리스에는 플랫폼별 제한이 적용되는 데스크톱, 웹 서버 및 Android 변형이 포함됩니다.

Simple 모드와 Advanced 모드 이해하기

Simple 모드

이미 여러 구성을 보유하고 있으며 그중 어떤 구성이 작동하는지 확인하려면 Simple 모드를 사용합니다. 테스트 경로는 다음과 같습니다.

사용자 -> 구성 -> AI Studio 또는 Gemini

vless://, vmess://, trojan:// 또는 ss:// 링크, 구독 URL, base64 구독 텍스트를 입력할 수 있습니다. 입력란을 비워 두고 미리 준비된 무료 목록을 선택할 수도 있습니다.

Advanced 모드

성공적으로 연결되지만 Google이 허용하는 다른 출구가 필요한 기본 구성이 있을 때 Advanced 모드를 사용합니다. 경로는 다음과 같이 구성됩니다.

사용자 -> 기본 구성 -> 무료 구성 -> AI Studio 또는 Gemini

기본 구성은 공유 링크, 전체 Xray JSON 구성 또는 다중 홉 체인일 수 있습니다. 후보를 검색하기 전에 애플리케이션이 기본 경로를 테스트하며, Google에 연결할 수 없으면 중지합니다.

이 모드에서 Anti-DPI 설정은 기본 구성의 첫 번째 홉에 적용됩니다. 내보낸 Xray 구성은 기본 구성 -> 무료 구성 체인을 유지합니다.

설치 및 설정

릴리스 다운로드 및 확인

  1. 프로젝트의 릴리스 페이지를 엽니다.
  2. 운영 체제와 아키텍처에 맞는 패키지를 다운로드합니다.
  3. 가능하면 포함된 SHA256SUMS.txt 파일을 사용하여 다운로드한 파일을 확인합니다.

Windows

  1. amd64 또는 arm64용 Windows 데스크톱 ZIP을 다운로드합니다.
  2. 원하는 디렉터리에 압축을 풉니다.
  3. GeminiConfigChecker.exe를 실행합니다.
  4. SmartScreen에서 서명되지 않은 빌드에 대한 경고가 표시되면, 다운로드한 릴리스를 신뢰하는 경우 추가 정보를 선택한 다음 실행을 선택합니다.

지역 확인에는 Chrome, Edge 또는 Brave가 필요합니다. WebView2는 Windows 10 및 Windows 11에 포함되어 있습니다.

macOS

  1. 범용 macOS 아카이브를 다운로드하고 압축을 풉니다.
  2. 애플리케이션을 응용 프로그램으로 이동합니다.
  3. 처음 실행할 때 애플리케이션을 마우스 오른쪽 버튼으로 클릭하고 열기를 선택합니다.

macOS가 계속 애플리케이션을 차단하면 README에 제공된 다음 명령을 사용합니다.

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

Linux

Debian 또는 Ubuntu에서는 데스크톱 런타임 라이브러리를 설치합니다.

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

아카이브의 압축을 풀고 데스크톱 애플리케이션을 시작합니다.

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

데스크톱 환경이 없는 시스템에서는 웹 서버 빌드를 사용합니다.

./gemini-config-checker

그런 다음 http://localhost:8787을 엽니다. Linux에서 지역 확인을 사용하려면 Chrome, Chromium, Edge 또는 Brave와 그래픽 세션이 필요합니다.

Android

  1. Android 8 이상 기기에서 arm64-v8a APK를 다운로드합니다.
  2. APK를 여는 데 사용한 브라우저 또는 파일 관리자에서 설치를 허용합니다.
  3. 애플리케이션을 설치하고 실행합니다.

Android는 로그인 기반 지역 확인이 아닌 연결만 테스트하는 스캔을 지원합니다. 화면이 꺼져도 지속 알림을 통해 스캔 엔진이 계속 실행됩니다. 엔진을 종료하려면 알림의 중지 작업을 사용합니다.

이후 APK에서 다른 서명 키를 사용하면 기존 설치를 그대로 업데이트할 수 없습니다. 새 버전을 설치하기 전에 이전 빌드를 제거합니다.

웹 서버 보안

웹 서버는 다음과 같은 옵션을 허용합니다.

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

인터페이스에는 인증 기능이 없습니다. localhost에 바인딩된 상태로 유지하세요. 원격으로 액세스하려면 공개적으로 노출하지 말고 터널링하세요.

ssh -L 8787:localhost:8787 your-server

지역 확인을 위한 Google 계정 연결

애플리케이션에는 Scan, Results, Export 탭이 있습니다. 정확한 지역 확인을 실행하기 전에 Google 계정을 연결하세요:

  1. Sign in with Google을 선택합니다.
  2. 애플리케이션 전용 프로필과 함께 Chrome, Edge 또는 Brave가 별도로 열릴 때까지 기다립니다.
  3. 평소처럼 로그인합니다. 애플리케이션은 비밀번호를 받지 않습니다.
  4. 브라우저가 자동으로 닫히고 인터페이스에 Google 계정이 연결되었다는 메시지가 표시될 때까지 기다립니다.

요청이 여러 IP 주소에서 발생할 수 있어 의심스러운 로그인 경고가 표시될 수 있으므로 보조 계정 사용을 권장합니다. Remove account from app을 선택하면 일반 브라우저 프로필에는 영향을 주지 않고 애플리케이션의 격리된 프로필이 삭제됩니다.

지원되는 브라우저를 사용할 수 없다면 확인 유형을 connectivity only로 변경하세요. 로그인할 필요는 없지만 Google이 해당 출구 지역을 허용하는지는 확인할 수 없습니다.

기본 사용법: Simple 모드에서 구성 검색

  1. 헤더 전환 버튼을 Simple로 설정합니다.
  2. 지원되는 프록시 링크를 한 줄에 하나씩 붙여 넣습니다. 또는 구독 URL이나 base64 구독을 붙여 넣을 수 있습니다.
  3. 내장된 무료 목록을 검색하려면 입력란을 비워 두고 사용 가능한 목록 중 하나를 선택합니다.
  4. 일반적인 Cloudflare 기반 구성이 네트워크에서 연결되지 않으면 Anti-DPI를 활성화합니다.
  5. 사용 가능 여부를 판정하려면 Region with signed-in browser를, 더 빠른 연결 가능성 테스트를 하려면 Connectivity only를 선택합니다.
  6. Start scan을 선택하거나 Ctrl과 Enter를 누릅니다.
  7. Results 탭을 열어 항목이 표시되는 과정을 확인합니다.

기본 입력은 다음과 같을 수 있습니다:

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

스캐너는 연결 가능성 테스트 중 연결할 수 없는 구성을 먼저 제외합니다. 지역 모드에서는 남은 경로에 대해 AI Studio와 Gemini를 대상으로 브라우저 확인을 진행합니다.

기본 사용법: Advanced 모드에서 체인 구성

  1. Advanced로 전환합니다.
  2. 작동하는 기본 구성을 붙여 넣습니다. 공유 링크, 전체 Xray JSON 또는 기존 멀티홉 체인을 사용할 수 있습니다.
  3. 컴퓨터에서 나가는 첫 연결에 필요하면 anti-DPI를 활성화합니다.
  4. 무료 구성 소스를 선택합니다. README에서는 verified 목록을 권장하며, custom에는 구독 URL을 입력할 수 있습니다.
  5. 또는 후보 무료 구성을 직접 붙여 넣습니다.
  6. 확인 유형과 브라우저 로그인 설정을 확인합니다.
  7. 검색을 시작합니다.

애플리케이션은 그 뒤의 무료 경로를 테스트하기 전에 기본 구성을 검증합니다. 기본 구성이 Google에 연결할 수 없다면 계속하기 전에 수정하세요.

Anti-DPI 프로필 구성

anti-DPI 프로필은 일반적인 Cloudflare 구성이 작동하지 않는 필터링된 네트워크를 위해 설계되었습니다. 권장 기본값에는 두 개의 fragment 마스크, unsafe 지문, http/1.1 ALPN, 미리 정의된 13개 암호 스위트 목록과 선택적 clean IP가 포함됩니다.

  • Finalmask: 레시피의 fragment 마스크를 사용하여 TLS ClientHello를 분할합니다.
  • Fingerprint: 기본값은 unsafe이며, 네이티브 Go TLS를 사용하므로 구성된 암호 스위트 목록이 적용됩니다.
  • ALPN: 기본값은 http/1.1입니다.
  • Cipher suites: 참조된 anti-DPI 레시피에 정의된 목록을 사용합니다.
  • Clean IP: SNI와 Host에는 원래 도메인을 유지하면서 연결 주소를 바꿉니다.

Read from config을 선택하면 finalmask, cipherSuites, alpn 같은 JSON 필드 또는 fm, ciphers, alpn, fp 같은 링크 매개변수에서 호환되는 값을 가져옵니다. Suggested values를 선택하면 기본값이 복원됩니다.

애플리케이션의 로컬 포워더는 PattN Xray 포크에서 사용하는 세그먼트별 lengths 및 delays 동작을 재현합니다. fragment 마스크만 지원됩니다. 지연 시간이 추가되므로 필터링되지 않은 네트워크에서는 프로필을 비활성화하세요.

실용적인 검색 설정 선택

  • Check type: 지역 모드는 정확하지만 구성 하나당 약 20~40초가 걸립니다. 연결 모드는 더 빠르지만 지역 액세스를 확인하지 않습니다.
  • Healthy means: 두 제품 모두, AI Studio만 또는 Gemini만 요구하도록 설정합니다.
  • Max configs: 기본값은 60이며, 테스트 전에 후보 목록이 무작위로 섞입니다.
  • Simultaneous browser checks: 기본값은 4입니다. 각 브라우저 확인에는 약 200MB의 메모리가 사용되므로 사양이 낮은 시스템에서는 값을 줄이세요.
  • Simultaneous connectivity tests: 기본값은 20입니다.
  • Connectivity timeout: 기본값은 10초이며 느린 경로에서는 늘릴 수 있습니다.
  • Remember: 기기의 로컬 저장소에 구성과 설정을 저장합니다. 공용 컴퓨터에서는 비활성화하세요.

결과 해석

  • Healthy: 지역 모드에서 경로가 선택한 제품 규칙을 통과했습니다.
  • Connected: 연결 모드에서 경로가 Google에 도달했지만 지역은 확인되지 않았습니다.
  • Region blocked: 필수 제품 중 하나 이상에서 해당 지역 제한이 표시되었습니다.
  • Error: 구성에 연결할 수 없었거나 시간 초과가 발생했거나 브라우저 문제가 발생했습니다. 보고된 원인을 보려면 레이블 위에 마우스를 올리세요.
  • Ping: 전체 경로를 통한 한 번의 요청을 측정합니다.

AI Studio 열과 Gemini 열에 별도의 결과가 표시되는 이유는 제품마다 지역 규칙을 다르게 적용할 수 있기 때문입니다. 상태별로 필터링하고, 이름이나 주소로 검색하고, 핑 또는 이름순으로 정렬하고, 여러 항목을 선택해 일괄 복사할 수 있습니다.

통과 결과는 샘플일 뿐 영구적인 보장이 아닙니다. Cloudflare Worker의 종료 지점은 연결마다 달라질 수 있으므로, 실제로 유지하려는 경로를 다시 테스트하세요.

작동하는 구성 내보내기

복사를 사용하면 공유 링크가 클립보드에 저장됩니다. 이 링크를 v2rayN, Hiddify, PattN 같은 클라이언트나 BPB의 Chain Proxy 필드에 붙여 넣을 수 있습니다.

Simple 모드에서 전체 구성 복사를 사용하면 선택한 경로의 Xray 구성이 생성됩니다. Advanced 모드에서 체인과 함께 복사를 사용하면 기본 경로부터 자유 경로까지의 전체 체인이 생성됩니다. Export 탭에서는 한 줄에 하나의 링크가 있는 출력, base64 구독 또는 저장된 JSON 파일도 만들 수 있습니다.

내보내기 대상을 신중하게 선택하세요.

  • PattN 또는 PattNG: finalmask가 포함된 옵션을 선택하세요.
  • 기본 Xray 또는 v2rayN: 표준 옵션을 선택하세요. 기본 코어는 포크 전용 스키마를 구문 분석할 수 없으므로 이 옵션에서는 finalmask가 제거됩니다.

생성된 파일은 10808 및 10809 포트의 혼합 인바운드, 고정 DNS, UDP 포트 443 차단 설정을 사용합니다. v2rayN에서는 서버를 선택한 다음 사용자 지정 구성 서버 추가를 선택하세요. 생성된 파일을 직접 테스트할 수도 있습니다.

xray run -c file.json

고급 팁 및 문제 해결

올바른 상태 규칙 사용

AI Studio는 작동하지만 Gemini가 차단되거나 그 반대인 경우, 실제로 필요한 제품에 맞게 정상 상태 기준을 변경하세요. 두 서비스는 서로 다른 지역 판정을 반환할 수 있습니다.

메모리 사용량 줄이기

메모리가 제한된 컴퓨터에서는 동시에 실행하는 브라우저 검사 수를 줄이세요. 연결성 검사는 비용이 적으므로 네트워크에 과부하가 걸리지 않는 한 더 높은 동시성을 유지해도 됩니다.

브라우저 감지 문제 해결

지원되는 브라우저를 찾을 수 없다면 Chrome, Edge, Brave 또는 지원되는 Chromium 변형을 설치하세요. 브라우저가 표준 위치가 아닌 곳에 설치되어 있다면 GCC_BROWSER 또는 CHROME_BIN을 해당 실행 파일로 설정하세요. Flatpak 브라우저는 애플리케이션에서 제어할 수 없습니다.

광범위한 시간 초과 처리

모든 경로에서 시간 초과가 발생하면 일반 프록시 클라이언트에서 구성을 확인하세요. Advanced 모드에서는 기본 구성이 작동하는지 확인하세요. 필터링된 네트워크에서는 anti-DPI 프로필을 활성화하고 깨끗한 IP를 시도하세요.

만료된 세션 복구

애플리케이션에서 Google 세션이 만료되었다고 표시하면 다시 로그인하세요. 변경되는 IP 주소에서 반복적으로 요청하면 Google에서 추가 보안 확인을 요구할 수 있습니다.

애플리케이션 초기화

먼저 애플리케이션에서 계정을 제거한 다음, 필요한 경우 로컬 데이터를 삭제하세요.

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

소스에서 빌드

빌드하려면 go.mod에 지정된 Go 버전이 필요합니다. 데스크톱 빌드에는 Wails v2와 플랫폼 웹뷰 종속 항목도 필요합니다. Android 빌드에는 Android SDK, JDK 17 이상 및 Gradle 8.10이 필요합니다.

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

make test는 vet과 단위 테스트를 실행합니다. 다른 명령은 웹 서버, 네이티브 데스크톱 애플리케이션, Android APK 또는 크로스 컴파일된 배포 바이너리를 빌드합니다.

개인정보 보호 및 보안 고려 사항

  • Google 로그인은 애플리케이션 내부가 아니라 별도의 브라우저 프로필에서 진행됩니다.
  • 애플리케이션은 Google 비밀번호를 받지 않습니다.
  • 구성 및 설정은 로컬 저장소에 남으며 기억하기가 활성화된 경우에만 저장됩니다.
  • Google로 전송되는 트래픽은 종단 간 TLS로 보호되지만, 무료 프록시 운영자는 여전히 목적지를 확인할 수 있습니다.
  • 알 수 없는 운영자가 관리하는 무료 구성을 통해 민감한 트래픽을 전송하지 마세요.
  • 인증되지 않은 웹 인터페이스를 공용 네트워크에 노출하지 마세요.

결론

Gemini Config Checker는 단순한 연결성과 실제 Google AI Studio 및 Gemini의 지역별 사용 가능 여부를 구분하는 실용적인 방법을 제공합니다. 직접 테스트하려면 Simple 모드로 시작하고, 안정적인 기본 경로 뒤에 다른 종료 지점이 필요할 때는 Advanced 모드를 사용하세요. 성공한 결과는 클라이언트가 지원하는 형식으로 내보내세요. 경로와 지역 판정은 변경될 수 있으므로, 구성을 사용하기 전에 항상 다시 테스트하세요.