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 man页

trip --generate-man

以 silent 追踪模式运行并输出带有 full 跨度事件的 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配置目录（仅限Unix）：$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策略，该策略将序列号编码在IPidentifier字段中，Trippy可以固定源端口和目标端口，通常在每个跟踪轮次中每个探测只会遵循一条路径。

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

[!注意] 请记住，每个探测都是一个独立的试验，每个都可能穿越完全不同的路径。在实际中，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

由于 UDP checksum 字段通常由 NAT 设备修改，因此 paris 策略在 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 跟踪代替 TCP 来诊断 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 数据。

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

Trippy 聊天室由 Zulip 赞助。

许可

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

除非您明确说明，否则任何有意提交以供您在 Apache-2.0 许可证定义的时间内包含在内的贡献，均应按照上述方式许可，而无需任何额外的条款或条件。

请参阅许可证以获取详细信息。

版权所有 2022 Trippy 贡献者