Tor 控制协议 GETINFO 可用参数列表

在 Tor 的各种控制程序（如 Python 的 Stem）中，GETINFO 都是一个极为重要的函数。其具体的信息可见 control-spec.txt，这里给出一个所有可用的列表。

对于不同的版本，可以使用info/names获取所有支持的列表，以 Stem 为例：

with Controller.from_port(port=9051) as controller:
    controller.authenticate()
    print(controller.get_info(
        "info/names",
    ))

简单翻译并分类，具体每个功能含义请查询control-spec.txt（不保证正确性）

统计信息相关

  • accounting/bytes: 统计区间中，读写的字节数
  • accounting/bytes-left: 统计区间中，还需要读取的字节数
  • accounting/enabled: 统计是否启用
  • accounting/hibernating: 处于激活状态还是休眠状态
  • accounting/interval-end: 统计区间的结束时间
  • accounting/interval-start: 统计区间的开始时间
  • accounting/interval-wake: 统计区间中激活状态时间
  • traffic/read: 启动后所有的读取流量字节数
  • traffic/written: 启动后所有写出流量字节数

地址相关

  • address: Tor 服务端对外的 IP（如果通过代理的话，是代理的 IP）
  • address-mappings/all: 当前的地址映射
  • address-mappings/cache: 当前的 DNS 缓存
  • address-mappings/config: 当前从配置文件中读取的地址映射
  • address-mappings/control: 当前从控制器（客户端）设置的地址映射
  • ip-to-country/*: GEOIP 解析（根据 IP 查询国家）

电路、中继节点相关

  • circuit-status: 当前所有已建立的电路信息
  • entry-guards: 所有被我们选中的入口守卫列表
  • ns/all: 路由节点状态描述（v2 目录格式）
  • ns/id/*: 根据 ID 获取路由节点状态描述（v2 目录格式）
  • ns/name/*: 根据名称获取路由节点状态描述（v2 目录格式）
  • ns/purpose/*: 根据用途获取路由节点状态描述（v2 目录格式）
  • status/enough-dir-info: 是由已拥有足够的目录信息来建立电路
  • stream-status: 所有正在使用的流

配置文件相关

  • config-can-saveconf: 是否允许将配置写入 torrc
  • config-defaults-file: 默认 torrc 文件位置
  • config-file: 当前使用的 torrc 文件位置
  • config-text: 输出使用SAVECONF将写出的内容
  • config/*: 特定配置项的内容
  • config/defaults: 所有配置项的默认值
  • config/names: 所有可用的配置项

时间相关

  • current-time/*: 输出某种格式的时间.
  • current-time/local: 本地时间
  • current-time/utc: UTC 时间

描述符相关

  • desc-annotations/id/*: 十六进制节点注释
  • desc/all-recent: 所有未过期、未被替代的节点描述符
  • desc/download-enabled: 是否会尝试下载节点描述符
  • desc/id/*: 特定 ID 的节点描述符
  • desc/name/*: 特定昵称的节点描述符
  • dir/server/*: 从 DirPort 检索节点描述符
  • dir/status-vote/current/consensus: v3 Networkstatus consensus as retrieved from a DirPort.
  • dir/status-vote/current/consensus-microdesc: v3 Microdescriptor consensus as retrieved from a DirPort.
  • dir/status/*: v2 networkstatus docs as retrieved from a DirPort

Tor 进程（OP）相关

  • dormant: Tor 是否处于休眠状态（不维护构建电路的工作）
  • process/descriptor-limit: 文件描述符限制
  • process/pid: 当前 Tor 进程的进程 ID (PID)
  • process/uid: 当前 Tor 进程对应的用户 ID (UID)
  • process/user: 当前 Tor 进程对应的用户名
  • uptime: Tor 守护进程运行时间
  • version: 当前的 Tor 版本
  • status/fresh-relay-descs: Tor 当前的中继信息状态
  • status/version/current: 当前的版本
  • status/version/recommended: 建议使用的版本

下载相关

  • downloads/bridge/*: 通过摘要值下载网桥描述符的状态
  • downloads/bridge/<desc>:特定描述符的下载状态
  • downloads/bridge/bridges: 带有下载状态的已配置网桥摘要列表
  • downloads/cert/*: 根据指纹或公钥查询证书下载状态
  • downloads/cert/fp/<fp>: 通过指纹查询证书下载状态
  • downloads/cert/fp/<fp>/<sk>: 通过指纹和公钥查询证书下载状态
  • downloads/cert/fp/<fp>/sks: 通过指纹查询证书与公钥下载状态
  • downloads/cert/fps: 已验证的指纹列表
  • downloads/desc/*: 根据描述符摘要查询下载状态
  • downloads/desc/<desc>: 根据描述符摘要查询下载状态
  • downloads/desc/descs: 返回所有已知的描述符摘要
  • downloads/networkstatus/*: 网络对象的下载状态
  • downloads/networkstatus/microdesc: 当前模式的微描述符下载状态
  • downloads/networkstatus/microdesc/bootstrap: 启动时微描述符下载状态
  • downloads/networkstatus/microdesc/running: 运行时微描述符下载状态
  • downloads/networkstatus/ns: 当前模式网络状态下载状态
  • downloads/networkstatus/ns/bootstrap: 启动时网络状态下载状态
  • downloads/networkstatus/ns/running: 运行时网络状态下载状态

隐藏服务和退出策略相关

  • exit-policy/default: 默认情况下的退出策略
  • exit-policy/full: 中继节点所有的退出策略
  • exit-policy/ipv4: IPv4 退出策略
  • exit-policy/ipv6: IPv6 退出策略
  • exit-policy/reject-private/default: ExitPolicyRejectPrivate 附加的退出策略
  • exit-policy/reject-private/relay: ExitPolicyRejectPrivate、ExitPolicyRejectLocalInterfaces 附加的退出策略
  • hs/client/desc/id*: 隐藏服务客户端缓存
  • hs/service/desc/id/*: 隐藏服务服务端缓存
  • net/listeners/*: 根据类型检索监听的地址

控制协议相关

  • events/names: 服务端支持的所有事件名称
  • features/names: USEFEATURE 支持的额外参数
  • info/names: GETINFO 所有支持的参数
  • signal/names: 服务端所有支持的信号

微描述符相关

  • md/all: 所有已知的微描述符
  • md/download-enabled: 是否开启（下载）微描述符
  • md/id/*: 根据 ID 查询微描述符
  • md/name/*: 根据名称查询为描述符
  • onions/current: 当前连接所控制的洋葱服务
  • onions/detached: 当前连接挂起的洋葱服务

其他

  • bw-event-cache: 短时间内的所有 BW 事件
  • consensus/*: 特定的共识信息
  • limits/max-mem-in-queues: 队列内存限制
  • extra-info/digest/*: 根据摘要值的额外信息
  • orconn-status: 当前连接的路由节点信息
  • network-liveness: 当前关于是否是实时网络的配置
  • network-status: 路由节点状态描述（v1 目录格式）
  • sr/current: 当前共享的随机值
  • sr/previous: 上一个共享的随机值
  • status/bootstrap-phase: Tor 发送的最后一个启动字段
  • status/circuit-established: 是否可认为客户端功能有效
  • status/clients-seen: 网桥所见的客户端国家（返回的是类似TimeStarted="1970-01-01 00:00:00" CountrySummary= IPVersions=v4=0,v6=0的信息，不知道什么含义）