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信息（系统解析器尚不可用，见 #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

生成bashshell自动补全（或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

命令参考

[!NOTE] 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的数据目录：%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地址以及端口的5元组确定。

此外，请注意返回路径可能不与前进路径相同，并且也可能在每个探测中不同。例如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

在NAT后面，paris 策略无法工作，因为UDP的checksum字段通常会被NAT设备修改。因此，当存在NAT时，建议使用dublin策略。

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

TCP

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

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

运行TCP跟踪

trip example.com --tcp

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

[!注意] 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 License（版本2.0）条款分发。

除非您明确声明，否则您提交的任何旨在包含在时间内的有意贡献，根据Apache-2.0许可证定义，应按上述方式授权，不附加任何额外条款或条件。

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

版权所有2022 Trippy贡献者