# 1Password CLI

通过终端访问 1Password 保险库和机密，将凭据注入命令，并使用具有范围限制的服务账户实现自动化。

> 这是 OpenNavo 上 1Password CLI 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/1password-cli>

- **最新版本**: `2.42.0`
- **开发者**: 1Password (AgileBits Inc.)
- **主页**: <https://developer.1password.com/docs/cli>
- **分类**: [安全与隐私](https://opennavo.com/zh/categories/security)
- **安装**: `brew install --cask 1password-cli`
- **近 30 天安装**: 27,273
- **Homebrew**: 可以安装，由 Homebrew 更新
- **下载地址**: <https://cache.agilebits.com/dist/1P/op2/pkg/v2.42.0/op_darwin_arm64_v2.42.0.zip>
- **SHA-256**: `216e86c6db491c752ccb7819b3b1851cc8456ea015a1f7c8a58dd103ef0a474e`
- **附带命令**: op

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "binary": [
        "op"
      ],
      "target": "$HOMEBREW_PREFIX/bin/op"
    },
    "phase": "install",
    "sources": [
      "op"
    ],
    "target": "$HOMEBREW_PREFIX/bin/op",
    "type": "binary"
  },
  {
    "declaration": {
      "generate_completions_from_executable": [
        "op",
        "completion",
        {
          "base_name": null,
          "shell_parameter_format": null,
          "shells": [
            "bash",
            "zsh",
            "fish"
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [
      "op",
      "completion"
    ],
    "type": "generate_completions_from_executable"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "~/.config/op"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

1Password CLI 将 1Password 保管库和开发者机密带入终端。`op` 命令面向开发者、管理员和自动化使用场景，这些场景需要对凭据进行受控访问，而无需在脚本中硬编码凭据。

### 主要功能
- 使用命令行命令查找和管理保管库与条目。
- 通过 `op://` 引用读取机密；使用 `op run` 将它们加载到子进程中，或使用 `op inject` 将它们替换到配置模板中。
- 通过 1Password 桌面应用进行身份验证（包括受支持的生物识别身份验证），或使用作用域限定为所选保管库或 Environments 的服务账户令牌，用于无头自动化。
- 为 Bash、Zsh 和 Fish 生成 shell 补全。单独的 1Password Shell Plugins 可将身份验证与受支持的第三方开发者工具集成。

### 安装与首次使用
在 macOS 上，使用 `brew install --cask 1password-cli` 安装此 Homebrew cask，然后检查 `op --version`。Homebrew 会将 `op` 链接到其二进制目录中，并生成 shell 补全。对于桌面应用身份验证，请安装并登录 1Password 桌面应用，启用 Settings → Developer → Integrate with 1Password CLI，然后尝试 `op vault list`。有多个账户时，`op signin` 会选择账户。对于共享构建和无头服务器，建议改用服务账户；仅配置自动化所需的访问权限。

### 系统、依赖项与冲突
官方 macOS 入门指南指定 macOS Big Sur 11 或更高版本，以及 Bash、Zsh、sh 或 Fish。官方下载支持 Apple Silicon 和 Intel Macs。Windows 和 Linux 构建版本单独提供：Windows 文档使用 PowerShell；Linux 桌面集成需要 1Password for Linux、PolKit 以及正在运行的 PolKit 身份验证代理。桌面应用集成需要安装相应的 1Password 应用，并拥有符合条件的已登录账户；它不同于服务账户身份验证。此目录条目安装的是 macOS CLI，而不是桌面应用。Homebrew 声明此 cask 没有额外的 formula 依赖项，并声明与 `1password-cli@1` 和 `1password-cli@beta` 冲突；这些替代 cask 也提供 `op`，不应与此 cask 一起安装。

### 账户、费用与许可
使用个人保管库需要 1Password 账户和订阅；服务账户访问取决于账户可用的功能和权限。订阅计划、试用和商业条款由 1Password 定义。CLI 是专有软件，依据 1Password 的适用条款分发；单独的开源 Shell Plugins 项目并不确立完整 CLI 的许可证。尚未找到完整 CLI 的公开源代码仓库。

`op run` 的输出掩码是尽力而为的，并不保证机密会被隐藏。避免记录机密或提交生成的包含机密的文件。

官方参考：[CLI 概览](https://www.1password.dev/cli)、[入门](https://www.1password.dev/cli/get-started)、[发行说明](https://releases.1password.com/developers/cli/)和[服务条款](https://1password.com/legal/terms-of-service)。

## 系统要求

- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 2.42.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · 核查于 2026-11-22
  - <https://cache.agilebits.com/dist/1P/op2/pkg/v2.42.0/op_darwin_amd64_v2.42.0.zip>
  - SHA-256: `917b0d2b41de3d943bb6562331275c43c4b525af6b003eade06248905ddd62b0`
- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 2.42.0 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · 核查于 2026-11-22
  - <https://cache.agilebits.com/dist/1P/op2/pkg/v2.42.0/op_darwin_arm64_v2.42.0.zip>
  - SHA-256: `216e86c6db491c752ccb7819b3b1851cc8456ea015a1f7c8a58dd103ef0a474e`

## 卸载

- `brew uninstall --cask 1password-cli`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask 1password-cli`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/.config/op` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 2.42.0 (2026-11-03)

1Password CLI 2.42.0 于 2026-11-03 发布，`op environment secret list` 命令正式可用，并新增一组 shell 插件。

- `op environment secret list` 现已正式可用；它列出 1Password Environment 中每个密钥的名称和值，并说明每个密钥是否被隐藏。
- 新增的 shell 插件为 Stackhero CLI、npm 和 pnpm、Octopus Deploy CLI、Doppler CLI、CockroachDB CLI（`cockroach sql`）、LocalXpose CLI（`loclx`）、配合 MotherDuck 使用的 DuckDB CLI、Postman CLI、Spacelift CLI（`spacectl`）、Netlify CLI、xAI Grok CLI 以及 OpenBao CLI（`bao`）提供 Touch ID 和其他解锁方式。
- Argo CD 插件现在仅在 `argocd` 指向条目 Address 中保存的服务器时才提供凭据，因此 `--argocd-context` 和 `--server` 的表现与未安装该插件时一致。
- Akamai 和 Pipedream 插件拒绝将包含换行符的凭据值写入其生成的配置文件。
- Sourcegraph 插件支持当前的 `sgp_` 令牌格式，并且现在要求填写 Endpoint 字段。
- Hugging Face 插件改用 `hf` 命令，不再使用 `huggingface-cli`；请运行 `op plugin init hf` 并删除旧别名。
- LocalStack 插件改用 `LOCALSTACK_AUTH_TOKEN`，不再使用已弃用的 `LOCALSTACK_API_KEY`。
- 当地址的某些部分（例如街道或国家/地区）为空时，`op item get`、`op read`、`op run` 和 `op inject` 现在会返回该 address 字段的值。
- MySQL 插件会对写入 `my.cnf` 的值加引号并转义，因此包含 `#`、反斜杠或首尾空白的密码可以正确通过认证。
- OpenTofu 插件会为 `tofu workspace` 命令提供凭据，行为与 Terraform 插件一致。
- 当启用 MFA 的配置文件通过 `source_profile` 代入角色时，AWS 插件不再报错“Cannot call GetSessionToken with session credentials”。

[官方发布说明](https://app-updates.agilebits.com/product_history/CLI2)

## 资料与来源

- <https://opennavo.com/zh/apps/1password-cli>
- <https://opennavo.com/zh/apps/1password-cli/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/1password-cli>
