# 使用 Homebrew, apt, Nix 安装 onionprobe

查看 onionprobe 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:onionprobe
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install onionprobe
```

  证据: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install onionprobe
```

  证据: Debian stable package indexes: onionprobe from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#onionprobe
```

  证据: nixpkgs package indexes: pkgs/by-name/on/onionprobe/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:onionprobe
- **软件包管理器:** Homebrew
- **版本:** 1.4.1
- **来源摘要:** Test and monitoring tool for Tor Onion Services
- **主页:** <https://tpo.pages.torproject.net/onion-services/onionprobe/>
- **最后更新:** 2026-05-14T09:54:07Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- onionprobe (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 1.4.1
## 项目历史与用法

Onionprobe is a Tor Project tool for testing and monitoring Tor Onion Services. It probes configured onion-service endpoints once or continuously and can export metrics to Prometheus, with Grafana and Alertmanager support in its monitoring-node setup.

### 项目历史

Onionprobe grew out of the operational need to monitor onion services as services, not just publish them. Its manual frames the tool as a way to test endpoints and paths, while the project site presents it as part of the Onion Services Ecosystem maintained around Tor onion-service operations.

The changelog shows active release engineering around the monitoring stack. Version 1.1.0 and 1.1.1 landed in April 2023, and Tor Project Forum announced version 1.2.0 on April 24, 2024 with a required database migration for monitoring-node users.

### 采用历史

Onionprobe is distributed through PyPI and documented in Debian and Ubuntu manpages, with Homebrew packaging it for macOS and Linux users. The Tor Project also maintains an Ansible role that can install Onionprobe from Git, PyPI, or distribution packages and configure either a single service or a standalone monitoring node.

### 使用方式

Operators use onionprobe to check whether onion-service URLs are reachable, whether specific paths respond, and whether the results should feed a metrics pipeline. In standalone mode, the project provides a containerized monitoring node with Prometheus, Alertmanager, Grafana, a persistent dataset, and an Onionprobe exporter.

The tool is especially practical for onion-service fleets because reachability can fail at several layers: Tor client connectivity, onion-service descriptor publication, path construction, web-service health, or application routing. Onionprobe packages those checks into a repeatable CLI and monitoring target.

### 为什么软件包爱好者会关心

For package nerds, Onionprobe is a clean example of a niche network daemon graduating into familiar observability shapes: PyPI package, distro package, Homebrew formula, man page, Prometheus exporter, Grafana dashboard, and Ansible role.

### 时间线

- 2023-04-03: Onionprobe v1.1.0 was released.
- 2023-04-04: Onionprobe v1.1.1 followed with Grafana, Docker, image-versioning, and database-upgrade fixes.
- 2024-04-24: Onionprobe v1.2.0 was announced by the Tor Project with monitoring-node database migration notes.
- 2026: Debian, Ubuntu, PyPI, and Homebrew provide install surfaces for the Onionprobe CLI.

### Related projects

- Related projects and technologies include Tor onion services, Prometheus, Grafana, Alertmanager, the Onionprobe Ansible role, and Tor Project onion-service operational tooling.

### 来源

- <https://forum.torproject.org/t/onionprobe-release-1-2-0/12442>
- <https://github.com/torproject/onionprobe-role/blob/main/README.md>
- <https://onionservices.torproject.org/apps/web/onionprobe/>
- <https://onionservices.torproject.org/apps/web/onionprobe/changelog/>
- <https://onionservices.torproject.org/apps/web/onionprobe/man/>
- <https://onionservices.torproject.org/apps/web/onionprobe/standalone/>
- <https://pypi.org/project/onionprobe/>


## 安全说明

没有找到 onionprobe 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。


## 其他软件包管理器记录

- Debian apt - onionprobe - 1.4.0+ds-1: normalized package name match | Debian stable package indexes: onionprobe from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | test/monitor tool for Tor Onion Services sites | https://gitlab.torproject.org/tpo/onion-services/onionprobe
- Nix - onionprobe: normalized package name match | nixpkgs package indexes: pkgs/by-name/on/onionprobe/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - onionprobe - 1.1.2+ds-1: normalized package name match | Ubuntu 24.04 LTS package indexes: onionprobe from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | test/monitor tool for Tor Onion Services sites | https://gitlab.torproject.org/tpo/onion-services/onionprobe


## Combined YAML source

View the package source record on GitHub. [combined/onionprobe.yml](https://github.com/mxcl/pkgdb/blob/main/combined/onionprobe.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph