# 使用 Homebrew 安装 ucloud

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

## 安装

```sh
sudo av install brew:ucloud
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install ucloud
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:ucloud
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/ucloud>
- **版本:** 0.3.5
- **来源摘要:** Official tool for managing UCloud services
- **主页:** <https://www.ucloud.cn>
- **仓库:** <https://github.com/ucloud/ucloud-cli>
- **上游文档:** <https://docs.ucloud.cn/cli/intro>
- **许可证:** Apache-2.0
- **源码归档:** <https://github.com/ucloud/ucloud-cli/archive/refs/tags/v0.3.5.tar.gz>
- **最后更新:** 2026-07-07T13:08:35Z
- **已生成:** 2026-07-08T18:08:21+00:00

## 可执行文件

- ucloud (cli)
- ucloud (别名)

## 构建依赖

- go

## 安装行为

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

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 0.3.5
- 管理器更新时间: 2026-07-07
- 本地数据: OK
- 上游仓库: https://github.com/ucloud/ucloud-cli
- 检测到的最新版本: v0.3.5 (当前)
## 项目历史与用法

UCloud CLI is the official command-line interface for UCloud services. The project positions the tool as a unified CLI built on UCloud's Go SDK and OpenAPI, with supported builds for Linux, macOS, and Windows.

### 项目历史

The public GitHub repository was created in 2018 and early release tags began at 0.1.1 in August 2018. Its changelog shows steady incremental releases focused on UCloud product coverage, UHost operations, generic API calls, cloud-shell adaptation, and later authentication improvements.

### 采用历史

Within package-manager culture, UCloud CLI is primarily an operational tool for users of one cloud provider rather than a general cloud abstraction. Its README explicitly documents Homebrew installation for macOS and Linux, source builds, binary releases, Docker usage, and shell completion.

### 使用方式

The CLI is used to initialize UCloud profiles, store project, region, zone, API endpoint, retry, and key settings under the user's home directory, and then manage UCloud services from scripts or terminals. Recent changelog entries add OAuth browser login for interactive users while preserving AK/SK profile support for scripts and CI.

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

For package nerds, the interesting point is that this is an official cloud CLI with a conventional Homebrew formula, cross-platform binary releases, completion support, and local profile files. It behaves like the small-provider counterpart to larger cloud CLIs, useful when reproducible terminal setup matters more than web-console workflows.

### 时间线

- 2018: GitHub repository created and 0.1.1 release published.
- 2020: UHost creation gained user-data and GPU-related flags.
- 2022: Generic signature and multi-region listing improvements appear in the changelog.
- 2024: UHost creation gained SSH key pair and security group support.
- 2026: OAuth browser login and safer config/credential writes were added in 0.3.1.

### Related projects

- The README says UCloud CLI works on ucloud-sdk-go and UCloud OpenAPI.
- The package sits in the same CLI niche as provider-specific tools such as awscli, gcloud, and aliyun-cli, but the cited sources only document its UCloud scope.

### 来源

- <https://api.github.com/repos/ucloud/ucloud-cli>
- <https://github.com/ucloud/ucloud-cli#readme>
- <https://raw.githubusercontent.com/ucloud/ucloud-cli/master/CHANGELOG.md>
- source_facts.repo


## 安全说明

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: ~/.ucloud/config.json

## Credential files

- Unix: ~/.ucloud/credential.json
## 源数据库详情

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


## 相关链接

- [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.
- [go](https://www.automicvault.com/zh-hans/pkg/brew/go/) - Build dependency declared by Homebrew.
- [hcloud](https://www.automicvault.com/zh-hans/pkg/brew/hcloud/) - Shares av.db curated category or tags: api-client, cli, cloud, cloud-cli, cloud-infrastructure.
- [osc-cli](https://www.automicvault.com/zh-hans/pkg/brew/osc-cli/) - Shares av.db curated category or tags: api-client, cli, cloud, cloud-cli, cloud-infrastructure.
- [doctl](https://www.automicvault.com/zh-hans/pkg/brew/doctl/) - Shares av.db curated category or tags: api-client, cli, cloud, cloud-infrastructure, cloud-management.
- [oci-cli](https://www.automicvault.com/zh-hans/pkg/brew/oci-cli/) - Shares av.db curated category or tags: cli, cloud-cli, cloud-infrastructure.
- [aiven-client](https://www.automicvault.com/zh-hans/pkg/brew/aiven-client/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure.
- [aliyun-cli](https://www.automicvault.com/zh-hans/pkg/brew/aliyun-cli/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure.
- [apache-brooklyn-cli](https://www.automicvault.com/zh-hans/pkg/brew/apache-brooklyn-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cloud-management.
- [azion](https://www.automicvault.com/zh-hans/pkg/brew/azion/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure.

## Combined YAML source

View the package source record on GitHub. [combined/ucloud.yml](https://github.com/automic-vault/db/blob/main/combined/ucloud.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
- cross-ecosystem install command graph
