Windows / macOS / iOS / Android / Linux는 모두 VPNGS 지원 플랫폼입니다. 앱에서 시스템 프록시를 사용할 수 있는지는 앱 자체 구현에 따라 달라집니다.
명령줄과 SDK
터미널 프로그램은 브라우저의 프록시 경로를 그대로 따르지 않을 수 있습니다. 사용하는 SDK나 런타임의 공식 문서를 확인해 HTTPS_PROXY, HTTP_PROXY, NO_PROXY를 읽는지, 아니면 프록시를 별도로 설정해야 하는지 확인하세요. 환경 변수 이름만으로 모든 프로그램의 지원을 보장할 수는 없습니다. 프록시 프로토콜과 클라이언트 수신 주소도 일치해야 하며, 클라이언트에 실제로 표시되는 정보를 기준으로 설정하세요.
서비스 인증 정보를 넣지 않은 상태에서 기본 연결을 확인한 뒤 최소한의 요청으로 API를 점검하세요. 연결을 위해 인증서 검증을 끄지 마세요. 인증서 오류가 발생하면 시스템 시간, 신뢰 체인, 기업 네트워크 정책을 확인하세요. 로그를 공유하기 전에 비밀 키, 인증 헤더, 구독 정보, 업무 내용을 삭제하고 문의에는 문제 파악에 필요한 오류 요약만 남기세요.
IDE 플러그인과 원격 개발
Cursor, GitHub Copilot 등의 도구는 편집기 네트워크 계층, 확장 프로그램 호스트, 외부 명령줄 프로그램을 각각 사용할 수 있습니다. 시스템 프록시를 변경한 뒤에도 실행 중인 프로세스에는 이전 설정이 남아 있을 수 있으므로 앱 문서에 따라 다시 불러오세요. 확장 프로그램 진단 정보를 먼저 확인한 다음 인증 실패인지, 모델 요청 실패인지, 자동 완성 스트림 중단인지 구분하세요.
원격 개발에서는 로컬 컴퓨터와 원격 실행 환경을 구분해야 합니다. 브라우저 로그인은 로컬에서 이뤄지지만 원격 호스트, 컨테이너, 하위 시스템에서 실행되는 요청까지 로컬 회선을 이용한다는 뜻은 아닙니다. 먼저 요청을 보내는 프로세스를 확인한 뒤 해당 환경에 권한이 있는 네트워크 경로를 설정하세요. 로컬 설정만 바꾸면서 원격 작업을 반복해 테스트하지 마세요.
CI 및 무인 작업
CI 실행기는 별도의 네트워크 출구, 인증 정보, 실행 권한을 사용합니다. 로컬 클라이언트 연결에 성공해도 호스팅 실행기의 라우팅이 자동으로 바뀌지는 않습니다. 자동화를 사용하려면 먼저 플랫폼과 조직 정책에서 허용하는지 확인하고 실행 환경이 지원하는 네트워크 설정을 사용하세요. VPNGS의 플랫폼 지원 목록은 모든 호스팅 CI 환경과 호환된다는 보장이 아닙니다.
작업에 적절한 시간 초과, 재시도, 오류 분류를 설정해 권한 오류를 반복 요청하지 않도록 하세요. 비밀 키는 실행 환경의 인증 정보 관리 기능에 보관하고 저장소, 빌드 산출물, 디버그 출력에 넣지 마세요. 생성 작업을 재시도하기 전에는 타사 요금이 중복 청구될 가능성도 고려해야 합니다.