在知识库中专注阅读，并随时返回相关工具与课程
@TOC目录 tiup 镜像为部署集群或通过 tiup 执行相关工具的源，可以是本地的离线镜像（本地的一个目录）或远程镜像（官方镜像 https://tiup-mirrors.pingcap.com）。 在 TiDB 官方文档中，建议联网安装 TiUP 组件： bash root@lucifer ~ curl --proto '=https' --tlsv1.2 -sSf https://tiup
本章目标：掌握本章核心知识点 前置要求：完成前序章节学习 预计时长：60 分钟
tiup 镜像为部署集群或通过 tiup 执行相关工具的源，可以是本地的离线镜像（本地的一个目录）或远程镜像（官方镜像 https://tiup-mirrors.pingcap.com）。
在 TiDB 官方文档中，建议联网安装 TiUP 组件：
1[root@lucifer ~]# curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh但是很多内网环境不支持外网连接，即使是临时开通部署后，后续运维也可能会遇到报错：
1failed to start: fetch /timestamp.json from mirror(https://tiup-mirrors.pingcap.com) failed: download from https://tiup-mirrors.pingcap.com/timestamp.json failed: Get “https://tiup-mirrors.pingcap.com/timestamp.json”: dial tcp: lookup tiup-mirrors.pingcap.com on 114.114.114.114:53: read udp 192.168.52.2:44673->114.114.114.114:53: i/o timeout查看镜像源配置：
1## 代表为官方镜像源2[root@lucifer ~]# tiup mirror show3https://tiup-mirrors.pingcap.com建议内网环境部署完成后，切换为本地离线镜像源，方便运维。
首先，找一台可以连接外网的主机，在线安装 TiUP 包管理器工具：
1[root@lucifer ~]# curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh确保 tiup 已经成功安装：
1[root@lucifer ~]# source .bash_profile2[root@lucifer ~]# tiup --version31.16.2 tiup4Go Version: go1.21.135Git Ref: v1.16.26GitHash: 678c52de0c0ef30634b8ba7302a8376caa95d50d使用 tiup mirror clone 命令手动拉取需要的组件：
1## 定义对应版本，我这里是 v8.5.32[root@lucifer ~]# version=v8.5.33[root@lucifer ~]# tiup mirror clone tidb-community-server-${version}-linux-amd64 ${version} --os=linux --arch=amd64通过 tar 命令打包离线组件包：
1[root@lucifer ~]# tar czvf tidb-community-server-${version}-linux-amd64.tar.gz tidb-community-server-${version}-linux-amd642tidb-community-server-v8.5.3-linux-amd64/3tidb-community-server-v8.5.3-linux-amd64/prometheus-v8.5.3-linux-amd64.tar.gz4tidb-community-server-v8.5.3-linux-amd64/tispark-v2.4.1-any-any.tar.gz5tidb-community-server-v8.5.3-linux-amd64/alertmanager-v0.26.0-linux-amd64.tar.gz6tidb-community-server-v8.5.3-linux-amd64/PCC-v1.0.2-linux-amd64.tar.gz7tidb-community-server-v8.5.3-linux-amd64/insight-v0.4.2-linux-amd64.tar.gz8tidb-community-server-v8.5.3-linux-amd64/82.tikv-importer.json9tidb-community-server-v8.5.3-linux-amd64/3738.dmctl.json10tidb-community-server-v8.5.3-linux-amd64/1.index.json11tidb-community-server-v8.5.3-linux-amd64/5768.grafana.json12tidb-community-server-v8.5.3-linux-amd64/dmctl-v8.5.3-linux-amd64.tar.gz13tidb-community-server-v8.5.3-linux-amd64/influxdb-v2.5.0-linux-amd64.tar.gz14tidb-community-server-v8.5.3-linux-amd64/pd-recover-v8.5.3-linux-amd64.tar.gz15tidb-community-server-v8.5.3-linux-amd64/demo-v0.0.11-linux-amd64.tar.gz16tidb-community-server-v8.5.3-linux-amd64/spark-v2.4.3-any-any.tar.gz17tidb-community-server-v8.5.3-linux-amd64/715.bench.json18tidb-community-server-v8.5.3-linux-amd64/183.sync-diff-inspector.json19tidb-community-server-v8.5.3-linux-amd64/1180.tiup.json20tidb-community-server-v8.5.3-linux-amd64/pd-v8.5.3-linux-amd64.tar.gz21tidb-community-server-v8.5.3-linux-amd64/tiproxy-v1.3.2-linux-amd64.tar.gz22tidb-community-server-v8.5.3-linux-amd64/tiflash-v8.5.3-linux-amd64.tar.gz23tidb-community-server-v8.5.3-linux-amd64/6953.pd-recover.json24tidb-community-server-v8.5.3-linux-amd64/tiup-linux-amd64.tar.gz25tidb-community-server-v8.5.3-linux-amd64/11283.dumpling.json26tidb-community-server-v8.5.3-linux-amd64/4863.pump.json27tidb-community-server-v8.5.3-linux-amd64/10.errdoc.json28tidb-community-server-v8.5.3-linux-amd64/blackbox_exporter-v0.23.0-linux-amd64.tar.gz29tidb-community-server-v8.5.3-linux-amd64/sync-diff-inspector-v9.0.0-beta.1-linux-amd64.tar.gz30tidb-community-server-v8.5.3-linux-amd64/drainer-v8.3.0-linux-amd64.tar.gz31tidb-community-server-v8.5.3-linux-amd64/server-v1.16.2-linux-amd64.tar.gz32tidb-community-server-v8.5.3-linux-amd64/9609.ctl.json33tidb-community-server-v8.5.3-linux-amd64/tikv-importer-v4.0.2-linux-amd64.tar.gz34tidb-community-server-v8.5.3-linux-amd64/9.blackbox_exporter.json35tidb-community-server-v8.5.3-linux-amd64/package-v0.0.9-linux-amd64.tar.gz36tidb-community-server-v8.5.3-linux-amd64/tidb-lightning-v8.5.3-linux-amd64.tar.gz37tidb-community-server-v8.5.3-linux-amd64/11.PCC.json38tidb-community-server-v8.5.3-linux-amd64/cluster-v1.16.2-linux-amd64.tar.gz39tidb-community-server-v8.5.3-linux-amd64/dm-master-v8.5.3-linux-amd64.tar.gz40tidb-community-server-v8.5.3-linux-amd64/snapshot.json41tidb-community-server-v8.5.3-linux-amd64/17.tispark.json42tidb-community-server-v8.5.3-linux-amd64/pump-v8.3.0-linux-amd64.tar.gz43tidb-community-server-v8.5.3-linux-amd64/dba-v1.0.4-linux-amd64.tar.gz44tidb-community-server-v8.5.3-linux-amd64/tidb-v8.5.3-linux-amd64.tar.gz45tidb-community-server-v8.5.3-linux-amd64/6.tikv-br.json46tidb-community-server-v8.5.3-linux-amd64/br-v8.5.3-linux-amd64.tar.gz47tidb-community-server-v8.5.3-linux-amd64/40.demo.json48tidb-community-server-v8.5.3-linux-amd64/11356.tidb-lightning.json49tidb-community-server-v8.5.3-linux-amd64/1.root.json50tidb-community-server-v8.5.3-linux-amd64/diag-v1.6.0-linux-amd64.tar.gz51tidb-community-server-v8.5.3-linux-amd64/3.package.json52tidb-community-server-v8.5.3-linux-amd64/tikv-cdc-v1.1.1-linux-amd64.tar.gz53tidb-community-server-v8.5.3-linux-amd64/18.insight.json54tidb-community-server-v8.5.3-linux-amd64/7.alertmanager.json55tidb-community-server-v8.5.3-linux-amd64/6950.cdc.json56tidb-community-server-v8.5.3-linux-amd64/bench-v1.12.0-linux-amd64.tar.gz57tidb-community-server-v8.5.3-linux-amd64/pushgateway-v0.7.0-linux-amd64.tar.gz58tidb-community-server-v8.5.3-linux-amd64/keys/59tidb-community-server-v8.5.3-linux-amd64/keys/260cacafffd26c47-snapshot.json60tidb-community-server-v8.5.3-linux-amd64/keys/518ba018508a1d66-root.json61tidb-community-server-v8.5.3-linux-amd64/keys/aac1ca97e377f6d2-root.json62tidb-community-server-v8.5.3-linux-amd64/keys/5aceabfad76e9981-index.json63tidb-community-server-v8.5.3-linux-amd64/keys/8c45deaddd757516-pingcap.json64tidb-community-server-v8.5.3-linux-amd64/keys/7b0cbab4be036527-timestamp.json65tidb-community-server-v8.5.3-linux-amd64/keys/dc36ee9e5bc7dcd9-root.json66tidb-community-server-v8.5.3-linux-amd64/dm-v1.16.2-linux-amd64.tar.gz67tidb-community-server-v8.5.3-linux-amd64/4834.drainer.json68tidb-community-server-v8.5.3-linux-amd64/1089.playground.json69tidb-community-server-v8.5.3-linux-amd64/1030.server.json70tidb-community-server-v8.5.3-linux-amd64/1014.client.json71tidb-community-server-v8.5.3-linux-amd64/6966.pd.json72tidb-community-server-v8.5.3-linux-amd64/3749.dm-master.json73tidb-community-server-v8.5.3-linux-amd64/5.pushgateway.json74tidb-community-server-v8.5.3-linux-amd64/tikv-br-v1.1.0-linux-amd64.tar.gz75tidb-community-server-v8.5.3-linux-amd64/tikv-v8.5.3-linux-amd64.tar.gz76tidb-community-server-v8.5.3-linux-amd64/ctl-v8.5.3-linux-amd64.tar.gz77tidb-community-server-v8.5.3-linux-amd64/764.tiproxy.json78tidb-community-server-v8.5.3-linux-amd64/6374.tiflash.json79tidb-community-server-v8.5.3-linux-amd64/dm-worker-v8.5.3-linux-amd64.tar.gz80tidb-community-server-v8.5.3-linux-amd64/5.chaosd.json81tidb-community-server-v8.5.3-linux-amd64/root.json82tidb-community-server-v8.5.3-linux-amd64/3747.dm-worker.json83tidb-community-server-v8.5.3-linux-amd64/errdoc-v4.0.7-linux-amd64.tar.gz84tidb-community-server-v8.5.3-linux-amd64/tidb-dashboard-v8.5.3-linux-amd64.tar.gz85tidb-community-server-v8.5.3-linux-amd64/5821.prometheus.json86tidb-community-server-v8.5.3-linux-amd64/7.influxdb.json87tidb-community-server-v8.5.3-linux-amd64/4.dba.json88tidb-community-server-v8.5.3-linux-amd64/playground-v1.16.2-linux-amd64.tar.gz89tidb-community-server-v8.5.3-linux-amd64/1077.dm.json90tidb-community-server-v8.5.3-linux-amd64/dumpling-v8.5.3-linux-amd64.tar.gz91tidb-community-server-v8.5.3-linux-amd64/chaosd-v1.1.1-linux-amd64.tar.gz92tidb-community-server-v8.5.3-linux-amd64/grafana-v8.5.3-linux-amd64.tar.gz93tidb-community-server-v8.5.3-linux-amd64/2.spark.json94tidb-community-server-v8.5.3-linux-amd64/local_install.sh95tidb-community-server-v8.5.3-linux-amd64/client-v1.16.2-linux-amd64.tar.gz96tidb-community-server-v8.5.3-linux-amd64/4.tikv-cdc.json97tidb-community-server-v8.5.3-linux-amd64/tiup-v1.16.2-linux-amd64.tar.gz98tidb-community-server-v8.5.3-linux-amd64/113.cloud.json99tidb-community-server-v8.5.3-linux-amd64/cdc-v8.5.3-linux-amd64.tar.gz100tidb-community-server-v8.5.3-linux-amd64/1173.cluster.json101tidb-community-server-v8.5.3-linux-amd64/6604.tikv.json102tidb-community-server-v8.5.3-linux-amd64/9.node_exporter.json103tidb-community-server-v8.5.3-linux-amd64/cloud-v1.0.0-beta.5-linux-amd64.tar.gz104tidb-community-server-v8.5.3-linux-amd64/timestamp.json105tidb-community-server-v8.5.3-linux-amd64/2240.diag.json106tidb-community-server-v8.5.3-linux-amd64/node_exporter-v1.5.0-linux-amd64.tar.gz107tidb-community-server-v8.5.3-linux-amd64/482.tidb-dashboard.json108tidb-community-server-v8.5.3-linux-amd64/11366.br.json109tidb-community-server-v8.5.3-linux-amd64/11059.tidb.json110111[root@lucifer ~]# ll tidb-community-server-v8.5.3-linux-amd64.tar.gz112-rw-r--r-- 1 root root 3207855391 Aug 26 09:53 tidb-community-server-v8.5.3-linux-amd64.tar.gz此时，tidb-community-server-v8.5.3-linux-amd64.tar.gz 就是一个独立的离线环境包。
将离线包发送到目标集群的中控机：
1[root@prod1 ~]# scp 192.168.31.222:/data/tidb-community-server-v8.5.3-linux-amd64.tar.gz .2root@192.168.31.222's password:3tidb-community-server-v8.5.3-linux-amd64.tar.gz 100% 3059MB 160.0MB/s 00:19执行以下命令安装 TiUP 组件：
1## 解压离线环境包2[root@prod1 ~]# tar -xf tidb-community-server-v8.5.3-linux-amd64.tar.gz34## local_install.sh 脚本会自动执行设置当前镜像地址为离线镜像源5[root@prod1 ~]# sh tidb-community-server-v8.5.3-linux-amd64/local_install.sh 67Detected shell: bash8Shell profile: /root/.bash_profile910✔ Installed in /root/.tiup/bin/tiup11✔ tiup PATH is already set, skip1213tiup is installed now 🎉1415Next step:1617 1: To make PATH change effective, restart your shell or execute:18 source /root/.bash_profile1920 2: Start a local TiDB for development:21 tiup playground2223## 生效环境变量24[root@prod1 ~]# source /root/.bash_profile查看 tiup 版本：
1[root@prod1 ~]# tiup --version21.16.2 v1.16.2-nightly-393Go Version: go1.24.14Git Ref: master5GitHash: f6aa0ac09b9d6405929c2cea3c0207880e53d199查看可用组件：
1[root@prod1 ~]# tiup list2Available components:3Name Owner Description4---- ----- -----------5PCC pingcap A tool used to capture plan changes among different versions of TiDB6alertmanager pingcap Prometheus alertmanager7bench pingcap Benchmark database with different workloads8blackbox_exporter pingcap Blackbox prober exporter9br pingcap TiDB/TiKV cluster backup restore tool.10cdc pingcap CDC is a change data capture tool for TiDB11chaosd pingcap An easy-to-use Chaos Engineering tool used to inject failures to a physical node12client pingcap Client to connect playground13cloud pingcap CLI tool to manage TiDB Cloud14cluster pingcap Deploy a TiDB cluster for production15ctl pingcap TiDB controller suite16dba pingcap dbatoolset17demo pingcap The dataset import tools for the demo of TiDB18diag pingcap Clinic client for data collection and quick health check19dm pingcap Data Migration Platform manager20dm-master pingcap dm-master component of Data Migration Platform.21dm-worker pingcap dm-worker component of Data Migration Platform.22dmctl pingcap dmctl component of Data Migration Platform.23drainer pingcap The drainer componet of TiDB binlog service24dumpling pingcap Dumpling is a CLI tool that helps you dump MySQL/TiDB data.25errdoc pingcap Document about TiDB errors26grafana pingcap Grafana is the open source analytics \u0026 monitoring solution for every database27influxdb pingcap InfluxDB28insight pingcap TiDB-Insight collector29node_exporter pingcap Exporter for machine metrics30package pingcap A toolbox to package tiup component31pd pingcap PD is the abbreviation for Placement Driver. It is used to manage and schedule the TiKV cluster.32pd-recover pingcap PD Recover is a disaster recovery tool of PD, used to recover the PD cluster which cannot start or provide services normally.33playground pingcap Bootstrap a local TiDB cluster for fun34prometheus pingcap The Prometheus monitoring system and time series database35pump pingcap The pump componet of TiDB binlog service36pushgateway pingcap Push acceptor for ephemeral and batch jobs37server pingcap TiUP publish/cache server38spark pingcap Spark is a fast and general cluster computing system for Big Data39sync-diff-inspector pingcap sync-diff-inspector is a tool used to verify the consistency across different MySQL-compatible data sources.40tidb pingcap TiDB is an open source distributed HTAP database compatible with the MySQL protocol.41tidb-dashboard pingcap TiDB Dashboard is a Web UI for monitoring, diagnosing, and managing the TiDB cluster42tidb-lightning pingcap TiDB Lightning is a tool used for fast full import of large amounts of data into a TiDB cluster43tiflash pingcap The TiFlash Columnar Storage Engine44tikv pingcap Distributed transactional key-value database, originally created to complement TiDB.45tikv-br pingcap TiKV cluster backup restore tool46tikv-cdc pingcap TiKV-CDC is a change data capture tool for TiKV47tikv-importer pingcap48tiproxy pingcap TiProxy is a database proxy that is based on TiDB.49tispark pingcap tispark50tiup pingcap TiUP is a command-line component management tool that can help to download and install TiDB platform components to the local system检查当前镜像源：
1[root@prod1 ~]# tiup mirror show2/root/tidb-community-server-v8.5.3-linux-amd64已经切换为本地离线镜像源。