一、环境说明

• 本次部署环境如下

项目	配置
CPU	12 Core
内存	48 GB
操作系统	Kylin Linux Advanced Server V10
架构	ARM64（Kunpeng）

本教程使用 TiDB 官方部署工具 TiUP 进行单机部署。

二、安装 TiUP 部署工具

• 执行以下命令安装 TiUP

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

• 安装完成后，新打开一个终端窗口或者执行

source ~/.bashrc

• 检查安装是否成功

tiup --version

示例输出

1.16.4 v1.16.2-nightly-90
Go Version: go1.24.1
Git Ref: master
GitHash: 908be86076919952e4c3f1e52c214c2f45be14e9

三、安装 TiDB cluster 组件

• TiUP 通过组件方式管理 TiDB 集群，需要安装cluster组件。

执行命令

tiup install cluster

示例输出

download https://tiup-mirrors.pingcap.com/cluster-v1.16.4-linux-arm64.tar.gz

四、创建部署目录

• 进入 /opt 目录并创建 TiDB 安装目录

cd /opt
mkdir tidb
cd tidb

五、创建 topology.yaml 文件

• 创建集群拓扑文件

vim topology.yaml

文件内容如下：

global:
  user: "tidb"
  ssh_port: 22
  deploy_dir: "/opt/tidb/tidb-deploy"
  data_dir: "/opt/tidb/tidb-data"

server_configs:
  tidb: {}
  tikv:
    storage.block-cache.capacity: "10GB"
  pd: {}

pd_servers:
  - host: 192.168.0.119

tidb_servers:
  - host: 192.168.0.119
    port: 4000
    status_port: 10080

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

说明:
IP 地址需要修改为自己的服务器 IP
deploy_dir 为部署目录
data_dir 为数据目录
storage.block-cache.capacity 表示 TiKV 的缓存大小

六、部署 TiDB 集群

• 执行部署命令

tiup cluster deploy tidb-single v8.5.5 topology.yaml --user root -p

参数说明：

参数	说明
tidb-single	集群名称
v8.5.5	TiDB 版本
–user root	使用 root 用户初始化环境
-p	SSH 使用密码登录

• 如需查看可安装版本：

tiup list tidb

七、部署报错（sudo 权限问题）

• 在部署过程中可能出现如下报错

executor.ssh.execute_failed
sudo: no tty present and no askpass program specified

该问题是由于 tidb 用户没有 sudo 权限导致。

• 解决方法：

#编辑 sudoers 文件：
visudo

# 在文件最后添加：
tidb ALL=(ALL) NOPASSWD: ALL
保存退出即可。

八、目录授权并重新部署

• 给部署目录授权

chown -R tidb.tidb /opt/tidb

• 然后重新执行部署命令

tiup cluster deploy tidb-single v8.5.5 topology.yaml --user root -p

部署成功后会看到

Cluster `tidb-single` deployed successfully

九、初始化 TiDB 集群

• 部署完成后，需要初始化并启动集群

tiup cluster start tidb-single --init

• 示例输出

Started cluster `tidb-single` successfully
The root password of TiDB database has been changed.
The new password is: 'e@25*17b-t68DA+Lgv'

• 注意

The new password is: 'xxxxx'

该密码 只会显示一次，需要记录保存。

十、安装客户端并连接测试

• 安装 MySQL 客户端

yum -y install mariadb

• 连接 TiDB 数据库

mysql -h127.0.0.1 -P4000 -uroot -p

输入初始化生成的 root 密码即可登录。

• 登录后建议修改 root 密码

ALTER USER 'root'@'%' IDENTIFIED BY 'Tidb@123456';
FLUSH PRIVILEGES;

十一、验证 TiDB 是否正常运行

• 执行以下 SQL 查看版本信息

SELECT tidb_version();

示例输出

Release Version: v8.5.5
Edition: Community
Store: tikv

说明 TiDB 已成功运行。

总结

本文介绍了在鲲鹏ARM服务器+Kylin Linux V10环境下，使用TiUP工具部署 TiDBv8.5.5单节点集群的完整过程，并记录了部署过程中遇到的sudo权限问题及解决方法。

通过以上步骤，可以快速完成 TiDB 单机环境部署，适用于：简洁精准
实用高效
清晰易懂简洁精准
实用高效
清晰易懂

• 学习测试环境
• 开发环境
• 小规模业务场景