네트워크 진단

브라우저에서 Ping, 경로 추적, 포트 점검, DNS 조회, 속도 측정, LAN 스캔을 실행합니다. 메뉴 위치: 사이드바 「도구 → 네트워크 진단」.

백그라운드 작업

「시작」을 누를 때마다 백그라운드 작업이 하나 만들어지며 API는 즉시 작업 ID를 반환하고 UI가 출력을 폴링합니다.

• 동시에 실행되는 작업은 최대 4개이며 초과하면 잠시 후 다시 시도하라는 안내가 표시됩니다.
• 작업 하나는 최대 5분 동안 실행되며 시간이 초과되면 자동으로 취소됩니다.
• 최근 작업 50개를 보관하며 실행 중인 작업은 정리되지 않습니다. 작업마다 출력은 최대 500줄까지 보관합니다.
• 실행 중에 「중지」를 눌러 취소할 수 있습니다. 페이지 아래쪽 「최근 작업」에 지난 작업이 나열되며 누르면 출력을 볼 수 있습니다.
• 작업 상태: 실행 중, 완료, 실패, 취소됨

Ping

대상에 ICMP 에코 요청을 보내 매번의 왕복 시간, 패킷 손실률, 최소 / 평균 / 최대 지연 시간을 출력합니다.

매개변수	설명
대상	호스트 이름 또는 IP, IPv4와 IPv6 지원
횟수	기본 4, 최대 20

요청마다 타임아웃은 2초이고 간격은 약 0.7초입니다. 권한이 필요 없는 UDP 방식 ICMP 소켓을 우선 사용하고 실패하면 raw 소켓을 시도합니다. Docker 컨테이너에서는 NET_RAW 권한이 필요하거나 net.ipv4.ping_group_range를 설정해야 하며, 권한이 부족하면 포트 점검을 대신 사용할 수 있습니다. 대상이 전혀 응답하지 않으면 작업 상태는 실패입니다.

경로 추적

시스템 명령을 호출해 경로를 추적하고 명령의 출력을 그대로 보여 줍니다.

• Windows는 tracert를 사용하고, 그 외 시스템은 traceroute를 우선 사용하며 없으면 tracepath를 사용합니다.
• 최대 20홉이며 역방향 조회를 하지 않고 IP를 그대로 표시합니다.
• 시스템에 해당 명령이 없으면 작업이 오류로 끝나며, Docker 이미지에는 traceroute 패키지를 설치할 수 있습니다.

포트 점검

대상에 TCP 연결을 시도하여 열려 있는 포트만 나열합니다.

매개변수	설명
대상	호스트 이름 또는 IP
포트	예: 22,80,443,8000-8100. 쉼표 구분과 범위를 지원하며 포트 범위는 1-65535입니다

• 한 번에 최대 1024개 포트를 점검합니다.
• 동시성 100, 포트당 연결 타임아웃 1.5초
• 자주 쓰는 포트에는 서비스 이름(ssh, http, https, mysql, redis, postgres, rdp 등)과 연결 소요 시간을 표시합니다.

DNS 조회

매개변수	설명
도메인 / IP	조회할 이름. PTR 유형에는 IP를 입력합니다
유형	A, AAAA, CNAME, MX, TXT, NS, PTR, 기본값 A
DNS 서버	비우면 시스템 리졸버를 사용합니다. 223.5.5.5, 223.5.5.5:5353 또는 DoH 주소 https://dns.alidns.com/dns-query를 입력할 수 있습니다

조회 타임아웃은 8초이며 레코드와 소요 시간을 출력합니다.

속도 측정

다운로드 속도 측정이며 4개 연결을 동시에 사용하고 1초마다 현재 속도(Mbps)를 출력하며, 끝나면 총 다운로드량과 평균 속도를 출력합니다.

매개변수	설명
다운로드 주소	전체 http(s):// URL. 비우면 Cloudflare 속도 측정 노드(https://speed.cloudflare.com/__down?bytes=200000000)를 사용합니다
시간	초 단위. UI 범위는 2~30이고 기본값은 8입니다

속도 측정 요청은 리다이렉트를 따라가지 않으므로 점검이 금지된 주소로 유도되는 일을 막습니다.

LAN 스캔

대역 안의 온라인 장치를 스캔하며 결과는 IP, MAC, 호스트 이름, 열린 포트의 표로 보여 줍니다.

매개변수	설명
대역	CIDR. 예: 192.168.1.0/24. 비우면 이 호스트의 첫 번째 사설 IPv4 인터페이스가 속한 대역을 사용합니다(드롭다운에 이 호스트에서 쓸 수 있는 대역이 나열되며 너무 큰 대역은 /24로 축소됩니다)

제한과 동작 원리는 다음과 같습니다.

• IPv4 사설 대역(10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16)만 지원합니다.
• 한 번에 최대 1024개 주소(/22에 해당)이며 네트워크 주소와 브로드캐스트 주소는 자동으로 제외됩니다.
• 각 주소에 대해 자주 쓰는 포트 80, 443, 22, 445, 139, 3389, 8080, 62078, 5000, 53을 점검하며 연결에 성공하거나 거부되면 온라인으로 판단합니다.
• MAC 주소는 시스템 이웃 테이블에서 가져오며, 이웃 테이블에 기록은 있지만 자주 쓰는 포트가 열려 있지 않은 호스트도 온라인으로 나열됩니다.
• 호스트 이름은 역방향 DNS로 확인합니다(타임아웃 1.5초).
• MAC이 있는 장치는 「Wake-on-LAN에 추가」를 눌러 Wake-on-LAN의 장치 목록에 추가할 수 있습니다.

점검 금지 목록

페이지 오른쪽 위의 「점검 금지 목록」에서 진단 도구가 접근하지 못하게 할 대상을 설정합니다.

• 클라우드 제공자 메타데이터 주소는 항상 금지됩니다: 169.254.169.254/32, 100.100.100.200/32, fd00:ec2::254/128. 도구가 인스턴스 자격 증명을 탈취하는 데 쓰이는 것을 막기 위해서입니다.
• IP 또는 대역을 한 줄에 하나씩 추가할 수 있습니다. 예: 10.0.0.0/8
• 대상 호스트 이름을 확인한 주소 중 하나라도 목록에 걸리면 작업이 오류로 끝납니다. 속도 측정의 다운로드 주소도 같은 검사를 받으며, 스캔은 목록에 걸린 주소를 건너뜁니다.

팁

진단 도구는 Gately가 실행되는 호스트나 컨테이너 안에서 동작하므로 점검 결과는 그 환경의 네트워크 상태를 반영합니다. 점검 가능한 범위를 제한해야 한다면 민감한 내부망 대역을 점검 금지 목록에 추가하세요.

네트워크 자가 점검

개요 페이지의 「자가 점검」 버튼(최초 시작 안내에도 진입점이 있음)은 흔한 네트워크 및 설정 문제를 한 번에 점검합니다. 문제 항목을 먼저 표시하고 해결 방법을 함께 안내합니다.

점검 항목	설명
공인 주소	DDNS가 사용하는 공인 IP 조회 주소로 외부 IPv4 / IPv6를 확인합니다
NAT	이 장비가 공인 IPv4 / IPv6를 직접 보유하는지 확인합니다. 네트워크 인터페이스에 100.64.0.0/10 주소가 있으면 통신사 NAT 뒤에 있을 수 있다고 알립니다(Tailscale 등 오버레이 네트워크 인터페이스는 제외)
시스템 시간	조회 서비스의 응답 시간으로 시계 오차를 추정합니다. 60초를 넘으면 2단계 인증 코드와 인증서 검증이 실패합니다
80 / 443 포트	비어 있는지, 이미 사용 중인지, 수신 권한이 없는지 확인합니다
DDNS 이름 확인	동적 주소를 쓰는 레코드의 도메인이 현재 이 장비의 외부 주소로 확인되는지 확인합니다
인증서	이미 만료되었거나 14일 이내에 만료되는 인증서
HTTPS 사이트 인증서	활성화된 HTTPS 리스너에서 도메인과 일치하는 인증서가 없는 사이트(이 도메인은 TLS 핸드셰이크에서 실패합니다)
frp 충돌	frpc에서 이름이 중복된 프록시, 그리고 최근 30분 로그에서 frps가 보고한 프록시 이름, 도메인, 원격 포트 충돌(여러 기기가 같은 frpc 설정을 복사했을 때 흔히 발생)
모듈 상태	개요에서 경고 또는 오류 상태인 모듈

자가 점검은 설정한 공인 IP 조회 서비스에 접속하며, 버튼을 눌렀을 때만 실행됩니다. 읽기 전용 계정과 API 토큰은 사용할 수 없습니다.