snitch

Un ss / netstat più amichevole per gli umani. Ispeziona le connessioni di rete con una tui pulita o tabelle stilizzate.

snitch demo

Installazione

homebrew

brew install snitch

Grazie a @bevanjkay per aver aggiunto snitch a homebrew-core

go

go install github.com/karol-broda/snitch@latest

nixpkgs

nix-env -iA nixpkgs.snitch

Grazie a @DieracDelta per aver aggiunto snitch a nixpkgs

nixos / nix (flake)

# try it
nix run github:karol-broda/snitch

# install to profile
nix profile install github:karol-broda/snitch

# or add to flake inputs
{
  inputs.snitch.url = "github:karol-broda/snitch";
}
# then use: inputs.snitch.packages.${system}.default

home-manager (flake)

Aggiungi snitch agli input del tuo flake e importa il modulo home-manager:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    home-manager.url = "github:nix-community/home-manager";
    snitch.url = "github:karol-broda/snitch";
  };

  outputs = { nixpkgs, home-manager, snitch, ... }: {
    homeConfigurations."user" = home-manager.lib.homeManagerConfiguration {
      pkgs = nixpkgs.legacyPackages.x86_64-linux;
      modules = [
        snitch.homeManagerModules.default
        {
          programs.snitch = {
            enable = true;
            # optional: use the flake's package instead of nixpkgs
            # package = snitch.packages.x86_64-linux.default;
            settings = {
              defaults = {
                theme = "catppuccin-mocha";
                interval = "2s";
                resolve = true;
              };
            };
          };
        }
      ];
    };
  };
}

Temi disponibili: ansi, catppuccin-mocha, catppuccin-macchiato, catppuccin-frappe, catppuccin-latte, gruvbox-dark, gruvbox-light, dracula, nord, tokyo-night, tokyo-night-storm, tokyo-night-light, solarized-dark, solarized-light, one-dark,

arch linux (aur)

# with yay
yay -S snitch-bin

# with paru
paru -S snitch-bin

Script shell

curl -sSL https://raw.githubusercontent.com/karol-broda/snitch/master/install.sh | sh

Installa in ~/.local/bin se disponibile, altrimenti in /usr/local/bin. Per modificare la destinazione:

curl -sSL https://raw.githubusercontent.com/karol-broda/snitch/master/install.sh | INSTALL_DIR=~/bin sh

macos: lo script di installazione rimuove automaticamente l'attributo di quarantena (com.apple.quarantine) dal binario per consentirne l'esecuzione senza avvisi di gatekeeper. Per disabilitare questo comportamento, imposta KEEP_QUARANTINE=1.

docker

Immagini oci precompilate disponibili dal registro container di github:

# pull from ghcr.io
docker pull ghcr.io/karol-broda/snitch:latest          # alpine (default)
docker pull ghcr.io/karol-broda/snitch:latest-alpine   # alpine (~17MB)
docker pull ghcr.io/karol-broda/snitch:latest-scratch  # minimal, binary only (~9MB)
docker pull ghcr.io/karol-broda/snitch:latest-debian   # debian trixie
docker pull ghcr.io/karol-broda/snitch:latest-ubuntu   # ubuntu 24.04

# or use a specific version
docker pull ghcr.io/karol-broda/snitch:0.2.0-alpine

In alternativa, compila localmente tramite il flake nix:

nix build github:karol-broda/snitch#snitch-alpine
docker load < result

Esecuzione del container:

# basic usage - sees host sockets but not process names
docker run --rm --net=host snitch:latest ls

# full info - includes PID, process name, user
docker run --rm --net=host --pid=host --cap-add=SYS_PTRACE snitch:latest ls

flag	scopo
`--net=host`	condividi il namespace di rete dell'host (necessario per vedere le connessioni dell'host)
`--pid=host`	condividi il namespace pid dell'host (necessario per le informazioni sui processi)
`--cap-add=SYS_PTRACE`	legge i dettagli dei processi da

nota: CAP_NET_ADMIN e CAP_NET_RAW non sono richiesti. snitch legge da /proc/net/*, che non richiede capacità di rete speciali.

Binario

Scarica dalla pagina releases:

linux: snitch_<version>_linux_<arch>.tar.gz oppure .deb/.rpm/.apk
macos: snitch_<version>_darwin_<arch>.tar.gz

tar xzf snitch_*.tar.gz
sudo mv snitch /usr/local/bin/

macos: se viene bloccato con il messaggio "non può essere aperto perché lo sviluppatore non può essere verificato", esegui:
xattr -d com.apple.quarantine /usr/local/bin/snitch

Avvio rapido

snitch              # launch interactive tui
snitch -l           # tui showing only listening sockets
snitch ls           # print styled table and exit
snitch ls -l        # listening sockets only
snitch ls -t -e     # tcp established connections
snitch ls -p        # plain output (parsable)

Comandi

`snitch` / `snitch top`

Tui interattiva con elenco delle connessioni aggiornato in tempo reale.

snitch                  # all connections
snitch -l               # listening only
snitch -t               # tcp only
snitch -e               # established only
snitch -i 2s            # 2 second refresh interval

Scorciatoie da tastiera:

j/k, ↑/↓      navigate
g/G           top/bottom
t/u           toggle tcp/udp
l/e/o         toggle listen/established/other
s/S           cycle sort / reverse
w             watch/monitor process (highlight)
W             clear all watched
K             kill process (with confirmation)
/             search
enter         connection details
?             help
q             quit

`snitch ls`

Output tabellare one-shot. Usa automaticamente un pager se l'output supera l'altezza del terminale.

snitch ls               # styled table (default)
snitch ls -l            # listening only
snitch ls -t -l         # tcp listeners
snitch ls -e            # established only
snitch ls -p            # plain/parsable output
snitch ls -o json       # json output
snitch ls -o csv        # csv output
snitch ls -n            # numeric (no dns resolution)
snitch ls --no-headers  # omit headers

`snitch json`

Output json per script.

snitch json
snitch json -l

`snitch watch`

Trasmette frame json a un intervallo prestabilito.

snitch watch -i 1s | jq '.count'
snitch watch -l -i 500ms

`snitch upgrade`

Controlla la disponibilità di aggiornamenti e aggiorna in-place.

snitch upgrade              # check for updates
snitch upgrade --yes        # upgrade automatically
snitch upgrade -v 0.1.7     # install specific version

Filtri

I flag abbreviati funzionano su tutti i comandi:

-t, --tcp           tcp only
-u, --udp           udp only
-l, --listen        listening sockets
-e, --established   established connections
-4, --ipv4          ipv4 only
-6, --ipv6          ipv6 only

Risoluzione

Opzioni di risoluzione dns e nomi dei servizi:

--resolve-addrs     resolve ip addresses to hostnames (default: true)
--resolve-ports     resolve port numbers to service names
--no-cache          disable dns caching (force fresh lookups)

Le ricerche dns vengono eseguite in parallelo e memorizzate nella cache per motivi di prestazioni. Usa --no-cache per bypassare la cache durante il debug o quando gli indirizzi cambiano frequentemente.

Per un filtraggio più specifico, usa la sintassi key=value con ls:

snitch ls proto=tcp state=listen
snitch ls pid=1234
snitch ls proc=nginx
snitch ls lport=443
snitch ls contains=google

Output

Tabella stilizzata (predefinita):

  ╭─────────────────┬───────┬───────┬─────────────┬─────────────────┬────────╮
  │ PROCESS         │ PID   │ PROTO │ STATE       │ LADDR           │ LPORT  │
  ├─────────────────┼───────┼───────┼─────────────┼─────────────────┼────────┤
  │ nginx           │ 1234  │ tcp   │ LISTEN      │ *               │ 80     │
  │ postgres        │ 5678  │ tcp   │ LISTEN      │ 127.0.0.1       │ 5432   │
  ╰─────────────────┴───────┴───────┴─────────────┴─────────────────┴────────╯
  2 connections

Output semplice (-p):

PROCESS    PID    PROTO   STATE    LADDR       LPORT
nginx      1234   tcp     LISTEN   *           80
postgres   5678   tcp     LISTEN   127.0.0.1   5432

Configurazione

File di configurazione opzionale in ~/.config/snitch/snitch.toml:

[defaults]
numeric = false      # disable name resolution
dns_cache = true     # cache dns lookups (set to false to disable)
theme = "auto"       # color theme: auto, dark, light, mono

[tui]
remember_state = false   # remember view options between sessions

Ricordare le opzioni di visualizzazione

Quando remember_state = true, la tui salva e ripristina:

i toggle dei filtri (tcp/udp, listen/established/other)
il campo e la direzione di ordinamento
le impostazioni di risoluzione di indirizzi e porte

Lo stato viene salvato in $XDG_STATE_HOME/snitch/tui.json (il percorso predefinito è ~/.local/state/snitch/tui.json).

I flag della CLI hanno sempre la priorità sullo stato salvato.

Variabili d'ambiente

SNITCH_THEME=dark          # set default theme
SNITCH_RESOLVE=0           # disable dns resolution
SNITCH_DNS_CACHE=0         # disable dns caching
SNITCH_NO_COLOR=1          # disable color output
SNITCH_CONFIG=/path/to     # custom config file path

Requisiti

linux o macos
linux: legge da /proc/net/*, root o CAP_NET_ADMIN per informazioni complete sui processi
macos: usa le API di sistema, potrebbe richiedere sudo per informazioni complete sui processi

snitch

Più Popolari

snitch

Installazione

homebrew

go

nixpkgs

nixos / nix (flake)

home-manager (flake)

arch linux (aur)

Script shell

docker

Binario

Avvio rapido

Comandi

snitch / snitch top

snitch ls

snitch json

snitch watch

snitch upgrade

Filtri

Risoluzione

Output

Configurazione

Ricordare le opzioni di visualizzazione

Variabili d'ambiente

Requisiti

`snitch` / `snitch top`

`snitch ls`

`snitch json`

`snitch watch`

`snitch upgrade`