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 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配置目录：$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

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

trip example.com

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

[tui]
custom-columns = "hosavbwdt"

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

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

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

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

[tui]
custom-columns = "holsravbwdtSPQ"

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

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

trip example.com --tcp