# 使用 Homebrew, apk, dnf, MacPorts, Nix, scoop, zypper 安装 oci-cli

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

## 安装

```sh
sudo av install brew:oci-cli
```

## 代理安全回答

oci-cli controls Oracle Cloud resources and account state.

- **凭据访问:** Reads OCI config, API keys, tenancy data, and environment credentials.
- **远程变更:** Can create, delete, or modify Oracle Cloud resources.
- **发布/制品风险:** Can upload artifacts and deploy infrastructure changes.
- **推荐控制:** Gate mutating oci commands and credential file access.
- **代理使用指南:** Allow read-only listing; require approval for writes, deletes, and credential changes.

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install oci-cli
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install oci-cli
```

  证据: MacPorts ports tree: net/oci-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add oci-cli
```

  证据: Alpine Linux edge package indexes: oci-cli from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- dnf (92%):

```sh
sudo dnf install oci-cli
```

  证据: Fedora Rawhide package metadata: oci-cli from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#oci-cli
```

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

- zypper (92%):

```sh
sudo zypper install oci-cli
```

  证据: openSUSE Tumbleweed package metadata: oci-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/oci-cli
```

  证据: Scoop official bucket manifest trees: bucket/oci-cli.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:oci-cli
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/oci-cli>
- **版本:** 3.89.0
- **来源摘要:** Oracle Cloud Infrastructure CLI
- **主页:** <https://docs.cloud.oracle.com/iaas/Content/API/Concepts/cliconcepts.htm>
- **仓库:** <https://github.com/oracle/oci-cli>
- **上游文档:** <https://docs.oracle.com/en-us/iaas/Content/API/Concepts/cliconcepts.htm>
- **许可证:** UPL-1.0 OR Apache-2.0
- **源码归档:** <https://files.pythonhosted.org/packages/ba/36/935d19fd65be951730a74ad85a5d3ada84950606433b4e5a91da6e653a98/oci_cli-3.89.0.tar.gz>
- **最后更新:** 2026-07-01T13:20:46Z
- **已生成:** 2026-07-08T07:18:31+00:00

## 可执行文件

- create_backup_from_onprem (cli)
- oci (cli)
- create_backup_from_onprem (别名)
- oci (别名)

## 依赖

- certifi
- cryptography
- libyaml
- python@3.14

## 安装行为

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

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 3.89.0
- 管理器更新时间: 2026-07-01
- 本地数据: OK
- 上游仓库: https://docs.cloud.oracle.com/iaas/Content/API/Concepts/cliconcepts.htm
- 信息: Release/tag comparison is only available for GitHub repositories.
## 项目历史与用法

OCI CLI is Oracle's open source command-line interface for Oracle Cloud Infrastructure. It gives operators and developers a scriptable interface to OCI objects and services, covering the same core administrative surface as the web Console while adding command-line workflows such as automation and batch execution.

### 项目历史

The upstream project is maintained by Oracle and distributed from the oracle/oci-cli repository. The README identifies it as the command-line interface for Oracle Cloud Infrastructure, with Oracle as maintainer and community contributions accepted through the public repository.

The README copyright line covers 2016 and 2019, matching OCI CLI's role as part of Oracle's post-Oracle Cloud Infrastructure tooling generation. Later project evolution is visible in the repository's changelog and release stream, while Oracle documentation remains the canonical user-facing reference for installation, configuration, troubleshooting, and command documentation.

The project expanded beyond a basic noninteractive command runner with interactive mode, shell guidance, suggestions, color-coded required and optional parameters, quick references, offline installation assets, and a container image published through GitHub Container Registry.

### 采用历史

OCI CLI became a standard cross-platform entry point for OCI automation because Oracle documents installation paths for macOS, Linux, Oracle Linux, Fedora, and Windows, and because Homebrew packages it as `oci-cli` with the `oci` executable.

Homebrew's formula API generated on 2026-07-01 reports 40,195 installs over 365 days and 11,792 installs over 90 days, showing sustained package-manager use outside Oracle's own installers. The same API lists binary bottles for macOS and Linux variants, making the package available to both workstation and automation environments.

### 使用方式

Users configure OCI credentials and profiles, then run `oci` commands to inspect and manage cloud resources. Oracle's documentation frames the tool as usable on its own or alongside the Console, and the README points users to example commands, help output, interactive mode, and troubleshooting documentation.

The package matters operationally because cloud teams can place OCI actions in shell scripts, CI jobs, recovery procedures, and offline administrative environments. The container image path adds a reproducible way to run the CLI where installing Python dependencies directly is inconvenient.

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

For package cataloging, OCI CLI is a large vendor cloud CLI with its own release cadence, Python packaging lineage, OS-specific installers, Homebrew bottles, and a container distribution channel. It is also a useful example of a cloud provider CLI that straddles package managers, language packaging, and official documentation.

### 时间线

- 2016: The repository license/copyright record begins in the same period as Oracle's public OCI tooling.
- 2019: The README license line still names Oracle and the dual UPL-1.0 / Apache-2.0 licensing.
- 2026-07-01: Homebrew formula metadata lists stable version 3.89.0 and 40,195 installs over the previous 365-day analytics window.

### Related projects

- OCI CLI sits beside Oracle's OCI SDK documentation and configuration model, and its container image is published from Oracle's GitHub container packages. It also overlaps with helper projects and integrations that wrap or invoke the `oci` executable in CI and shell workflows.

### 来源

- <https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliinstall.htm>
- <https://docs.oracle.com/iaas/Content/API/Concepts/cliconcepts.htm>
- <https://formulae.brew.sh/api/formula/oci-cli.json>
- <https://github.com/oracle/oci-cli/releases>
- <https://raw.githubusercontent.com/oracle/oci-cli/master/README.rst>


## 安全说明

infrastructure mutation or orchestration signal.

- **Geiger 风险:** orange / 中
- infrastructure mutation or orchestration signal


## 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: ~/.oci/config
- Windows: $Env:UserProfile\.oci\config

## Credential files

- Unix: ~/.oci/oci_api_key.pem
- Windows: %HOMEDRIVE%%HOMEPATH%\.oci\oci_api_key.pem
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** oci-cli
- **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 - oci-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/oc/oci-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - oci-cli - 3.77.0-r0: normalized package name match | Alpine Linux edge package indexes: oci-cli from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Oracle Cloud Infrastructure CLI | https://docs.oracle.com/en-us/iaas/Content/API/Concepts/cliconcepts.htm
- apk - oci-cli-pyc - 3.77.0-r0: normalized package name match | Alpine Linux edge package indexes: oci-cli-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for oci-cli | https://docs.oracle.com/en-us/iaas/Content/API/Concepts/cliconcepts.htm
- dnf - oci-cli - 3.85.0-2.fc45: normalized package name match | Fedora Rawhide package metadata: oci-cli from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Command Line Interface for Oracle Cloud Infrastructure | https://github.com/oracle/oci-cli
- zypper - oci-cli - 3.83.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: oci-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Oracle Cloud Infrastructure CLI | https://docs.us-phoenix-1.oraclecloud.com/Content/API/SDKDocs/cli.htm
- MacPorts - oci-cli: normalized package name match | MacPorts ports tree: net/oci-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/oci-cli: normalized package name match | Scoop official bucket manifest trees: bucket/oci-cli.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## 相关链接

- [Cloud CLI packages](https://www.automicvault.com/zh-hans/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Secret-risk packages](https://www.automicvault.com/zh-hans/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/zh-hans/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://www.automicvault.com/zh-hans/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [hcloud](https://www.automicvault.com/zh-hans/pkg/brew/hcloud/) - Shares av.db curated category or tags: cli, cloud-cli, cloud-infrastructure, infrastructure.
- [osc-cli](https://www.automicvault.com/zh-hans/pkg/brew/osc-cli/) - Shares av.db curated category or tags: cli, cloud-cli, cloud-infrastructure.
- [ucloud](https://www.automicvault.com/zh-hans/pkg/brew/ucloud/) - Shares av.db curated category or tags: cli, cloud-cli, cloud-infrastructure.
- [apko](https://www.automicvault.com/zh-hans/pkg/brew/apko/) - Shares av.db curated category or tags: cli, cloud-infrastructure, oci.
- [bosh-cli](https://www.automicvault.com/zh-hans/pkg/brew/bosh-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, infrastructure.
- [clusterawsadm](https://www.automicvault.com/zh-hans/pkg/brew/clusterawsadm/) - Shares av.db curated category or tags: cli, cloud-infrastructure, infrastructure.
- [clusterctl](https://www.automicvault.com/zh-hans/pkg/brew/clusterctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, infrastructure.
- [container](https://www.automicvault.com/zh-hans/pkg/brew/container/) - Shares av.db curated category or tags: cli, cloud-infrastructure, oci.
- [rockcraft](https://www.automicvault.com/zh-hans/pkg/brew/rockcraft/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, cloud, cloud-infrastructure, create.
- [ansible](https://www.automicvault.com/zh-hans/pkg/brew/ansible/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, cloud, cloud-infrastructure, cryptography.

## Combined YAML source

View the package source record on GitHub. [combined/oci-cli.yml](https://github.com/automic-vault/db/blob/main/combined/oci-cli.yml)


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
- curated agent safety answer
