当前位置:首页>Linux>单台 Linux 服务器上离线部署 TiDB

单台 Linux 服务器上离线部署 TiDB

  • 2026-09-02 20:36:20
单台 Linux 服务器上离线部署 TiDB

脚本下载链接:https://pan.baidu.com/s/1xMtR3HOdJsnJ20qHRmw2VQ?pwd=e09i 提取码:e09i 复制这段内容后打开百度网盘手机App,操作更方便哦

简介

本指南面向希望在单台 Linux 服务器上离线部署 TiDB 的用户,提供从零开始的完整流程:系统要求检查、离线安装包准备、执行安装、基础连接验证与常见初始配置。文档兼顾初学者的逐步指导与有经验用户的快速参考,所有命令均来自仓库内的脚本与文档,确保可重复性与准确性。

项目结构

该仓库包含一套完整的离线安装与运维脚本,以及配套的快速开始与详细说明文档:

  • 快速开始文档:提供三步法与常用命令示例
  • 详细文档:涵盖硬件/系统要求、目录结构、管理命令、监控访问、故障排查、高级配置与安全加固
  • 安装脚本:自动检测架构、解压安装包、生成配置与 systemd 服务、启动集群并输出状态
  • 环境检查脚本:对权限、系统、硬件、网络、端口、系统设置、依赖与安装包进行综合检查
  • 安装包检查脚本:列出安装包内容并校验关键二进制文件
  • 卸载脚本:智能识别安装痕迹并提供“完全卸载/仅卸载程序”两种模式
  • 密码变更示例:提供 root 密码变更语句(需结合实际使用)
  • QUICKSTART.md
  • README.md
  • install_tidb_offline.sh
  • pre_check.sh
  • check_package.sh
  • uninstall_tidb.sh
  • chan_pass

章节来源

  • QUICKSTART.md
  • README.md

核心组件

  • 环境检查脚本:对系统架构、操作系统版本、内核版本、硬件资源、网络连通、端口占用、系统设置、依赖与安装包进行逐项检查,输出 PASS/WARN/FAIL 并给出修复建议
  • 安装脚本:自动检测架构、解压安装包、生成配置与 systemd 服务、配置系统参数、生成管理脚本、启动集群并输出状态
  • 安装包检查脚本:列出安装包内容并校验关键二进制文件(pd-server、tikv-server、tidb-server)
  • 卸载脚本:智能识别安装痕迹,支持“完全卸载(含数据)/仅卸载程序(保留数据)”
  • 快速开始与详细文档:提供三步法、连接测试、常用管理命令、故障排查与安全加固

章节来源

  • pre_check.sh
  • install_tidb_offline.sh
  • check_package.sh
  • uninstall_tidb.sh
  • QUICKSTART.md
  • README.md

架构总览

离线安装脚本会自动检测系统架构(x86_64/amd64 或 aarch64/arm64),并据此选择对应的安装包。安装完成后,生成如下目录结构与服务:

  • 安装目录:/opt/tidb(包含二进制、配置、管理脚本)
  • 数据目录:/data/tidb(按节点划分)
  • 日志目录:/var/log/tidb(按组件划分)
  • systemd 服务:pd1/pd2/pd3、tikv1/tikv2/tikv3、tidb1(含开机自启)
  • README.md
  • install_tidb_offline.sh
  • install_tidb_offline.sh

章节来源

  • README.md
  • install_tidb_offline.sh
  • install_tidb_offline.sh

详细组件分析

环境检查脚本(pre_check.sh)

  • 功能:对权限、系统、硬件、网络、端口、系统设置、依赖与安装包进行综合检查
  • 关键检查点:
    • 权限:需要 root 权限
    • 系统:架构支持(x86_64/amd64、ARM64/aarch64)、操作系统版本(CentOS/RHEL 7+、Ubuntu 18.04+、Debian 9+)、内核版本 3.10+
    • 硬件:CPU 核心数、内存、磁盘空间
    • 网络:本地回环、主机名
    • 端口:PD/TiKV/TiDB 相关端口占用检查
    • 系统设置:透明大页、Swap、文件句柄限制、SELinux、防火墙
    • 依赖:tar、gzip、systemctl 等必备命令;可选 mysql、curl、wget
    • 安装包:检测当前架构匹配的安装包
  • 输出:统计 PASS/WARN/FAIL,并给出开始安装或修复建议
  • pre_check.sh

章节来源

  • pre_check.sh

安装脚本(install_tidb_offline.sh)

  • 功能:自动化完成离线安装的全流程
  • 关键流程:
    • 权限检查:需要 root
    • 已有安装检查:支持清理旧安装或保留数据
    • 系统检查:CPU/内存/磁盘空间
    • 用户创建:优先 tidb 用户,否则使用 root
    • 目录创建:安装目录、数据目录、日志目录
    • 安装包解压:自动检测架构并解压对应组件
    • 配置生成:生成 PD/TiKV/TiDB 配置文件
    • systemd 服务:生成服务文件并启用开机自启
    • 系统参数:禁用 SELinux、透明大页,设置 ulimit、sysctl
    • 管理脚本:生成 start/stop/check 脚本
    • 启动集群:按 PD→TiKV→TiDB 顺序启动并轮询健康状态
    • 状态检查:输出各组件状态与连接信息
  • 注意事项:
    • 安装包必须与脚本在同一目录
    • 需要 root 权限
    • 端口占用与磁盘空间不足会导致启动失败
    • 建议关闭防火墙或放行必要端口
  • install_tidb_offline.sh
  • install_tidb_offline.sh

章节来源

  • install_tidb_offline.sh

安装包检查脚本(check_package.sh)

  • 功能:列出安装包内容并校验关键二进制文件(pd-server、tikv-server、tidb-server)
  • 使用场景:在离线环境中提前验证安装包完整性与内容

章节来源

  • check_package.sh

卸载脚本(uninstall_tidb.sh)

  • 功能:智能识别安装痕迹,支持“完全卸载(含数据)/仅卸载程序(保留数据)”
  • 关键流程:
    • 自动侦测安装路径、数据目录、日志目录与运行中的服务
    • 停止服务、禁用服务、删除 systemd 文件
    • 删除安装目录、日志目录与(可选)数据目录
    • 清理用户与残留进程

章节来源

  • uninstall_tidb.sh

密码变更示例(chan_pass)

  • 提供 root 密码变更语句与刷新权限的示例,便于安装后立即加固安全

章节来源

  • chan_pass

依赖关系分析

  • 安装脚本依赖环境检查脚本提供的系统兼容性保障
  • 安装包检查脚本用于提前验证离线包内容
  • 卸载脚本用于清理与重装场景
  • 文档(QUICKSTART 与 README)提供操作步骤与连接测试指引
  • pre_check.sh
  • install_tidb_offline.sh
  • check_package.sh
  • uninstall_tidb.sh
  • QUICKSTART.md
  • README.md

章节来源

  • pre_check.sh
  • install_tidb_offline.sh
  • check_package.sh
  • uninstall_tidb.sh
  • QUICKSTART.md
  • README.md

性能考虑

  • 关闭透明大页与 NUMA 平衡,提升性能稳定性
  • 调整 I/O 调度器(SSD 场景)与文件句柄上限
  • 使用 SSD 磁盘并预留充足空间(建议 500GB+)
  • 单机部署不提供高可用,生产环境建议使用 TiUP 多机集群

章节来源

  • README.md

故障排查指南

  • PD 启动失败:检查端口占用、磁盘空间、数据目录权限与防火墙/SELinux
  • TiKV 无法连接 PD:检查 PD 健康状态与 TiKV 配置中的 endpoints
  • TiDB 连接失败:检查 TiDB 进程与 4000 端口监听,查看日志
  • 完全重置:停止所有服务、清理数据目录、重新启动

章节来源

  • QUICKSTART.md
  • README.md

结论

本指南基于仓库内的脚本与文档,提供了从系统要求检查、离线包准备到安装与验证的完整流程。通过环境检查脚本与安装脚本的配合,用户可以在单台服务器上快速完成 TiDB 的离线部署,并通过文档中的连接测试与常用管理命令进行基础验证与运维。

附录

三步快速部署(来自快速开始)

  • 准备阶段:确认系统架构、下载对应离线安装包、上传到目标服务器
  • 安装阶段:赋予执行权限、运行环境检查、执行安装脚本
  • 验证阶段:检查集群状态、使用 MySQL 客户端连接并执行基础查询

章节来源

  • QUICKSTART.md

常用管理命令(来自快速开始)

  • 启动/停止/检查集群
  • 设置开机自启
  • 查看日志

章节来源

  • QUICKSTART.md

连接信息与端口(来自快速开始)

  • TiDB SQL 端口:4000
  • TiDB 状态端口:10080
  • PD Dashboard:2379

章节来源

  • QUICKSTART.md

安全加固(来自详细文档)

  • 设置 root 密码
  • 创建应用用户并授权
  • 配置防火墙仅允许本地访问

章节来源

  • README.md

本文引用的文件

  • QUICKSTART.md
  • README.md
  • install_tidb_offline.sh
  • pre_check.sh
  • check_package.sh
  • uninstall_tidb.sh
  • chan_pass

最新文章

随机文章