/
Agent 연결 오류: "No such host is known" (프록시 설정 문제)
Document toolboxDocument toolbox

Agent 연결 오류: "No such host is known" (프록시 설정 문제)

Owned by Lucas Oh
Last updated: 5월 21, 2025

1. 이슈 개요

  • 제목: Tunnel Session Error - "No such host is known" (프록시 호스트 설정 오류)

  • 버전: N/A (특정 버전에 국한되지 않는 설정 문제)

  • 상태: 해결

2. 이슈 상세

증상

  • QueryPie Agent를 통해 데이터소스 접속 시도 시 다음과 같은 에러 메시지가 발생합니다:

    • "Tunnel Session Error"

    • "Failed to connect to server"

    • "No such host is known."

  • Agent 로그 파일에 System.Net.Sockets.SocketException (11001): No such host is known. 오류가 기록됩니다.

  • 상세 로그에서 프록시 서버 연결 시도 시 Connecting to Unspecified/<https://[hostname]:[port]> 와 같이 <https://가> 포함된 주소로 연결을 시도하는 것을 확인할 수 있습니다. (예: Connecting to Unspecified/<https://lucas-proxy.querypie-pe.pro:9000)>

재현 방법

  1. QueryPie Agent를 실행합니다.

  2. 프록시를 통해 연결해야 하는 서버에 접속을 시도합니다.

    image-20250521-012028.png

  3. 상기 언급된 에러 메시지가 화면에 표시되는 것을 확인합니다.

    image-20250521-012102.png

  4. 상세 원인 파악을 위해 Agent 로그를 확인합니다.

    • Windows: C:\\Users\\$USER\\.querypie-agent\\logs

    • MacOS: /Users/$USER/.querypie-agent/logs

    • Linux: /home/$USER/.querypie-agent/logs

    • 로그 예시 (오류 발생 부분):

      pQTO8e9CsG/0FGO1662DN3G/AGT:AGT/00078 [INF] [2025-05-21 03:57:03.641] <Tunnel/Session/0FGO4MA3HLFG/Forward> Connecting to Unspecified/[https://lucas-proxy.querypie-pe.pro:9000](https://lucas-proxy.querypie-pe.pro:9000) pQTO8e9CsG/0FGO1662DN3G/AGT:AGT/00079 [ERR] [2025-05-21 03:57:03.642] <Tunnel/Session/0FGO4MA3HLFG/Forward> Unexpected error occurred in connect to Unspecified/[https://lucas-proxy.querypie-pe.pro:9000](https://lucas-proxy.querypie-pe.pro:9000) System.Net.Sockets.SocketException (11001): No such host is known.

3. 원인 분석

  • QueryPie 메타데이터베이스 내 proxies 테이블의 host 컬럼에 저장된 프록시 서버 주소 형식이 올바르지 않습니다.

  • 정상적인 호스트 주소(예: lucas-proxy.querypie-pe.pro) 대신, URL 스킴(Scheme)인 <https://가> 포함된 주소(예: <https://lucas-proxy.querypie-pe.pro)가> 입력되어 있어, 시스템이 해당 문자열 전체를 호스트명으로 인식하고 DNS 조회를 시도하여 실패하게 됩니다. 이로 인해 "No such host is known" (해당 호스트를 알 수 없음) 오류가 발생합니다.

4. 해결 방법

해결책

잘못된 프록시 호스트 정보를 QueryPie 메타데이터베이스에서 직접 수정합니다.

  1. QueryPie 메타DB에 접속합니다.
    (사용 중인 DB 관리 도구를 이용하여 QueryPie 메타DB에 접속합니다.)

  2. proxies 테이블에서 현재 설정을 확인합니다.
    문제가 되는 프록시의 id와 host 값을 확인합니다.

    SELECT id, name, host, port FROM querypie.proxies;

  3. 잘못된 프록시 host 정보를 수정합니다.
    host 필드 값에서 <https://> 부분을 제거하고 실제 호스트 주소만 남깁니다.
    예를 들어, id가 1인 프록시의 host 값이 <https://lucas-proxy.querypie-pe.pro로> 되어 있다면 아래와 같이 수정합니다.

    -- 수정 전 실제 id 값을 반드시 확인하세요. UPDATE querypie.proxies SET host = 'lucas-proxy.querypie-pe.pro' WHERE id = 1; -- 실제 문제가 발생한 프록시의 id로 변경해주세요.

  4. 수정된 정보를 다시 확인합니다.

    SELECT id, name, host, port FROM querypie.proxies WHERE id = 1; -- 수정한 id로 확인

  5. QueryPie Agent 설정을 초기화하고 다시 로그인합니다.

    • 실행 중인 QueryPie Agent를 완전히 종료합니다.

    • QueryPie Agent 설정 메뉴에서 '모든 설정 초기화(Reset All Settings)'를 실행합니다.

    • Agent를 다시 시작하고 로그인하여 접속이 정상적으로 이루어지는지 확인합니다.