热门搜索:
grafana/cloudsql-proxy
Grafana提供的Cloud SQL Proxy Docker镜像，用于安全连接Google Cloud SQL实例，无需管理SSL证书，支持多种认证方式，简化数据库加密连接流程。
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Grafana Cloud SQL Proxy 镜像文档
镜像概述
Grafana Cloud SQL Proxy镜像基于Google Cloud SQL Proxy工具构建，由Grafana团队维护。该镜像提供轻量级代理服务，用于安全连接Google Cloud SQL实例，避免直接暴露数据库端口。通过代理建立加密连接，无需手动管理SSL证书或配置IP白名单，简化数据库访问流程。
核心功能与特性
安全连接
- 自动建立与Cloud SQL实例的加密TLS连接，无需手动配置SSL证书
- 避免数据库实例直接暴露公网，降低***面
简化认证
- 支持多种认证方式：
- Google Cloud服务账号密钥文件
- GCE/GKE实例默认应用凭据（无需额外配置）
- 工作负载身份（GKE环境）
多数据库支持
- 兼容PostgreSQL、MySQL等Cloud SQL支持的数据库类型
- 自动适配目标数据库协议
轻量级设计
- 基于精简基础镜像，容器体积小，资源占用低
- 无状态设计，支持水平扩展
使用场景
容器化应用连接
适用于Kubernetes或Docker环境中，容器化应用需要连接Cloud SQL实例的场景
本地开发环境
本地开发时安全连接Cloud SQL实例，无需配置复杂网络规则
生产环境部署
生产环境中通过代理访问数据库，统一管理连接配置，增强安全性
多环境一致性
开发、测试、生产环境使用相同连接方式，减少环境差异导致的问题
使用方法
前提条件
- 已创建Google Cloud SQL实例
- 已准备认证凭据（服务账号密钥文件或GCE/GKE环境默认凭据）
- 目标Cloud SQL实例已配置允许代理连接（通常默认支持）
镜像拉取
bashdocker pull grafana/cloudsql-proxy
基础使用示例
使用服务账号密钥文件认证
bashdocker run -d \ -v /local/path/to/service-account-key.json:/config/key.json \ -p 5432:5432 \ grafana/cloudsql-proxy \ --credentials-file /config/key.json \ --port 5432 \ my-gcp-project:us-central1:my-sql-instance
GCE/GKE环境（默认凭据）
在GCE实例或GKE集群中运行时，可使用默认应用凭据，无需挂载密钥文件：
bashdocker run -d \ -p 3306:3306 \ grafana/cloudsql-proxy \ --port 3306 \ my-gcp-project:asia-east1:my-mysql-instance
Docker Compose示例
yamlversion: '3' services: cloudsql-proxy: image: grafana/cloudsql-proxy ports: - "5432:5432" volumes: - ./service-account-key.json:/config/key.json command: - --credentials-file=/config/key.json - --port=5432 - my-gcp-project:us-west1:my-postgres-instance restart: always
核心配置参数
命令行参数
| 参数 | 说明 | 示例 |
|---|---|---|
--credentials-file | 服务账号密钥文件路径 | /config/key.json |
--port | 代理监听端口 | 5432 |
--address | 监听地址（默认0.0.0.0） | 127.0.0.1 |
--instances | Cloud SQL实例连接名（多个实例用逗号分隔） | project:region:instance1,project:region:instance2 |
--log_debug_stdout | 启用调试日志输出到stdout | - |
环境变量
部分参数可通过环境变量配置（优先级低于命令行参数）：
| 环境变量 | 对应参数 | 说明 |
|---|---|---|
CLOUDSQL_PROXY_CREDENTIALS_FILE | --credentials-file | 服务账号密钥文件路径 |
CLOUDSQL_PROXY_PORT | --port | 代理监听端口 |
CLOUDSQL_PROXY_INSTANCES | --instances | Cloud SQL实例连接名 |
注意事项
- 密钥文件权限：容器内密钥文件权限建议设置为
400，避免权限过高 - 网络配置：确保容器可访问Google Cloud API（
https://www.googleapis.com） - 资源限制：根据并发连接数调整容器CPU/内存资源，建议至少分配100m CPU和64Mi内存
- 版本选择：生产环境建议使用特定版本标签（如
grafana/cloudsql-proxy:1.33.0），避免自动升级导致兼容性问题
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 cloudsql-proxy 镜像标签
docker pull docker.xuanyuan.run/grafana/cloudsql-proxy:<标签>
DockerHub 原生拉取命令
docker pull grafana/cloudsql-proxy:<标签>
更多 cloudsql-proxy 镜像推荐
proceedfinance/cloudsql-proxy
proceedfinance
Cloudsql Proxy
10万+ 次下载
4 年前更新
nullable/cloudsql-proxy
nullable
暂无描述
5万+ 次下载
6 年前更新
quisst/cloudsql-proxy
quisst
暂无描述
1万+ 次下载
3 年前更新
syoya/cloudsql-proxy
syoya
该Docker镜像封装Google Cloud SQL Proxy工具，用于安全连接Google Cloud Platform上的Cloud SQL数据库实例，无需直接暴露数据库端口。
1万+ 次下载
7 年前更新
haproxytech/haproxy-debian
haproxytech
HAProxy社区版Docker Debian镜像，提供高性能的开源负载均衡和应用交付控制功能，支持TCP/HTTP代理、SSL终止、健康检查等特性，适用于构建可靠的流量管理解决方案。
9 次收藏1000万+ 次下载
17 天前更新
haproxytech/haproxy-alpine
haproxytech
HAProxy社区版Docker镜像，基于Alpine Linux构建，提供高性能负载均衡与反向代理功能，适用于构建轻量级、高可用的Web服务或应用集群。
18 次收藏500万+ 次下载
17 天前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"