#문제 해결

Cheolsu Proxy 사용 중 발생하는 일반적인 문제와 해결 방법을 안내합니다.

#프록시가 시작되지 않음

#포트가 이미 사용 중

증상: "Port is already in use" 오류 메시지

해결:

1. 다른 포트 번호로 변경합니다 (예: 8080, 9000).
2. 설정 → 프록시 포트에서 포트를 변경합니다.
3. 프록시를 재시작합니다.

사용 중인 포트를 확인하려면 터미널에서 다음 명령어를 실행합니다:

# macOS
lsof -i :8100

#방화벽 차단

증상: 프록시는 시작되지만 연결이 실패

해결:

1. macOS: 시스템 설정 → 개인정보 보호 및 보안 → 방화벽에서 Cheolsu Proxy를 허용합니다.
2. 별도의 보안 소프트웨어가 있다면 해당 설정에서도 허용합니다.

#관리자 권한 필요

증상: "Insufficient privileges" 오류

해결:

1. 시스템 프록시 설정을 자동으로 변경하려면 관리자 권한이 필요합니다.
2. macOS에서 관리자 계정으로 로그인되어 있는지 확인합니다.

#웹사이트에 접속할 수 없음

#브라우저 프록시 설정 확인

증상: 모든 웹사이트에 접속 불가

해결:

1. Cheolsu Proxy가 시스템 프록시를 자동 설정하므로, 별도 설정이 필요 없습니다.
2. 수동으로 프록시를 설정한 경우, HTTP/HTTPS 프록시가 127.0.0.1:8100 (또는 설정한 포트)으로 올바르게 지정되었는지 확인합니다.
3. 브라우저에서 프록시 설정을 초기화하고 시스템 프록시를 사용하도록 변경합니다.

#인터넷 연결 확인

증상: 프록시 없이는 동작하지만 프록시를 켜면 실패

해결:

1. 인터넷 연결 상태를 확인합니다.
2. DNS 설정을 확인합니다 (8.8.8.8, 1.1.1.1 권장).
3. 프록시를 일시 중지하고 직접 연결을 테스트합니다.

#특정 사이트만 접속 불가

증상: 일부 사이트는 정상, 다른 사이트는 접속 불가

해결:

1. 해당 사이트가 프록시를 차단하는지 확인합니다.
2. 인터셉트 규칙에서 해당 도메인을 차단하고 있지 않은지 확인합니다.
3. 다른 브라우저로 테스트합니다.

#HTTPS 사이트 문제

#"연결이 안전하지 않습니다" 경고

증상: 브라우저에서 보안 경고 표시

해결:

1. Cheolsu Proxy의 CA 인증서가 설치되었는지 확인합니다.
2. 설정 → 인증서에서 **"인증서 재생성"**을 클릭합니다.
3. Keychain Access에서 인증서가 **"항상 신뢰"**로 설정되었는지 확인합니다.
4. 브라우저를 재시작합니다.

자세한 내용은 SSL 인증서 가이드를 참조하세요.

#인증서 설치 실패

증상: 인증서 설치 버튼이 동작하지 않음

해결:

1. 관리자 권한으로 Cheolsu Proxy를 실행합니다.
2. 보안 소프트웨어를 일시적으로 비활성화합니다.
3. Keychain Access에서 수동으로 인증서를 설치합니다.

#특정 브라우저에서만 경고 표시

증상: Chrome에서는 정상인데 Firefox에서 경고

해결:

Firefox는 시스템 인증서 저장소가 아닌 자체 인증서 저장소를 사용합니다.

1. Firefox: 설정 → 개인정보 및 보안 → 인증서에서 Cheolsu Proxy 인증서를 가져옵니다.
2. 또는 Firefox의 about:config에서 security.enterprise_roots.enabled를 true로 설정하면 시스템 인증서를 사용합니다.

#모바일 연결 문제

#모바일 기기가 프록시에 연결되지 않음

증상: 프록시 설정 후 모바일에서 연결 실패

해결:

1. PC와 모바일이 동일한 Wi-Fi 네트워크에 있는지 확인합니다.
2. PC의 IP 주소가 올바른지 확인합니다 (터미널에서 ifconfig 실행).
3. PC의 방화벽에서 모바일 IP 또는 프록시 포트를 허용합니다.

#모바일에서 HTTPS 접속 불가

증상: 모바일에서 HTTPS 사이트에 접속할 수 없음

해결:

1. 모바일 기기에 Cheolsu Proxy의 CA 인증서를 설치합니다.
2. iOS: 설정 → 일반 → VPN 및 기기 관리에서 인증서를 신뢰합니다.
3. Android: 설정 → 보안 → 인증서 설치에서 CA 인증서를 설치합니다.

#성능 문제

#연결이 느림

증상: 웹사이트 로딩이 매우 느림

해결:

1. 불필요한 인터셉트 규칙이나 스크립트를 비활성화합니다.
2. 캡처된 트래픽이 너무 많으면 초기화(클리어)합니다.
3. 프록시를 재시작합니다.

#메모리 사용량이 높음

증상: Cheolsu Proxy가 많은 메모리를 사용

해결:

1. 캡처된 트래픽을 정기적으로 초기화합니다.
2. 장시간 캡처가 필요한 경우 세션을 저장하고 새 세션을 시작합니다.
3. 프로그램을 재시작합니다.

#고급 진단

#네트워크 진단

터미널에서 프록시 연결을 직접 테스트할 수 있습니다:

# 프록시를 통한 HTTP 요청 테스트
curl -x http://127.0.0.1:8100 http://httpbin.org/ip

# 프록시를 통한 HTTPS 요청 테스트 (인증서 검증 무시)
curl -x http://127.0.0.1:8100 -k https://httpbin.org/ip

# 포트 사용 확인 (macOS)
lsof -i :8100

#설정 파일 위치

• macOS: ~/Library/Application Support/CheolsuProxy/config/

#로그 파일 위치

• macOS: ~/Library/Logs/CheolsuProxy/

#추가 도움

위 방법으로 해결되지 않으면:

1. GitHub Issues에서 유사한 문제를 검색합니다.
2. 새 이슈를 생성할 때 다음 정보를 포함해주세요:
   • 운영체제 및 버전
   • Cheolsu Proxy 버전
   • 오류 메시지 또는 스크린샷
   • 문제 재현 단계