本页面介绍了如何使用 Cloud SQL Auth 代理从本地测试环境连接到 Cloud SQL。借助 Cloud SQL Auth 代理，您无需授权网络或配置 SSL，即可安全访问 Cloud SQL 实例。通过使用 Cloud SQL Auth 代理，您可以安全地连接到 Cloud SQL 实例。
下述说明不适用于为生产环境设置 Cloud SQL Auth 代理。此外，如需了解用于身份验证和使用代理的更多连接选项，请参阅使用 Cloud SQL Auth 代理进行连接。
设置项目
在执行本快速入门中的步骤之前，请完成以下任务：
- 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
确保您的用户帐号具有 Cloud SQL Admin 角色。
- 转到 IAM 页面。
转到 IAM 页面 - 点击添加。
- 在新主帐号中，添加您的用户帐号名称。
- 在选择角色中，过滤 Cloud SQL Admin，然后从列表中选择该角色。
- 点击保存。
- 转到 IAM 页面。
-
启用 Cloud SQL Admin API 和 Compute Engine API。
启用 API
创建 Cloud SQL 实例
在本快速入门中，您将使用 Google Cloud Console。如需使用 gcloud、cURL 或 PowerShell，请参阅创建实例。
-
在 Google Cloud Console 中，转到 Cloud SQL 实例页面。
- 点击创建实例。
- 点击选择 PostgreSQL。
- 在实例 ID 部分输入
myinstance。 - 为
postgres用户输入密码。 点击创建。
您会返回到实例列表。您可以立即点击新实例以查看详细信息，但该实例只能在初始化并启动之后才可用于其他操作。
注意：在此示例中，将使用默认设置（包括公共 IP 地址）创建实例。
安装 psql 客户端
Debian/Ubuntu
通过软件包管理器安装 psql 客户端：
sudo apt-get update sudo apt-get install postgresql-client
CentOS/RHEL
通过软件包管理器安装 psql 客户端：
sudo yum install postgresql
openSUSE
通过软件包管理器安装 psql 客户端：
sudo zypper install postgresql
其他平台
- 从 PostgreSQL 下载页面下载适用于您的平台的 PostgreSQL 核心发行版。
核心发行版包含 psql 客户端。 - 按照下载页面上的说明安装 PostgreSQL 数据库。
安装 Cloud SQL Auth 代理客户端
您下载的 Cloud SQL Auth 代理二进制文件取决于您的操作系统，以及该系统使用的是 32 位还是 64 位内核。大多数较新的硬件使用的是 64 位内核。如果您不确定自己的机器运行的内核是 32 位还是 64 位，请使用 uname -a 命令（Linux 或 macOS）。对于 Windows，请参阅 Windows 文档。
Linux 64 位
- 下载 Cloud SQL Auth 代理：
wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
- 使 Cloud SQL Auth 代理可执行：
chmod +x cloud_sql_proxy
Linux 32 位
- 下载 Cloud SQL Auth 代理：
wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
- 如果找不到
wget命令，请运行sudo apt-get install wget并重复执行下载命令。 - 使 Cloud SQL Auth 代理可执行：
chmod +x cloud_sql_proxy
macOS 64 位
- 下载 Cloud SQL Auth 代理：
curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
- 使 Cloud SQL Auth 代理可执行：
chmod +x cloud_sql_proxy
macOS 32 位
- 下载 Cloud SQL Auth 代理：
curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
- 使 Cloud SQL Auth 代理可执行：
chmod +x cloud_sql_proxy
Mac M1
- 下载 Cloud SQL Auth 代理：
curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.arm64
- 使 Cloud SQL Auth 代理可执行：
chmod +x cloud_sql_proxy
Windows 64 位
右键点击 https://dl.google.com/cloudsql/cloud_sql_proxy_x64.exe，然后选择链接另存为以下载 Cloud SQL Auth 代理。将文件重命名为cloud_sql_proxy.exe。Windows 32 位
右键点击 https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe，然后选择链接另存为以下载 Cloud SQL Auth 代理。将文件重命名为cloud_sql_proxy.exe。Cloud SQL Auth 代理 Docker 映像
为方便起见，GitHub 上的 Cloud SQL Auth 代理代码库中提供了多个包含 Cloud SQL Auth 代理的容器映像。您可以通过 Docker 使用以下命令将最新映像拉取到本地机器：docker pull gcr.io/cloudsql-docker/gce-proxy:1.19.1
其他操作系统
对于此处未列出的其他操作系统，您可以通过源代码编译 Cloud SQL Auth 代理。获取实例连接名称
-
在 Google Cloud Console 中，转到 Cloud SQL 实例页面。
- 点击实例名称，打开其概览页面。
- 在连接到此实例部分，复制连接名称。连接名称的格式为
projectID:region:instanceID。
启动 Cloud SQL Auth 代理
在专有的终端中启动 Cloud SQL Auth 代理，以便监控其输出。将 INSTANCE_CONNECTION_NAME 替换为您在上一步中复制的实例连接名称。
对于 Linux 环境，使用以下命令启动 Cloud SQL Auth 代理：
./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:5432
在 Windows 中的 PowerShell 中，使用以下命令启动 Cloud SQL Auth 代理：
.\cloud_sql_proxy.exe -instances=INSTANCE_CONNECTION_NAME=tcp:5432
系统会显示类似以下内容的消息：
Listening on 127.0.0.1:5432 for INSTANCE_CONNECTION_NAME Ready for new connections
将 INSTANCE_ID 替换为 Cloud SQL 实例的名称后，运行以下命令：
psql "host=127.0.0.1 port=5432 sslmode=disable dbname=INSTANCE_ID user=postgres"
在“输入密码：”提示符处，输入您的 PostgreSQL 帐号的密码。
验证 PostgreSQL 提示符是否显示。您已使用 psql 客户端连接到数据库。
返回到您启动了 Cloud SQL Auth 代理的终端窗口。您应该会看到如下所示的消息：
New connection for myInstance
清理
-
在 Google Cloud Console 中，转到 Cloud SQL 实例页面。
- 选择实例名称以打开概览页面。
- 在页面顶部的图标栏中，点击删除。
- 在删除实例窗口中，输入实例名称，然后点击删除。
在删除实例后的大约七天内，您不能重新使用相应的实例名称。