censys/cencli
GitHub: censys/cencli
Censys 官方命令行工具,将互联网资产情报查询、搜索聚合与威胁狩猎能力直接集成到终端环境。
Stars: 24 | Forks: 2
# Censys CLI
`cencli` 将互联网情报的强大功能带到了您的终端。分析资产、执行查询以及追踪威胁,一切皆可在命令行中完成。

Censys CLI 对 Censys 平台的免费和付费用户开放,并支持 macOS、Linux 和 Windows。
## 快速入门
确保您已[安装](#installation) `cencli` 并且其位于您的 `$PATH` 中。
1. 运行以下命令并按照提示添加您的 Censys 平台个人访问令牌:
$ censys config auth add
2. (可选)运行以下命令并按照提示添加您的 Censys 平台组织 ID:
$ censys config org-id add
3. 完成!您现在可以使用 `censys` 命令执行资产查询、搜索等操作。
$ censys view 8.8.8.8
## 安装
本节介绍如何在您的系统中安装 `cencli`。
### Homebrew
macOS 和 Linux 用户可以使用 [Homebrew](https://brew.sh/) 安装 `cencli`:
```
$ brew install censys/tap/cencli
```
在安装过程结束时,`zsh` 和 `bash` 的自动补全脚本将自动生成并链接到您的 shell 环境中。
对于 Windows 用户(以及不想使用 Homebrew 的用户),您需要使用下面介绍的其他方法。
### 下载二进制文件
适用于不同平台和架构的稳定版二进制文件可在[发布页面](https://github.com/censys/cencli/releases)下载。下载并解压二进制文件后,请确保将其添加到您的 `$PATH` 中。
### Go Install
如果您安装了 Go 1.25+,可以使用以下命令安装 `cencli`:
```
$ go install github.com/censys/cencli/cmd/cencli@latest
# 确保将可执行文件重命名为 'censys'
$ mv "$(go env GOPATH)/bin/cencli" "$(go env GOPATH)/bin/censys"
```
### 从源码构建
确保您已安装 Go 1.25+,并运行以下命令:
```
$ git clone https://github.com/censys/cencli.git
$ cd cencli
$ make censys # builds the executable to ./bin/censys
$ export PATH=$PATH:$(pwd)/bin
$ censys --help
```
## 使用说明
`cencli` 支持多种命令来访问我们的平台。运行 `censys --help` 查看所有可用命令。
### 配置
`config` 命令允许您管理个人访问令牌和组织 ID。有关更多详细信息,请参阅 [config 命令文档](./docs/commands/CONFIG.md)。
### 视图
`view` 命令允许您获取特定主机、证书或 Web 属性资产在特定时间点的信息。有关更多详细信息,请参阅 [view 命令文档](./docs/commands/VIEW.md)。

您还可以使用 `-O short`(或 `--output-format short`)通过模板渲染输出,这些模板可以自定义。有关更多详细信息,请参阅 [模板文档](./docs/commands/VIEW.md#templates)。
### 搜索
`search` 命令允许您在全球范围或在集合内执行 Censys 平台搜索。有关更多详细信息,请参阅 [search 命令文档](./docs/commands/SEARCH.md)。

### 聚合
`aggregate` 命令允许您在全球范围或在集合内执行聚合查询。有关更多详细信息,请参阅 [aggregate 命令文档](./docs/commands/AGGREGATE.md)。

### Censeye
`censeye` 命令允许您对主机执行 Censeye 扫描。有关更多详细信息,请参阅 [censeye 命令文档](./docs/commands/CENSEYE.md)。

### 历史记录
此功能尚在开发中(WIP)。有关更多详细信息,请参阅 [history 命令文档](./docs/commands/HISTORY.md)。
### 其他命令
- `$ censys org`:管理和查看组织详情。有关更多详细信息,请参阅 [org 命令文档](./docs/commands/ORG.md)。
- `$ censys credits`:显示您的 Censys 免费用户账户的额度详情。有关更多详细信息,请参阅 [credits 命令文档](./docs/commands/CREDITS.md)。
- `$ censys completion `:生成 shell 自动补全脚本
- `$ censys version`:打印版本信息
## 许可证
本项目基于 Apache License 2.0 授权。
标签:API客户端, CLI, ESC4, EVTX分析, GitHub, Go, Homebrew, IP查询, OSINT, Ruby工具, WiFi技术, 互联网情报, 域名信息, 实时处理, 密码管理, 情报收集, 无线安全, 日志审计, 漏洞研究, 网络安全, 资产分析, 资产测绘, 隐私保护