轻量云服务器如何链接分布式数据库 TDSQL？

轻量云服务器连接自身云数据库 连接腾讯云分布式数据库 TDSQL（通常指 TDSQL for MySQL 或 TDSQL-C）与连接普通单机数据库略有不同，因为分布式架构涉及网关层（Proxy/Gateway）。

对于**轻量应用服务器（Lighthouse）**用户，连接 TDSQL 主要分为两种场景：

1. 场景 A：你的轻量服务器与 TDSQL 实例在同一地域。
2. 场景 B：你的轻量服务器与 TDSQL 实例在不同地域（跨公网访问）。

以下是高信息密度、可执行的连接攻略。

🟢 核心概念：TDSQL 的连接方式

TDSQL 分布式版通常通过 Proxy（代理节点） 对外提供服务，而不是直接连接后端的数据分片（Shard）。

• 前端地址 (Proxy IP)：你代码中填写的地址。
• 后端地址 (Data Node)：通常不需要直接连接，除非进行底层调试。

🔵 场景一：同地域内网连接（推荐，高性能、免费流量）

如果你的轻量服务器和 TDSQL 实例都在同一个地域（例如都在“上海”），这是最佳方案。

1. 获取连接信息

登录腾讯云控制台 -> 数据库产品 -> TDSQL -> 找到你的实例 -> 基本信息。 记录以下关键信息：

• 前端地址 (Proxy IP/Domain)：类似 gxxxxxx.sql.tencentcdb.com 或一个内网 IP。
  • 注意：务必确认这是前端 Proxy 地址，而不是后端 Data Node 地址。
• 端口：默认 6379 (Redis) 或 3306 (MySQL)，TDSQL for MySQL 通常是 3306。
• 账号/密码：你在创建实例时设置的超级管理员账号和密码。

2. 配置白名单（关键！）

TDSQL 对 IP 访问控制非常严格。

1. 在 TDSQL 实例详情页，找到 “白名单设置”。
2. 添加你的轻量服务器的内网 IP。
   • 如何获取轻量服务器内网 IP？ SSH 登录轻量服务器，执行 hostname -I 或 ifconfig，查找以 10.x.x.x 或 172.x.x.x 开头的地址。
   • 格式：如果是单个 IP，填 IP/32；如果是整个子网，填 IP/MASK。

3. 测试连接

SSH 登录轻量服务器，安装 MySQL 客户端：

# Ubuntu/Debian
sudo apt install mysql-client -y

# CentOS
sudo yum install mysql -y

使用命令行测试：

mysql -h <PROXY_IP> -P 3306 -u <USERNAME> -p

• 如果连接成功，说明内网打通。

4. 代码连接示例 (Python/Node.js)

import pymysql

conn = pymysql.connect(
    host='<PROXY_IP>',  # 使用内网 Proxy IP
    port=3306,
    user='<USERNAME>',
    password='<PASSWORD>',
    database='<DATABASE_NAME>'
)

🟠 场景二：跨地域公网连接（需谨慎，有延迟和费用）

如果你的轻量服务器在外地（如北京），而 TDSQL 在上海，你需要通过公网连接。

1. 前置条件

• TDSQL 实例必须开启了公网访问功能（通常在实例详情页 -> “更多” -> “绑定弹性公网 IP”）。
• 你需要知道 TDSQL 的公网域名/IP。

2. 配置白名单

在 TDSQL 白名单中，添加你的轻量服务器的公网 IP。

• 如何获取？ 在轻量服务器终端执行 curl ifconfig.me。
• 建议：只添加你自己的 IP，不要添加 0.0.0.0/0。

3. 配置轻量服务器防火墙

在腾讯云控制台 -> 轻量应用服务器 -> 防火墙，确保没有规则阻止出站连接（通常默认允许所有出站，但需检查是否有自定义限制）。

4. 连接测试

mysql -h <TDsql_PUBLIC_DOMAIN_OR_IP> -P 3306 -u <USERNAME> -p

⚠️ 警告：

1. 延迟高：跨地域 TCP 连接会有较高延迟，不适合高频读写业务。
2. 费用：TDSQL 的公网流出流量可能产生费用。
3. 安全性：公网暴露数据库风险极高，务必使用强密码，并仅对白名单 IP 开放。

🟣 场景三：使用 TDSQL 专属客户端/驱动（高级）

对于分布式数据库，建议使用支持分片路由特性的客户端库，以获得更好的性能。

1. Java (Spring Boot + MyBatis/JPA)

如果使用 Spring Cloud Alibaba 或 TDSQL 官方提供的 Starter，可以自动处理分片逻辑。

<dependency>
    <groupId>com.tencentcloudapi</groupId>
    <artifactId>tdsql-jdbc-spring-boot-starter</artifactId>
    <version>latest</version>
</dependency>

2. Python (PyMySQL/TencentDB Connector)

普通 PyMySQL 也可以连接，但如果数据量极大，建议使用腾讯云的 TDSQL Python SDK 或 Proxy 优化版驱动。

3. Node.js (Sequelize/Mongoose)

同样可以使用标准 MySQL 驱动，但需注意连接池大小，避免并发过高导致 Proxy 拒绝连接。

⚠️ 高信息密度避坑指南

1. Proxy vs Data Node：
   • 永远连接 Proxy 地址，不要尝试直连 Data Node。直连会导致无法分片路由，报错 Table doesn't exist 或数据不一致。
   • 在控制台区分清楚：前端地址 (Proxy) 和 后端地址 (Data Node)。
2. 字符集问题：
   • 确保轻量服务器、应用代码、TDSQL 实例的字符集一致（推荐 utf8mb4）。否则可能出现中文乱码。
3. 最大连接数：
   • TDSQL 的 Proxy 有最大连接数限制。如果轻量服务器上的应用并发很高，需监控连接数，必要时升级 TDSQL 规格或增加 Proxy 节点。
4. SSL/TLS 加密：
   • 腾讯云 TDSQL 支持 SSL 连接。在生产环境中，建议在连接字符串中添加 ?ssl=true 并使用腾讯云提供的 CA 证书，以确保数据安全。
5. 轻量服务器内存：
   • TDSQL 是分布式数据库，连接建立和维护需要一定内存。确保轻量服务器至少有 2GB+ 内存，否则在高并发下可能 OOM。

✅ 总结操作清单

1. 确定拓扑：同地域用内网，跨地域用公网。
2. 获取 Proxy 地址：从 TDSQL 控制台复制前端 Proxy 地址。
3. 配置白名单：将轻量服务器的内网/公网 IP 加入 TDSQL 白名单。
4. 测试连接：使用 mysql 命令行验证连通性。
5. 代码集成：在应用中配置 Proxy 地址、端口、账号密码。
6. 监控：上线后监控连接数和延迟，确保稳定性。

按照以上步骤，你应该能顺利连接到腾讯云 TDSQL 分布式数据库。如果遇到具体报错，请提供错误信息以便进一步排查。