업데이트로 돌아가기
New releaseSep 12, 2026

pingtunnel master-d7cd0d6ab5f18e7d8d050385e8d240b3b2f41e6c

Pingtunnel은 TCP/UDP 트래픽을 ICMP를 통해 전송하는 도구입니다.

공유

Pingtunnel

Go Report Card

Pingtunnel은 ICMP를 통해 TCP/UDP 트래픽을 전송하는 도구입니다.

참고: 이 도구는 학습 및 연구 목적으로만 사용해야 하며, 불법적인 목적으로 사용하지 마십시오

image

사용법 및 상세 문서

📖 전체 사용 문서는 USAGE.md를 참조하십시오: 모든 명령줄 인수 목록, 구성 파일 모드(-c config.json), 각 시나리오별 프록시 설정(SOCKS5 전역, GeoIP 분할, TCP 포트 터널링, UDP 전달, 2단계 업스트림 프록시, 종단 간 AES/ChaCha20 암호화) 등을 포함합니다.

빠른 시작

1. 서버

  • 공인 IP가 있는 서버를 준비합니다(예: www.yourserver.com)
  • releases에서 릴리스 패키지(예: pingtunnel_linux64.zip)를 다운로드하고 압축을 푼 뒤 root 권한으로 실행합니다:
sudo ./pingtunnel -type server -key 123456
  • (선택 사항) 시스템 기본 ICMP 에코 응답을 비활성화합니다:
echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all

2. 클라이언트

관리자 권한으로 실행합니다:

  • SOCKS5 프록시 모드:
pingtunnel -type client -l :4455 -s www.yourserver.com -sock5 1 -key 123456
  • TCP 전달(예: SSH/Web):
pingtunnel -type client -l :4455 -s www.yourserver.com -t 192.168.1.100:22 -tcp 1 -key 123456
  • UDP 전달(예: DNS):
pingtunnel -type client -l :4455 -s www.yourserver.com -t 8.8.8.8:53 -key 123456

3. 구성 파일 모드 (-c)

클라이언트와 서버 모두 JSON 구성 파일을 지원합니다:

# Start server with config
sudo ./pingtunnel -c server.json

# Start client with config
./pingtunnel -c client.json

JSON 구성 템플릿과 규칙은 USAGE.md를 참조하십시오.

Android 클라이언트 사용

커뮤니티에서 개발한 pingtunnel 전용 Android 클라이언트를 사용할 수 있습니다:

이 Android 클라이언트를 개발한 itismoej에게 큰 감사를 전합니다!

Docker 사용

Docker로 pingtunnel을 직접 시작할 수도 있습니다:

  • 서버:
docker run --name pingtunnel-server -d --privileged --network host --restart=always esrrhs/pingtunnel ./pingtunnel -type server -key 123456
  • 클라이언트:
docker run --name pingtunnel-client -d --restart=always -p 1080:1080 esrrhs/pingtunnel ./pingtunnel -type client -l :1080 -s www.yourserver.com -sock5 1 -key 123456

카테고리