Ubuntu 安装 TIDB 分布式数据库

环境

使用 Ubuntu 24.04 系统的服务器。

端口

检查是否启用防火墙

sudo ufw status

如果输出 “active” ，表示防火墙已启用，如果需要内网访问，需要开放 4000（TiDB SQL服务端口）、2379（集群内部通信）、3000（运维监控端口） 端口。 如分布式集群，需开放内网互联。

开放端口的命令：

# 1. 开放SSH端口（用于部署和管理）
sudo ufw allow from 192.168.1.0/24 to any port 22 proto tcp
# 2. 开放TiDB SQL服务端口（给应用连接）
sudo ufw allow from 192.168.1.0/24 to any port 4000 proto tcp
# 3. 开放PD服务端口（集群内部通信）
sudo ufw allow from 192.168.1.0/24 to any port 2379 proto tcp
# 4. 开放Grafana监控端口（给运维人员）
sudo ufw allow from 192.168.1.0/24 to any port 3000 proto tcp

注：涉及的端口还有很多，如分布式集群部署建议内网放开所有端口。

安装 chrony 服务（分布式系统一致性）

# 1. 安装chrony
sudo apt update
sudo apt install chrony -y

# 2. 启动并设置开机自启
sudo systemctl enable chrony --now

# 3. 检查同步状态（显示"Leap status : Normal"表示正常）
sudo chronyc tracking

# 4. 可查看当前连接的NTP服务器
sudo chronyc sources -v

关闭 Swap 并调整系统参数

TiDB 对内存和磁盘 I/O 要求高，生产环境需关闭 Swap 并优化内核参数。 先执行命令检查是否启用 Swap：

swapon --show

如果返回空就代表未启用。

可参考的调整参数（具体需按服务器配置调整）：

# 关闭Swap（永久生效需注释/etc/fstab中的swap行）
sudo swapoff -a
# 调整内核参数
echo "vm.swappiness = 0" | sudo tee -a /etc/sysctl.conf
echo "fs.file-max = 1000000" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

安装 TiUP 及其集群组件

TiUP 是 TiDB 的包管理器和集群部署工具，是官方推荐的生产环境部署方式

curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh
source ~/.bashrc

安装 TiUP 的集群组件

tiup cluster

编写集群拓扑配置文件

vim ~/topo.yaml

内容:

# 全局配置，对所有部署生效
global:
  user: "tidb"                  # TiUP 会创建此系统用户来管理服务
  ssh_port: 22
  deploy_dir: "/tidb-deploy"    # 部署目录
  data_dir: "/tidb-data"        # 数据目录

# 监控相关端口
monitored:
  node_exporter_port: 9100
  blackbox_exporter_port: 9115

# 集群中各组件的服务配置
pd_servers:
  - host: 192.168.1.100        # 替换为你的内网IP

tidb_servers:
  - host: 192.168.1.100

tikv_servers:
  - host: 192.168.1.100
    port: 20160
    status_port: 20180

monitoring_servers:
  - host: 192.168.1.100

grafana_servers:
  - host: 192.168.1.100

部署并启动 TiDB 集群

使用密码访问服务器的方式部署：

tiup cluster deploy my-tidb v8.5.1 ./topo.yaml --user root -p

使用密钥访问服务器的方式部署 （密钥路径自行调整）：

tiup cluster deploy my-tidb v8.5.1 ./topo.yaml --user root -i /path/to/your/private_key

执行成功后，会显示 "Cluster my-tidb deployed successfully"。

启动集群

第一次启动执行 (最后会显示数据库密码，需自行保存)：

tiup cluster start my-tidb --init

后续启动执行：

tiup cluster start my-tidb

启动后，可以通过以下命令检查各组件状态：

tiup cluster display my-tidb

所有组件的状态应为 Up。

使用

mysql -h <你的服务器公网或内网IP> -P 4000 -u root

即可连接 TIDB 数据库进行使用。