# 使用 Homebrew, zypper 安装 docker-credential-helper

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

## 安装

```sh
sudo av install brew:docker-credential-helper
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install docker-credential-helper
```

  证据: local Homebrew formula metadata

### Linux

- zypper (92%):

```sh
sudo zypper install docker-credential-secretservice
```

  证据: openSUSE Tumbleweed package metadata: docker-credential-secretservice from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## 软件包事实

- **软件包键:** brew:docker-credential-helper
- **软件包管理器:** Homebrew
- **版本:** 0.9.8
- **来源摘要:** Platform keystore credential helper for Docker
- **主页:** <https://github.com/docker/docker-credential-helpers>
- **仓库:** <https://github.com/docker/docker-credential-helpers>
- **最后更新:** 2026-06-08T21:10:10Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- docker-credential-pass (别名)
- docker-credential-secretservice (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

Docker Credential Helpers is Docker's suite of helper binaries and Go libraries for storing registry credentials in native platform stores rather than plain Docker config JSON.

### 项目历史

The repository was created to house the helper programs that Docker can invoke through its credential-store protocol. The README describes helpers for macOS Keychain, Linux Secret Service, Windows Credential Manager, and pass, plus libraries for client applications and for implementing new helpers.

The tag history begins with v0.1.0 in 2016 and continues through the 2020s. Its development has stayed intentionally narrow: it maintains small platform-specific executables, a common credentials protocol with store/get/erase/list commands, and build/release machinery for distributing helper binaries.

### 采用历史

The helper suite became part of normal Docker desktop and CLI workflows because Docker config supports a credsStore setting in ~/.docker/config.json. Users often encounter it indirectly when Docker Desktop or a package manager installs docker-credential-osxkeychain, docker-credential-wincred, docker-credential-secretservice, or docker-credential-pass.

### 使用方式

Users configure Docker with a credsStore value such as osxkeychain, secretservice, wincred, or pass. Docker then calls the corresponding docker-credential-* program to store, retrieve, erase, and list registry secrets. Other command-line applications can also call helpers through the Go client package documented by the project.

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

This is a classic small package with outsized operational effect: it is not the Docker daemon, but it determines whether registry authentication is stored in a system keychain or leaks into config files. It also explains why Docker packages often need platform-specific credential-helper binaries alongside the main CLI.

### 时间线

- 2016: v0.1.0 tagged for the Docker credential helper suite.
- 2017: v0.5.x releases continue early helper development.
- 2022: v0.7.0 appears after a long 0.6.x line.
- 2024: v0.8.x releases continue maintenance of the helper binaries.
- 2026: v0.9.8 is tagged in the upstream repository.

### Related projects

- Related projects include Docker CLI and Docker Engine, platform credential stores such as macOS Keychain, Secret Service, Windows Credential Manager, and pass, and service-specific helpers such as Amazon ECR Docker Credential Helper.

### 来源

- <https://github.com/docker/docker-credential-helpers#readme>
- <https://github.com/docker/docker-credential-helpers/releases>
- <https://github.com/docker/docker-credential-helpers/tags>
- <https://docs.docker.com/reference/cli/docker/login/>


## 安全说明

没有找到 docker-credential-helper 的匹配本地密钥处理 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: ~/.docker/config.json
## 其他软件包管理器记录

- zypper - docker-credential-secretservice - 0.9.8-1.1: installed executable or alias match | openSUSE Tumbleweed package metadata: docker-credential-secretservice from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Leverage Docker credentials with libsecret | http://www.docker.io


## Combined YAML source

View the package source record on GitHub. [combined/docker-credential-helper.yml](https://github.com/mxcl/pkgdb/blob/main/combined/docker-credential-helper.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
