mirror of
https://github.com/webinstall/webi-installers.git
synced 2026-04-19 08:26:39 +00:00
108 lines
2.4 KiB
Markdown
108 lines
2.4 KiB
Markdown
---
|
|
title: Trippy
|
|
homepage: https://github.com/fujiapple852/trippy
|
|
tagline: |
|
|
Trippy: A tool that combines the functionality of traceroute and ping designed for networking issue analysis.
|
|
---
|
|
|
|
To update or switch versions, run `webi trip@stable` (or `@v0.8`, `@beta`, etc).
|
|
|
|
## Cheat Sheet
|
|
|
|
> Trippy combines the functionality of `traceroute` and `ping` to assist in
|
|
> analyzing networking issues. It supports multiple protocols such as ICMP, UDP,
|
|
> and TCP, and is equipped with a Tui interface for detailed analysis.
|
|
|
|
```sh
|
|
sudo env PATH="$PATH" trip example.com
|
|
```
|
|
|
|
|
|
|
|
## Table of Contents
|
|
|
|
- Files
|
|
- Granting Root
|
|
- Tracing Protocols
|
|
- Tracing Options
|
|
- GoeIP Map
|
|
|
|
### Files
|
|
|
|
These are the files / directories that are created and/or modified with this
|
|
install:
|
|
|
|
```text
|
|
~/.config/trippy.toml
|
|
~/.local/bin/trip
|
|
<PROJECT-DIR>/.trippy.toml
|
|
|
|
# Windows
|
|
~/.local/bin/sudo.cmd
|
|
/Windows/System32/vcruntime140.dll (msvc runtime)
|
|
```
|
|
|
|
### How to Always Run as Root
|
|
|
|
Due to the nature of raw network access, `trip` always needs to run with
|
|
elevated network privileges.
|
|
|
|
On Linux `setcap` can be used to limit its root privileges to the network only.
|
|
On other systems it may need full root access.
|
|
|
|
**Linux**
|
|
|
|
```sh
|
|
trip_bin="$( readlink -f "$( command -v trip )" )"
|
|
|
|
sudo setcap 'CAP_NET_RAW+p' "${trip_bin}"
|
|
```
|
|
|
|
**macOS**
|
|
|
|
```sh
|
|
trip_bin="$( command -v trip )"
|
|
|
|
sudo chown root "${trip_bin}" && \
|
|
sudo chmod +s "${trip_bin}"
|
|
```
|
|
|
|
**Windows**
|
|
|
|
1. You need to add a firewall rule to allow ICMP
|
|
```pwsh
|
|
New-NetFirewallRule -DisplayName "ICMP Trippy Allow" -Name ICMP_TRIPPY_ALLOW -Protocol ICMPv4 -Action Allow
|
|
```
|
|
2. You'll need to run with an Administrator shell, or `sudo.cmd` **every time**:
|
|
```sh
|
|
sudo.cmd trip.exe example.com
|
|
```
|
|
|
|
### How to Trace with Various Protocols
|
|
|
|
You can use `icmp`, `tcp`, or `udp`:
|
|
|
|
```sh
|
|
trip --protocol icmp example.com
|
|
```
|
|
|
|
### How to set Tracing Options
|
|
|
|
You can pick a payload byte pattern (0-255) and packet size:
|
|
|
|
```sh
|
|
trip --packet-size 64 --payload-pattern 255
|
|
```
|
|
|
|
### How to View GeoIP Mapping
|
|
|
|
You'll need to download a geoip map database, such as this:
|
|
|
|
- <https://dev.maxmind.com/geoip/geolite2-free-geolocation-data>
|
|
|
|
```sh
|
|
trip example.com --geoip-mmdb-file ./GeoLite2-City.mmdb --tui-geoip-mode long
|
|
```
|
|
|
|
|