proxymanapp/tcpviewerL'app macOS di prim'ordine per vedere chiaramente ogni pacchetto sul tuo Mac. Alternativa a Wireshark
TCP Viewer è un visualizzatore di pacchetti per macOS per catture live e file di cattura. Utilizza AppKit per l'app principale, libpcap di sistema per la cattura e librerie Wireshark integrate per i dettagli approfonditi dei pacchetti.
brew install cmake ninja meson pkg-config autoconf automake libtool
Clona con i sottomoduli e avvia la dipendenza Wireshark fissata:
git clone --recurse-submodules <repo-url>
cd TCPViewer
cp Config/TCPViewer.local.xcconfig.example Config/TCPViewer.local.xcconfig
./scripts/bootstrap-wireshark.sh
Se hai già clonato senza sottomoduli:
git submodule update --init --recursive
./scripts/bootstrap-wireshark.sh
scripts/bootstrap-wireshark.sh prima esegue
scripts/bootstrap-wireshark-deps.sh, che compila le librerie runtime incluse di Wireshark dal codice sorgente in Vendor/.install/wireshark-deps con macOS 15.0 come target di distribuzione. Homebrew viene utilizzato solo per gli strumenti di build; i bundle di rilascio non devono copiare i dylib delle bottiglie Homebrew da /opt/homebrew o /usr/local.
Mantieni i valori locali di firma, appcast, Sparkle, Sentry e rilascio fuori da Git. Utilizza file locali ignorati come Config/TCPViewer.local.xcconfig, .env, variabili d'ambiente della shell o strumenti supportati da Keychain.
In Xcode:
TCPViewer.xcodeproj.TCPViewer.My Mac.Build da riga di comando:
xcodebuild -project TCPViewer.xcodeproj -scheme TCPViewer build
Se Xcode richiede la firma, seleziona un team di sviluppo per TCPViewer e PcapPlusPlusCore.
xcodebuild test \
-project TCPViewer.xcodeproj \
-scheme TCPViewer \
-destination 'platform=macOS'
I rilasci di TCP Viewer vengono compilati, notarizzati, firmati per Sparkle, caricati su Cloudflare R2 e opzionalmente pubblicati nel backend di rilascio dallo script di rilascio.
Configurazione iniziale del rilascio:
npm install
bundle install
gh auth login
Crea un file .env locale da .env.example e inserisci i valori di rilascio richiesti. Non commettere mai segreti reali. Mantieni i commenti in .env come commenti # perché sentry-cli non accetta commenti // quando carica il file.
Per i rilasci di produzione, aggiungi una voce corrispondente a ReleaseNote.json, poi esegui:
npm run release
Scegli beta o production quando richiesto. I rilasci di produzione creano anche l'appcast Sparkle, spingono il tag v<versione> e pubblicano il rilascio su GitHub. Gli artefatti vengono scritti in:
~/Desktop/tcpviewer-production/
TCP Viewer è concesso in licenza GPL-2.0 o successive. Questo corrisponde all'integrazione dell'app con Wireshark: libwireshark, libwiretap e libwsutil sono librerie Wireshark coperte da GPL.
Il testo completo della GPL è in COPYING, gli avvisi di terze parti sono in THIRD_PARTY_NOTICES.md e i termini di disponibilità del codice sorgente per i rilasci binari sono in SOURCE_CODE_OFFER.md.
TCP Viewer si basa su Wireshark per la dissection dei pacchetti e su HexFiend per il visualizzatore esadecimale integrato. Vedi THIRD_PARTY_NOTICES.md per i dettagli.