安装

其他安装命令

macOS

Homebrew已验证 · 100%

brew install cloud-sql-proxy

local Homebrew formula metadata

Windows

Scoop已验证 · 92%

scoop install main/cloud-sql-proxy

Scoop official bucket manifest trees · bucket/cloud-sql-proxy.json · 来源: api.github.com

概览

软件包摘要

Utility for connecting securely to your Cloud SQL instances

项目链接

命令和别名

cloud-sql-proxy

历史

项目历史与用法

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.

来源

安全态势

风险级别：orange

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

风险分类器

orange 风险 · 中置信度 · infrastructure

原因

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

信号

text:cloud
text:sql

安装行为

formula 元数据中未记录 Homebrew post-install 钩子。
Homebrew bottle 元数据适用于 6 个平台目标。
构建元数据列出 1 个构建依赖。

建议审查

在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。

可执行文件

已安装的可执行文件

命令	类型	暴露范围	备注
`cloud-sql-proxy`	cli	全局可执行文件

新鲜度

版本和新鲜度

这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。

页面生成时间2026-07-08

管理器版本2.23.0

管理器更新时间2026-06-26

本地数据OK

上游当前

检测到的最新版本v2.23.0

https://github.com/GoogleCloudPlatform/cloud-sql-proxy

OK没有生成新鲜度警告。

安装元数据

软件包元数据

软件包键	brew:cloud-sql-proxy
版本	2.23.0
软件包管理器	Homebrew
软件包管理器页面	https://formulae.brew.sh/formula/cloud-sql-proxy
主页	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
Pulse	updated
构建依赖	go
Bottle	可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	未定义
服务	未声明

注册表事实

源数据库详情

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

源数据库匹配

其他软件包管理器记录

匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。

Scoop95%

main/cloud-sql-proxy

scoop install main/cloud-sql-proxy

normalized package name match
匹配方式：Cloud Sql Proxy

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

软件包图谱

链接来自本地软件包关系图、补充数据、依赖边、生态匹配和软件包 hub 归属。

来源线索

由仓库数据生成

此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。

Combined YAML source

View the package source record on GitHub.

combined/cloud-sql-proxy.yml

使用的来源

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

使用 Homebrew, scoop 安装 cloud-sql-proxy