脚本下载链接:https://pan.baidu.com/s/1xMtR3HOdJsnJ20qHRmw2VQ?pwd=e09i 提取码:e09i 复制这段内容后打开百度网盘手机App,操作更方便哦
简介
本指南面向希望在单台 Linux 服务器上离线部署 TiDB 的用户,提供从零开始的完整流程:系统要求检查、离线安装包准备、执行安装、基础连接验证与常见初始配置。文档兼顾初学者的逐步指导与有经验用户的快速参考,所有命令均来自仓库内的脚本与文档,确保可重复性与准确性。
项目结构
该仓库包含一套完整的离线安装与运维脚本,以及配套的快速开始与详细说明文档:
- 详细文档:涵盖硬件/系统要求、目录结构、管理命令、监控访问、故障排查、高级配置与安全加固
- 安装脚本:自动检测架构、解压安装包、生成配置与 systemd 服务、启动集群并输出状态
- 环境检查脚本:对权限、系统、硬件、网络、端口、系统设置、依赖与安装包进行综合检查
- 安装包检查脚本:列出安装包内容并校验关键二进制文件
- 卸载脚本:智能识别安装痕迹并提供“完全卸载/仅卸载程序”两种模式
- 密码变更示例:提供 root 密码变更语句(需结合实际使用)
章节来源
核心组件
- 环境检查脚本:对系统架构、操作系统版本、内核版本、硬件资源、网络连通、端口占用、系统设置、依赖与安装包进行逐项检查,输出 PASS/WARN/FAIL 并给出修复建议
- 安装脚本:自动检测架构、解压安装包、生成配置与 systemd 服务、配置系统参数、生成管理脚本、启动集群并输出状态
- 安装包检查脚本:列出安装包内容并校验关键二进制文件(pd-server、tikv-server、tidb-server)
- 卸载脚本:智能识别安装痕迹,支持“完全卸载(含数据)/仅卸载程序(保留数据)”
- 快速开始与详细文档:提供三步法、连接测试、常用管理命令、故障排查与安全加固
章节来源
架构总览
离线安装脚本会自动检测系统架构(x86_64/amd64 或 aarch64/arm64),并据此选择对应的安装包。安装完成后,生成如下目录结构与服务:
- 安装目录:/opt/tidb(包含二进制、配置、管理脚本)
- 日志目录:/var/log/tidb(按组件划分)
- systemd 服务:pd1/pd2/pd3、tikv1/tikv2/tikv3、tidb1(含开机自启)
章节来源
详细组件分析
环境检查脚本(pre_check.sh)
- 功能:对权限、系统、硬件、网络、端口、系统设置、依赖与安装包进行综合检查
- 系统:架构支持(x86_64/amd64、ARM64/aarch64)、操作系统版本(CentOS/RHEL 7+、Ubuntu 18.04+、Debian 9+)、内核版本 3.10+
- 系统设置:透明大页、Swap、文件句柄限制、SELinux、防火墙
- 依赖:tar、gzip、systemctl 等必备命令;可选 mysql、curl、wget
- 输出:统计 PASS/WARN/FAIL,并给出开始安装或修复建议
章节来源
安装脚本(install_tidb_offline.sh)
- 用户创建:优先 tidb 用户,否则使用 root
- 配置生成:生成 PD/TiKV/TiDB 配置文件
- 系统参数:禁用 SELinux、透明大页,设置 ulimit、sysctl
- 管理脚本:生成 start/stop/check 脚本
- 启动集群:按 PD→TiKV→TiDB 顺序启动并轮询健康状态
章节来源
安装包检查脚本(check_package.sh)
- 功能:列出安装包内容并校验关键二进制文件(pd-server、tikv-server、tidb-server)
章节来源
卸载脚本(uninstall_tidb.sh)
- 功能:智能识别安装痕迹,支持“完全卸载(含数据)/仅卸载程序(保留数据)”
- 自动侦测安装路径、数据目录、日志目录与运行中的服务
章节来源
密码变更示例(chan_pass)
- 提供 root 密码变更语句与刷新权限的示例,便于安装后立即加固安全
章节来源
依赖关系分析
- 文档(QUICKSTART 与 README)提供操作步骤与连接测试指引
章节来源
性能考虑
- 调整 I/O 调度器(SSD 场景)与文件句柄上限
- 使用 SSD 磁盘并预留充足空间(建议 500GB+)
- 单机部署不提供高可用,生产环境建议使用 TiUP 多机集群
章节来源
故障排查指南
- PD 启动失败:检查端口占用、磁盘空间、数据目录权限与防火墙/SELinux
- TiKV 无法连接 PD:检查 PD 健康状态与 TiKV 配置中的 endpoints
- TiDB 连接失败:检查 TiDB 进程与 4000 端口监听,查看日志
章节来源
结论
本指南基于仓库内的脚本与文档,提供了从系统要求检查、离线包准备到安装与验证的完整流程。通过环境检查脚本与安装脚本的配合,用户可以在单台服务器上快速完成 TiDB 的离线部署,并通过文档中的连接测试与常用管理命令进行基础验证与运维。
附录
三步快速部署(来自快速开始)
- 准备阶段:确认系统架构、下载对应离线安装包、上传到目标服务器
- 安装阶段:赋予执行权限、运行环境检查、执行安装脚本
- 验证阶段:检查集群状态、使用 MySQL 客户端连接并执行基础查询
章节来源
常用管理命令(来自快速开始)
章节来源
连接信息与端口(来自快速开始)
章节来源
安全加固(来自详细文档)
章节来源
本文引用的文件