Skip to main content

Initiate wireshark remote capture (SSH or AVM FRITZ!Box)

Project description

Build Status Coverage Status PyPI Version

wireshark_remote - Initiate wireshark remote capture (SSH or AVM FRITZ!Box)

This project provides the wireshark-ssh and wireshark-fritzbox wrapper scripts that simplify executing Wireshark to remotely capture network traffic.

Installation

wireshark_remote (and its dependencies) can be installed from PyPI with: python -m pip install wireshark_remote

In addition the following programs need to be available an in PATH. The corresponding packages have to be installed through your distro's package manager.

wireshark-ssh requires on the host:

  • wireshark
  • ssh

and on the remote machine (besides having an SSH server running):

  • tcpdump
  • sudo (optional)

wireshark-fritzbox requires on the host:

  • wireshark
  • wget

Usage

wireshark-ssh

Usage: wireshark-ssh.py [OPTIONS] HOST [EXPRESSION]...

  Launches wireshark locally and runs tcpdump on the remote [USER@]HOST via
  SSH. An optional tcpdump filter EXPRESSION allows to prefilter the captured
  packets.

Options:
  -i, --interface TEXT  The interface to capture from (default any).
  -s, --sudo            Run tcpdump via sudo.
  --help                Show this message and exit.

The following example shows how to remotely capture DNS network traffic on any interface over SSH (tcpdump is executed with sudo on the remote host):

wireshark-ssh --sudo <user>@<host> port 53

wireshark-fritzbox

Usage: wireshark-fritzbox.py [OPTIONS] [HOST]

  Launches wireshark locally and captures from the AVM FRITZ!Box webinterface.

Options:
  -i, --interface TEXT  The interface to capture from (default 3-0).
  -U, --username TEXT   [required]
  -P, --password TEXT   [required]
  --help                Show this message and exit.

The following example shows how to remotely capture all network traffic on the Routing Interface (3-0) of the AVM FRITZ!Box on fritz.box:

wireshark-fritzbox -U <username> -P <password>

License

This projected is licensed under the terms of the MIT license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wireshark_remote-0.1.0.tar.gz (9.0 kB view details)

Uploaded Source

Built Distribution

wireshark_remote-0.1.0-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

File details

Details for the file wireshark_remote-0.1.0.tar.gz.

File metadata

  • Download URL: wireshark_remote-0.1.0.tar.gz
  • Upload date:
  • Size: 9.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.13

File hashes

Hashes for wireshark_remote-0.1.0.tar.gz
Algorithm Hash digest
SHA256 089ba87e69a75643dda209f5f5b4ea6fa6be49323e372c657c57bf300946f567
MD5 166559a3300dd420575ec3284c67903a
BLAKE2b-256 bc39b9c750d48cdbf4578d19418f49dc1948177f283f030611efe2a419cda1fe

See more details on using hashes here.

File details

Details for the file wireshark_remote-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for wireshark_remote-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 21c5acd87d602b4941805cb07065c9ce3e5555c08d6d03be6f2c719016a7e17b
MD5 be4e4eabd4baac1a4ad597a35bc69bbe
BLAKE2b-256 f0508d5a6f2ea77de3a44885c6ee8378b4d278cafef9228f7750015f74480ea2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page