# 使用 Homebrew, Nix 安装 ggshield

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

## 安装

```sh
sudo av install brew:ggshield
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install ggshield
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#ggshield
```

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

## 软件包事实

- **软件包键:** brew:ggshield
- **软件包管理器:** Homebrew
- **版本:** 1.53.0
- **来源摘要:** Scanner for secrets and sensitive data in code
- **主页:** <https://www.gitguardian.com>
- **仓库:** <https://github.com/GitGuardian/ggshield>
- **最后更新:** 2026-07-30T01:29:14Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- ggshield (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

ggshield is GitGuardian's open-source command-line scanner for detecting hardcoded secrets and sensitive data before they reach source-control history or CI artifacts.

### 项目历史

GitGuardian opened the ggshield repository in April 2020 and published the early 1.0.x release line soon afterward. The project is built as the local and CI-facing companion to GitGuardian's secret-detection service, using the GitGuardian public API through the py-gitguardian client.

### 采用历史

The tool gained adoption through several security workflows rather than one single editor or platform: local scans, pre-commit and pre-push hooks, CI/CD jobs, GitHub Actions, GitLab, Jenkins, Docker-image scans, package scans, and packaged distribution through PyPI, Homebrew, Chocolatey, Cloudsmith packages, and standalone installers.

### 使用方式

Practitioners authenticate with `ggshield auth login` or an API key, then scan paths, repositories, staged changes, Docker images, package artifacts, or CI workspaces. Teams commonly install it as a pre-commit, pre-push, or pre-receive hook so leaked credentials are blocked before they enter shared repositories.

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

For package ecosystems, ggshield is notable because it packages a SaaS-backed security control as a normal developer CLI: it can be installed by a package manager, run in a hook, and produce exit codes that fit standard CI pipelines.

### 时间线

- 2020: The GitGuardian ggshield repository was created.
- 2020: The 1.0.x release line appeared in the GitHub release feed.
- 2026: The release feed showed the 1.52 series.

### Related projects

- ggshield is closely tied to GitGuardian's public API and py-gitguardian client, and it overlaps operationally with pre-commit, CI/CD systems, and repository-hosting security workflows.

### 来源

- <https://api.github.com/repos/GitGuardian/ggshield>
- <https://api.github.com/repos/GitGuardian/ggshield/releases>
- <https://docs.gitguardian.com/ggshield-docs/getting-started>
- <https://docs.gitguardian.com/ggshield-docs/integrations/overview>
- <https://formulae.brew.sh/formula/ggshield>
- <https://github.com/GitGuardian/ggshield>
- <https://pypi.org/project/ggshield/>
- <https://raw.githubusercontent.com/GitGuardian/ggshield/main/README.md>


## 安全说明

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



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.gitguardian.yaml, ./.gitguardian.yaml
- Windows: %USERPROFILE%\.gitguardian.yaml, .\.gitguardian.yaml
## 其他软件包管理器记录

- Nix - ggshield: normalized package name match | nixpkgs package indexes: pkgs/by-name/gg/ggshield/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

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


## 来源

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