# 使用 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
- **软件包管理器页面:** <https://formulae.brew.sh/formula/ggshield>
- **版本:** 1.53.0
- **来源摘要:** Scanner for secrets and sensitive data in code
- **主页:** <https://www.gitguardian.com>
- **仓库:** <https://github.com/GitGuardian/ggshield>
- **上游文档:** <https://www.gitguardian.com>
- **许可证:** MIT
- **源码归档:** <https://files.pythonhosted.org/packages/f4/85/dda71184a6e4f3195216b6d5d2671101a5f199da437adeb033b44bbdd5e3/ggshield-1.53.0.tar.gz>
- **最后更新:** 2026-07-30T01:29:14Z
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- ggshield (cli)
- ggshield (别名)

## 依赖

- certifi
- cryptography
- libyaml
- openssl@3
- pydantic
- python@3.14

## 构建依赖

- pkgconf
- rust

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 1.53.0
- 管理器更新时间: 2026-07-30
- 本地数据: OK
- 上游仓库: https://www.gitguardian.com
- 信息: Release/tag comparison is only available for GitHub repositories.
## 项目历史与用法

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。软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 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
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** ggshield
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

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

- 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


## 相关链接

- [Source-control packages](https://pkg.so/zh-hans/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Database and data packages](https://pkg.so/zh-hans/database-data-tools/) - Matched database, SQL, migration, or data-store metadata.
- [openssl@3](https://pkg.so/zh-hans/brew/openssl-3/) - Runtime dependency declared by Homebrew.
- [python@3.14](https://pkg.so/zh-hans/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://pkg.so/zh-hans/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://pkg.so/zh-hans/brew/rust/) - Build dependency declared by Homebrew.
- [gitleaks](https://pkg.so/zh-hans/brew/gitleaks/) - Shares pkgdb curated category or tags: cli, devsecops, security.
- [trufflehog](https://pkg.so/zh-hans/brew/trufflehog/) - Shares pkgdb curated category or tags: cli, secrets-scanning, security.
- [cycode](https://pkg.so/zh-hans/brew/cycode/) - Shares pkgdb curated category or tags: cli, devsecops, secrets-scanning, security.
- [git-secrets](https://pkg.so/zh-hans/brew/git-secrets/) - Shares pkgdb curated category or tags: cli, git-hooks, security.
- [detect-secrets](https://pkg.so/zh-hans/brew/detect-secrets/) - Shares pkgdb curated category or tags: cli, devsecops, security.
- [noseyparker](https://pkg.so/zh-hans/brew/noseyparker/) - Shares pkgdb curated category or tags: cli, secrets-scanning, security.
- [ripsecrets](https://pkg.so/zh-hans/brew/ripsecrets/) - Shares pkgdb curated category or tags: cli, git-hooks, security.
- [chain-bench](https://pkg.so/zh-hans/brew/chain-bench/) - Shares pkgdb curated category or tags: cli, devsecops, security.
- [bbot](https://pkg.so/zh-hans/brew/bbot/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, cryptography, libyaml, openssl.

## 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
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
