TCPViewer v1.10.0
최고 수준의 macOS 앱으로 Mac에서 모든 패킷을 명확하게 확인하세요. Wireshark의 대안입니다.
TCP Viewer
TCP Viewer는 라이브 캡처 및 캡처 파일을 위한 macOS 패킷 뷰어입니다. 메인 앱에는 AppKit을, 캡처에는 시스템 libpcap을, 심층 패킷 세부 정보에는 벤더링된 Wireshark 라이브러리를 사용합니다.
요구 사항
- macOS 15+
- 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.sh는 먼저 scripts/bootstrap-wireshark-deps.sh를 실행합니다. 이 스크립트는 Wireshark에 번들된 런타임 라이브러리를 소스 코드에서 Vendor/.install/wireshark-deps로 빌드하며, 배포 대상은 macOS 15.0입니다. Homebrew는 빌드 도구에만 사용됩니다; 릴리스 번들은 /opt/homebrew 또는 /usr/local에서 Homebrew bottle dylib을 복사해서는 안 됩니다.
로컬 서명, 앱캐스트, Sparkle, Sentry 및 릴리스 값을 Git 외부에 유지하세요. Config/TCPViewer.local.xcconfig, .env, 셸 환경 변수 또는 Keychain 기반 도구와 같이 무시된 로컬 파일을 사용하세요.
실행
Xcode에서:
TCPViewer.xcodeproj를 엽니다.TCPViewer스킴을 선택합니다.My Mac을 선택합니다.- 실행을 누릅니다.
명령줄 빌드:
xcodebuild -project TCPViewer.xcodeproj -scheme TCPViewer build
Xcode에서 서명을 요청하면 TCPViewer 및 PcapPlusPlusCore에 대한 개발 팀을 선택하세요.
테스트
xcodebuild test \
-project TCPViewer.xcodeproj \
-scheme TCPViewer \
-destination 'platform=macOS'
배포
TCP Viewer 릴리스는 빌드되고, 공증되며, Sparkle용으로 서명되고, Cloudflare R2에 업로드되며, 선택적으로 릴리스 스크립트에 의해 릴리스 백엔드에 게시됩니다.
최초 릴리스 설정:
npm install
bundle install
gh auth login
.env.example에서 로컬 .env를 만들고 필요한 릴리스 값을 채우세요. 실제 비밀을 커밋하지 마세요. sentry-cli가 파일을 로드할 때 // 주석을 허용하지 않으므로 .env의 주석은 # 주석으로 유지하세요.
프로덕션 릴리스의 경우 ReleaseNote.json에 일치하는 항목을 추가한 다음 실행하세요:
npm run release
프롬프트가 나타나면 beta 또는 production을 선택하세요. 프로덕션 릴리스는 또한 Sparkle 앱캐스트를 생성하고 v<version> 태그를 푸시하며 GitHub 릴리스를 게시합니다. 아티팩트는 다음 위치에 작성됩니다:
~/Desktop/tcpviewer-production/
라이선스
TCP Viewer는 GPL-2.0-or-later에 따라 라이선스가 부여됩니다. 이는 앱의 Wireshark 통합과 일치합니다: libwireshark, libwiretap 및 libwsutil은 GPL이 적용되는 Wireshark 라이브러리입니다.
전체 GPL 텍스트는 COPYING에, 타사 고지 사항은 THIRD_PARTY_NOTICES.md에, 바이너리 릴리스 소스 코드 제공 조건은 SOURCE_CODE_OFFER.md에 있습니다.
감사의 말
TCP Viewer는 패킷 분석을 위해 Wireshark를, 내장된 16진수 뷰어를 위해 HexFiend를 기반으로 합니다. 자세한 내용은 THIRD_PARTY_NOTICES.md를 참조하세요.