版本

以下表格列出了可用的Trippy版本以及相应的发行说明和文档链接

[!NOTE] 仅支持Trippy当前和以前版本的最新修补版本。

发行版

Cargo

cargo install trippy --locked

PPA（Ubuntu）

sudo add-apt-repository ppa:fujiapple/trippy
sudo apt update && apt install trippy

Snap（Linux）

snap install trippy

Homebrew（macOS）

brew install trippy

WinGet（Windows）

winget install trippy

Scoop（Windows）

scoop install trippy

Chocolatey（Windows）

choco install trippy

NetBSD

pkgin install trippy

FreeBSD

pkg install trippy

OpenBSD

pkg_add trippy

Pacman（Arch Linux）

pacman -S trippy

Nix

nix-env -iA trippy

Docker

docker run -it fujiapple/trippy

二进制资产下载

库

以下表格列出了Trippy提供的crate。有关更多信息，请参阅crate。

权限

由于使用了原始套接字，Trippy通常需要提升权限。可以通过以下方式启用平台所需权限：Trippy可以在某些平台上使用，而无需提升权限，但会有限制。

Unix

1: 通过 sudo 以 root 用户运行

sudo trip example.com

2: 以 root 用户 chown trip 并设置 setuid 位

sudo chown root $(which trip) && sudo chmod +s $(which trip)

3: [仅限Linux] 设置 CAP_NET_RAW 能力

sudo setcap CAP_NET_RAW+p $(which trip)

[!NOTE]
Trippy 是一种能力感知的应用程序，如果它存在于允许集合中，则会将 CAP_NET_RAW 添加到有效集合。创建原始套接字后，Trippy 将丢弃所有能力。

Windows

在 Windows 上，必须以管理员权限运行 Trippy。

非特权模式

Trippy 允许在支持该功能的平台上以非特权模式运行所有跟踪模式（ICMP、UDP 和 TCP）。

[!NOTE] 目前，非特权模式仅在 macOS 上受支持。Linux 支持（可能在未来添加）。NetBSD、FreeBSD 和 Windows 上不支持非特权模式，因为这些平台不支持 IPPROTO_ICMP 套接字类型。有关更多信息，请参阅 #101。

可以通过添加命令行标志 --unprivileged（或 -u）或通过在 配置文件 的 trippy 部分中添加 unprivileged 条目来启用非特权模式。

[trippy]
unprivileged = true

[!NOTE] 在非特权模式下不支持 paris 和 dublin ECMP 策略，因为这些策略需要操作 UDP 和 IP 以及头部，这反过来又需要使用原始套接字。

使用示例

使用默认参数的基本用法

trip example.com

在不需要提升权限的情况下进行跟踪（仅限支持的平台，请参阅 权限）

trip example.com --unprivileged

使用 udp（或 tcp 或 icmp）协议进行跟踪（也别名 --icmp、--udp & --tcp）

trip example.com -p udp

同时跟踪多个目标（仅限 icmp 协议，请参阅 #72）

trip example.com google.com crates.io

以 250ms 的最小往返时间和 50ms 的宽限期进行跟踪

trip example.com -i 250ms -g 50ms

使用自定义的首个和最大 TTL 进行跟踪

trip example.com --first-ttl 2 --max-ttl 10

对于 tcp 跟踪使用自定义目标端口 443

trip example.com -p tcp -P 443

对于 udp 跟踪使用自定义源端口 5000

trip example.com -p udp -S 5000

对于具有固定源和目标端口的 udp，使用 dublin（或 paris）ECMP 路由策略

trip example.com -p udp -R dublin -S 5000 -P 3500

使用自定义源地址进行跟踪

trip example.com -p tcp -A 127.0.0.1

使用接口 en0 的 IPv4 地址确定源地址进行跟踪

trip example.com -p tcp -I en0

使用 IPv6 进行跟踪

trip example.com -6

使用 ipv4-then-ipv6 回退（或 ipv6-then-ipv4 或 ipv4 或 ipv6）进行跟踪

trip example.com --addr-family ipv4-then-ipv6

生成包含 5 轮数据的 json（或 csv、pretty、markdown）跟踪报告

trip example.com -m json -C 5

在 5 轮之后生成 TCP 跟踪所有跟踪流的所有 Graphviz DOT 文件报告

trip example.com --tcp -m dot -C 5

在 5 轮之后生成 UDP 跟踪所有跟踪流的所有文本报告

trip example.com --udp -m flows -C 5

使用 google DNS 解析器执行 DNS 查询（或 cloudflare、system、resolv）

trip example.com -r google

查找所有发现的 IP 地址的 AS 信息（对于 system 解析器尚不可用，请参阅 #66）

trip example.com -r google -z

将反向 DNS 查询缓存生存时间设置为 60 秒

trip example.com --dns-ttl 60sec

从 mmdb 文件中查找并显示 short（或 long、location 或 off） GeoIp 信息

trip example.com --geoip-mmdb-file GeoLite2-City.mmdb --tui-geoip-mode short

解析 icmp 扩展

trip example.com -e

隐藏前两个跳转的 IP 地址、主机名和 GeoIp

trip example.com --tui-privacy-max-ttl 2

自定义 Tui 列（见 列参考）

trip example.com --tui-custom-columns holsravbwdt

自定义颜色主题

trip example.com --tui-theme-colors bg-color=blue,text-color=ffff00

列出所有可以自定义颜色主题的 Tui 项目

trip --print-tui-theme-items

自定义按键绑定

trip example.com --tui-key-bindings previous-hop=k,next-hop=j,quit=shift-q

列出所有可以自定义按键绑定的 Tui 命令

trip --print-tui-binding-commands

指定 Trippy 配置文件的位置

trip example.com --config-file /path/to/trippy.toml

生成模板配置文件

trip --print-config-template > trippy.toml

生成 bash shell 自动补全（或 fish、powershell、zsh、elvish）

trip --generate bash

生成 ROFF 手册页

trip --generate-man

以静默跟踪模式运行并使用完整跨度事件输出 compact 跟踪日志

trip example.com -m silent -v --log-format compact --log-span-events full

命令参考

[!注意] Trippy 命令行参数的顺序可以是任意的，并且可以出现在目标之前或之后。

A network diagnostic tool

Usage: trip [OPTIONS] [TARGETS]...

Arguments:
  [TARGETS]...
          A space delimited list of hostnames and IPs to trace

Options:
  -c, --config-file <CONFIG_FILE>
          Config file

  -m, --mode <MODE>
          Output mode [default: tui]

          Possible values:
          - tui:      Display interactive TUI
          - stream:   Display a continuous stream of tracing data
          - pretty:   Generate a pretty text table report for N cycles
          - markdown: Generate a Markdown text table report for N cycles
          - csv:      Generate a CSV report for N cycles
          - json:     Generate a JSON report for N cycles
          - dot:      Generate a Graphviz DOT file for N cycles
          - flows:    Display all flows for N cycles
          - silent:   Do not generate any tracing output for N cycles

  -u, --unprivileged
          Trace without requiring elevated privileges on supported platforms
          [default: false]

  -p, --protocol <PROTOCOL>
          Tracing protocol [default: icmp]

          Possible values:
          - icmp: Internet Control Message Protocol
          - udp:  User Datagram Protocol
          - tcp:  Transmission Control Protocol

      --udp
          Trace using the UDP protocol

      --tcp
          Trace using the TCP protocol

      --icmp
          Trace using the ICMP protocol

  -F, --addr-family <ADDR_FAMILY>
          The address family [default: Ipv4thenIpv6]

          Possible values:
          - ipv4:           Ipv4 only
          - ipv6:           Ipv6 only
          - ipv6-then-ipv4: Ipv6 with a fallback to Ipv4
          - ipv4-then-ipv6: Ipv4 with a fallback to Ipv6

  -4, --ipv4
          Use IPv4 only

  -6, --ipv6
          Use IPv6 only

  -P, --target-port <TARGET_PORT>
          The target port (TCP & UDP only) [default: 80]

  -S, --source-port <SOURCE_PORT>
          The source port (TCP & UDP only) [default: auto]

  -A, --source-address <SOURCE_ADDRESS>
          The source IP address [default: auto]

  -I, --interface <INTERFACE>
          The network interface [default: auto]

  -i, --min-round-duration <MIN_ROUND_DURATION>
          The minimum duration of every round [default: 1s]

  -T, --max-round-duration <MAX_ROUND_DURATION>
          The maximum duration of every round [default: 1s]

  -g, --grace-duration <GRACE_DURATION>
          The period of time to wait for additional ICMP responses after the
          target has responded [default: 100ms]

      --initial-sequence <INITIAL_SEQUENCE>
          The initial sequence number [default: 33434]

  -R, --multipath-strategy <MULTIPATH_STRATEGY>
          The Equal-cost Multi-Path routing strategy (UDP only) [default:
          classic]

          Possible values:
          - classic:
            The src or dest port is used to store the sequence number
          - paris:
            The UDP `checksum` field is used to store the sequence number
          - dublin:
            The IP `identifier` field is used to store the sequence number

  -U, --max-inflight <MAX_INFLIGHT>
          The maximum number of in-flight ICMP echo requests [default: 24]

  -f, --first-ttl <FIRST_TTL>
          The TTL to start from [default: 1]

  -t, --max-ttl <MAX_TTL>
          The maximum number of TTL hops [default: 64]

      --packet-size <PACKET_SIZE>
          The size of IP packet to send (IP header + ICMP header + payload)
          [default: 84]

      --payload-pattern <PAYLOAD_PATTERN>
          The repeating pattern in the payload of the ICMP packet [default: 0]

  -Q, --tos <TOS>
          The TOS (i.e. DSCP+ECN) IP header value (TCP and UDP only) [default: 0]

  -e, --icmp-extensions
          Parse ICMP extensions

      --read-timeout <READ_TIMEOUT>
          The socket read timeout [default: 10ms]

  -r, --dns-resolve-method <DNS_RESOLVE_METHOD>
          How to perform DNS queries [default: system]

          Possible values:
          - system:     Resolve using the OS resolver
          - resolv:     Resolve using the `/etc/resolv.conf` DNS configuration
          - google:     Resolve using the Google `8.8.8.8` DNS service
          - cloudflare: Resolve using the Cloudflare `1.1.1.1` DNS service

  -y, --dns-resolve-all
          Trace to all IPs resolved from DNS lookup [default: false]

      --dns-timeout <DNS_TIMEOUT>
          The maximum time to wait to perform DNS queries [default: 5s]

      --dns-ttl <DNS_TTL>
          The time-to-live (TTL) of DNS entries [default: 300s]

  -z, --dns-lookup-as-info
          Lookup autonomous system (AS) information during DNS queries [default:
          false]

  -s, --max-samples <MAX_SAMPLES>
          The maximum number of samples to record per hop [default: 256]

      --max-flows <MAX_FLOWS>
          The maximum number of flows to record [default: 64]

  -a, --tui-address-mode <TUI_ADDRESS_MODE>
          How to render addresses [default: host]

          Possible values:
          - ip:   Show IP address only
          - host: Show reverse-lookup DNS hostname only
          - both: Show both IP address and reverse-lookup DNS hostname

      --tui-as-mode <TUI_AS_MODE>
          How to render AS information [default: asn]

          Possible values:
          - asn:          Show the ASN
          - prefix:       Display the AS prefix
          - country-code: Display the country code
          - registry:     Display the registry name
          - allocated:    Display the allocated date
          - name:         Display the AS name

      --tui-custom-columns <TUI_CUSTOM_COLUMNS>
          Custom columns to be displayed in the TUI hops table [default:
          holsravbwdt]

      --tui-icmp-extension-mode <TUI_ICMP_EXTENSION_MODE>
          How to render ICMP extensions [default: off]

          Possible values:
          - off:  Do not show `icmp` extensions
          - mpls: Show MPLS label(s) only
          - full: Show full `icmp` extension data for all known extensions
          - all:  Show full `icmp` extension data for all classes

      --tui-geoip-mode <TUI_GEOIP_MODE>
          How to render GeoIp information [default: short]

          Possible values:
          - off:      Do not display GeoIp data
          - short:    Show short format
          - long:     Show long format
          - location: Show latitude and Longitude format

  -M, --tui-max-addrs <TUI_MAX_ADDRS>
          The maximum number of addresses to show per hop [default: auto]

      --tui-preserve-screen
          Preserve the screen on exit [default: false]

      --tui-refresh-rate <TUI_REFRESH_RATE>
          The Tui refresh rate [default: 100ms]

      --tui-privacy-max-ttl <TUI_PRIVACY_MAX_TTL>
          The maximum ttl of hops which will be masked for privacy [default: 0]

      --tui-theme-colors <TUI_THEME_COLORS>
          The TUI theme colors [item=color,item=color,..]

      --print-tui-theme-items
          Print all TUI theme items and exit

      --tui-key-bindings <TUI_KEY_BINDINGS>
          The TUI key bindings [command=key,command=key,..]

      --print-tui-binding-commands
          Print all TUI commands that can be bound and exit

  -C, --report-cycles <REPORT_CYCLES>
          The number of report cycles to run [default: 10]

  -G, --geoip-mmdb-file <GEOIP_MMDB_FILE>
          The supported MaxMind or IPinfo GeoIp mmdb file

      --generate <GENERATE>
          Generate shell completion

          [possible values: bash, elvish, fish, powershell, zsh]

      --generate-man
          Generate ROFF man page

      --print-config-template
          Print a template toml config file and exit

      --log-format <LOG_FORMAT>
          The debug log format [default: pretty]

          Possible values:
          - compact: Display log data in a compact format
          - pretty:  Display log data in a pretty format
          - json:    Display log data in a json format
          - chrome:  Display log data in Chrome trace format

      --log-filter <LOG_FILTER>
          The debug log filter [default: trippy=debug]

      --log-span-events <LOG_SPAN_EVENTS>
          The debug log format [default: off]

          Possible values:
          - off:    Do not display event spans
          - active: Display enter and exit event spans
          - full:   Display all event spans

  -v, --verbose
          Enable verbose debug logging

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

主题参考

下表列出了默认的 Tui 颜色主题。这些可以通过命令行选项 --tui-theme-colors 或配置文件中的 theme-colors 部分来覆盖。

支持以下ANSI颜色：

• 黑色，红色，绿色，黄色，蓝色，品红色，青色，灰色，深灰色，浅红色，浅绿色，浅黄色，浅蓝色，浅品红色，浅青色，白色

此外，还可以使用CSS 命名颜色（例如：SkyBlue）和原始十六进制值（例如：ffffff），但请注意，这些可能只在某些平台和终端上受支持，并且可能在其他地方无法正确渲染。

颜色名称不区分大小写，并且可以包含短横线。

键绑定参考

以下表格列出了默认的Tui命令键绑定。这些可以通过命令行选项--tui-key-bindings或配置文件中的bindings部分进行重写。

支持的修饰符有：shift，ctrl，alt，super，hyper & meta。可以指定多个修饰符，例如 ctrl+shift+b。

列参考

以下表格列出了Tui中可显示的列。这些列可以通过命令行选项 --tui-custom-columns 或配置文件中 tui 部分的 tui-custom-columns 属性来覆盖。

默认列是 holsravbwdt。

[!注意] 列将按照配置中指定的顺序显示。

配置参考

Trippy可以通过命令行参数或可选的配置文件进行配置。如果配置文件和命令行参数中指定了相同的配置项，则后者将优先。

可以通过 -c（--config-file）参数将配置文件位置提供给Trippy。如果没有提供，Trippy将尝试在以下位置查找 trippy.toml 或 .trippy.toml 配置文件：

• 当前目录
• 用户主目录
• Unix上的XDG配置目录： $XDG_CONFIG_HOME 或 ~/.config
• Windows数据目录（仅限Windows）： %APPDATA%

为0.9.0、0.10.0和0.11.0版本，提供了注释模板配置文件。

Trippy（版本0.9.0或更高版本）可以生成模板配置文件

trip --print-config-template > trippy.toml

常见问题解答

为什么Trippy显示“等待数据...”？

[!IMPORTANT]
如果你使用的是Windows，你必须 配置 Windows Defender防火墙以允许传入的ICMP流量

当Trippy显示“等待数据...”时，这意味着它对追踪中发送的探测没有收到任何响应。这表明要么探测没有被发送，要么更常见的情况是响应没有被接收。

请检查本地和网络防火墙是否允许ICMP流量，并且系统traceroute（或Windows上的tracert.exe）是否按预期工作。请注意，在Windows上，即使tracert.exe按预期工作，你必须 配置 Windows Defender防火墙以允许传入的ICMP流量。

为了进行更深入的诊断，你可以运行工具如https://www.wireshark.org和https://www.tcpdump.org，以验证icmp请求和响应是否被发送和接收。

如何在Windows Defender防火墙中允许传入的ICMP流量？

可以使用PowerShell创建Windows Defender防火墙规则。

New-NetFirewallRule -DisplayName "ICMPv4 Trippy Allow" -Name ICMPv4_TRIPPY_ALLOW -Protocol ICMPv4 -Action Allow
New-NetFirewallRule -DisplayName "ICMPv6 Trippy Allow" -Name ICMPv6_TRIPPY_ALLOW -Protocol ICMPv6 -Action Allow

可以按照以下方式启用规则

Enable-NetFirewallRule ICMPv4_TRIPPY_ALLOW
Enable-NetFirewallRule ICMPv6_TRIPPY_ALLOW

可以按照以下方式禁用规则

Disable-NetFirewallRule ICMPv4_TRIPPY_ALLOW
Disable-NetFirewallRule ICMPv6_TRIPPY_ALLOW

Windows Defender防火墙规则也可以手动配置，有关逐步指南，请参阅此处。

Trippy的推荐设置是什么？

对于Trippy没有特定的推荐设置，它提供了多种可配置的功能，可用于执行不同类型的分析。设置的选择将取决于你希望执行的分析以及你工作的环境。

以下列出了一些常见选项，以及一些基本指导，说明它们何时可能适用。

[!NOTE] Windows的tracert工具默认使用ICMP，而大多数Unix的traceroute工具默认使用UDP。

ICMP

默认情况下，Trippy将对目标运行ICMP追踪。这通常会产生每个追踪轮次到目标的连续路径（单个流），这使得阅读和分析变得容易。这对于一般的网络故障排除非常有用。

然而，许多路由器被配置为对ICMP流量进行速率限制，这可能会使获取准确的丢包率图变得困难。此外，ICMP流量通常不受到ECMP路由的约束，因此可能无法反映UDP和TCP等其他协议可能采用的路径。

要运行简单的ICMP追踪

trip example.com

由于ICMP流量的速率限制，有些人更喜欢在Tui中隐藏Loss%和Recv列，因为这些列容易被误解。

trip example.com --tui-custom-columns hosavbwdt

可以通过将这些设置添加到Trippy配置文件中来使这些设置永久生效。

[tui]
custom-columns = "hosavbwdt"

[注意] 《Sts》列通过不同的颜色代码反映中间跳与目标跳之间的数据包丢失，更多信息请参阅列参考。

具有固定端口的UDP/Dublin

UDP跟踪提供了对受ECMP路由影响的流量路径的更真实视图。

在33434-33534范围内设置一个固定的目标端口，可能允许Trippy确定探针已到达目标，因为许多路由器和防火墙都配置为允许该范围内的UDP探针，并将响应以目标不可达响应。

然而，使用固定目标端口和可变源端口的UDP跟踪通常会导致在每一轮跟踪中每个探针遵循不同的路径。这可能会使得输出难以解释，因为不同的主机会在不同轮次中对给定的跳（生存时间）进行回复。

通过使用dublin ECMP策略，该策略将序列号编码在IP identifier字段中，Trippy可以固定源端口和目标端口，通常在每一轮跟踪中为每个探针产生单个路径。

[注意] 对于IPv6，UDP/Dublin将序列号编码为有效载荷长度，因为IPv6中IP identifier字段不可用。

[注意] 请记住，每个探针都是一个独立的试验，每个都可能穿越完全不同的路径。在实际操作中，ICMP探针通常遵循单个路径，而UDP和TCP探针的路径通常由协议、源和目标IP地址以及端口的五元组决定。

此外，请注意返回路径可能与前进路径不同，并且也可能在每次探针中不同。例如dublin和paris等策略有助于控制前向探针的路径，但不能帮助控制返回路径。因此，建议在两个方向上运行跟踪以获得完整的视图。

使用dublin ECMP策略运行具有固定源和目标端口的UDP跟踪

trip example.com --udp --multipath-strategy dublin --source-port 5000 --target-port 33434

[注意] 源端口可以是任何有效的端口号，但目标端口通常应该在33434-33534范围内或目标主机上开放的UDP探针的任何范围内。

可以通过将这些设置添加到Trippy配置文件中来使这些设置永久生效。

[strategy]
protocol = "udp"
multipath-strategy = "dublin"
source-port = 5000
target-port = 33434

具有固定目标端口和可变源端口的UDP/Dublin

作为上述内容的扩展，如果您在使用dublin ECMP策略时没有固定源端口，Trippy将在每一轮跟踪（即给定轮次中的每个探针）中改变源端口（即每个给定轮次中的每个探针将共享相同的源端口，源端口将在每个轮次中变化）。这通常会导致在给定轮次中每个探针遵循相同的路径，但在每个轮次中遵循不同的路径。

可以通过按toggle-flows键绑定（默认为f键）在Trippy Tui中探索这些单独的流量。

将Seq、Sprt和Dprt列添加到Tui将分别显示序列号、源端口和目标端口，这使得可视化更加容易。

trip example.com --udp --multipath-strategy dublin --target-port 33434 --tui-custom-columns holsravbwdtSPQ

可以通过将这些设置添加到Trippy配置文件中来使这些设置永久生效。

[strategy]
protocol = "udp"
multipath-strategy = "dublin"
target-port = 33434

[tui]
custom-columns = "holsravbwdtSPQ"

为了使流量更容易可视化，您可以生成所有跟踪流量的Graphviz DOT文件报告

trip example.com --udp --multipath-strategy dublin --target-port 33434 -m dot -C 5

UDP/Paris

具有paris ECMP策略的UDP提供了与固定端口dublin策略相同的优点，并且可以以相同的方式使用。

它们在探针中编码序列号的方式上有所不同。 dublin 策略使用 IP identifier 字段，而 paris 策略使用 UDP checksum 字段。

使用 paris ECMP 策略运行具有固定源和目标端口的 UDP 跟踪

trip example.com --udp --multipath-strategy paris --source-port 5000 --target-port 33434

paris 策略不适用于 NAT 背后，因为 UDP checksum 字段通常会被 NAT 设备修改。因此，当存在 NAT 时，建议使用 dublin 策略。

[!NOTE] 在某些情况下，使用 dublin 策略时，Trippy 可以检测到 NAT 设备的存在，并且可以在 Tui 中显示 Nat 列表以指示检测到 NAT。有关更多信息，请参阅 列参考。

TCP

TCP 跟踪与 UDP 跟踪类似，因为它提供了对受 ECMP 路由影响的流量所采取路径的更真实视图。

TCP 跟踪默认使用目标端口 80，并将源端口设置为序列号，这通常会导致每个跟踪轮次中的每个探针遵循不同的路径。

运行 TCP 跟踪

trip example.com --tcp

TCP 跟踪用于诊断 TCP 连接和高层协议（如 HTTP）的问题。通常可以使用 UDP 跟踪来诊断 IP 层网络问题，因为它提供了控制探针所采取路径的方法，因此通常更受欢迎。

[!NOTE] Trippy 不支持 TCP 跟踪的 dublin 或 paris ECMP 策略，因此您不能同时固定源和目标端口。有关详细信息，请参阅 跟踪问题。

致谢

Trippy 是由 ratatui（以前称为 tui-rs）、crossterm 以及 几个 基础 Rust 库共同实现的。

Trippy 从 mtr 中汲取了大量灵感，并吸收了来自 libparistraceroute 和 Dublin Traceroute 的想法。

Trippy 的网络代码受到了 pnet 的启发，并且该代码库的一些元素被整合到了 Trippy 中。

来自 Team Cymru 提供的 IP 到 ASN 映射服务 获取 AS 数据。

trippy.cli.rs CNAME 主机服务由 cli.rs 提供。

Trippy 聊天室由 Zulip 赞助。

许可协议

本项目根据 Apache 许可证（版本 2.0）分发。

除非您明确表示否则，根据 Apache-2.0 许可证定义，您有意提交的任何贡献，均应按上述规定许可，不附加任何额外条款或条件。

有关详细信息，请参阅 LICENSE。

版权所有 2022 Trippy 贡献者