TCP Viewer

Mac용 간단하고 네이티브한 패킷 뷰어입니다.

웹사이트 · 다운로드 · 문서 · 릴리스

TCP Viewer는 macOS에서 네트워크 패킷을 캡처하고 읽습니다. 캡처에는 시스템 libpcap을 사용하고, 상세 패킷 정보에는 Wireshark 라이브러리를 사용합니다.

기능

• AppKit으로 구축된 네이티브 macOS 앱
• Wireshark Lib 기반으로 구축된 Wireshark 대안
• 실시간 트래픽 캡처
• 앱, 도메인 또는 IP 주소별로 패킷 그룹화
• TCP, UDP, DNS, HTTP, TLS, WebSocket 등 필터링
• 프로토콜 필드 및 원시 바이트 읽기
• PCAP 및 PCAPNG 파일 열기
• 전체 TCP 스트림 추적
• 패킷을 PCAP 또는 PCAPNG로 내보내기
• TCP Viewer MCP로 캡처에 대해 AI 에이전트에게 질문
• tcpviewer-cli로 캡처, 패킷 쿼리, 파일, 라이선스 및 설정 자동화
• 전체 소스 코드 검토

간편한 패킷 캡처

• 네트워크 인터페이스 선택
• 한 번의 클릭으로 시작 또는 중지
• 대용량 캡처도 읽기 쉽게 유지

실시간 캡처 동영상 보기

TCP Viewer MCP

• TCP Viewer를 Codex 또는 다른 MCP 클라이언트에 연결
• 캡처 상태 확인
• 네트워크 인터페이스 목록 표시
• 간단한 프롬프트로 패킷 찾기
• TCP Viewer PRO에서 사용 가능

캡처 파일 열기

• PCAP 또는 PCAPNG 파일 끌어서 놓기
• 즉시 패킷 미리보기
• 실시간 캡처와 동일한 보기 사용

파일 미리보기 동영상 보기

TCP 스트림 추적

• 하나의 전체 TCP 대화 재구성
• 양방향을 함께 표시
• 클라이언트 또는 서버 데이터만 표시
• 텍스트와 16진수 간 전환
• 스트림 검색
• 원본 패킷으로 돌아가기

TCP 스트림 추적 동영상 보기

트래픽 그룹화

• 앱별로 패킷 그룹화
• 도메인별로 패킷 그룹화
• IP 주소별로 패킷 그룹화
• 필요한 트래픽으로 바로 이동

그룹화된 트래픽 동영상 보기

프로토콜 필터

• 일반적인 프로토콜용 빠른 필터 사용
• 텍스트 검색과 필터 결합
• 유용한 패킷에 빠르게 집중

프로토콜 필터 동영상 보기

캡처 내보내기

• 전체, 필터링 또는 선택된 패킷 내보내기
• PCAP 또는 PCAPNG로 저장
• 다른 패킷 도구에서 결과 열기

패킷 상세 정보

• Wireshark급 프로토콜 트리 읽기
• 필드 이름과 값 검사
• 필드를 원시 바이트와 매칭
• 패킷 상세 정보 검색

패킷 상세 정보 동영상 보기

오픈 소스

• GPL-2.0-or-later 라이선스
• 캡처 파이프라인 검토
• 패킷 디코딩 검토
• 네이티브 macOS 인터페이스 검토
• 이슈 보고 또는 풀 리퀘스트 보내기

Proxyman 팀이 제작

• Proxyman 및 Tiny Shield 팀이 제작
• macOS용으로 구축
• 개인정보 보호와 명확한 네트워크 디버깅에 중점

요구 사항

TCP Viewer 실행 요구 사항:

• Apple Silicon Mac
• macOS 15 이상

TCP Viewer 빌드 요구 사항:

• Xcode 16 이상
• Git
• CMake, Ninja, Meson, pkg-config 및 autotools

brew install cmake ninja meson pkg-config autoconf automake libtool

설정

서브모듈과 함께 클론합니다. 그런 다음 고정된 Wireshark 의존성을 부트스트랩합니다.

git clone --recurse-submodules <repo-url>
cd TCPViewer
cp Config/TCPViewer.local.xcconfig.example Config/TCPViewer.local.xcconfig
./scripts/bootstrap-wireshark.sh

이미 서브모듈 없이 클론하셨나요?

git submodule update --init --recursive
./scripts/bootstrap-wireshark.sh

부트스트랩 스크립트:

• 먼저 scripts/bootstrap-wireshark-deps.sh를 실행합니다.
• Wireshark 런타임 라이브러리를 소스에서 빌드합니다.
• Vendor/.install/wireshark-deps에 작성합니다.
• macOS 15를 배포 대상으로 사용합니다.
• 빌드 도구에만 Homebrew를 사용합니다.
• 릴리스에 Homebrew bottle dylib를 복사하지 않습니다.

로컬 서명, appcast, Sparkle, Sentry 및 릴리스 값을 Git에 보관하지 마세요. Config/TCPViewer.local.xcconfig, .env, 환경 변수 또는 Keychain 기반 도구를 사용하세요.

실행

Xcode에서:

1. TCPViewer.xcodeproj를 엽니다.
2. TCPViewer 스킴을 선택합니다.
3. My Mac을 선택합니다.
4. Run을 누릅니다.

명령줄 빌드:

xcodebuild -project TCPViewer.xcodeproj -scheme TCPViewer build

Xcode에서 서명을 요청하면 TCPViewer 및 PcapPlusPlusCore에 대한 개발 팀을 선택하세요.

테스트

xcodebuild test \
  -project TCPViewer.xcodeproj \
  -scheme TCPViewer \
  -destination 'platform=macOS'

릴리스

릴리스 스크립트는 다음을 수행할 수 있습니다:

• 앱 빌드 및 notarize
• Sparkle 업데이트 서명
• Cloudflare R2에 파일 업로드
• 백엔드에 릴리스 게시

최초 설정:

npm install
bundle install
gh auth login

.env.example에서 로컬 .env를 생성합니다. 필요한 릴리스 값을 추가합니다. 실제 비밀값을 커밋하지 마세요.

.env에서 주석에는 #을 사용하세요. sentry-cli는 // 주석을 허용하지 않습니다.

프로덕션 릴리스의 경우 ReleaseNote.json에 일치하는 항목을 추가합니다. 그런 다음 실행:

npm run release

요청 시 beta 또는 production을 선택합니다.

프로덕션 릴리스는 또한:

• Sparkle appcast를 생성합니다.
• v<version> 태그를 푸시합니다.
• GitHub 릴리스를 게시합니다.

최신 공개 프로덕션 릴리스에 대한 Homebrew Cask 풀 리퀘스트만 생성하려면 make build를 실행하고 Homebrew Cask PR from latest release를 선택합니다. 직접 명령을 실행할 수도 있습니다:

npm run release:homebrew

이 명령은 공개 DMG를 GitHub 릴리스 자산과 대조하여 검증하고, ProxymanApp/homebrew-cask에 브랜치를 푸시하며, Homebrew/homebrew-cask에 기여 풀 리퀘스트를 엽니다.

아티팩트는 다음 위치에 작성됩니다:

~/Desktop/tcpviewer-production/

라이선스

TCP Viewer는 GPL-2.0-or-later로 라이선스가 부여됩니다. 이는 Wireshark 라이브러리 사용과 일치합니다.

• 전체 GPL 텍스트는 COPYING을 참조하세요.
• 타사 고지 사항은 THIRD_PARTY_NOTICES.md를 참조하세요.
• 바이너리 릴리스 소스 조건은 SOURCE_CODE_OFFER.md를 참조하세요.

감사의 말

• Wireshark는 패킷 분석을 제공합니다.
• HexFiend는 내장 16진수 뷰어를 제공합니다.

Wireshark는 Wireshark Foundation의 상표입니다. TCP Viewer는 Wireshark Foundation과 제휴하거나 보증하지 않습니다.