# cloud-sql-proxy を Homebrew, scoop でインストール

cloud-sql-proxy のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

```sh
sudo av install brew:cloud-sql-proxy
```

追加のインストールコマンド:

### macOS

- Homebrew (100%):

```sh
brew install cloud-sql-proxy
```

  証拠: local Homebrew formula metadata

### Windows

- Scoop (92%):

```sh
scoop install main/cloud-sql-proxy
```

  証拠: Scoop official bucket manifest trees: bucket/cloud-sql-proxy.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## パッケージ情報

- **パッケージキー:** brew:cloud-sql-proxy
- **パッケージマネージャ:** Homebrew
- **パッケージマネージャページ:** <https://formulae.brew.sh/formula/cloud-sql-proxy>
- **バージョン:** 2.23.0
- **ソース概要:** Utility for connecting securely to your Cloud SQL instances
- **ホームページ:** <https://github.com/GoogleCloudPlatform/cloud-sql-proxy>
- **リポジトリ:** <https://github.com/GoogleCloudPlatform/cloud-sql-proxy>
- **上流ドキュメント:** <https://docs.cloud.google.com/sql/docs/postgres/sql-proxy>
- **ライセンス:** Apache-2.0
- **ソースアーカイブ:** <https://github.com/GoogleCloudPlatform/cloud-sql-proxy/archive/refs/tags/v2.23.0.tar.gz>
- **最終更新:** 2026-06-26T15:03:55Z
- **生成日時:** 2026-07-08T07:18:31+00:00

## 実行可能ファイル

- cloud-sql-proxy (cli)
- cloud-sql-proxy (エイリアス)

## ビルド依存関係

- go

## インストール挙動

- post-install フック: 未定義
- Bottle: 利用可能 対象 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## バージョンと鮮度

- ページ生成日: 2026-07-08
- マネージャ版: 2.23.0
- マネージャ更新日: 2026-06-26
- ローカルデータ: OK
- 上流リポジトリ: https://github.com/GoogleCloudPlatform/cloud-sql-proxy
- 検出された最新: v2.23.0 (最新)
## プロジェクトの歴史と使われ方

Cloud SQL Auth Proxy is Google's CLI for making secure local or sidecar connections to Cloud SQL instances. It is historically important because it packages Google Cloud database connectivity, IAM authorization, and TLS handling into a standalone executable used across local development, VMs, containers, and Kubernetes-style deployments.

### プロジェクトの歴史

The GoogleCloudPlatform/cloud-sql-proxy repository was created in 2015 and remains the official upstream for the Cloud SQL Auth Proxy. The README describes it as a utility for secure Cloud SQL connections with IAM authorization and TLS 1.3 encryption, avoiding manual certificate management.

The v2 migration guide documents a major CLI evolution from the old `cloud_sql_proxy` executable to `cloud-sql-proxy`, with more explicit flags, environment-variable support, a new container image name, and changed connection behavior.

### 採用の歴史

Official docs distribute platform-specific binaries through Google storage, document `go install`, and point to GitHub releases. The input package-manager facts show Homebrew and Scoop packaging, reflecting common workstation installation patterns.

The README positions language-specific Cloud SQL connectors for Go, Java, Python, and Node.js as alternatives when users prefer in-process connectivity, so the proxy sits beside a broader connector ecosystem rather than replacing it.

### 使われ方

Users run the proxy with one or more Cloud SQL instance connection names, optionally choosing TCP ports, Unix sockets, private IP behavior, IAM database authentication, metrics, health checks, service-account impersonation, or a credentials-file flag.

The proxy obtains credentials through Google Application Default Credentials by default, and can also take an OAuth token or service-account key file path supplied by the user.

### パッケージ好きにとっての重要性

For package nerds, Cloud SQL Auth Proxy is a classic cloud vendor CLI where binary naming, major-version migration, install channel, and authentication defaults all matter. The v1-to-v2 executable rename is exactly the sort of detail package formulas and scripts must track.

It is also significant because the same package has to serve developer laptops, CI jobs, VM agents, and container images while remaining aligned with Google Cloud IAM and Cloud SQL behavior.

### タイムライン

- 2015: GoogleCloudPlatform/cloud-sql-proxy GitHub repository metadata was created.
- v2: Migration guide documents the rename from cloud_sql_proxy to cloud-sql-proxy and the new container image name.
- v2.17.1: README records signed Windows binaries starting with this version.

### Related projects

- Cloud SQL Go, Java, Python, and Node.js connectors are official related projects named by the README.
- Google Cloud SDK and Application Default Credentials provide the usual authentication environment.
- The older v1 Cloud SQL proxy behavior is documented through the upstream migration guide.

### ソース

- <https://github.com/GoogleCloudPlatform/cloud-sql-proxy#readme>
- <https://github.com/GoogleCloudPlatform/cloud-sql-proxy/blob/main/migration-guide.md>
- <https://docs.cloud.google.com/sql/docs/postgres/sql-proxy>


## セキュリティノート

broad file, network, media, or database tool signal. infrastructure mutation or orchestration signal.

- **Geiger リスク:** orange / 中
- broad file, network, media, or database tool signal
- infrastructure mutation or orchestration signal

## ソースデータベース詳細

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** cloud-sql-proxy
- **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

## 他のパッケージマネージャ記録

- Scoop - main/cloud-sql-proxy: normalized package name match | Scoop official bucket manifest trees: bucket/cloud-sql-proxy.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## 関連リンク

- [Cloud CLI packages](https://www.automicvault.com/ja/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Source-control packages](https://www.automicvault.com/ja/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/ja/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/ja/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [go](https://www.automicvault.com/ja/pkg/brew/go/) - Build dependency declared by Homebrew.
- [pscale](https://www.automicvault.com/ja/pkg/brew/pscale/) - Shares av.db curated category or tags: cli, cloud-infrastructure, database.
- [gcsfuse](https://www.automicvault.com/ja/pkg/brew/gcsfuse/) - Shares av.db curated category or tags: cli, cloud-infrastructure, google-cloud.
- [terracognita](https://www.automicvault.com/ja/pkg/brew/terracognita/) - Shares av.db curated category or tags: cli, cloud-infrastructure, google-cloud.
- [actions-batch](https://www.automicvault.com/ja/pkg/brew/actions-batch/) - Shares av.db curated category or tags: cli, cloud-infrastructure.
- [aiac](https://www.automicvault.com/ja/pkg/brew/aiac/) - Shares av.db curated category or tags: cli, cloud-infrastructure.
- [aiven-client](https://www.automicvault.com/ja/pkg/brew/aiven-client/) - Shares av.db curated category or tags: cli, cloud-infrastructure, database.
- [akamai](https://www.automicvault.com/ja/pkg/brew/akamai/) - Shares av.db curated category or tags: cli, cloud-infrastructure.
- [aliyun-cli](https://www.automicvault.com/ja/pkg/brew/aliyun-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure.
- [aws-es-proxy](https://www.automicvault.com/ja/pkg/brew/aws-es-proxy/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, infrastructure, proxy.

## Combined YAML source

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


## ソース

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- 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
