实战教程｜Kylin V10 SP3 虚拟机从零部署 TDSQL-Lite 单机版

前言

本文手把手教大家在 VMware 虚拟机中完整部署 TDSQL-Lite 单机基础版，适配 CentOS、银河麒麟V10 等国产 Linux 环境。

很多同学部署时会遇到：外网Docker源解析失败、磁盘挂载异常、Docker版本不兼容、部署权限报错等问题，网上教程残缺不全、步骤混乱。

本文提供可100%复现的离线适配方案，规避所有外网源报错问题，从环境初始化、Docker安装、磁盘挂载、集群部署、登录验证全覆盖，新手照着操作即可部署成功。

适用场景：学习测试、实验环境搭建、国产化数据库预演、TDSQL基础运维练习

环境版本信息

  • 部署平台：VMware 虚拟机
  • 操作系统：CentOS 7+、TencentOS、银河麒麟V10（x86/ARM通用）
  • 部署版本：TDSQL-Lite 基础版 8.0.51.0.0
  • 依赖环境：Docker 18.09.x+、Docker Compose v2.0+

硬件资源要求

  • CPU：最低4核，推荐8核
  • 内存：最低8GB，推荐16GB
  • 磁盘：系统盘50GB+ SSD、数据盘50GB+ SSD

一、问题背景与常见部署坑点

常规网上TDSQL部署教程普遍存在以下问题，导致新手部署失败率极高：

  • 默认使用外网Docker官方源，虚拟机隔离环境解析失败、超时无法安装
  • 缺少磁盘挂载、SELinux、防火墙初始化配置，部署后服务异常
  • 权限不规范，解压目录权限不足导致安装脚本报错
  • 外网MySQL rpm源无法访问，无法安装客户端验证数据库

本文全部采用国内镜像源+离线适配方案，彻底解决外网源访问失败问题，所有步骤经过实测验证。

二、系统环境初始化（必做）

所有命令全程复制即用，统一标准化环境，规避90%部署报错。

2.1 修改主机名

hostnamectl set-hostname tdsql01 && bash

2.2 永久关闭SELinux

setenforce 0
sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/sysconfig/selinux
# 校验配置
getenforce
cat /etc/sysconfig/selinux

2.3 关闭防火墙并禁用自启

systemctl disable firewalld && systemctl stop firewalld.service && systemctl status firewalld.service

2.4 数据盘格式化与永久挂载（关键）

TDSQL数据必须独立数据盘存储，禁止使用系统盘，此处将空闲磁盘 /dev/sdb 挂载至 /data

lsblk
mkdir /data
mkfs.xfs -f /dev/sdb
echo "`blkid | grep /dev/sdb | awk '{print $2}'` /data xfs defaults 0 0" >> /etc/fstab
mount -a
lsblk

三、Docker环境离线适配安装（解决外网源报错）

核心优化：废弃外网超时源，替换腾讯云国内稳定镜像源，适配虚拟机隔离网络。

3.1 清理系统残余旧Docker

yum remove docker docker-client docker-common docker-engine -y

3.2 安装系统依赖工具

yum install -y yum-utils wget unzip vim net-tools.x86_64 lsof.x86_64
yum install -y pcp-import-iostat2pcp.x86_64 sysstat.x86_64 dstat.noarch mlocate.x86_64 smartmontools.x86_64

3.3 配置国内Docker源并安装

# 添加国内Docker镜像源
yum-config-manager --add-repo https://mirrors.cloud.tencent.com/docker-ce/linux/centos/docker-ce.repo
# 替换源地址，规避外网拦截超时
sed -i 's/download.docker.com/mirrors.cloud.tencent.com\/docker-ce/g' /etc/yum.repos.d/docker-ce.repo
# 刷新yum缓存
yum clean all
yum makecache
# 安装Docker全套组件
yum install -y docker-ce docker-ce-cli containerd.io
# 校验版本
docker --version && docker compose version
# 启动并设置开机自启
systemctl start docker && systemctl enable docker && systemctl status docker

四、TDSQL-Lite 单机版完整部署

提前将官方离线安装包放置服务器 /root目录，全程离线部署，无需外网。

4.1 解压部署包

unzip TDSQL基础版-软件包_6cc2715b.zip
mv /root/TDSQL基础版-软件包/tdsql-lite-8.0.51.0.0-amd64.tar.gz /root
cd /root
ll
tar zxvf tdsql-lite-8.0.51.0.0-amd64.tar.gz

4.2 权限校验（必做）

确保安装目录归属root用户，避免部署权限不足失败

cd tdsql-lite-8.0.51.0.0-amd64
ll

4.3 修改配置并执行安装

编辑 config.env，将数据存储目录修改为 /data，其余参数默认即可

vim config.env
# 执行一键安装脚本
./install.sh

五、部署成功信息与访问入口

安装脚本执行完毕，自动输出所有服务访问地址、账号信息，部署成功标识：TDSQL-Lite 安装完成！

5.1 全服务访问地址

  • 管理控制台：http://【服务器公网/内网IP】:8080
  • MySQL数据库端口：【服务器公网/内网IP】:3306
  • 监控时序数据库：http://【服务器公网/内网IP】:8428
  • 告警服务地址：http://【服务器公网/内网IP】:9093

5.2 默认登录信息

  • 管理员用户名：admin
  • 初始密码：部署终端实时输出，手动记录保存

重要建议：首次登录控制台立即修改默认密码，规避安全风险。

5.3 日常运维核心命令

# 查看集群整体运行状态
./status.sh
# 停止服务
./stop.sh [all|manager|mysql|monitoring]
# 启动服务
./start.sh [all|manager|mysql|monitoring]
# 重启服务
./restart.sh [all|manager|mysql|monitoring]
# 卸载服务（--purge 清空所有数据）
./uninstall.sh [--purge]
# 收集日志排障
./collect_logs.sh

所有部署日志自动保存至 .install_info，可追溯部署记录。

六、数据库客户端安装与登录验证

规避外网MySQL源解析失败问题，本地yum直接安装客户端，完成数据库连通性验证。

6.1 安装MySQL客户端

yum install -y mysql-community-client --nogpgcheck

6.2 数据库登录测试

在TDSQL控制台提前创建测试用户，执行以下命令登录验证

mysql -h【服务器公网/内网IP】 -P3306 -utest -p【自定义测试账号密码】

可正常登录、执行SQL语句，代表集群部署完全正常。

七、部署常见问题与避坑指南

1. 外网源解析/访问失败

原因：虚拟机隔离网络无法访问境外官方源

解决方案：全部替换国内镜像源，放弃外网repo、rpm源，采用离线安装模式

2. 部署权限不足报错

原因：安装目录归属普通用户

解决方案：全程使用root用户操作，保证安装目录权限完整

3. Docker启动异常

原因：防火墙/SELinux未关闭、旧版本残留冲突

解决方案：彻底关闭安全策略，清理残余组件后重启Docker

4. 数据目录异常

原因：使用系统盘存储数据，无独立数据盘挂载

解决方案：必须单独挂载SSD数据盘至/data，规范存储结构

八、总结

本文适配国产化麒麟、CentOS全系列Linux系统，解决了全网多数教程外网源失效、步骤残缺、环境不规范的问题。

核心要点总结：

  • TDSQL部署环境标准化优先：关闭安全策略、独立数据盘挂载是部署成功的前提
  • 隔离虚拟机环境必须抛弃外网源，使用国内镜像/离线部署
  • 部署完成后务必验证控制台访问、数据库登录、服务状态，确保集群可用

该方案可直接用于个人学习、企业测试环境搭建、国产化数据库预演交付。

九、资源领取与技术交流

很多小伙伴在实操过程中，经常遇到安装包缺失、配置参数不懂、环境适配报错等问题，自行摸索耗时费力。

我已整理好TDSQL-Lite 完整离线部署包、全套安装运维手册、常见报错解决方案，适配麒麟V10、CentOS等国产化环境，开箱即用、无需繁琐配置。

需要领取 TDSQL部署包 + 详细部署文档 + 一对一部署答疑 的朋友，可以添加个人微信交流！

✅ 免费获取：官方离线安装包、完整版部署手册、运维命令大全

✅ 技术答疑：部署报错排查、环境适配优化、TDSQL基础运维问题解答

✅ 学习交流：数据库运维、国产化数据库部署、分布式技术经验分享

big

（添加备注：TDSQL学习，统一通过并发送全套资源）

posted @ 2026-08-26 17:09  数字化探索者笔记  阅读(37)  评论(0)    收藏  举报