LinuxOps

函数与数组

Thu, 02 Jul 2026 00:00:00 GMT

函数 && 数组#

[TOC]

函数#

基本概念#

变量是一个名字对应一个值，==函数是一个名字对应一堆命令==——把完成特定功能的代码块打个包、起个名，需要时喊名字就行

Terminal window

1
# 函数只定义、不调用则不执行
2
函数名(){
3
    命令集
4
}
5
# 函数必须先定义再调用
6
# 函数名不能和系统命令重名

Important

📌 ==变量==是一个名字对应一个值 📌 ==函数==是一个名字对应一堆命令

把重复的活儿打包成函数，一次定义，到处调用

1) 函数定义的三种方式#

1
[root@shell ~]#cat fun.sh
2
#!/bin/bash
3
fun1(){
4
    echo "第一种定义方法"
5
}
6
# 最常用写法——函数名+()+{}
7

8
function fun2(){
9
    echo "第二种定义方法"
10
}
11
# 加function关键字，更像其他语言
12

13
function fun3 {
14
    echo "第三种定义方式"
15
}
16
# function + 函数名 + {命令}，省略括号
17

18
fun1
19
fun2
20
fun3
21
# 调用函数——喊名字就执行里面的全部命令
22
'三种写法等效，第一种最简洁，也是最常用的'

展开收起

2) 函数的传参#

函数传参有三种方式——和脚本传参是同一套逻辑

方法1：在函数后传参（位置参数）#

1
1)传一个参数——$1
2
[root@shell ~]#cat fun.sh
3
#!/bin/bash
4
fun(){
5
    if [ -f $1 ];then
6
        echo $1 存在
7
    else
8
        echo $1 不存在
9
    fi
10
}
11
fun /etc/hosts
12
[root@shell ~]#sh fun.sh
13
/etc/hosts 存在
14
# fun后跟参数，函数内用$1接收
15
'函数传参和脚本传参一样——$1 $2 $3...'
16

17
========================================
18
2)传多个参数——$1 $2
19
========================================
20
[root@shell ~]#cat fun.sh
21
#!/bin/bash
22
fun(){
23
    if [ -f $2 ];then
24
        echo $2 存在
25
    else
26
        echo $2 不存在
27
    fi
28
}
29
fun /etc/hosts /etc/passwd
30
[root@shell ~]#sh fun.sh
31
/etc/passwd 存在
32
# 传了两个参数，函数内取$2
33

34
========================================
35
3)脚本参数和函数参数的关系
36
========================================
37
[root@shell ~]#cat fun.sh
38
#!/bin/bash
39
fun(){
40
    if [ -f $2 ];then
41
        echo $2 存在
42
    else
43
        echo $2 不存在
44
    fi
45
}
46
fun $2 $1
47
[root@shell ~]#sh fun.sh /etc/hosts /etc/passwd
48
/etc/hosts 存在
49
# 脚本的$1=/etc/hosts $2=/etc/passwd
50
# fun $2 $1 → fun /etc/passwd /etc/hosts
51
# 函数内$1=/etc/passwd $2=/etc/hosts
52
'脚本的$1和函数的$1是两个不同的东西——看谁传的'
53
⚠️ 函数内部$1取的是函数参数，不是脚本参数

展开收起

方法2：通过赋值传参#

1
4)变量赋值传参
2
[root@shell ~]#cat fun.sh
3
#!/bin/bash
4
file=$1                 # 脚本的$1赋给变量file
5
fun(){
6
    if [ -f $file ];then
7
        echo $file 存在
8
    else
9
        echo $file 不存在
10
    fi
11
}
12
fun
13
[root@shell ~]#sh fun.sh /etc/hosts
14
/etc/hosts 存在
15
[root@shell ~]#sh fun.sh /etc/hostsssssssssssss
16
/etc/hostsssssssssssss 不存在
17
# 变量在函数外定义，函数内直接引用
18
'函数可以访问外部变量——通过变量桥接传参，灵活方便'

展开收起

方法3：通过read读入传参#

1
5)read交互传参
2
[root@shell ~]#cat fun.sh
3
#!/bin/bash
4
read -p "请输入文件名称: " file
5
fun(){
6
    if [ -f $file ];then
7
        echo $file 存在
8
    else
9
        echo $file 不存在
10
    fi
11
}
12
fun
13
# read读入存到file变量，函数内直接引用

传参方式	特点	适用场景
函数后传参 `fun $1 $2`	位置参数，函数内用 `$1` `$2`	参数少、调用链清晰
赋值传参 `file=$1`	变量桥接，函数内外共享	参数多、多个函数共用
read读入	交互式，运行时输入	需要人工确认的场景

3) 函数的变量——local#

1
1)函数内不加local——变量泄露到外部
2
[root@shell ~]#cat fun.sh
3
#!/bin/bash
4
fun(){
5
    name=oldboy
6
}
7
fun
8
echo $name
9
[root@shell ~]#sh fun.sh
10
oldboy
11
# 函数内定义的变量，函数外也能访问——变量泄露了
12
'不加local，函数内的变量会跑到外面去'
13

14
========================================
15
2)函数外加local——只在本函数内生效
16
========================================
17
[root@shell ~]#cat fun.sh
18
#!/bin/bash
19
name=oldboy
20
fun1(){
21
    local name=oldgirl    # local限定了作用域
22
}
23
fun1
24
echo $name
25
[root@shell ~]#sh fun.sh
26
oldboy
27
# 加了local，函数内的name=oldgirl不影响外部的name=oldboy
28
'local像一堵墙——函数内的变量出不去，外部的变量也进不来（同名时）'
29

30
========================================
31
3)函数访问外部变量——默认可以
32
========================================
33
[root@shell ~]#cat fun.sh
34
#!/bin/bash
35
name=oldboy              # 外部定义
36
fun(){
37
    echo $name           # 函数内可以读到外部变量
38
}
39
fun
40
[root@shell ~]#sh fun.sh
41
oldboy
42
# 函数默认可以读取外部变量——除非函数内用local定义了同名变量

展开收起

📌 核心：

函数默认能访问外部变量
local 关键字将变量作用域限定在函数内部，防止变量污染
函数内不加 local 定义的变量，函数执行完后外部也能用

4) 函数的返回值#

函数通过 return 或 exit 自定义 $? 的值，数字范围 0-255

exit 方式#

1
1)exit自定义$?
2
[root@shell ~]#cat fun.sh
3
#!/bin/bash
4
fun1(){
5
    if [ -f $1 ];then
6
        exit 50
7
    else
8
        exit 100
9
    fi
10
}
11
fun1 $1
12
[root@shell ~]#sh fun.sh /etc/hosts
13
[root@shell ~]#echo $?
14
50
15
[root@shell ~]#sh fun.sh /etc/hostssssssssss
16
[root@shell ~]#echo $?
17
100
18
# exit直接退出脚本并设置$? 文件存在→50 不存在→100
19
⚠️ exit会终止整个脚本，不只是退出函数

展开收起

return 方式#

1
2)return返回$?——更推荐的方式
2
[root@shell ~]#cat fun.sh
3
#!/bin/bash
4
fun1(){
5
    if [ -f $1 ];then
6
        return 50
7
    else
8
        return 100
9
    fi
10
}
11
fun1 $1
12
[root@shell ~]#sh fun.sh /etc/hosts
13
[root@shell ~]#echo $?
14
50
15
[root@shell ~]#sh fun.sh /etc/hostssss
16
[root@shell ~]#echo $?
17
100
18
# return只退出函数，不影响脚本后续执行
19
✅️ 函数内用return，脚本内用exit——各管各的

展开收起

错误示范——$? 只能取一次#

1
3)错误写法——$?被覆盖
2
[root@shell ~]#cat fun.sh
3
#!/bin/bash
4
fun1(){
5
    if [ -f $1 ];then
6
        return 50
7
    else
8
        return 100
9
    fi
10
}
11
fun1 $1
12
[ $? -eq 50 ] && echo 文件存在
13
[ $? -eq 100 ] && echo 文件不存在
14
# ❌ 第一个[ $? -eq 50 ]执行后$?变成了它自己的返回值(0或1)
15
# 第二个[ $? -eq 100 ]取到的是上一个判断的结果，不是return的值
16

17
========================================
18
4)正确写法——先保存$?到变量
19
========================================
20
[root@shell ~]#cat fun.sh
21
#!/bin/bash
22
fun1(){
23
    if [ -f $1 ];then
24
        return 50
25
    else
26
        return 100
27
    fi
28
}
29
fun1 $1
30
re=$?                  # 第一时间把$?存到变量
31
if [ $re -eq 50 ];then
32
    echo $1文件存在
33
elif [ $re -eq 100 ];then
34
    echo $1文件不存在
35
fi
36
[root@shell ~]#sh fun.sh /etc/hosts
37
/etc/hosts文件存在
38
[root@shell ~]#sh fun.sh /etc/hostssss
39
/etc/hostssss文件不存在
40
# $?是一次性的——读到变量里保存起来，后面才能反复用
41

42
========================================
43
5)简化写法——用 && ||
44
========================================
45
[ $? -eq 50 ] && echo $1文件存在 || echo $1文件不存在
46
# 简单场景下 && || 一行搞定

展开收起

📌 核心：$? 每次执行命令都会更新——==拿到立刻存变量==，否则就丢了

5) 主函数#

将各个功能函数集合到 main() 中统一调度——代码结构清晰，便于维护

1
1)主函数调度——代码备份到远程服务器
2
[root@shell ~]#cat fun.sh
3
#!/bin/bash
4
code_dir=`hostname`_`hostname -I|awk '{print $1}'`_`date +%F-%H-%M-%S`
5
ip=172.16.1.7
6
# 目录名：主机名_IP_时间戳 —— 唯一标识
7

8
DIR(){
9
    mkdir /opt/$code_dir
10
}
11
# 创建备份目录
12

13
TAR(){
14
    cd /etc
15
    tar zcf /opt/$code_dir/code.tar.gz hosts passwd
16
}
17
# 打包要备份的文件
18

19
COPY(){
20
    scp -r /opt/$code_dir/ $ip:/opt/ &>/dev/null
21
}
22
# scp传送到远程服务器
23

24
UN_TAR(){
25
    ssh $ip "cd /opt/$code_dir/ && tar xf code.tar.gz" &>/dev/null
26
}
27
# 远程解压
28

29
RM(){
30
    ssh $ip "find /opt/ -mtime +7|xargs rm -rf" &>/dev/null
31
}
32
# 清理7天前的旧备份
33

34
main(){
35
    DIR
36
    TAR
37
    COPY
38
    UN_TAR
39
    RM
40
}
41
main
42
# main按顺序调用所有函数——就像调度中心
43
'每个函数干一件事，main统一指挥——思路清晰，改哪里找哪里'
44
✅️ 主函数模式：函数拆功能 + main编排流程 = 企业级脚本结构

展开收起

Tip

💡 主函数设计思想：（1）每个函数只做一件事——单一职责（2）main 函数编排调用顺序——流程一目了然（3）要加功能就加一个函数，在 main 里插一行——扩展成本极低

数组#

基本概念#

概念	说明	类比
变量	一个名字对应==一个值==	箱子1 = 🍎
数组	一个名字对应==多个值==	箱子1 = [盒子1]=🍎, [盒子2]=🍌, [盒子3]=🍐

Terminal window

1
# 数组的语法
2
数组名称[索引]=值
3
数组名称[下标]=值
4
数组名称[元素名]=值

数组分类#

类型	索引方式	声明
普通数组	只能以数字作为索引	默认即是，`declare -a`
关联数组	可以用数字和字符串作为索引	`declare -A`

定义数组的4种方法#

Terminal window展开收起

1
1)方法1：使用索引一个一个定义
2
[root@shell ~]#declare -a array        # 声明为普通数组（默认就是）
3
[root@shell ~]#array[1]=shell
4
[root@shell ~]#array[2]=awk
5
[root@shell ~]#array[3]=sed
6
# 逐个指定索引赋值——索引可以跳号
7

8
========================================
9
2)方法2：直接一行定义
10
========================================
11
[root@shell ~]#unset array
12
[root@shell ~]#array=(awk sed grep find zabbix)
13
[root@shell ~]#echo ${array[*]}
14
awk sed grep find zabbix
15
[root@shell ~]#echo ${!array[*]}
16
0 1 2 3 4
17
# 括号+空格分隔，索引从0开始自动分配
18
'一行定义，索引自动0、1、2...排好'
19

20
========================================
21
3)方法3：混合定义——指定部分索引
22
========================================
23
[root@shell ~]#unset array
24
[root@shell ~]#array=([2]=awk sed [5]=zabbix find)
25
[root@shell ~]#echo ${!array[*]}
26
2 3 5 6
27
[root@shell ~]#echo ${array[*]}
28
awk sed zabbix find
29
[root@shell ~]#echo ${array[2]}
30
awk
31
[root@shell ~]#echo ${array[3]}
32
sed
33
[root@shell ~]#echo ${array[5]}
34
zabbix
35
[root@shell ~]#echo ${array[6]}
36
find
37
# [2]=awk 索引2赋值awk, sed紧跟索引3
38
# [5]=zabbix 索引5赋值zabbix, find紧跟索引6
39
'指定索引的那个位置开始，后面依次排——没指定的索引就跳过'
40

41
========================================
42
4)方法4：命令结果赋值给数组
43
========================================
44
[root@shell ~]#unset array
45
[root@shell ~]#array=(`ls`)
46
[root@shell ~]#ls
47
1.txt  c.sh  count.sh  day01-day03  for.sh  fun.sh  jumpserver.sh  pass.txt  ping.sh  test.sh  user.sh  weixin.py  while.sh
48
[root@shell ~]#echo ${array[*]}
49
1.txt count.sh c.sh day01-day03 for.sh fun.sh jumpserver.sh pass.txt ping.sh test.sh user.sh weixin.py while.sh
50
[root@shell ~]#echo ${!array[*]}
51
0 1 2 3 4 5 6 7 8 9 10 11 12
52
# ls的输出按空格分隔，自动变成数组元素
53
'命令结果存数组——方便后面遍历处理'

展开收起

查看数组#

Terminal window

1
[root@shell ~]#echo ${array[1]}       # 查看索引1的值
2
shell
3
[root@shell ~]#echo ${array[2]}
4
awk
5
[root@shell ~]#echo ${array[3]}
6
sed
7

8
[root@shell ~]#echo ${array[*]}       # 查看所有值（作为一个整体）
9
shell awk sed
10
[root@shell ~]#echo ${array[@]}       # 查看所有值（作为独立元素）
11
shell awk sed
12

13
[root@shell ~]#echo ${!array[*]}      # 查看所有索引
14
1 2 3

语法	含义
`${array[N]}`	取索引 N 的值
`${array[*]}`	取所有值，当整体
`${array[@]}`	取所有值，每个独立
`${!array[*]}`	取所有索引名

案例1：数组 + for 探测不连续IP#

数组天然适合存储不规则的地址列表，配合 for 遍历

1
1)遍历数组值——${ip[*]}
2
[root@shell ~]#cat ra.sh
3
#!/bin/bash
4
ip=(
5
    www.baidu.com
6
    10.0.0.2
7
    www.sina.com
8
    www.baiduddd.com
9
    10.0.0.7
10
    10.0.0.51
11
)
12

13
for i in ${ip[*]}            # 遍历数组的所有值
14
do
15
    ping -c1 -W1 $i &>/dev/null
16
    [ $? -eq 0 ] && echo $i 在线....
17
done
18
[root@shell ~]#sh ra.sh
19
www.baidu.com 在线....
20
10.0.0.2 在线....
21
www.sina.com 在线....
22
10.0.0.7 在线....
23
# 域名和IP混在一起也能遍历——数组不要求元素类型一致
24
'${ip[*]}遍历值——取到的是什么就ping什么'

展开收起

案例2：通过索引遍历#

1
2)先看索引和值的对应关系
2
[root@shell ~]#cat ra.sh
3
#!/bin/bash
4
ip=(
5
    www.baidu.com
6
    10.0.0.2
7
    www.sina.com
8
    www.baiduddd.com
9
    10.0.0.7
10
    10.0.0.51
11
)
12

13
for i in ${!ip[*]}            # 遍历索引: 0 1 2 3 4 5
14
do
15
    echo $i ${ip[$i]}         # 索引 + 值
16
done
17
[root@shell ~]#sh ra.sh
18
0 www.baidu.com
19
1 10.0.0.2
20
2 www.sina.com
21
3 www.baiduddd.com
22
4 10.0.0.7
23
5 10.0.0.51
24

25
========================================
26
3)通过索引ping
27
========================================
28
[root@shell ~]#cat ra.sh
29
#!/bin/bash
30
ip=(...同上...)
31

32
for i in ${!ip[*]}
33
do
34
    ping -c1 -W1 ${ip[$i]} &>/dev/null
35
    [ $? -eq 0 ] && echo ${ip[$i]} 在线....
36
done
37
[root@shell ~]#sh ra.sh
38
www.baidu.com 在线....
39
10.0.0.2 在线....
40
www.sina.com 在线....
41
10.0.0.7 在线....
42
'${!ip[*]}遍历索引→${ip[$i]}取对应值——效果一样，多了一步'

展开收起

📌 ${ip[*]} 直接遍历值 vs ${!ip[*]} 先取索引再取值——大多数场景前者就够了，需要知道位置时用后者

关联数组#

关联数组可以用==字符串作为索引==，定义前必须先 declare -A 声明

Terminal window

1
1)声明并赋值
2
[root@shell ~]#declare -A array
3
[root@shell ~]#array[index1]=awk
4
[root@shell ~]#array[index2]=sed
5
[root@shell ~]#array[index3]=grep
6
[root@shell ~]#echo ${array[*]}
7
awk grep sed
8
[root@shell ~]#echo ${!array[*]}
9
index1 index3 index2
10
# 索引是字符串，不是数字——这是关联数组和普通数组的唯二区别
11
'declare -A 是关键——不声明就当普通数组用，字符串索引会被当成0'

案例3：统计性别出现次数#

关联数组的经典应用：==按类别统计计数==

Terminal window展开收起

1
1)准备数据
2
[root@shell ~]#cat sex.txt
3
m
4
m
5
f
6
m
7
f
8
x
9
[root@shell ~]#cat sex.txt|sort |uniq -c
10
      2 f
11
      3 m
12
      1 x
13
# 传统方式用sort|uniq -c统计，但这是外部命令
14

15
========================================
16
2)关联数组统计——纯bash实现
17
========================================
18
[root@shell ~]#cat sex.sh
19
#!/bin/bash
20
while read line
21
do
22
    declare -A sex
23
    let sex[$line]++              # 以$line为key，计数+1
24
done<sex.txt
25

26
for i in ${!sex[*]}
27
do
28
    echo $i 出现了 ${sex[$i]} 次
29
done
30
[root@shell ~]#sh sex.sh
31
x 出现了 1 次
32
m 出现了 3 次
33
f 出现了 2 次
34
# 每读一行，sex[m]++ 或 sex[f]++，最后遍历输出
35
'let sex[$line]++ 是精髓——key自动分组，值自动累加'
36
❤️ 关联数组做统计：不用sort、不用uniq、纯bash搞定

展开收起

案例4：统计系统中每种shell的使用人数#

1
3)统计/etc/passwd中每种shell的用户数
2
[root@shell ~]#cat sex.sh
3
#!/bin/bash
4
while read line
5
do
6
    declare -A shell
7
    let shell[`echo $line|awk -F: '{print $NF}'`]++
8
    # 取每行最后一个字段（shell类型），以此为key计数
9
done</etc/passwd
10

11
for i in ${!shell[*]}
12
do
13
    echo $i 出现了 ${shell[$i]} 次
14
done
15
[root@shell ~]#sh sex.sh
16
/bin/bash 出现了 11 次
17
/bin/false 出现了 1 次
18
/bin/sync 出现了 1 次
19
/sbin/halt 出现了 1 次
20
/sbin/nologin 出现了 32 次
21
/sbin/shutdown 出现了 1 次
22
# /etc/passwd最后一段是用户登录shell
23
# /sbin/nologin最多——说明大部分是服务账户，不能登录
24
'一行命令看出系统账户分布——关联数组做分类统计就是这么直接'

展开收起

📌 关联数组统计模式：

Terminal window

1
while read line
2
do
3
    declare -A 数组名
4
    let 数组名[分类字段]++
5
done<数据文件
6
# 然后遍历${!数组名[*]}输出结果

小结#

知识点	核心要点
函数定义	三种写法：`fun(){}` / `function fun(){}` / `function fun{}`
函数传参	三种方式：`fun $1 $2` / 赋值传参 `file=$1` / `read` 交互
`local`	限定变量作用域在函数内，防止变量污染外部
`return` vs `exit`	return 退出函数，exit 退出脚本；$? 范围都是 0-255
`$?` 保存	`$?` 是一次性的——拿到立刻 `re=$?` 存变量
主函数 `main()`	函数拆功能 + main 编排流程 = 企业级脚本骨架
普通数组	`array=(值1 值2)`，数字索引，默认从0开始
关联数组	`declare -A array`，字符串索引，用前必须声明
`${array[*]}`	查看数组所有值
`${!array[*]}`	查看数组所有索引
`let array[key]++`	关联数组做分组统计的核心操作

Important

📌 函数核心价值：去重 + 封装 + 可维护——重复代码抽函数，一个函数干一件事

📌 数组核心价值：一个变量存多个值 + 支持遍历 + 关联数组天然做分组统计

📌 Shell编程完整路线：变量 → 判断 → if → case → for → while → 函数 → 数组

循环与case多分支

Sun, 28 Jun 2026 00:00:00 GMT

循环 && case多分支#

[TOC]

初识while#

while 属于循环语句，条件为真时反复执行循环体

Terminal window

1
while 条件
2
do
3
    命令集
4
done
5
# 条件满足就一直循环，直到条件不满足或遇到break/exit才退出

Important

==while true== 表示死循环，必须配合 break 或 exit 来退出，否则永远不会停止

break跳出循环#

Tip

break 用于跳出当前层循环，break N 跳 N 层

✅️ break N中的N表示跳出的循环层数，默认 break = break 1

1
1)break跳出一层
2
[root@shell ~]#cat while.sh
3
#!/bin/bash
4
while true
5
do
6
    echo 1...
7
    while true
8
    do
9
        echo 2...
10
        sleep 1
11
        break               # 跳出内层while
12
    done
13
done
14
# break默认只跳一层，外层while继续执行
15
'外层循环会不断进入内层→内层break→外层再进入内层...'
16
# 效果: 1...2...1...2...1...2... 无限循环
17

18
2)break 2 跳出两层
19
[root@shell ~]#cat while.sh
20
#!/bin/bash
21
while true
22
do
23
    echo 1...
24
    while true
25
    do
26
        echo 2...
27
        sleep 1
28
        break 2             # 跳出2层循环
29
    done
30
done
31
echo done............
32

33
[root@shell ~]#sh while.sh
34
1...
35
2...
36
done............
37
# break 2一次性跳出两层，直接到最外层done后面
38
'break 2 让程序干净利落地收工'

展开收起

Note

✅️ break → 跳出当前循环体，回到上一层 ✅️ exit → 终止整个脚本进程，不管嵌套多深

📌 关键区分：break 跳出循环，exit 退出脚本

猜数字游戏#

Tip

RANDOM 随机数

RANDOM 是 bash 内置变量，生成 0-32767 之间的随机整数

Terminal window

1
1)生成1-100的随机数
2
[root@shell ~]#echo $((RANDOM))
3
17937
4
# RANDOM范围是0-32767
5
[root@shell ~]# echo $((RANDOM))
6
27566
7
[root@shell ~]#echo $((RANDOM%100+1))
8
86
9
# %100取余得到0~99，+1得到1~100
10
'$((RANDOM%N+M)) 生成M到M+N-1之间的随机整数'

🌰 带计数器版

1
2)带计数器——统计猜了几次
2
[root@shell ~]#cat ran.sh
3
#!/bin/bash
4
run=$(($RANDOM%100+1))      # 先随机生成一个1-100的目标数
5

6
while true; do
7
  let i++            # 每次循环计数器+1
8
  read -p "请输入你要猜的数字（1-100）：" num
9

10
  if [ "$num" -gt "$run" ]; then
11
    echo "猜大了~"
12
  elif [ "$num" -lt "$run" ]; then
13
    echo "猜小了~"
14
  else
15
    echo "总共猜了${i}次, 🎉恭喜你终于猜对了~"
16
    exit
17
  fi
18
done
19
# let i++ 整数运算，自增计数器，统计循环次数
20
✅️ 猜对时打印累计次数
21
# 三种分支：大了、小了、猜对了
22
'猜对就exit退出，游戏结束'

展开收起

ping脚本#

1
[root@shell ~]#cat ping.sh
2
#!/bin/bash
3
ping -c2 -W2 $1 &>/dev/null
4
# -c2: 只发2个包  -W2: 超时1秒
5
if [ $? -eq 0 ];then
6
    echo $1 ✅ 在线.....
7
else
8
    echo $1 ❌ 不在线...
9
fi
10

11
[root@shell ~]# bash ping.sh www.baidu.com
12
www.baidu.com ✅ 在线.....
13
[root@shell ~]# bash ping.sh wwwww.basifasdfasdf.com
14
wwwww.basifasdfasdf.com ❌ 不在线...
15
'ping -c2 -W2 控制发包数和超时，避免脚本卡住'

展开收起

case语句#

📌 类似 if，是流程控制语句，用于多分支匹配

语法结构#

Terminal window展开收起

1
case 变量 in            # 变量来源: 直接传参、赋值传参、read接收、脚本定义
2
    匹配序列1)
3
        命令集
4
        ;;
5
    匹配序列2)
6
        命令集
7
        ;;
8
    匹配序列3)
9
        命令集
10
        ;;
11
    *)
12
        echo "Usage: $0 参数1|参数2"
13
esac
14
# )  匹配序列后跟右括号
15
# ;; 每个分支结束必须双分号
16
# *) 通配符，匹配所有其他情况，类似default
17
# esac case的反写，结束标志 ⭕

展开收起

🌰 基础示例

1
[root@shell ~]#cat case.sh
2
#!/bin/bash
3
case $1 in
4
    shell)
5
        echo shell.........
6
        ;;
7
    mysql)
8
        echo mysql.........
9
        ;;
10
    nginx)
11
        echo nginx........
12
        ;;
13
    *)
14
        echo "Usage: $0 [shell|mysql|nginx]"
15
        # 这里用双引号括起来
16
esac
17
# $1是脚本的第一个参数，case根据参数值分发到对应分支
18
'最简单的case——传什么参数就执行什么分支'

展开收起

案例1：系统信息查看脚本#

case + while 实现交互式菜单，循环接收用户输入

1
1)系统信息查看菜单
2
[root@shell ~]#cat case.sh
3
#!/bin/bash
4
men(){
5
    echo -e "\e[34m\t\t（1）查看内存\e[0m"
6
    echo -e "\e[34m\t\t（2）查看磁盘\e[0m"
7
    echo -e "\e[34m\t\t（3）查看负载\e[0m"
8
    echo -e "\e[34m\t\t（4）显示主菜单\e[0m"
9
    echo -e "\e[34m\t\t（exit）退出~\e[0m"
10
}
11
men
12
# 先调用一次函数 --> 显示菜单
13

14
while true
15
do
16
    read -p "输入后~查看对应系统编号[（4）显示菜单]: " num
17
    case $num in
18
        1)
19
            free -h
20
            ;;
21
        2)
22
            df -h
23
            ;;
24
        3)
25
            uptime
26
            ;;
27
        4)
28
            men           # 重新显示菜单
29
            ;;
30
        exit)
31
            exit
32
            ;;
33
        *)
34
            echo "Usage: $0 [1|2|3|4]"
35
    esac
36
done
37
# men()函数封装菜单显示，避免在循环里重复写echo
38
# case根据用户输入执行对应命令，选4重显菜单
39
'函数定义菜单→while死循环等待输入→case匹配执行'
40
✅️ 经典组合: while + case + 函数

展开收起

Tip

💡 men() 函数封装菜单显示，定义一次，多处调用——这就是函数的意义

案例2：Nginx启动脚本#

Terminal window展开收起

1
1)确认nginx路径
2
[root@web ~]#which nginx
3
/usr/sbin/nginx
4
[root@web ~]#/usr/sbin/nginx              # 启动
5
[root@web ~]#/usr/sbin/nginx -s stop      # 停止
6
[root@web ~]#/usr/sbin/nginx -s reload    # 重新加载
7
[root@web ~]#/usr/sbin/nginx -s stop && sleep 1 && /usr/sbin/nginx  # 重启
8
# restart: 先stop，sleep 1秒等进程结束，再start
9
✅ nginx通过-s参数控制: stop停止、reload重载、stop+sleep+start=重启
10
========================================
11
小bug🐛 --> 如果nginx处于停止状态，-s stop 会报错
12
root@Ubuntu ~# nginx -s stop
13
root@Ubuntu ~# ss -lntup | grep nginx | wc -l
14
0
15
root@Ubuntu ~# /usr/sbin/nginx -s stop && sleep 1 && /usr/sbin/nginx
16
nginx: [error] open() "/run/nginx.pid" failed (2: No such file or directory)
17
# 本来就没有运行，没有办法关闭 ❌ --> 后面也Nginx也启动不起来~
18
root@Ubuntu ~# ss -lntup | grep nginx | wc -l
19
0
20
'优化后'
21
root@Ubuntu ~# /usr/sbin/nginx -s stop 2>/etc/null; sleep 1 && /usr/sbin/nginx
22
# 吞掉报错 --> ;无论是否成功继续启动Nginx
23
root@Ubuntu ~# echo $?
24
0 ✅ 说明上一条命令执行成功
25
root@Ubuntu ~# ss -lntup | grep nginx | wc -l
26
1 ✅ 服务启动成功
27
========================================
28

29

30
2)Nginx启动脚本
31
'加执行结果反馈（加成功/失败提示）'
32
# 避免重复代码
33
[root@web ~]#cat nginx.sh
34
#!/bin/bash
35
ac=$1
36
# 在函数外 $1 是脚本的第一个参数
37
# 把$1先存到变量，方便函数内引用
38
te(){
39
    if [ $? -eq 0 ];then
40
        echo -e "\e[32m Nginx $ac 成功✅\e[0m"
41
    else
42
        echo -e "\e[31m Nginx $ac 失败❌\e[0m"
43
    fi
44
}
45

46
case $ac in
47
    start)
48
        /usr/sbin/nginx
49
        te
50
        ;;
51
    stop)
52
        /usr/sbin/nginx -s stop
53
        te
54
        ;;
55
    reload)
56
        /usr/sbin/nginx -s reload
57
        te
58
        ;;
59
    restart)
60
        /usr/sbin/nginx -s stop 2>/etc/null; sleep 1 && /usr/sbin/nginx
61
        te
62
        ;;
63
    status)
64
        nginx_re=`ps axu|grep "nginx: master"|grep -v grep|wc -l`
65
        [ $nginx_re -eq 0 ] && echo "nginx未运行❌" || echo "Nginx运行中ing✅"
66
        # 通过过滤 nginx 的主进程，来判断nginx是否在运行
67
        # 等于0，说明主进程没有启动起来~
68
        # grep -v grep排除grep自身进程，不然统计会多1
69
        ;;
70
    *)
71
        echo "Usage: $0 [start|stop|restart|reload|status]"
72
esac
73
# te()把重复的成功/失败判断封装起来，每个分支只需调用一行te
74
✅️ 函数可以访问外部变量$ac——函数内外不是完全隔离的
75
✅️ status分支逻辑不同，不需要TE，保持独立即可

展开收起

案例3：case或判断表达式#

case 支持 | 匹配多个值

1
1)用if -o实现或判断
2
[root@shell ~]#cat jumpserver.sh
3
#!/bin/bash
4
web=10.0.0.7
5
WEB02=10.0.0.8
6
DB01=10.0.0.51
7
men(){
8
    echo -e "\e[34m\t\t\t\t\t1.web\e[0m"
9
    echo -e "\e[34m\t\t\t\t\t2.WEB02\e[0m"
10
    echo -e "\e[34m\t\t\t\t\t3.DB01\e[0m"
11
}
12
men
13

14
read -p "输入连接的服务器编号或者IP地址或者主机名称" num
15
if [ $num = 1 -o $num = web -o $num = 10.0.0.7 ];then
16
# 这里必须用的是字符串匹配，-eq只能用于整数
17
# 如果输入的是 web -eq 1 会报错的~
18
    echo hehe
19
fi
20
# -o 表示or，多个条件有一个成立即可
21
'if用-o写多个or条件，但多了可读性差'
22

23
========================================
24
2)用case | 实现——更优雅
25
========================================
26
[root@shell ~]#cat jumpserver.sh
27
# ...变量定义和men1函数同上...
28
read -p "输入连接的服务器编号或者IP地址或者主机名称" num
29
case $num in
30
    1|web|10.0.0.7)
31
        echo web...........
32
        ;;
33
    2|WEB02|10.0.0.8)
34
        echo web02......
35
        ;;
36
esac
37
# case中用|分隔多个匹配值，比if -o直观太多
38
✅️ case + | 是写多条件匹配的首选方式

展开收起

案例4：跳板机脚本#

1
1)基础跳板机
2
[root@shell ~]#cat jumpserver.sh
3
#!/bin/bash
4
web=172.16.1.7
5
WEB02=172.16.1.8
6
DB01=172.16.1.51
7
men1(){
8
    echo -e "\e[34m\t\t\t\t\t1.web\e[0m"
9
    echo -e "\e[34m\t\t\t\t\t2.WEB02\e[0m"
10
    echo -e "\e[34m\t\t\t\t\t3.DB01\e[0m"
11
}
12
men1
13

14
read -p "输入连接的服务器编号或者IP地址或者主机名称" num
15
case $num in
16
    1|web)
17
        ssh $web
18
        ;;
19
    2|WEB02)
20
        ssh $WEB02
21
        ;;
22
esac
23

24
========================================
25
2)免密登录准备——先和客户端做免密钥
26
========================================
27
[root@shell ~]#ssh-keygen          # 服务端生成密钥对
28
[root@shell ~]#ssh-copy-id 172.16.1.8
29
[root@shell ~]#ssh-copy-id 172.16.1.7
30
# 免密后ssh直接连，不弹密码框

展开收起

完善版跳板机——角色+密码+验证码#

1
1)完善后的jumpserver
2
[root@shell ~]#cat jumpserver.sh
3
#!/bin/bash
4
web=172.16.1.7
5
WEB02=172.16.1.8
6
DB01=172.16.1.51
7
role(){
8
    echo -e "\e[33m\t\t\t\t\t1.运维\e[0m"
9
    echo -e "\e[33m\t\t\t\t\t2.开发\e[0m"
10
}
11
role
12

13
men1(){
14
    echo -e "\e[34m\t\t\t\t\t1.web\e[0m"
15
    echo -e "\e[34m\t\t\t\t\t2.WEB02\e[0m"
16
    echo -e "\e[34m\t\t\t\t\t3.DB01\e[0m"
17
}
18

19
men2(){
20
    echo -e "\e[34m\t\t\t\t\t1.web\e[0m"
21
}
22

23
trap "" HUP TSTP INT
24
# 屏蔽Ctrl+C等信号，防止用户退出脚本
25

26
read -p "请输入你的角色: " num
27
if [ $num -eq 1 ];then              # 运维——可管理所有主机
28
    while true
29
    do
30
        read -p "请输入你的密码: " pass
31
        if [ $pass -eq 123 ];then
32
            break
33
        else
34
            let i++
35
            echo "你输入密码不正确、请重新输入"
36
            [ $i -eq 3 ] && echo 密码错误次数过多,请稍后再试 && sleep 5
37
            if [ $i -eq 5 ];then
38
                read -p "密码次数过多请输入你的微信账号: " wx
39
                ran=`echo $((RANDOM))|md5sum|cut -c 1-8`
40
                echo 验证码已发送到$wx
41
                python2.7 weixin.py "$wx" "验证码" "$ran"
42
                read -p "请输入接收到的验证码: " ra
43
                if [ $ra = $ran ];then
44
                    python2.7 weixin.py "$wx" "密码" "123"
45
                    unset i
46
                    continue
47
                else
48
                    echo hehe
49
                fi
50
            fi
51
        fi
52
    done
53
    men1
54
    while true
55
    do
56
        read -p "输入连接的服务器编号[p输出主机列表]: " num
57
        case $num in
58
            1|web)
59
                ssh $web
60
                ;;
61
            2|WEB02)
62
                ssh $WEB02
63
                ;;
64
            p)
65
                men1
66
                ;;
67
        esac
68
    done
69
elif [ $num -eq 2 ];then            # 开发——只能连web
70
    men2
71
    while true
72
    do
73
        read -p "输入连接的服务器编号[p输出主机列表]: " num
74
        case $num in
75
            1)
76
                ssh $web
77
                ;;
78
            p)
79
                men2
80
                ;;
81
        esac
82
    done
83
fi
84
# 运维角色：输密码→最多3次重试→5次锁住→微信验证码解锁→显示运维菜单
85
# 开发角色：直接显示开发菜单，只能连web
86
'用角色控制权限——运维看全菜单，开发只看一台机器'
87
⚠️ trap屏蔽信号防止Ctrl+C退出，要预留后门: woshiyunwei→exit

展开收起

Important

📌 跳板机核心设计：

① 角色分离——运维 vs 开发，菜单不同
② 密码验证——3次错误锁5秒，5次错误发微信验证码
③ trap 屏蔽信号——防止 Ctrl+C 直接退出
④ 预留后门——woshiyunwei) → exit

for循环#

语法结构#

Terminal window

1
for i in 取值列表
2
do
3
    命令集合
4
done
5
# i 是循环变量，每次从取值列表中取一个值
6
# 取值列表可以是: 字符串、数字、序列、命令、变量

案例1：循环数字#

Terminal window

1
1)直接写数字列表
2
[root@shell ~]#cat for.sh
3
for i in 1 2 10
4
do
5
    echo $i
6
done
7
[root@shell ~]#sh for.sh
8
1
9
2
10
10
11
# 数字以空格分隔，for按空格取值

案例2：循环字符串#

Terminal window

1
2)循环字符串
2
[root@shell ~]#cat for.sh
3
for i in a b c
4
do
5
    echo $i
6
done
7
[root@shell ~]#sh for.sh
8
a
9
b
10
c
11
# 字符串同样按空格分隔

案例3：支持序列#

Terminal window展开收起

1
3)数字序列 {1..10}
2
[root@shell ~]#cat for.sh
3
for i in {1..10}
4
do
5
    echo $i
6
done
7
[root@shell ~]#sh for.sh
8
1
9
2
10
3
11
4
12
5
13
6
14
7
15
8
16
9
17
10
18
# {1..10} 自动展开为1到10的序列
19

20
========================================
21
4)字母序列 {a..d}
22
========================================
23
[root@shell ~]#cat for.sh
24
for i in {a..d}
25
do
26
    echo $i
27
done
28
[root@shell ~]#sh for.sh
29
a
30
b
31
c
32
d
33
'{a..d} 字母序列也能展开，好用'

展开收起

案例4：支持命令#

取值列表可以来自命令的输出——用反引号 ` 或 $() 包裹

Terminal window展开收起

1
5)seq命令生成序列
2
[root@shell ~]#cat for.sh
3
read -p "请输入数字: " num
4
for i in `seq $num`
5
do
6
    echo $i
7
done
8
[root@shell ~]#sh for.sh
9
请输入数字: 5
10
1
11
2
12
3
13
4
14
5
15
# seq $num 动态生成1到$num的序列
16

17
========================================
18
6)cat命令读取文件
19
========================================
20
[root@shell ~]#cat for.sh
21
for i in `cat 1.txt`
22
do
23
    echo $i
24
done
25
[root@shell ~]#cat 1.txt
26
zhangsan
27
lisi
28
[root@shell ~]#sh for.sh
29
zhangsan
30
lisi
31
# cat 1.txt的输出作为取值列表
32
'命令结果也能当列表——for的取值来源非常灵活'

展开收起

案例5：支持拼接#

Terminal window

1
7)变量拼接
2
[root@shell ~]#cat for.sh
3
for i in {1..3}
4
do
5
    echo a$i
6
done
7
[root@shell ~]#sh for.sh
8
a1
9
a2
10
a3
11
# 循环体内可以用变量$i做各种拼接

案例6：批量创建用户#

Terminal window展开收起

1
8)批量创建用户——基础版
2
[root@shell ~]#cat for.sh
3
for i in {1..3}
4
do
5
    useradd oldboy$i
6
done
7
# 循环三次，创建oldboy1、oldboy2、oldboy3
8

9
========================================
10
9)批量创建用户——灵活版（输入前缀和个数）
11
========================================
12
[root@shell ~]#cat for.sh
13
read -p "请输入用户前缀: " prefix
14
read -p "请输入用户个数: " num
15
for i in `seq $num`
16
do
17
    user=$prefix$i
18
    echo $user
19
done
20

21
read -p "[y创建用户|d删除用户]" num1
22
for a in `seq $num`
23
do
24
    case $num1 in
25
        y)
26
            user=$prefix$a
27
            id $user &>/dev/null
28
            if [ $? -eq 0 ];then
29
                echo "$user 用户已存在"
30
            else
31
                useradd $user &>/dev/null
32
                [ $? -eq 0 ] && echo $user创建成功
33
            fi
34
            ;;
35
        d)
36
            user=$prefix$a
37
            id $user &>/dev/null
38
            if [ $? -eq 0 ];then
39
                userdel -r $user
40
                [ $? -eq 0 ] && echo $user删除成功
41
            else
42
                echo "$user 用户不存在"
43
            fi
44
            ;;
45
    esac
46
done
47
# 先输入前缀和个数预览用户名，再选择y创建或d删除
48
'id检查用户是否存在→存在跳过/不存在创建'
49
✅️ 创建前先预览，确认后再操作——安全操作的好习惯

展开收起

案例7：批量探测IP是否在线#

笔试题经典：探测 10.0.0.1-254 的 IP 地址是否在线

1
1)并发ping探测
2
[root@shell ~]#cat ping.sh
3
#!/bin/bash
4
for i in `seq 254`
5
do
6
    {
7
        ip=10.0.0.$i
8
        ping -c1 -W1 $ip &>/dev/null
9
        if [ $? -eq 0 ];then
10
            echo $ip 在线...
11
        fi
12
    } &
13
done
14
wait
15
echo 探测完成.....
16
# {} & 每个ping放进后台并发执行，254个同时跑
17
# wait 等待所有后台进程结束后再继续
18
'不用{}&，254个IP顺序ping要等很久——并发才是王道'
19
✅️ 后台并发 + wait等待 = 快速批量ping

展开收起

案例8：从文件读取创建用户#

1
2)从文件批量创建用户
2
[root@shell ~]#cat user.sh
3
#!/bin/bash
4
for i in `cat 1.txt`
5
do
6
    useradd $i
7
done
8

9
[root@shell ~]#cat 1.txt
10
zhangsan
11
lisi
12
laowang
13
# 用户列表写在文件里，for循环逐行读取创建

案例9：给每个用户设置随机密码#

Terminal window展开收起

1
3)创建用户并设随机密码
2
[root@shell ~]#cat for.sh
3
read -p "请输入用户前缀: " prefix
4
read -p "请输入用户个数: " num
5
for i in `seq $num`
6
do
7
    user=$prefix$i
8
    echo $user
9
done
10

11
read -p "[y创建用户|d删除用户]" num1
12
for a in `seq $num`
13
do
14
    case $num1 in
15
        y)
16
            user=$prefix$a
17
            id $user &>/dev/null
18
            if [ $? -eq 0 ];then
19
                echo "$user 用户已存在"
20
            else
21
                useradd $user &>/dev/null
22
                [ $? -eq 0 ] && echo $user创建成功
23
                echo $user >> pass.txt
24
                echo `mkpasswd`|tee -a pass.txt|passwd --stdin $user
25
            fi
26
            ;;
27
        d)
28
            user=$prefix$a
29
            id $user &>/dev/null
30
            if [ $? -eq 0 ];then
31
                userdel -r $user
32
                [ $? -eq 0 ] && echo $user删除成功
33
            else
34
                echo "$user 用户不存在"
35
            fi
36
            ;;
37
    esac
38
done
39
# mkpasswd生成随机密码串→tee记录到pass.txt→passwd --stdin设给用户
40
'mkpasswd生成随机密码，tee一边记密码本一边设密码'
41
✅️ 密码记录到pass.txt方便后续分发

展开收起

Warning

🤡 生产环境记得保管好 pass.txt，或者用完就删

命令行一行for#

Terminal window展开收起

1
# 命令行快速循环——适合临时批量操作
2
[root@shell ~]#for i in `seq 5`;do echo $i;done
3
1
4
2
5
3
6
4
7
5
8

9
[root@shell ~]#for i in `seq 5`;do echo old$i;done
10
old1
11
old2
12
old3
13
old4
14
old5
15

16
# 批量建用户——一行搞定
17
[root@shell ~]#for i in `seq 5`;do useradd old$i;done
18
[root@shell ~]#tail -5 /etc/passwd
19
old1:x:1014:1014::/home/old1:/bin/bash
20
old2:x:1015:1015::/home/old2:/bin/bash
21
old3:x:1016:1016::/home/old3:/bin/bash
22
old4:x:1017:1017::/home/old4:/bin/bash
23
old5:x:1018:1018::/home/old5:/bin/bash
24

25
# 批量删——也是一行
26
[root@shell ~]#for i in `seq 5`;do userdel -r old$i;done
27
# 命令行for循环是运维的瑞士军刀
28
'一行建5个，一行删5个——简洁高效'

展开收起

案例10：100内能被3整除的数的和#

Terminal window展开收起

1
1)执行过程分析
2
for i in `seq 100`
3
# i=1: 1%3=1 不等于0 跳过
4
# i=2: 2%3=2 不等于0 跳过
5
# i=3: 3%3=0 count=$[0+3]=3
6
# i=4: 4%3=1 不等于0 跳过
7
# i=5: 5%3=2 不等于0 跳过
8
# i=6: 6%3=0 count=$[3+6]=9
9
# ...以此类推...
10

11
========================================
12
2)完整脚本
13
========================================
14
[root@shell ~]#cat count.sh
15
#!/bin/bash
16
for i in `seq 100`
17
do
18
    num=`echo $[$i%3]`         # $i%3 取余数
19
    if [ $num -eq 0 ];then
20
        count=$[$count+$i]     # 余数为0则累加
21
    fi
22
done
23
echo $count
24
[root@shell ~]#sh count.sh
25
1683
26
# 100以内能被3整除的数: 3,6,9,...,99 总和1683

展开收起

案例11：for循环从1加到100#

Terminal window

1
[root@shell ~]#cat c.sh
2
for i in `seq 100`
3
do
4
    count=$[count+i]
5
done
6
echo $count
7
[root@shell ~]#sh c.sh
8
5050
9
# 经典的累加——for循环的最佳练手题

while循环#

语法结构#

Terminal window

1
while [ 条件表达式 ]    # 成立则执行、不成立不执行
2
do
3
    命令集合
4
done

📌 和 if 一样用 [ ] 条件表达式，条件成立才进入循环体

案例1：死循环的两种写法#

Terminal window展开收起

1
1)while true
2
while true
3
do
4
    echo hehe
5
done
6
# true永远为真→死循环
7

8
========================================
9
2)while [ 条件恒成立 ]
10
========================================
11
while [ 10 -eq 10 ]
12
do
13
    echo hehe
14
done
15
# 10永远等于10→也是死循环
16
'两种写法等效，while true更常用'

展开收起

案例2：循环序列（while版）#

1
1)while实现1到100
2
[root@shell ~]#cat while.sh
3
#!/bin/bash
4
i=1
5
while [ $i -le 100 ]
6
do
7
    echo $i
8
    let i++
9
done
10
# while版需要自己维护计数器：初始值i=1，每次let i++，条件i<=100
11
'while不像for自动取序列——需要手动管理变量和条件'

案例3：从1加到100（while版）#

1
[root@shell ~]#cat while.sh
2
#!/bin/bash
3
i=1
4
while [ $i -le 100 ]
5
do
6
    c=$[c+i]
7
    let i++
8
done
9
echo $c
10
[root@shell ~]#sh while.sh
11
5050
12
# 同样的累加逻辑，while版三步：初始化i→循环累加→自增

案例4：for vs while 读取文件的关键区别#

Terminal window展开收起

1
1)准备测试文件
2
[root@shell ~]#cat /etc/hosts
3
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
5
# /etc/hosts每行有多个字段，空格分隔
6

7
========================================
8
2)for循环——按空格分隔
9
========================================
10
[root@shell ~]#cat while.sh
11
#!/bin/bash
12
for i in `cat /etc/hosts`
13
do
14
    echo $i
15
done
16
[root@shell ~]#sh while.sh
17
127.0.0.1
18
localhost
19
localhost.localdomain
20
localhost4
21
localhost4.localdomain4
22
::1
23
localhost
24
localhost.localdomain
25
localhost6
26
localhost6.localdomain6
27
# for按空格和换行符切分，每个词单独一行
28
'for循环：见到空格就切一刀——不管原来是不是一行'
29

30
========================================
31
3)while read——按行读取
32
========================================
33
[root@shell ~]#cat while.sh
34
#!/bin/bash
35
while read line
36
do
37
    echo $line
38
done</etc/hosts
39
[root@shell ~]#sh while.sh
40
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4
41
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
42
# while read 逐行读取，保留每行的原始格式
43
'while read：一行就是一整行——空格不动'

展开收起

📌 核心区别：for 按空格分隔值，while read 按行读取——读文件内容时 while read 更准确

案例5：基于文件批量创建用户和密码#

Terminal window展开收起

1
1)准备用户密码文件
2
[root@shell ~]#cat 1.txt
3
zhangsan test.oldboy123.com
4
lisi     old.123.com
5
laowang  hehe.123.com
6
# 每行：用户名 密码
7

8
========================================
9
2)while read 逐行处理
10
========================================
11
[root@shell ~]#cat while.sh
12
#!/bin/bash
13
while read line
14
do
15
    user=`echo $line|awk '{print $1}'`
16
    pass=`echo $line|awk '{print $2}'`
17

18
    useradd $user &>/dev/null
19
    [ $? -eq 0 ] && echo $user 创建成功
20
    echo $pass|passwd --stdin $user
21
done<1.txt
22
# read读每一行→awk取第1列用户名、第2列密码→创建用户并设密码
23
'done < 1.txt 把文件重定向到while循环的标准输入'
24
✅️ while read + awk 是处理格式化文件的经典组合

展开收起

流程控制：break continue exit#

Terminal window展开收起

1
1)exit——直接退出脚本
2
========================================
3
[root@shell ~]#useradd old3
4
# 先让old3存在，触发exit分支
5
[root@shell ~]#cat while.sh
6
#!/bin/bash
7
for i in {1..5}
8
do
9
    user=old$i
10
    id $user &>/dev/null
11
    if [ $? -eq 0 ];then
12
        exit # 直接退出脚本
13
    else
14
        useradd $user &>/dev/null
15
        [ $? -eq 0 ] && echo $user创建成功
16
    fi
17
done
18
echo 执行完成.......
19
[root@shell ~]#sh while.sh
20
old1创建成功
21
old2创建成功
22
# old3已存在→触发exit→脚本直接终止→最后的echo没执行
23
'exit是核武器——不管在哪层，直接结束整个进程'
24

25
========================================
26
2)break——跳出循环继续执行
27
========================================
28
[root@shell ~]#for i in `seq 2`;do userdel -r old$i;done
29
# 清理old1和old2
30
[root@shell ~]#cat while.sh
31
#!/bin/bash
32
for i in {1..5}
33
do
34
    user=old$i
35
    id $user &>/dev/null
36
    if [ $? -eq 0 ];then
37
        break # 跳出循环继续执行
38
    else
39
        useradd $user &>/dev/null
40
        [ $? -eq 0 ] && echo $user创建成功
41
    fi
42
done
43
echo 执行完成.......
44
[root@shell ~]#sh while.sh
45
old1创建成功
46
old2创建成功
47
执行完成.......
48
# old3已存在→触发break→跳出for循环→继续执行echo
49
'break是退出当前循环——脚本还活着，echo照常执行'
50

51
========================================
52
3)continue——跳过本次，继续下一次
53
========================================
54
[root@shell ~]#for i in `seq 2`;do userdel -r old$i;done
55
[root@shell ~]#sh while.sh
56
old1创建成功
57
old2创建成功
58
old4创建成功
59
old5创建成功
60
执行完成.......
61
# old3存在→触发continue→跳过old3的创建→继续old4、old5
62
'continue是跳过当前这一轮——下一轮照常跑'
63
# old3被跳过了，但old4和old5正常创建

展开收起

命令	作用	影响范围
`exit`	直接终止整个脚本	整个进程
`break`	跳出当前循环体	当前循环
`continue`	跳过本次循环，继续下一次	当前循环的本次迭代

项目练习#

Tip

① 写过的项目都需要加上判断:

判断传参不能为空
判断必须为整数
判断必须连续的字符串

② 中午吃啥？随机生成一个——用 RANDOM + case 实现

③ 老男孩大饭店——二级菜单 + 会员系统 + 结账

④ 大酒店服务——菜单 + 服务 + 价格 + 会员 + 消费 + 余额

⑤ 双色球——随机数生成 + 数组统计

📌 这些项目将 while + case + for + 函数 + 数组综合运用，是检验学习成果的好练习

小结#

知识点	核心要点
`while`	条件循环，`while true` = 死循环，配合 `break` / `exit` 退出
`break N`	跳出 N 层循环，默认 = `break 1`
`exit`	直接退出整个脚本，不管嵌套多深
`continue`	跳过本次循环，继续下一次
`case`	多分支匹配，`\|` 连接多值，`;;` 结束分支，`*)` 通配，`esac` 结束
`for i in 列表`	取值列表支持：字符串、数字、`{1..10}` 序列、`命令`、变量
`for` vs `while read`	for 按空格分隔，while read 按行读取
`{} &` + `wait`	后台并发 + 等待所有结束——批量任务加速
`let i++`	整数自增，等效 `((i++))`，常用于计数器
`RANDOM`	bash 内置随机数，范围 0-32767，`$((RANDOM%100+1))` 生成 1-100
`$?`	上一条命令返回值，0 = 成功，非0 = 失败
`trap "" HUP TSTP INT`	屏蔽信号，防止 Ctrl+C 退出脚本
`/etc/init.d/functions`	系统函数库，`action` 美化输出 `[ OK ]` / `[FAILED]`

Important

📌 三种循环各自适用场景：

for —— 知道循环次数 / 遍历列表 / 批量操作
while —— 条件判断式循环 / 逐行读文件 / 死循环+break
case —— 多分支分发 / 服务管理脚本 / 菜单路由

📌 代码进化思路：基础实现 → 加状态反馈 → 抽函数去冗余 → 用系统库美化

数值运算与if条件判断

Wed, 24 Jun 2026 00:00:00 GMT

数值运算&&if条件判断#

[TOC]

📦 变量子串#

长度统计#

统计字符串的长度（笔试题）#

三种统计字符串长度的方法：

Terminal window展开收起

1
1)wc -L
2
'-L vs -l：小写 -l 是行数，大写 -L 是最长行长度'
3
[root@shell ~]# name=oldboy
4
[root@shell ~]# echo $name
5
oldboy
6
[root@shell ~]# echo $name | wc -L
7
6
8

9
2)awk length
10
[root@shell ~]# echo $name | awk '{print length}'
11
6
12

13
3)子串统计长度 — ${#变量名} ✅ 最常用
14
[root@shell ~]# echo ${#name}
15
6

展开收起

Tip

📌 ${#变量名} 是 bash 内置语法，==效率最高==，推荐使用

统计长度小于 3 的字符串#

1
1)for 循环 + ${#i}
2
[root@shell ~]# cat for.sh
3
#!/bin/bash
4
for i in I am lizhenya I am 18
5
# 不能加引号，不然会变成一个整体
6
do
7
        echo $i
8
done
9
[root@shell ~]# sh for.sh
10
I
11
am
12
lizhenya
13
I
14
am
15
18
16

17
2)输出每个字符的长度 & 并比较
18
# 只输出长度小于 3 的字符串
19
[root@shell ~]# cat for.sh
20
#!/bin/bash
21
for i in I am lizhenya I am 18
22
do
23
        [ ${#i} -lt 3 ] && echo $i
24
done
25
[root@shell ~]# sh for.sh
26
I
27
am
28
I
29
am
30
18

展开收起

扩展 — 用三剑客实现同样的效果：

Terminal window展开收起

1
1)xargs + awk
2
[root@shell ~]# echo I am lizhenya I am 18 | xargs -n1
3
I
4
am
5
lizhenya
6
I
7
am
8
18
9
[root@shell ~]# echo I am lizhenya I am 18 | xargs -n1 | awk '{print length}'
10
1
11
2
12
8
13
1
14
2
15
2
16
[root@shell ~]# echo I am lizhenya I am 18 | xargs -n1 | awk '{if(length<3) print}'
17
I
18
am
19
I
20
am
21
18
22

23
2)纯 awk
24
'NF --> 每行有多少列' # 默认以空格分开
25
[root@shell ~]# echo I am lizhenya I am 18 | awk '{for(i=1;i<=NF;i++) if(length($i)<3) print $i}'
26
✅ 给i一个初值，$i为每一列字符 ⚠️ 中间是分号
27
I
28
am
29
I
30
am
31
18

展开收起

子串删除#

从前往后删除#

Terminal window展开收起

1
[root@shell ~]# url=www.baidu.com
2
[root@shell ~]# echo $url
3
www.baidu.com
4
[root@shell ~]# echo ${#url}
5
13
6
⚠️ #号 在前面是统计字符串长度 ⚠️
7
'依旧是{ 花括号 }'
8

9
1)# 匹配 — 删除最短匹配（从前往后）
10
[root@shell ~]# echo ${url#www.}
11
baidu.com
12
# '删掉了开头的 www.'
13
[root@shell ~]# echo ${url#w}
14
ww.baidu.com
15
'只删了第一个 w，# 是懒惰匹配（最短）'
16
[root@shell ~]# echo ${url#*.}
17
baidu.com
18
# '匹配到第一个 . 就停，删掉 www.'
19
[root@shell ~]# echo ${url#*.*.}
20
com
21
# 'w*.*. 匹配到第二个点，删掉 www.baidu.'
22

23
2)## 匹配 — 删除最长匹配（从前往后，贪婪）
24
[root@shell ~]# echo ${url##*.}
25
com
26
'贪婪匹配到最后一个点，只留下 com'

展开收起

语法	方向	匹配方式	记忆技巧
`#`	从前往后	==最短匹配==（懒惰）	键盘上 `#` 在左，管左边
`##`	从前往后	==最长匹配==（贪婪）	两个 `#` 就贪到底
`%`	从后往前	==最短匹配==（懒惰）	键盘上 `%` 在右，管右边
`%%`	从后往前	==最长匹配==（贪婪）	两个 `%` 就贪到底

从后往前删除#

Terminal window展开收起

1
[root@shell ~]# echo ${url}
2
www.baidu.com
3

4
1)% 匹配 — 从后往前删除最短匹配
5
[root@shell ~]# echo ${url%com}
6
www.baidu.
7
[root@shell ~]# echo ${url%.com}
8
www.baidu
9
[root@shell ~]# echo ${url%.*}
10
www.baidu
11
# '匹配到最后一个 . 前面的全部留下'
12

13
2)%% 匹配 — 从后往前删除最长匹配
14
[root@shell ~]# echo ${url%%.*}
15
www
16
# '贪婪从后往前，匹配到第一个 . 就全删了'

展开收起

实战案例 — 去掉磁盘容量的单位 G：

Terminal window展开收起

1
[root@shell ~]# df -h | awk 'NR==6'
2
/dev/sda3         48G    4.9G   43G   11% /
3
[root@shell ~]# df -h | awk 'NR==6{print $2}'
4
48G
5
[root@shell ~]# disk=`df -h | awk 'NR==6{print $2}'`
6
[root@shell ~]# echo $disk
7
48G
8

9
'${disk%G} — 从后面把 G 删掉，拿到纯数字'
10
[root@shell ~]# echo ${disk%G}
11
48
12
[root@shell ~]# [ ${disk%G} -gt 30 ]
13
-gt > '大于'
14
[root@shell ~]# echo $?
15
0
16
# '48 > 30，成立'
17

18
# 纯 awk
19
[root@shell ~]# df -h | awk -F '[ G]+' '{print $(NF-4)}'
20
48

展开收起

子串替换#

Terminal window展开收起

1
[root@shell ~]# url=www.baidu.com
2

3
1)/ 替换 — 只替换第一个匹配
4
[root@shell ~]# echo ${url/w/W}
5
Www.baidu.com
6
✅ 单个 `/` → 替换一次就停止
7
✅ 双 `//`  → 全局替换
8

9
[root@shell ~]# echo ${url/wW/W}
10
www.baidu.com
11
# 'wW 这个模式不存在，所以没替换'
12

13
[root@shell ~]# echo ${url/ww/W}
14
Ww.baidu.com
15
# '只替换了第一个 ww'
16

17
2)// 替换 — 替换所有匹配（全局替换）
18
[root@shell ~]# echo ${url//w/W}
19
WWW.baidu.com
20
# '所有的 w 都变成了 W'
21

22
3)替换域名 '百度' --> '京东'
23
[root@shell ~]# echo ${url/baidu/jd}
24
www.jd.com

展开收起

语法	含义
`${变量/旧/新}`	替换第一个匹配
`${变量//旧/新}`	替换所有匹配
`${变量/#旧/新}`	匹配开头（必须是前缀）才替换
`${变量/%旧/新}`	匹配结尾（必须是后缀）才替换

Terminal window展开收起

1
url="www.baidu.www.com"
2

3
# 1️⃣ 普通替换：只换第一个 w
4
echo ${url/w/W}        # Www.baidu.www.com
5

6
# 2️⃣ 全局替换：所有 w 都换
7
echo ${url//w/W}       # WWW.baidu.WWW.com
8

9
# 3️⃣ # 锚定开头：只有开头的 www 被替换
10
echo ${url/#www/W}   # W.baidu.www.com
11

12
# 4️⃣ % 锚定结尾：只有结尾的 com 被替换
13
echo ${url/%com/COM}   # www.baidu.www.COM
14

15
# ❌ # 不匹配开头时：什么都不发生
16
echo ${url/#baidu/BAIDU}  # www.baidu.www.com（baidu不在开头，原样输出）

展开收起

⚙️ 数值运算#

Shell 中常见的 6 种运算方式：

方式	整数	小数	效率	推荐度
`expr`	✅	❌	低（需 fork 子进程）	⭐⭐
`$(())`	✅	❌	==最高==（bash 内置）	⭐⭐⭐⭐⭐
`$[]`	✅	❌	高（bash 内置）	⭐⭐⭐
`let`	✅	❌	高（bash 内置）	⭐⭐⭐
`bc`	✅	✅	低（需 fork 子进程）	⭐⭐⭐
`awk`	✅	✅	低（需 fork 子进程）	⭐⭐⭐

expr — 支持整数、不支持小数#

Terminal window

1
'expr 要求运算符两边必须有空格！'
2
[root@shell ~]# expr 1+1
3
1+1
4
# ❌ 没空格，当成字符串原样输出
5
[root@shell ~]# expr 1 + 1
6
2
7

8
'乘法需要用 \* 转义'
9
[root@shell ~]# expr 100 \* 10
10
1000
11
[root@shell ~]# expr 100 / 10
12
10
13
[root@shell ~]# expr 100 - 10
14
90

`$(())` — 支持整数、效率最高#

Terminal window

1
'两个小括号' ✅ 推荐使用
2
[root@shell ~]# echo $((10+10))
3
20
4
[root@shell ~]# echo $((10-10))
5
0
6
[root@shell ~]# echo $((10*10))
7
100
8
[root@shell ~]# echo $((10/10))
9
1
10
[root@shell ~]# echo $((10%10))
11
0
12
# '% 是取余（取模）'

`$[]` — 不支持小数（老式语法）#

Terminal window

1
[root@shell ~]# echo $[10+10]
2
20
3
[root@shell ~]# echo $[10-10]
4
0
5
[root@shell ~]# echo $[10*10]
6
100
7
[root@shell ~]# echo $[10/10]
8
1
9
'$[] 是老式写法，推荐用 $(()) 替代'

let — 常用于自增/自减#

Tip

Shell（Bash）在进行算术运算时（包括 let、(( ))、expr），如果变量未被赋值或值为空，会自动将其当作 整数 0 处理

Terminal window

1
1)let i++ —-> 自增
2
[root@shell ~]# let i++
3
[root@shell ~]# echo $i
4
1
5
[root@shell ~]# let i++
6
[root@shell ~]# echo $i
7
2
8

9
2)let i=i+1
10
[root@shell ~]# let i=i+1
11
[root@shell ~]# echo $i
12
3

Important

📌 i++ 和 ++i 的区别（有变量时不同）：

Terminal window

1
[root@shell ~]# a=1
2
[root@shell ~]# b=1
3
[root@shell ~]# let c=a++      # 先赋值后运算
4
[root@shell ~]# let d=++b      # 先运算后赋值
5
[root@shell ~]# echo $c
6
1
7
[root@shell ~]# echo $d
8
2

a++ → 先把 a 的值给 c，然后 a 自增
++b → 先让 b 自增，再把结果给 d

实战 — 用 let 统计循环次数：

1
[root@shell ~]# cat for.sh
2
#!/bin/bash
3
for i in I am lizhenya I am 18
4
do
5
        let a++
6
done
7
echo 总共循环了 $a 次
8
[root@shell ~]# sh for.sh
9
总共循环了 6 次

bc — 支持整数和小数#

Terminal window展开收起

1
[root@shell ~]# echo 10+10 | bc
2
20
3
[root@shell ~]# echo 10-10 | bc
4
0
5
[root@shell ~]# echo 10*10 | bc
6
100
7
[root@shell ~]# echo 10/10 | bc
8
1
9

10
'bc 独有的优势：支持小数运算'
11
[root@shell ~]# echo 10+10.5 | bc
12
20.5
13
[root@shell ~]# echo 10.123+10.5 | bc
14
20.623
15

16
'小数除法'
17
[root@shell ~]# echo 10/3 | bc
18
3
19
[root@shell ~]# echo 10/2.5 | bc
20
4
21
[root@shell ~]# echo 10/2.3 | bc
22
4
23
# '默认不保留小数位'
24

25
'支持运算优先级'
26
[root@shell ~]# echo 10+2*2 | bc
27
14

展开收起

awk BEGIN — 支持整数和小数#

Terminal window展开收起

1
[root@shell ~]# awk 'BEGIN{print 10*10}'
2
100
3
[root@shell ~]# awk 'BEGIN{print 10-10}'
4
0
5
[root@shell ~]# awk 'BEGIN{print 10/10}'
6
1
7
[root@shell ~]# awk 'BEGIN{print 10+10}'
8
20
9
[root@shell ~]# awk 'BEGIN{print 10+10*2}'
10
30
11
[root@shell ~]# awk 'BEGIN{print 10^22}'
12
10000000000000000000000
13

14
'awk 小数除法默认保留精度'
15
[root@shell ~]# awk 'BEGIN{print 10/3}'
16
3.33333

展开收起

Tip

💡 选择建议：

整数运算 → $(()) 效率最高，bash 内置
小数运算 → bc 或 awk
自增/统计 → let
==运算中都支持变量==：$(($num1 * $num2))、$[$num1 * $num2]、expr $num1 + $num2

⚙️ 整数比较#

语法结构#

Terminal window

1
# 第一种: test
2
test 10 -eq 10
3

4
# 第二种: [ ]  ✅ 最常用
5
[ 10 -eq 10 ]

✨比较符号#

运算符	含义	英文全称	助记
`-lt`	小于	Less Than	Less Than
`-gt`	大于	Greater Than	Greater Than
`-le`	小于等于	Less or Equal	≤
`-ge`	大于等于	Greater or Equal	≥
`-eq`	等于	Equal	=
`-ne`	不等于	Not Equal	≠

Terminal window展开收起

1
'基础演示'
2
[root@shell ~]# test 10 -eq 10
3
[root@shell ~]# echo $?
4
0
5
[root@shell ~]# [ 10 -eq 10 ]
6
[root@shell ~]# echo $?
7
0
8

9
'搭配 && 和 ||'
10
[root@shell ~]# [ 10 -gt 5 ] && echo 成立 || echo 不成立
11
成立
12
[root@shell ~]# [ 10 -eq 5 ] && echo 成立 || echo 不成立
13
不成立
14
[root@shell ~]# [ 10 -lt 5 ] && echo 成立 || echo 不成立
15
不成立
16
[root@shell ~]# [ 10 -lt 10 ] && echo 成立 || echo 不成立
17
不成立
18
⚠️ '小于，不包含等于'
19
[root@shell ~]# [ 10 -ge 10 ] && echo 成立 || echo 不成立
20
成立  '≥'
21
[root@shell ~]# [ 10 -le 10 ] && echo 成立 || echo 不成立
22
成立  '≤'

展开收起

支持变量#

Terminal window

1
[root@shell ~]# echo $num1
2
10
3
[root@shell ~]# echo $num2
4
10
5

6
[root@shell ~]# [ $num1 -eq $num2 ] && echo 成立 || echo 不成立
7
成立

支持命令#

Terminal window展开收起

1
[root@Rocky ~]# df -h | awk '/\/$/'
2
'先过滤出以根/结尾的行' --> 撬棍
3
/dev/mapper/rlm-root   16G  1.7G   15G  11% /
4
[root@shell ~]# df -h | awk -F "[ %]+" '/\/$/{print $(NF-1)}'
5
11
6
'获取根分区使用率（去掉 % 号）'
7
[root@shell ~]# [ `df -h | awk -F "[ %]+" '/\/$/{print $(NF-1)}'` -gt 10 ] && echo 成立 || echo 不成立
8
成立
9

10
'使用变量方式做比较 — 更清晰'
11
[root@shell ~]# disk=`df -h | awk -F "[ %]+" '/\/$/{print $(NF-1)}'`
12
[root@shell ~]# echo $disk
13
11
14
[root@shell ~]# [ $disk -gt 80 ] && echo 成立 || echo 不成立
15
不成立

展开收起

灵活取值 — 子串删除配合整数比较#

Terminal window

1
'不加 awk -F 过滤，拿到的是 11% 带百分号'
2
[root@shell ~]# disk=`df -h | awk '/\/$/{print $(NF-1)}'`
3
[root@shell ~]# echo $disk
4
11%
5
[root@shell ~]# [ $disk -gt 10 ] && echo 成立 || echo 不成立
6
-bash: [: 11%: integer expression expected
7
不成立
8
# ❌ '带 % 不能直接做整数比较！'
9

10
'用 ${disk%\%} 去掉百分号'
11
[root@shell ~]# [ ${disk%\%} -gt 10 ] && echo 成立 || echo 不成立
12
成立

Tip

💡 ${disk%\%} — 用 \ 转义 %，表示从后面删除一个 % 字符

也可以用 ${disk%?} 删掉最后一个字符

Terminal window

1
[root@shell ~]# disk=$(df -h | awk '/\/$/{print $(NF-1)}')
2
[root@shell ~]# echo $disk
3
11%
4
[root@shell ~]# echo ${disk%?}
5
11

多整数比较 — `-o` 和 `-a`#

⚠️ -o / -a 是过时语法，现代 Shell 脚本中不推荐使用
请用 || / && 和 [[ ]] 替代 ✅

含义	❌ 旧写法（`-o`/`-a`）	✅ 推荐写法（`[[ ]]`）
OR	`[ A -o B ]`	`[[ A
AND	`[ A -a B ]`	`[[ A && B ]]`
混合	`[ A -a B -o C ]`	`[[ A && B

实战案例#

🌰 案例 1 — 磁盘使用率告警

Tip

脚本逻辑流程：

① 取主机名、IP、磁盘使用率 → ② 用 ${disk_use%\%} 去掉百分号 → ③ 整数比较判断 → ④ 大于阈值发告警，小于发正常通知

1
[root@shell ~]# cat disk.sh
2
#!/bin/bash
3

4
# 取值定义变量
5
HOST=`hostname`
6
IP=`hostname -I | awk '{print $1}'`
7
disk_use=`df -h | awk '/\/$/{print $(NF-1)}'`
8

9
# 比对判断
10
if [ ${disk_use%\%} -gt 10 ]
11
then
12
        python3 weixin.py "ShiHao" "${IP}_$HOST: 磁盘告警" "当前磁盘使用率为$disk_use,请快速处理!"
13
else
14
        python3 weixin.py "ShiHao" "${IP}_$HOST: 磁盘正常" "当前磁盘使用率为$disk_use,喝喝茶吧"
15
fi

展开收起

🌰 案例 2 — 内存使用率超过 80% 告警

Terminal window

1
[root@shell ~]# free | awk 'NR==2{print $3/$2*100}'
2
20.3711
3
[root@shell ~]# t=`free | awk 'NR==2{print $3/$2*100}'`
4
[root@shell ~]# [ ${t%.*} -eq 20 ] && echo 成立
5
成立

📌 ${t%.*} — 从后面删除 . 及之后的内容，拿到整数部分

🌰 案例 3 — 负载平均值大于 1 则告警

Terminal window

1
[root@shell ~]# uptime
2
    11:23:35 up    9:29,   2 users,   load average: 0.18, 0.11, 0.09
3
num1=$(uptime | awk -F'[ ,]+' '{print $NF}')
4
num2=$(uptime | awk -F'[ ,]+' '{print $(NF-1)}')
5
nmu3=$(uptime | awk -F'[ ,]+' '{print $(NF-2)}')
6

7
⚠️ '只有bc 和 awk命令支持小数' --> 可以都乘100再比较

📦 文件判断#

语法结构与判断符号#

Terminal window

1
# 语法结构
2
test -f /etc/hosts
3
[ -f /etc/hosts ]

符号	含义	说明
`-f`	==普通文件==存在则为真	`-f /etc/hosts`
`-d`	==目录==存在则为真	`-d /etc/`
`-e`	==存在==则为真（文件和目录都行）	`-e /etc/passwd`
`-r`	==可读==则为真	`-r /etc/hosts`
`-w`	==可写==则为真	`-w /etc/hosts`
`-x`	==可执行==则为真	`-x /etc/hosts`

Terminal window展开收起

1
1)基础演示
2
[root@shell ~]# [ -f /etc/hosts ] && echo 存在 || echo 不存在
3
存在
4
[root@shell ~]# [ -f /etc/ ] && echo 存在 || echo 不存在
5
不存在
6
# '/etc/ 是目录，不是普通文件'
7
[root@shell ~]# [ -d /etc/ ] && echo 存在 || echo 不存在
8
存在
9
[root@shell ~]# [ -e /etc/ ] && echo 存在 || echo 不存在
10
存在
11
[root@shell ~]# [ -e /etc/passwd ] && echo 存在 || echo 不存在
12
存在
13

14
2)权限判断
15
[root@shell ~]# [ -r /etc/hosts ] && echo 存在 || echo 不存在
16
存在
17
[root@shell ~]# [ -w /etc/hosts ] && echo 存在 || echo 不存在
18
存在
19
[root@shell ~]# [ -x /etc/hosts ] && echo 存在 || echo 不存在
20
不存在
21
# '普通文件默认没有执行权限' --> 0644
22
[root@shell ~]# [ -x /etc/ ] && echo 存在 || echo 不存在
23
存在
24
# '目录默认有执行权限（x 对目录意味着可以 cd 进去）' --> 755

展开收起

实战案例#

🌰 案例 1 — 文件存在则 source 执行

Terminal window

1
[root@shell ~]# unset name
2
[root@shell ~]# cat a.sh
3
name=gege
4
[root@shell ~]# echo $name
5
'🈳'
6
[root@shell ~]# cat test.sh
7
#!/bin/bash
8
[ -f /root/a.sh ] && . /root/a.sh
9
echo $name
10

11
[root@shell ~]# bash test.sh
12
gege
13
# 'a.sh 存在，source 执行后 $name 被导入当前脚本'

🌰 案例 2 — .bashrc 中的 -f 判断

.bashrc

1
[root@shell ~]# cat ~/.bashrc
2
# Source global definitions
3
if [ -f /etc/bashrc ]; then        # 如果 /etc/bashrc 存在则调用执行
4
        . /etc/bashrc
5
fi
6

7
# User specific aliases and functions
8
alias rm='rm -i'
9
alias cp='cp -i'
10
alias mv='mv -i'

📌 这就是之前讲过的：~/.bashrc 里主动 source /etc/bashrc

🌰 案例 3 — 目录不存在则创建

Terminal window

1
[root@shell ~]# [ -d oldboy ] || mkdir oldboy
2
# 'oldboy 目录不存在 → 创建'

🌰 案例 4 — 支持 -o 和 -a

Terminal window

1
[root@shell ~]# [ -f /etc/hosts -o -d hehe ] && echo 成立 || echo 不成立
2
成立
3
# '/etc/hosts 存在，-o 只要一个成立即可'
4
✅ 比起上面的方法，我更推荐下面这种方法
5
[root@shell ~]# [[ -f /etc/hosts || -d hehe ]] && echo 成立 || echo 不成立
6
成立
7

8
[root@shell ~]# [[ -f /etc/hosts && -d hehe ]] && echo 成立 || echo 不成立
9
不成立
10
# '/etc/hosts 存在但 hehe 目录不存在，&& 要求全部成立'

🔣 字符串判断#

语法结构#

Terminal window

1
test a = a
2
[ a = a ]
3
[ a != b ]

判断符号#

符号	含义
`=`	字符串相等
`!=`	字符串不相等
`-n`	字符串长度==不为 0==则成立 ==n==ot empty（非空则为真）
`-z`	字符串长度==为 0==则成立 ==z==ero length（长度为 0 则为真）

Tip

✅ -n 和 -z 是相反的

-n 和 -z 直接判断变量本身的值即可
- 不需要使用 ${#name}

Terminal window

1
1)字符串相等/不相等
2
[root@shell ~]# [ root = root ] && echo 相等 || echo 不等于
3
相等
4
[root@shell ~]# [ aroot = root ] && echo 相等 || echo 不等于
5
不等于
6

7
2)判断字符串长度 -n 和 -z
8
[root@shell ~]# num=123
9
[root@shell ~]# [ -n $num ] && echo 成立 || echo 不成立
10
成立
11
# '-n 长度不为 0 → 成立'
12
[root@shell ~]# [ -z $num ] && echo 成立 || echo 不成立
13
不成立
14
# '-z 长度为 0 → 不成立'

Warning

⚠️ 重要提醒：务必加双引号

Terminal window

1
3)错误示范
2
[root@shell ~]# num=
3
[root@shell ~]# [ -n $num ] && echo 成立 || echo 不成立
4
成立  '我给了一个空，应该是不成立的 ❌'
5
[ -n $num ] → shell 展开为 [ -n ] → 永远成立（bug！）
6
[ -n "$num" ] → shell 展开为 [ -n "" ] → 正确判断空字符串 → 返回假 ✅
7
[root@shell ~]# [ -n "$num" ] && echo 成立 || echo 不成立
8
不成立
9
# 一定加引号
10
[root@shell ~]# [ -z "$num" ] && echo 成立 || echo 不成立
11
成立
12
# 长度为 0 → -z 成立'

Note

唯一不需要加引号的场景是纯数字算术比较且你确定变量==一定是合法整数==

但即便如此，加引号也不会有任何副作用

💡 终极建议：不要记”哪个可以省引号”，养成无条件加双引号的肌肉记忆 ✅

Terminal window

1
# ✅ 永远这样写
2
[ -n "$var" ]
3
[ -z "$var" ]
4
[ "$a" = "$b" ]
5
[ "$count" -gt 0 ]

实战案例#

🌰 案例 1 — 字符串比对（登录验证）

1
[root@shell ~]# cat name.sh
2
#!/bin/bash
3
echo -e "web01 web01@123.com\nweb02 web02@123.com\njiu jiu@123.com" > ./a.txt
4
read -p "请输入你的用户名: " name
5
num=`grep -w $name a.txt | wc -l`
6
# -w精确匹配 0/1
7
[ "$num" -ne 1 ] && echo 用户名错误请重新输入 && exit
8

9
read -s -p "请输入你的密码: " passwd
10
echo -e "\n"
11
[ "$passwd" != `grep -w $name a.txt | awk '{print $2}'` ] && echo 密码错误重新输入 && exit
12
echo 恭喜你登录成功
13
[root@shell ~]# cat ./a.txt
14
web01 web01@123.com
15
web02 web02@123.com
16
jiu jiu@123.com

展开收起

🌰 案例 2 — 限制用户输入不能为空

1
[root@shell ~]# cat test.sh
2
#!/bin/bash
3
read -p "请输入你的姓名: " name
4
[ -z "$name" ] && echo "必须输入姓名" && exit
5

6
read -p "请输入你的年龄: " age
7
[ -z "$age" ] && echo "必须输入年龄" && exit
8

9
echo name=$name
10
echo age=$age

⚙️ 正则判断#

语法结构#

1
[[ 字符串 =~ 正则表达式 ]]

Important

正则判断必须用 [[ ]] ==双中括号==，不能用 [ ] 单中括号

=~ 是正则匹配操作符

基础用法#

Terminal window展开收起

1
'^ 匹配开头，$ 匹配结尾'
2
[root@shell ~]# [[ root =~ ^r ]]
3
[root@shell ~]# echo $?
4
0
5
# '以 r 开头 → 匹配成功'
6

7
[root@shell ~]# [[ root =~ t$ ]]
8
[root@shell ~]# echo $?
9
0
10
# '以 t 结尾 → 匹配成功'
11

12
[root@shell ~]# [[ root =~ o ]]
13
[root@shell ~]# echo $?
14
0
15
# '包含字母 o → 匹配成功'
16
⚠️ 不会自动加 ^（不强制开头匹配）
17

18
'包含判断'
19
[root@shell ~]# [[ $USER =~ t$ ]] && echo 成立 || echo 不成立
20
成立
21
[root@shell ~]# [[ root =~ s ]] && echo 成立 || echo 不成立
22
不成立

展开收起

正则模式#

Terminal window展开收起

1
'[a-z] 匹配单个小写字母'
2
[root@shell ~]# [[ root =~ [a-z] ]] && echo 成立 || echo 不成立
3
成立
4

5
'^[a-z]+$ 匹配纯小写字母字符串'
6
# + 连续出现（一次及以上）
7
[root@shell ~]# [[ root =~ ^[a-z]+$ ]] && echo 成立 || echo 不成立
8
成立
9
[root@shell ~]# [[ 1root =~ ^[a-z]+$ ]] && echo 成立 || echo 不成立
10
不成立
11
# '1root、root1，中间有数字也不行'
12

13
'[a-Z] 匹配字母（含大小写）'
14
[root@shell ~]# [[ Aroot =~ ^[a-Z]+$ ]] && echo 成立 || echo 不成立
15
成立

展开收起

实战案例#

通过正则匹配控制传入的参数

Tip

正则中使用 “并且” 和 “或者”

Terminal window

1
&&  # 并且 — [[ ]] 内部使用
2
||  # 或者 — [[ ]] 内部使用

1
[root@shell ~]# cat test.sh
2
#!/bin/bash
3
read -p "请输入你的姓名: " name
4
if [[ ! "$name" =~ ^[a-z]+$ ]]        # 如果姓名不是连续的字符串则表达式成立
5
then                                 # 成立则执行 then 后面的动作
6
        echo "必须输入字符串"
7
        exit
8
fi
9

10
read -p "请输入你的年龄: " age
11
if [[ ! "$age" =~ ^[0-9]+$ ]]         # 如果年龄不是连续的数字则表达式成立
12
then                                 # 成立则执行 then 后面的动作
13
        echo "必须输入整数"
14
        exit
15
fi
16

17
echo name=$name
18
echo age=$age

展开收起

⚙️ if 条件判断#

单分支（一个条件一个结果）#

类似 [ 10 -eq 10 ] && echo 成立

Terminal window

1
if [ 条件表达式 ]
2
then
3
        命令集合
4
fi
5

6
⚠️ 如果 then 写在 if 后面，'需要有;分号'
7
if [ 条件表达式 ];then
8
        命令集合
9
fi

Tip

分号与换行：];then 可以写在一行（中间必须有分号 ;）

也可以把 then 单独写在下一行（此时不需要分号）

1
1)单分支各种写法
2
[root@shell ~]# cat if.sh
3
#!/bin/bash
4
if [ 10 -eq 10 ];then
5
        echo 成立
6
fi
7

8
if [ 10 -eq 10 ]
9
then
10
        echo 成立
11
fi
12

13
if [ -f /etc/hosts ]
14
then
15
        echo 成立
16
fi
17

18
if [[ root =~ t$ ]]
19
then
20
        echo 成立
21
fi
22

23
if [ 10 -eq 10 -o -f /etc/hosts ];then
24
# -o 单括号
25
        echo 成立
26
fi
27

28
if [[ 10 = 10 && etc =~ e ]];then
29
# && 是双括号
30
        echo 成立
31
fi
32

33
[root@shell ~]# bash test.sh
34
成立
35
成立
36
成立
37
成立
38
成立
39
成立

展开收起

Note

📌 if 后面可以是 ==任何条件判断==：

整数比较 [ 10 -eq 10 ]
文件判断 [ -f /etc/hosts ]
字符串判断 [ root = root ]
正则判断 [[ root =~ t$ ]]
多条件组合 [[ 10 = 10 && etc =~ e ]]

双分支（一个条件两个结果）#

类似 [ 10 -eq 10 ] && echo 成立 || echo 不成立

Terminal window

1
if [ 条件表达式成立 ];then
2
       执行命令
3
else
4
       执行命令
5
fi

1
[root@shell ~]# cat tesh.sh
2
#!/bin/bash
3
if [ -f $1 ];then
4
        echo $1文件存在
5
else
6
        echo $1文件不存在
7
fi
8
[root@shell ~]# bash test.sh /etc/hosts
9
/etc/hosts文件存在
10
[root@shell ~]# bash test.sh /blogggggggggg
11
/blogggggggggg文件不存在
12
[root@shell ~]# bash test.sh /etc
13
/etc文件不存在
14
# '/etc/ 是目录，-f 判断为假'

多分支（多个条件、多个结果）#

Terminal window

1
if [ 条件表达式1 ];then
2
        命令
3
elif [ 条件表达式2 ];then
4
        命令
5
elif [ 条件表达式3 ];then
6
        命令
7
elif [ 条件表达式4 ];then
8
        命令
9
else
10
        命令
11
fi

实战案例#

🌰 案例 1 — 传入 2 个整数比较大小

1
[root@shell ~]# cat diff.sh
2
#!/bin/bash
3
read -p "输入两个整数空格间隔: " num1 num2
4
if [[ ! "$num1" =~ ^[0-9]+$ ]];then
5
  echo 请输入整数
6
  exit
7
fi
8
if [[ ! "$num2" =~ ^[0-9]+$ ]];then
9
  echo 请输入整数
10
  exit
11
fi
12

13
if [ $num1 -eq $num2 ]
14
then
15
        echo "$num1 = $num2"
16
# 这里输出的是一整个字符串 --> 整体
17
elif [ $num1 -gt $num2 ]
18
then
19
        echo "$num1 > $num2"
20
else
21
        echo "$num1 < $num2"
22
fi

展开收起

✨ 颜色输出#

颜色码	颜色
`\e[31m`	红色
`\e[32m`	绿色
`\e[33m`	黄色
`\e[34m`	蓝色
`\e[0m`	==重置颜色==

💡 核心使用公式

Terminal window

1
echo -e "\e[颜色码m 你的文字 \e[0m"

Note

必须使用 echo -e，普通的 echo 不会解析 \e 转义符。
文字后面务必加上 \e[0m 重置颜色，否则终端后续的所有输出都会变成该颜色

1
#!/bin/bash
2

3
echo -e "\e[34m====== 系统管理菜单 ======\e[0m"
4
echo -e "\e[32m（1）启动服务\e[0m"
5
echo -e "\e[33m（2）查看日志\e[0m"
6
echo -e "\e[31m（3）停止服务\e[0m"
7
echo -e "\e[34m=========================\e[0m"
8

9
read -p "请输入选项（1|2|3|4）: " choice
10

11
if [ "$choice" == "1" ]; then
12
# 这里是字符串判断
13
    echo -e "\e[32m✔ 服务启动成功\e[0m"
14
elif [ "$choice" -eq 2 ]; then
15
# 这里是数字比较（整数）
16
    echo -e "\e[33m⚠ 正在读取日志...\e[0m"
17
elif [ $choice == "3" ]; then
18
    echo -e "\e[31m✘ 服务已停止\e[0m"
19
else
20
    echo -e "\e[31m✘ 无效选项\e[0m"
21
fi

展开收起

📌 进阶小贴士（避免重复写颜色码）

在实际写脚本时，每次都写 \e[31m...\e[0m 会很繁琐，推荐在脚本开头定义变量：

Terminal window

1
RED='\e[31m'
2
GREEN='\e[32m'
3
YELLOW='\e[33m'
4
BLUE='\e[34m'
5
RESET='\e[0m'
6

7
# 使用时直接拼接，简洁且不易漏掉重置符
8
echo -e "${GREEN}操作成功${RESET}"
9
echo -e "${RED}错误：文件不存在${RESET}"

📌 小结#

Important

本章从变量子串出发，覆盖了 Shell 编程中最常用的变量操作和条件判断：

章节	核心知识点	关键语法
变量子串 — 长度	统计字符串长度	`${#变量}` ⭐
变量子串 — 删除	从前往后/从后往前删除	`#` `##` `%` `%%`
变量子串 — 替换	替换第一个/替换全部	`/` `//`
数值运算	6 种运算方式	`$(())` ⭐ `bc` `let`
整数比较	6 个比较符号	`-eq` `-ne` `-gt` `-ge` `-lt` `-le`
文件判断	6 个文件测试	`-f` `-d` `-e` `-r` `-w` `-x`
字符串判断	相等/不等/长度	`=` `!=` `-n` `-z`
正则判断	`[[ ]]` 中 `=~` 匹配	`^` `$` `[a-z]` `+`
if 判断	单分支/双分支/多分支	`if-then-elif-else-fi`

Shell编程基础

Sat, 20 Jun 2026 00:00:00 GMT

Shell编程基础#

[TOC]

🧱 什么是Shell#

Shell 是==命令解释器==，负责翻译用户输入的命令给内核，内核处理完成后返回给 Shell

Terminal window

1
┌──────────────┐     ┌──────────────┐     ┌─────────────────┐
2
│   用户        │────▶│    Shell     │────▶│     内核        │
3
│ (输入命令)     │     │ (翻译+调度)   │     │ (真正干活)       │
4
└──────────────┘     └──────┬───────┘     └────────┬────────┘
5
                            │                      │
6
                            ▼                      ▼
7
                       [调用系统调用]         [访问硬件：磁盘/内存/CPU]
8
                            │                      │
9
                            ◀─────── 结果返回 ───────┘
10
                                     │
11
                                     ▼
12
                           'Shell 输出结果到终端 → 你看到！'

Tip

📌 一句话：Shell 就是你跟内核之间的”翻译官”

Linux默认交互式 Shell（👤 人类用户）的解释器是 bash
- 当你打开终端、SSH 登录服务器时，系统自动启动的那个 Shell（交互式shell）

Terminal window

1
1)默认交互式shell
2
[root@Rocky ~]# bash
3
[root@Rocky ~]# exit
4
exit
5
[root@Rocky ~]# exit
6
logout
7

8
root@Ubuntu ~# bash
9
root@Ubuntu ~# exit
10
exit
11
root@Ubuntu ~# exit
12
logout

/bin/sh 是==🤖 脚本中==默认的解释器，但前提是脚本**没有写 Shebang（#!）**或者显式调用了 /bin/sh
- 是一个标准化的系统接口，用于执行非交互式的 Shell

Terminal window展开收起

1
2)Red Hat系
2
`/bin/sh` 指向的就是 `bash`：
3
✅ bash 好用、功能丰富
4
[root@Rocky ~]# ll /bin/sh
5
lrwxrwxrwx. 1 root root 4 Oct 29  2024 /bin/sh -> bash
6
[root@Rocky ~]# ll /bin/bash
7
-rwxr-xr-x. 1 root root 1410688 Oct 29  2024 /bin/bash
8

9
3)Debian/Ubuntu 系
10
`/bin/sh` 实际指向的就是 `dash`：
11
⚠️ bash ≠ dash（不支持 `[[ ]]`、数组等 bash 特性，但快速、轻量）
12
# 不可以随意使用 bash 扩展语法
13
root@Ubuntu ~# ll /bin/sh
14
lrwxrwxrwx 1 root root 4 Mar 31  2024 /bin/sh -> dash*
15
root@Ubuntu ~# ll /bin/dash
16
-rwxr-xr-x 1 root root 129784 Mar 31  2024 /bin/dash*
17
'他是有/bin/bash的'
18
root@Ubuntu ~# ll /bin/bash
19
-rwxr-xr-x 1 root root 1446024 Mar 31  2024 /bin/bash*

展开收起

Warning

正因为 Ubuntu 的 sh 是 dash，在编写 Shell 脚本时必须使用#!/bin/bash 作为 Shebang，而不能用 #!/bin/sh

想用 bash 特性 → 必须写 #!/bin/bash
永远不要假设 /bin/sh 就是 bash，尤其是在 Ubuntu/Debian 系统上！

🚢 Shell编程的作用#

面试题：给你一台服务器，对服务器操作流程是什么样的？

Terminal window展开收起

1
1)硬件准备
2
# 组RAID
3

4
2)安装操作系统
5
# 自动化安装 cobbler、kickstart 脚本
6

7
3)系统优化
8
# 优化SSH、加大文件描述符、时间同步、优化防火墙、安装常用软件、内核优化 ... 脚本
9

10
4)安装服务、优化服务
11
# yum、编译 脚本
12

13
5)监控服务
14
# 脚本
15

16
6)日志切割、定时任务
17
# 防止日志过大
18

19
7)日志统计处理
20

21
8)编写启停脚本
22
# python程序、jar包...
23

24
9)辅助程序正常运行
25
# 资源满导致负载过高 -> 自动杀死进程

展开收起

📌 可以看到，Shell 编程贯穿了服务器运维的==整个生命周期==

⚙️ Shell脚本规范#

序号	规范	说明
①	脚本开头指定解释器	`#!/bin/bash`，Redhat系可写可不写（sh —> bash） Debian系必须指定（sh —> dash）
②	脚本名称结尾	以 `.sh` 结尾
③	见名知意	脚本名称要能看出功能
④	避免中文符号	脚本中不能出现中文符号 "" '' `` {} () [] , . <>
⑤	成对符号一次写完	写 `{}` `[]` `()` 时一次写完，避免遗漏
⑥	统一存放位置	脚本放在同一个位置，方便管理
⑦	写注释	注明作用、功能、作者

Tip

💡 新服务器如何找到所有 shell 脚本的位置？

查看定时任务 crontab -l ✅
查看进程 ps aux | grep sh ✅
- 执行一个脚本文件时，操作系统会将该脚本的==完整路径==作为参数传递给==解释器进程==
- 而 ps aux 恰好能捕获并显示这个完整的==命令行参数==
查看 history 记录 ✅
find 可以查找，但业务运行中不要在 / 开始查找
下下策：grep -r bash /*

📌 学习 Shell 需要的基础：① Linux 系统命令 ② 三剑客（grep/sed/awk） ③ vim

⚙️ 第一个Shell脚本#

1
# 脚本内容
2
[root@Rocky ~]# cat test.sh
3
#!/bin/bash
4
echo "Hello World!"     # 将字符输出到屏幕，支持中文
5

6
# 执行脚本
7
[root@Rocky ~]# sh test.sh
8
Hello World!

⚙️ 执行Shell脚本的方式#

三种常用执行方式#

第一种：`sh` / `bash`#

Terminal window

1
[root@Rocky ~]# ls /server/sh/
2
bash_config.sh
3
[root@Rocky ~]# mv test.sh /server/sh/
4
[root@Rocky ~]# cd /server/sh/
5
[root@Rocky sh]# sh test.sh
6
Hello World!
7
[root@Rocky sh]# bash test.sh
8
Hello World!

Tip

✅ 推荐用 bash 执行，Debian系的 ==sh —> dash== ⚠️

dash 是一个严格遵循 POSIX 标准的轻量级 Shell，它不支持大量 Bash 扩展语法

第二种：路径方式（需要 `+x` 执行权限）#

Terminal window展开收起

1
# 绝对路径
2
'以根 / 开始'
3
[root@Rocky sh]# /server/sh/test.sh
4
-bash: /server/sh/test.sh: Permission denied   # 权限拒绝
5

6
[root@Rocky sh]# chmod +x test.sh
7
[root@Rocky sh]# ll test.sh
8
-rwxr-xr-x 1 root root 40 Jan 19 10:14 'test.sh'
9
[root@Rocky sh]# /server/sh/test.sh
10
Hello World!
11

12
# 相对路径
13
[root@Rocky sh]# ./test.sh        # 使用 ./ 路径方式执行脚本
14
'点./ 路径'
15
Hello World!

展开收起

Note

⚠️ 直接输入脚本名 test.sh 会报 command not found（命令未找到），必须用 ./test.sh

❌ 上面 test.sh 会去找 —> PATH变量（压根没有这个命令）

第三种：`source` / `.`（紧跟空格）#

Terminal window

1
[root@Rocky sh]# source test.sh
2
Hello World!
3
[root@Rocky sh]# . test.sh
4
Hello World!

其他执行方式#

1
1)管道传给 bash（最常用）
2
# 它把前一个命令原本要打印到'屏幕上的内容'，转而塞进了后一个命令的标准输入通道里
3
[root@Rocky sh]# cat test.sh
4
#!/bin/bash
5
echo "Hello World!"     # 将字符输出到屏幕，支持中文
6
[root@Rocky sh]# cat test.sh | bash
7
Hello World!
8

9
[root@Rocky sh]# echo touch haha.txt
10
touch haha.txt
11
[root@Rocky sh]# echo touch haha.txt | bash
12
[root@Rocky sh]# ll haha.txt
13
-rw-r--r-- 1 root root 0 Jun 22 10:55 haha.txt
14

15
2)远程执行
16
[root@Rocky sh]# curl https://kpyun.fun/test.sh
17
#!/bin/bash
18
echo "远程执行命令中ing..."
19
-S配合-s使用    # 静默模式下，如果发生错误，仍然显示错误信息
20
-L          # 跟随重定向（如 301/302）
21
[root@Rocky sh]# curl -sSL https://kpyun.fun/test.sh |bash
22
远程执行命令中ing...
23

24
3)重定向方式
25
[root@Rocky sh]# bash < test.sh
26
Hello World!

展开收起

执行方式的区别#

Important

📌 关键区别：

bash / 路径方式 —> 在子进程中执行命令（执行完后，自动退出）
source script.sh / . script.sh —> 当前 Shell（父进程）==逐行读取并解析==（不会创建新的进程）
- 无需 x 权限

⚠️ 路径方式（需要 +x 执行权限），其它都不需要 x 权限

子进程：默认继承父进程中 export过的环境变量（全局变量），脚本中的变量不会影响当前终端
- 它不会继承父进程的普通变量
父进程：脚本中的变量会保留在当前终端

📦 Shell变量#

变量分类#

分类	作用域	定义方式
==系统变量==（全局变量）	全局生效（国法）	`export name=oldboy` 写入 `/etc/profile`
==普通变量==（局部变量）	局部生效（家规）	直接定义 `dir=/data/wordpress`

Tip

env → 只看已 export 的环境变量，这些变量会传递给子进程
set → 看当前 Shell 的所有变量（包括环境变量 + 未导出的局部/普通变量）

Terminal window展开收起

1
[root@Rocky sh]# env
2
SHELL=/bin/bash
3
..............
4
HOSTNAME=Rocky
5
PWD=/server/sh
6
[root@Rocky sh]# set | wc -l
7
1698
8

9
1)子进程只继承全局变量
10
[root@Rocky ~]# name=jiuzhao  # 普通变量
11
[root@Rocky ~]# echo ${name}  # 当前shell生效
12
jiuzhao
13
[root@Rocky ~]# cat test.sh
14
echo ${name}
15
[root@Rocky ~]# bash test.sh
16
🈳  '子进程不会继承普通变量'
17
[root@Rocky ~]# export name=jiuzhao    # 声明为全局变量
18
[root@Rocky ~]# bash test.sh
19
jiuzhao # 这样子进程就可以继承到了
20

21
2)source / . --> 当前shell
22
'无需 +x 执行权限' ✅ 无论是局部变量，还是全局变量都会生效
23
[root@Rocky ~]# class=kpyun
24
[root@Rocky ~]# echo $class
25
kpyun
26
[root@Rocky ~]# cat test.sh
27
echo ${class}
28
[root@Rocky ~]# ll test.sh
29
-rw-r--r-- 1 root root 14 Jun 22 14:46 test.sh
30
# 没有x执行权限
31
[root@Rocky ~]# source test.sh
32
kpyun
33
[root@Rocky ~]# . test.sh
34
kpyun
35

36
3)路径（子进程）执行，必须有 +x 执行权限
37
[root@Rocky ~]# ./test.sh
38
-bash: ./test.sh: Permission denied
39
[root@Rocky ~]# chmod +x test.sh
40
[root@Rocky ~]# ./test.sh
41
'🈳'
42
[root@Rocky ~]# export class=kpyun  # 依旧是必须得全局声明
43
[root@Rocky ~]# ./test.sh
44
kpyun
45

46
4)⚠️ 取消变量
47
[root@Rocky ~]# unset class
48
[root@Rocky ~]# echo $class
49
'🈳'
50

51
5)不加 export
52
# 只对当前的 bash 生效
53
[root@Rocky ~]# unset name
54
[root@Rocky ~]# name =jiuzhao
55
-bash: name: command not found '等于号两边没有空格'
56
[root@Rocky ~]# name=jiuzhao
57
[root@Rocky ~]# echo $name
58
jiuzhao
59
[root@Rocky ~]# bash    # 进入到子进程
60
[root@Rocky ~]# echo $name
61
'🈳'
62
[root@Rocky ~]# ps auxf | grep sh
63
'f' --> 以树形结构显示
64
root  1066   ?        S    09:27   0:08  \_ sshd-session: root@pts/0
65
root  1067   pts/0    Ss   09:27   0:00      \_ -bash ✅ 父进程
66
root  1851   pts/0    S    15:09   0:00          \_ bash ✅ 子进程
67
root  1873   pts/0    S+   15:09   0:00              \_ grep --color=auto sh
68
💡 只有全局变量（export） --> 对所有的 bash（子进程）生效

展开收起

变量名称定义规范#

规则	示例
下划线、字符串、数字的组合	`name` `_name` `Name_Age`
等号两端==不允许有空格==	`name=oldboy` ✅ `name = oldboy` ❌
名字不能以数字开头	`1name` ❌ `name1` ✅
见名知意	`dir=/etc` `code=/data/wordpress`
命名风格	大驼峰 `NameAge`、小驼峰 `nameAge`、全大写 `NAME`、全小写 `name`

Terminal window

1
[root@Rocky ~]# name=oldboy       # ✅
2
[root@Rocky ~]# name= oldboy      # ❌
3
[root@Rocky ~]# name = oldboy     # ❌
4
[root@Rocky ~]# 1name=oldboy      # ❌
5
[root@Rocky ~]# _name=oldboy      # ✅
6
[root@Rocky ~]# echo $_name
7
oldboy  '这里是变量名称'

变量值的定义#

Note

值必须是连续的数字或字符串，⚠️ 如果不连续则使用单引号或双引号

数字定义：#

Terminal window

1
[root@Rocky ~]# age=22
2
[root@Rocky ~]# echo $name
3
jiuzhao
4
[root@Rocky ~]# age=22 45
5
-bash: 45: command not found
6
❌ 不连续的必须用'单引号或双引号'
7
[root@Rocky ~]# age="23    423"
8
[root@Rocky ~]# echo $age
9
23 423
10
[root@Rocky ~]# age='23    423'
11
[root@Rocky ~]# echo $age
12
23 423

字符串定义：#

Terminal window

1
[root@Rocky ~]# name=fjiewjfiw         # ✅ 连续字符串
2
[root@Rocky ~]# name=fjie wjfiw        # ❌
3
[root@Rocky ~]# name='fjie wjfiw'      # ✅ 有空格（不连续）必须加引号
4
'单引号 or 双引号都是可以的'
5
[root@Rocky ~]# echo $name
6
fjie wjfiw
7

8
# 变量在路径中的使用
9
[root@Rocky ~]# dir=/etc/sysconfig/network-sh/
10
[root@Rocky ~]# echo $dir
11
/etc/sysconfig/network-sh/
12
[root@Rocky ~]# cd $dir
13
[root@Rocky network-sh]# pwd
14
/etc/sysconfig/network-sh

命令定义：#

Terminal window

1
✅ 使用反引号 `` 或 $()
2
[root@Rocky ~]# IP=`hostname -I`
3
[root@Rocky ~]# echo $IP
4
10.0.0.71 172.16.1.71
5

6
[root@Rocky ~]# IP=`hostname -I | awk '{print $1}'`
7
[root@Rocky ~]# echo $IP
8
10.0.0.71
9

10
[root@Rocky ~]# HOST=$(hostname)
11
[root@Rocky ~]# echo $HOST
12
Rocky

变量拼接：#

Terminal window展开收起

1
1)单个变量定义
2
[root@Rocky ~]# TIME=`date +"%F %T"`
3
[root@Rocky ~]# echo $TIME
4
2026-06-22 17:24:22
5
[root@Rocky ~]# echo $IP
6
10.0.0.71
7
[root@Rocky ~]# echo $HOST
8
Rocky
9

10
2)变量拼接
11
[root@Rocky ~]# DIR=$IP_$HOST_$TIME
12
[root@Rocky ~]# echo $DIR
13
2026-06-22 17:24:22 ❌
14
'${变量名} 用花括号明确变量边界'
15
[root@Rocky ~]# DIR=${IP}_${HOST}_$TIME
16
[root@Rocky ~]# echo $DIR
17
10.0.0.71_Rocky_2026-06-22 17:24:22

展开收起

不加引号 vs 单引号 vs 双引号#

方式	行为	示例
不加引号	可以解析变量	`DIR=$IP`
`"双引号"`	可以解析变量	`DIR="$IP"` → 解析
`'单引号'`	==所见即所得==，不能解析变量	`DIR='$IP'` → 原样输出

Terminal window

1
[root@Rocky ~]# DIR=${IP}_${HOST}_$TIME
2
[root@Rocky ~]# echo $DIR
3
10.0.0.71_Rocky_2026-01-19-11-29
4

5
[root@Rocky ~]# DIR="${IP}_${HOST}_$TIME"
6
[root@Rocky ~]# echo $DIR
7
10.0.0.71_Rocky_2026-01-19-11-29
8

9
[root@Rocky ~]# DIR='${IP}_${HOST}_$TIME'
10
[root@Rocky ~]# echo $DIR
11
${IP}_${HOST}_$TIME
12
# 单引号所见即所得！

命令定义方式的注意事项#

Note

命令可以定义为==命令==，也可以定义为==字符串==：

Terminal window展开收起

1
1)定义为命令（反引号）
2
[root@Rocky ~]# TIME=`date +%F-%H-%M`
3
⚠️ '时间已经被写死了'
4
[root@Rocky ~]# echo $TIME
5
2026-01-19-11-37
6
[root@Rocky ~]# $TIME
7
-bash: 2026-01-19-11-37: command not found
8
📌 固定死了的值 --> 无法作为命令
9

10
2)定义为字符串（单引号）
11
[root@Rocky ~]# TIME='date +%F-%H-%M'
12
[root@Rocky ~]# echo $TIME
13
date +%F-%H-%M
14
# '此时 $TIME 的值是一个字符串'
15
✅ 可以直接在终端执行
16
'字符串方式定义的 TIME，执行 $TIME 相当于直接执行 date +%F-%H-%M'
17
[root@Rocky ~]# $TIME
18
2026-01-19-11-42-53
19
[root@Rocky ~]# $TIME
20
2026-01-19-11-42-54
21
'每次执行都会获取最新时间！' 📌 会随时间变化

展开收起

📦 变量相关文件#

🧱 两个维度：登录方式 × 交互方式#

判断一个 Shell 会加载哪些配置文件，需要同时看两个==正交的维度==：

维度	分类	判断标准	决定什么
登录方式	Login / Non-login	有没有走登录流程（输密码、`su -`）	读不读 `/etc/profile`
交互方式	Interactive / Non-interactive	有没有终端提示符（人能不能打字）	读不读 `~/.bashrc`

这两个维度可以组合出 4 种场景：

#	场景	登录	交互	典型例子
①	交互式登录 Shell	Login	Interactive	SSH 登录、tty 登录、`su -`
②	交互式非登录 Shell	Non-login	Interactive	终端里敲 `bash`、`su`（无横杠）
③	非交互式非登录 Shell	Non-login	Non-interactive	执行脚本 `bash script.sh`、cron 定时任务
④	非交互式登录 Shell	Login	Non-interactive	`bash -l script.sh`、`echo cmd \| ssh user@host`

Important

📌 运维中最常打交道的是 ①②③，④ 极少见

⚠️ ③ 是最大的坑：脚本执行时 既不读 /etc/profile，也不读 ~/.bashrc

🔗 四种场景的加载链条#

① 交互式 Login Shell — SSH 登录 / tty / `su -`#

🚪 进大门 → 刷门禁卡（加载 /etc/profile）→ 这是你一天中第一次也是唯一一次刷这张卡

Terminal window

1
/etc/profile（bash 自己读）    ← ① 系统级”欢迎礼包”（所有用户通用）
2
    ↓
3
~/.bash_profile（bash 自己读） ← ② 用户级”个人偏好”
4
    ↓ 通常它会主动 source ✅ '里面有判断' # 如果存在则拉进来
5
~/.bashrc             ← ③ 交互式配置（别名、颜色、补全）
6
    ↓   ✅ # 这里面也有判断
7
/etc/bashrc           ← ④ 系统级 bash 交互配置

🔍 ==细节纠正==：其实 ==bash 自己只读了前 2 个==，后面的文件是被拉进来的

Terminal window展开收起

1
'Rocky'
2
# /etc/profile  ⭕ 👇 '子目录下的所有.sh结尾的文件'
3
for i in /etc/profile.d/*.sh ; do
4
    if [ -r “$i” ]; then
5
        if [ “${-#*i}” != “$-” ]; then
6
            . “$i”
7
========================================
8
# ~/.bash_profile
9
if [ -f ~/.bashrc ]; then
10
        . ~/.bashrc    ✅ 包含 ~/.bashrc
11
fi
12
========================================
13
# ~/.bashrc
14
if [ -f /etc/bashrc ]; then
15
        . /etc/bashrc  ✅ 包含 /etc/bashrc
16
fi
17
========================================
18
# /etc/bashrc  ⭕ 👇/etc/profile.d/下的所有.sh结尾的文件
19
for i in /etc/profile.d/*.sh; do
20
    if [ -r "$i" ]; then
21
        if [ "$PS1" ]; then
22
            . "$i"

展开收起

② 交互式 Non-login Shell — 终端里敲 `bash` / `su`#

🚶 进办公室 → 刷工位卡（加载 ~/.bashrc）→ 每进一间都要刷，但刷的是==另一张卡==

Terminal window

1
/etc/bashrc           ← ① bash 自己先读这个（系统级）
2
    ↓
3
~/.bashrc             ← ② bash 再读这个（用户级，覆盖/追加系统设置）
4
# 注：RedHat 系的 ~/.bashrc 里通常也会主动 source /etc/bashrc
5
📌 所以实际上 /etc/bashrc 会被读两遍 —— bash 先读一次，~/.bashrc 再拉一次

Caution

⚠️ 交互式 Non-login Shell 完全跳过 /etc/profile 和 ~/.bash_profile

所以你在 /etc/profile 里定义的 alias → 新开的 bash 里用不了

✅ 正确做法：alias 写进 /etc/bashrc 或 ~/.bashrc

③ 非交互式 Non-login Shell — 执行脚本 / cron#

Warning

🤖 这是最容易被忽视的场景，也是坑最多的地方

Terminal window展开收起

1
'执行脚本时，bash 既不读 /etc/profile，也不读 ~/.bashrc'
2
[root@Rocky ~]# cat test.sh
3
echo $NAME
4
echo $HOME
5
alias
6
========================================
7
'当前终端里 NAME 是有的（~/.bashrc 里定义的）'
8
[root@Rocky ~]# unset NAME
9
[root@Rocky ~]# tail -1 ~/.bashrc
10
NAME=jiuzhao
11
[root@Rocky ~]# echo $NAME
12
🈳
13
[root@Rocky ~]# source ~/.bashrc
14
✅ source后才会生效
15
[root@Rocky ~]# echo $NAME
16
jiuzhao
17
========================================
18
'但脚本里就是看不到！'
19
[root@Rocky ~]# bash test.sh
20
🈳             # NAME 为空！
21
/root         # HOME 是 bash 内置的，不受影响
22
🈳             # alias 也没有！
23
========================================
24
[root@Rocky ~]# source test.sh
25
jiuzhao
26
/root
27
alias cp='cp -i'
28
'直接 source 执行（在当前终端执行），可以读取到'

展开收起

为什么？ 非交互式 Shell 的配置来源只有一个：

来源	说明
`$BASH_ENV`	如果设置了这个环境变量，bash 会 source 它指向的文件
继承自父进程的 `export` 变量	跟配置无关，靠的是进程继承
==其他配置文件一概不读==	`/etc/profile` `~/.bashrc` 统统跳过

Warning

⚠️ 这就是为什么：

cron 任务里 alias 全部失效 → cron 是非交互式 Non-login Shell
脚本里用不了 ll → ll 是 alias，脚本不走 ~/.bashrc
systemd 启动的服务读不到 JAVA_HOME → 服务进程根本不走 Shell 初始化

✅ 解决方案：脚本里需要的变量要么 export，要么在脚本开头显式设置

Terminal window展开收起

1
'要让脚本读到 NAME，有三种办法'
2
1)export 传递
3
[root@Rocky ~]# export NAME=jiuzhao
4
[root@Rocky ~]# bash test.sh
5
jiuzhao                        # ✅ 子进程继承了
6

7
2)脚本里显式 source
8
[root@Rocky ~]# cat test.sh
9
source ~/.bashrc               # 手动加载配置
10
echo $NAME
11
[root@Rocky ~]# bash test.sh
12
jiuzhao                        # ✅ 手动拉进来了
13

14
3)通过 BASH_ENV 指定
15
[root@Rocky ~]# export BASH_ENV=~/.bashrc
16
[root@Rocky ~]# bash test.sh
17
jiuzhao                        # ✅ 非交互式 bash 也会读 BASH_ENV
18
[root@Rocky ~]# unset BASH_ENV
19
'千万别忘记取消定义'

展开收起

④ 非交互式 Login Shell — `bash -l script.sh`#

极少见，但存在：用 -l（或 --login）强制以 Login 模式执行脚本

Terminal window

1
[root@Rocky ~]# bash -l script.sh
2
# 此时会先加载 /etc/profile → ~/.bash_profile，再执行脚本
3
'不读 ~/.bashrc'
4
# 但如果脚本跑完就退出，环境变量也不会留在当前终端

⚙️ 为什么分成两层？#

把配置分成两层，是为了==效率 + 合理分工==：

Terminal window展开收起

1
第一层：/etc/profile → ~/.bash_profile（Login 专属）
2
  ↓
3
  放”一辈子只需要设置一次”的东西
4
  - PATH 环境变量
5
  - umask
6
  - 全局环境变量（JAVA_HOME 等）
7
  ✅ 你登录一次，设置一次就够了
8

9
第二层：~/.bashrc → /etc/bashrc
10
  ↓
11
  放”每次开新 bash 都需要”的东西
12
  - alias 别名
13
  - PS1 提示符颜色
14
  - 命令补全脚本
15
  ✅ 每个新的 bash 实例都来一遍

展开收起

Note

📌 一句话总结：

/etc/profile 是 ”登录欢迎礼包”，不是 ”开机自检程序”

只有用户真正登入系统的那一刻，它才会被拆开
后续开新的 bash（Non-login Shell），都不会再重复拆这个礼包
服务器开机后如果一直没人登录，/etc/profile 永远等于一张废纸 🈚

🎯 一张表总结：哪种场景读哪个文件？#

场景	`/etc/profile`	`~/.bash_profile`	`~/.bashrc`	`/etc/bashrc`	`$BASH_ENV`
① SSH 登录 / `su -`	✅	✅	✅（被拉进来）	✅（被拉进来）	❌
② 终端敲 `bash` / `su`	❌	❌	✅	✅	❌
③ 脚本 `bash script.sh`	❌	❌	❌	❌	✅（如果设置了）
④ `bash -l script.sh`	✅	✅	✅（被拉进来）	✅（被拉进来）	❌
cron 定时任务	❌	❌	❌	❌	❌（默认不设）
systemd 服务	❌	❌	❌	❌	❌

📦 `/etc/profile.d/` 机制#

想让变量对所有交互式 Shell 都可见？最稳妥的做法：

Terminal window

1
'不要直接改 /etc/profile，在 /etc/profile.d/ 下创建 .sh 文件'
2
[root@Rocky ~]# vim /etc/profile.d/custom.sh
3
export APP_HOME=/opt/myapp
4
export APP_USER=admin

Tip

💡 /etc/profile 源码里有一行 for i in /etc/profile.d/*.sh; do . $i; done

/etc/bashrc 确实也会遍历 /etc/profile.d/*.sh，这不是 bug，是刻意设计
两段遍历是互补的：分别覆盖登录和非登录场景，确保所有交互式 Shell 都能获得一致的环境
放入 /etc/profile.d/ 的脚本必须是幂等的，因为它们可能被 source 多次
- 更模块化、更好维护

⚠️ 但 /etc/profile.d/ 也只对交互式 Shell 生效，脚本（非交互式）仍然不会自动加载！

⚠️ 加载频率 vs 变量作用域#

Caution

千万别把两件事混为一谈：

概念	意思
加载频率	这个文件什么时候被读取
变量作用域	这个变量谁能看到（子进程能不能继承）

~/.bashrc 每次交互都加载 → 解决的是==加载频率==，跟==作用域==毫无关系

❓ 为什么会有”像全局变量”的错觉

Terminal window

1
'你开了 3 个终端'
2
终端A → bash → ~/.bashrc 加载 → NAME=jiuzhao ✅
3
终端B → bash → ~/.bashrc 加载 → NAME=jiuzhao ✅
4
终端C → bash → ~/.bashrc 加载 → NAME=jiuzhao ✅
5

6
'看起来像是”全局”的，但其实是各自独立的三份副本！'
7
'一旦你从终端A 执行一个脚本'
8
终端A → bash script.sh → 子进程 → 🈚 NAME 没传过来！
9
# 脚本是非交互式 Non-login Shell，不读 ~/.bashrc
10
# 而且 NAME 没有 export，所以子进程也继承不到

Important

📌 三句话总结：

~/.bashrc 保证每个交互式终端都自动配好变量（靠的是==每次开 bash 都加载==）
export 保证所有子进程能继承（靠的是==作用域标记==）
两者配合（~/.bashrc 里写 export NAME=jiuzhao）→ 每个交互式终端自动有，且它启动的子进程也能用

📦 Shell位置变量#

位置变量速查表#

变量	含义	说明
`$0`	脚本名称	常用于启停脚本中的 usage 提示 $0 就是脚本自己的名字
`$n`	第 n 个参数	`$1` 第一个参数，`$2` 第二个… `$10` 后需用 `${10}`
`$#`	传参的个数	常用于判断用户是否传入了正确数量的参数
`$?`	上一条命令的返回结果	`0` = 成功，非 `0` = 失败
`$$`	脚本的 PID 号	用于写 PID 文件，防止重复启动
`$!`	上一个后台运行脚本的 PID 号	调试脚本用
`$*`	接收所有传参	在循环体中与 `$@` 不同（见下方）
`$@`	接收所有传参	在循环体中与 `$*` 不同（见下方）
`$_`	脚本传参的最后一个参数	也表示上一条命令的最后一个参数

`$n` — 脚本传参#

1
[root@Rocky sh]# cat test.sh
2
#!/bin/bash
3
#test
4
echo $1
5
[root@Rocky sh]# sh test.sh hehe
6
hehe
7
[root@Rocky sh]# sh test.sh abc
8
abc
9

10
# 多个参数
11
[root@Rocky sh]# cat test.sh
12
#!/bin/bash
13
#test
14
echo $1 $2
15
[root@Rocky sh]# sh test.sh a b
16
a b
17

18
# 传参支持序列
19
[root@Rocky sh]# sh test.sh {a..z}
20
a b
21
[root@Rocky sh]# sh test.sh {1..10}
22
1 2
23

24
# $10 需要用 ${10}
25
✅ 作为一个整体
26
'否则只识别前面的1，不会识别后面的0'
27
[root@Rocky sh]# cat test.sh
28
#!/bin/bash
29
#test
30
echo $1 $2 $3 $4 $5 $6 $7 $8 $9 ${10}
31
[root@Rocky sh]# sh test.sh {a..z}
32
a b c d e f g h i j

展开收起

`$#` — 传参数量#

1
[root@Rocky sh]# cat test.sh
2
#!/bin/bash
3
#test
4
echo $1 $2 $3 $4 $5 $6 $7 $8 $9 ${10}
5
echo $#
6
[root@Rocky sh]# sh test.sh {a..z}
7
a b c d e f g h i j
8
26

案例：判断用户传参个数

1
[root@Rocky sh]# cat test.sh
2
#!/bin/bash
3
[ $# -ne 2 ] && echo "必须传入2个参数" && exit
4
# 如果传入的参数 -ne 不等于2
5
echo name=$1   age=$2
6

7
[root@Rocky sh]# sh test.sh
8
必须传入2个参数
9
[root@Rocky sh]# sh test.sh a c d
10
必须传入2个参数
11
[root@Rocky sh]# sh test.sh a c
12
name=a age=c
13

14
# 使用 -x 查看脚本执行过程
15
[root@Rocky sh]# sh -x test.sh a
16
+ '[' 1 -ne 2 ']'
17
+ echo 必须传入2个参数
18
必须传入2个参数
19
+ exit
20
[root@Rocky sh]# sh -x test.sh a b
21
+ '[' 2 -ne 2 ']'
22
+ echo name=a age=b
23
name=a age=b

展开收起

`$?` — 上一条命令返回结果#

Terminal window展开收起

1
[root@Rocky ~]# ping -c1 -W1 www.baidu.com &>/dev/null
2
[root@Rocky ~]# echo $?
3
0
4
# 0 = 成功
5
[root@Rocky ~]# ping -c1 -W1 www.baiduaaaa.com &>/dev/null
6
[root@Rocky ~]# echo $?
7
2
8
# 非0 = 失败
9

10
# 实用组合
11
[root@Rocky ~]# [ $? -eq 0 ] && echo 域名通 || echo 域名不通
12
域名不通
13
[root@Rocky ~]# ping -c1 -W1 www.baidu.com &>/dev/null
14
[root@Rocky ~]# [ $? -eq 0 ] && echo 域名通 || echo 域名不通
15
域名通

展开收起

ping 检测脚本：

1
[root@Rocky sh]# cat ping.sh
2
#!/bin/bash
3
ping -c1 -W1 $1 &>/dev/null
4
[ $? -eq 0 ] && echo $1域名通 || echo $1域名不通
5

6
[root@Rocky sh]# sh ping.sh www.baidu.com
7
www.baidu.com域名通 ✅
8
[root@Rocky sh]# sh ping.sh www.baiduaaaa.com
9
www.baiduaaaa.com域名不通 ❌

Warning

⚠️ $? 的返回值==极易被覆盖==！它始终返回紧邻的上一条命令的结果

如果需要保留 $? 的值，务必==立即赋值给变量==：

Terminal window

1
ping -c2 -W2 $1 &>/dev/null
2
flag=$?             # 将 $? 的值立即赋予给 flag
3
echo hehe         # 这条命令成功后 $? 变成 0！
4
touch 1.txt
5
echo $?           # 现在 $? 是 touch 的返回值
6
ech oldboyedu     # 这条命令报错
7

8
[ $flag -eq 0 ] && echo $1域名通 || echo $1域名不通  # 用 flag 而非 $?

`$$` — 脚本的 PID 号#

作用：将 PID 写入文件，启动时判断此文件，有则无需重复启动，没有则启动

Terminal window

1
[root@Rocky ~]# cat /var/run/nginx.pid
2
1024
3
[root@Rocky ~]# kill `cat /var/run/nginx.pid`

`$*` vs `$@` — 所有传参#

1
[root@Rocky sh]# cat test.sh
2
#!/bin/bash
3
echo name=$1   age=$2
4

5
echo $*
6
echo $@
7
[root@Rocky sh]# sh test.sh {a..z}
8
name=a age=b
9
a b c d e f g h i j k l m n o p q r s t u v w x y z
10
a b c d e f g h i j k l m n o p q r s t u v w x y z
11
# '不加引号时，$* 和 $@ 看起来一样'

Important

📌 加双引号后 $* 和 $@ 的区别：

Terminal window

1
[root@Rocky sh]# set -- "I am" oldboy
2

3
# "$*" → 把所有参数当成一个整体
4
[root@Rocky sh]# for i in "$*"; do echo $i; done
5
I am oldboy
6

7
# "$@" → 每个参数独立处理（保留原始参数边界）
8
[root@Rocky sh]# for i in "$@"; do echo $i; done
9
I am
10
oldboy

"$*"：所有参数合并成一个字符串
"$@"：每个参数保持独立，==推荐在循环中使用 "$@"== ✅

`$_` — 最后一个参数#

Terminal window

1
[root@Rocky sh]# sh test.sh a b c d e
2
name=a age=b
3
a b c d e
4
a b c d e
5
[root@Rocky sh]# echo $_
6
e
7
# '表示传参的最后一个参数'
8

9
[root@Rocky sh]# ll /etc/hosts /etc/passwd
10
-rw-r--r-- 1 root root   158 Jun 23  2020 /etc/hosts
11
-rw-r--r-- 1 root root 2046 Jan 19 10:58 /etc/passwd
12
[root@Rocky sh]# echo $_
13
/etc/passwd
14
# '也表示上一条命令的最后一个参数'

⚙️ 变量传参的三种方式#

方法 1：直接传参#

1
[root@Rocky sh]# cat test.sh
2
#!/bin/bash
3
echo name=$1    age=$2
4
[root@Rocky sh]# sh test.sh old 123
5
name=old age=123

方法 2：赋值传参#

案例：赋值传参 + 友好输出

1
[root@Rocky sh]# cat test.sh
2
#!/bin/bash
3
name=$1
4
age=$2
5

6
echo 姓名: $name
7
echo 年龄: $age
8
[root@Rocky sh]# sh test.sh oldgirl 123
9
姓名: oldgirl
10
年龄: 123

案例：ping 检测（赋值传参）

1
[root@Rocky sh]# cat ping.sh
2
#!/bin/bash
3
url=$1
4
ping -c1 -W1 $url &>/dev/null
5
[ $? -eq 0 ] && echo $url域名通 || echo $url域名不通
6

7
[root@Rocky sh]# sh ping.sh www.sina.com
8
www.sina.com域名通

方法 3：`read` 读入#

1
[root@Rocky sh]# cat test.sh
2
#!/bin/bash
3
read -p "请输入你的姓名: " name
4
read -p "请输入你的年龄: " age
5

6
echo "你的姓名是: " $name
7
echo "你的年龄是: " $age
8
[root@Rocky sh]# sh test.sh
9
请输入你的姓名: oldboy
10
请输入你的年龄: 123
11
你的姓名是:  oldboy
12
你的年龄是:  123

案例：银行卡密码验证（-s 隐藏输入）

1
[root@Rocky sh]# cat a.sh
2
#!/bin/bash
3
read -p "请输入你的银行卡号: " num
4
read -s -p "请输入你的银行密码: " pass     # -s 隐藏密码
5
echo -e "\n"
6
[ $pass -eq 123456 ] && echo 银行卡$num 余额999999999RMB! || echo 密码错误
7

8
[root@Rocky sh]# sh a.sh
9
请输入你的银行卡号: 666666
10
请输入你的银行密码:           # '输入时看不到密码'
11
银行卡666666 余额999999999RMB!

三种传参方式对比

方式	语法	适用场景
直接传参	`$1` `$2` `$3`	脚本间调用、命令行快速执行
赋值传参	`name=$1`	参数较多时提高可读性
`read` 读入	`read -p "提示: " var（变量名）`	交互式脚本、需要隐藏输入（`-s`）

Ansible Docker 动态清单

Mon, 15 Jun 2026 00:00:00 GMT

Ansible Docker 动态清单#

[TOC]

概述#

Note

动态清单就是让 Ansible 自己去问 Docker：“你现在有哪些容器在跑？“，把答案自动当成主机列表

环境准备#

组件	情况
虚拟机	Ubuntu 24.04，IP 192.168.122.211
Docker	已安装（/var/run/docker.sock）
Ansible	pipx 安装（/root/.local/bin/）
容器	myweb（nginx）、mypy（python）

Terminal window展开收起

1
'当前容器状态'
2
root@m01 ~# docker ps
3
CONTAINER ID   IMAGE               NAMES
4
973a18250fe8   python:alpine3.24   mypy
5
b009b9d26bd3   nginx:latest        myweb
6

7
1）初始动态清单
8
'第一个动态清单'
9
# 让 Ansible 自动发现这两个正在运行的容器
10
root@m01 ~# pwd
11
/root
12
mkdir -p /root/inventory
13
root@m01 ~# mkdir -p /root/inventory
14
root@m01 ~# cat > /root/inventory/docker.yml << 'EOF'
15
plugin: community.docker.docker_containers
16
docker_host: unix:///var/run/docker.sock
17
EOF
18
root@m01 ~# ansible-inventory -i ~/inventory/docker.yml --list
19
❌ 报错
20
✅ 插件的判断规则是：文件名必须包含 `.docker.` 这个子串
21
🌰 `docker.yml` 里没有 `.docker.`，插件不认识它，Ansible 就把它当普通 YAML 清单去解析
22

23
2）改正
24
root@m01 ~# mv /root/inventory/docker.yml /root/inventory/docker.docker.yml
25
root@m01 ~# ansible-inventory -i ~/inventory/docker.docker.yml --list
26
'注意名字是已经更正过的名字'
27
Failed to parse inventory with 'auto' plugin.
28
Failed to import the required Python library (requests)
29
😭 还是不对 ❌                  👆

展开收起

现象：文件名改成 docker.docker.yml 后，插件已经能识别了，但仍然报错：

排错#

requests 库缺失 ✅

Terminal window展开收起

1
'排查过程'
2
1）怀疑 docker SDK 没装
3
root@m01 ~# python3 -c "import docker"
4
ModuleNotFoundError: No module named 'docker'
5
✅ 确实没装，但不是首要问题
6
'这个python3是系统里面的，不是Ansible中的'
7

8
2）怀疑 collection 没装
9
'Collection（集合）——它是 Ansible 的包管理单位'
10
root@m01 ~# ansible-galaxy collection list | grep docker
11
community.docker  5.2.0
12
# 装了（v5.2.0），排除
13

14
3）开详细模式看真实错误
15
✅ '-vvv' --》 定位到 requests 缺失
16
oot@m01 ~# ansible-inventory -i /root/inventory/docker.docker.yml --list -vvv
17
关键行：ModuleNotFoundError: No module named 'requests'
18
"注意报错里的 Python 路径："
19
#   /root/.local/share/pipx/venvs/ansible/bin/python

展开收起

根因：pipx 安装的 Ansible 跑在独立的虚拟环境里（/root/.local/share/pipx/venvs/ansible/）

community.docker 插件调用 Docker API 时底层依赖 Python 的 requests 库
- 但 pipx 的虚拟环境里没有得用 pipx inject 专门给 Ansible 的环境装一份
- 他没有 requests 库 & docker SDK

Important

关键认知：pipx 安装的工具，它的 Python 虚拟环境是隔离的

Ubuntu 24.04 的系统 Python 是”externally managed”，直接 pip install 根本不让装
就算用 --break-system-packages 强行装进系统 Python，pipx 里的 Ansible 也照样看不到
- 必须用 pipx inject 把依赖注入进 Ansible 自己的虚拟环境

Terminal window展开收起

1
4）修复：
2
✅ 把 requests 和 docker SDK 注入到 pipx 的 Ansible 虚拟环境
3
root@m01 ~# pipx inject ansible requests
4
  injected package requests into venv ansible
5
done! ✨ 🌟 ✨
6
root@m01 ~# pipx inject ansible docker
7
  injected package docker into venv ansible
8
done! ✨ 🌟 ✨
9

10
哈哈...
11

12
5）验证：
13
root@m01 ~# ansible-inventory -i /root/inventory/docker.docker.yml --list
14
✅ 正常输出容器清单
15
{
16
    "_meta": {
17
        "hostvars": {
18
            "mypy": {
19
                "ansible_connection": {
20
                    "__ansible_unsafe": "community.docker.docker_api"
21
                },
22
             ....................
23
            },
24
            "myweb": {
25
                "ansible_connection": {
26
                    "__ansible_unsafe": "community.docker.docker_api"
27
                },
28
                .....................
29
        }

展开收起

Tip

光有主机清单，ansible_connection 也没配，还不能执行任何任务
接下来就要引入过滤器和连接配置，让这个清单真正可用

过滤器（filters）#

需求: 容器停了的不应该出现在清单里 —> 只想要”正在运行”的

初尝试——直接翻车#

1
plugin: community.docker.docker_containers
2
docker_host: unix:///var/run/docker.sock
3

4
filters:
5
  - include: "status=running"

Terminal window

1
root@m01 ~# vim ./inventory/docker.docker.yml
2
root@m01 ~# ansible-inventory -i ~/inventory/docker.docker.yml --list
3
Could not evaluate filter condition 'status=running' ❌

过滤器表达式是 Jinja2 语法，status=running 有 3 个问题：

错误 ❌	原因	修正
`status`	没有这个变量；Docker inspect 的 `State` 键经 slugify 后叫 `docker_state`	`docker_state`
`=`	Jinja2 里 `=` 是赋值，比较用 `==`	`==`
`running`	裸词在 Jinja2 里是变量名（未定义），字符串必须加引号	`"running"`

三条一起改掉 → 'docker_state == "running"'，但往下看——

修正后”通了”——其实没生效#

1
filters:
2
  - include: 'docker_state == "running"'

Note

外层单引号，里面双引号 "running"

Terminal window

1
root@m01 ~# ansible-inventory -i ~/inventory/docker.docker.yml --graph
2
# 树状图方式显示
3
@all:
4
  |--@ungrouped:
5
  |  |--mypy
6
  |  |--myweb
7
# 两个都在，看起来"对了"

问题出在两层：

第一层：docker_state 不是字符串，是 Docker inspect 返回的对象：

1
docker_state = {
2
    "Status": "running",
3
    "Running": true,
4
    "Paused": false,
5
    ...
6
}

所以 docker_state == "running" = 拿对象跟字符串比 → 永远 False —> 这条 include 从来没命中过

第二层：既然条件永远不命中，为什么两个容器还在？停掉一个试试：

Terminal window

1
root@m01 ~# docker stop mypy
2
root@m01 ~# ansible-inventory -i ~/inventory/docker.docker.yml --graph
3
@all:
4
  |--@ungrouped:
5
  |  |--mypy      # ← 停了还在！说明过滤器完全没干活
6
  |  |--myweb

→ 引出核心机制 ↓

核心机制：include / exclude + 默认放行#

filters 是一个列表，每一项有且仅有 include 或 exclude 之一，对每个容器独立求值：

Terminal window

1
对【每个容器】独立执行：
2
  遍历 filters 列表（从上到下）：
3
    include 条件 = True  → 入选，立即停止
4
    exclude 条件 = True  → 排除，立即停止
5
  ⚠️ 走到列表末尾，'没有一条为 True' → 入选（默认放行）

关键字	角色	条件成立时
`include`	白名单	入选，不再看后面的 filter
`exclude`	黑名单	排除，不再看后面的 filter

以 include: '"mypy" in docker_name' 为例，两个容器各走各的：

Terminal window

1
mypy:
2
  filter[0] include: "mypy" in "mypy" → True  → 入选 ✅
3

4
myweb:
5
  filter[0] include: "mypy" in "myweb" → False → 继续
6
  走到头了，没有一条 True → 默认放行 → 混进来了！

加上 exclude: true 兜底：

Terminal window

1
myweb:
2
  filter[0] include: "mypy" in "myweb" → False → 继续
3
  filter[1] exclude: true → True → 排除 ❌  ← 被拦住！
4
📌 mypy 在 filter[0] 就入选了，根本走不到这里

Important

必须有一条为 true，否则就会混进来。

所有 filter 条件都是 false → 走到末尾无结论 → 默认放行
exclude: true = 永远为 true 的守门员，保证最后一定有一条命中
include 只能主动请人进来，拦不住不匹配的

正确写法#

只要运行中的容器——两种方式：

方式	写法	说明
排除法 ✅ 推荐	`exclude: 'not docker_state.Running'`	`Running` 是==布尔值==，逐个推演： stopped → `Running`=`false` → `not false`=`true` → 命中 → 踢掉 ❌ running → `Running`=`true` → `not true`=`false` → 不命中 → 留下 ✅ 一行搞定
include + 兜底	`include: 'docker_state.Running'` `exclude: true`	running → `Running`=`true` → 第 1 条命中 → 入选 stopped → `Running`=`false` → 第 1 条不命中 → 走到第 2 条 `exclude: true` 命中 → 踢掉

Warning

单写 include: 'docker_state.Running' 不行——stopped 的 Running 为 false，include 不成立 → ==默认放行==

Terminal window展开收起

1
'验证排除法'
2
root@m01 ~# docker stop mypy
3
root@m01 ~# cat > /root/inventory/docker.docker.yml << 'EOF'
4
plugin: community.docker.docker_containers
5
docker_host: unix:///var/run/docker.sock
6

7
filters:
8
  - exclude: 'not docker_state.Running'
9

10
compose:
11
  ansible_connection: community.docker.docker
12
EOF
13

14
root@m01 ~# ansible-inventory -i ~/inventory/docker.docker.yml --graph
15
@all:
16
  |--@ungrouped:
17
  |  |--myweb              # ← mypy 被正确排除 ✅

展开收起

过滤器（filters）字符串比较：用 in 别用 ==

由于 __ansible_unsafe 包装，过滤器中 == 比较字符串不可靠：

表达式	可用？	替代
`docker_name == "mypy"`	❌	`"mypy" in docker_name`
`docker_name.startswith("my")`	❌	`"my" in docker_name`
`docker_state.Status == "running"`	❌	`"running" in docker_state.Status` ⚠️ ==字符串==
`"mypy" in docker_name`	✅	—
`docker_state.Running` ⚠️ ==布尔值==	✅	—

Tip

记一个规则：==过滤器（filters）==中字符串判断用 in 别用 == —> ==groups 不受此影响==（走另一条求值路径）

组合条件（and / or）

1
filters:
2
  - include: 'docker_state.Running and ("nginx" in docker_config.Image)'
3
  - exclude: true

and — 两边都满足才留下
or — 任意一边满足就留下
not — 取反

Terminal window

1
root@m01 ~# ansible-inventory --graph
2
@all:
3
  |--@ungrouped:
4
  |  |--myweb              # ← 只有 nginx + 运行中

容器	`Running`	`docker_config.Image`	结果
myweb	`true`	`nginx:latest`	✅
mypy	`true`	`python:3.12-alpine`	❌
old-nginx (停)	`false`	`nginx:1.27`	❌

完整示例：

1
filters:
2
  - include: '"my" in docker_name'      # 只要名字含 my 的
3
  - exclude: '"test" in docker_name'    # 排除含 test 的
4
  - exclude: true                       # 兜底

连接容器#

发现容器了，试试能不能”连上”——用 ping 模块测试

配置 ansible.cfg#

Terminal window展开收起

1
root@m01 ~# ansible --version | grep 'config file'
2
  config file = /etc/ansible/ansible.cfg
3
# 现在使用的是系统级配置文件
4

5
1）创建一个项目级 `ansible.cfg`，省得每次敲 `-i`
6
root@m01 ~# cat > /root/ansible.cfg << 'EOF'
7
[defaults]
8
inventory = /root/inventory/docker.docker.yml
9
interpreter_python = auto_silent
10

11
[privilege_escalation]
12
become = true
13
become_method = sudo
14
become_user = root
15
become_ask_pass = false
16
EOF

展开收起

报错 A：`sudo: not found`#

Terminal window

1
root@m01 ~# ansible all -m ping
2
mypy | FAILED! => {
3
    "module_stderr": "/bin/sh: sudo: not found",
4
    "msg": "Module result deserialization failed: ...",
5
    "rc": 127
6
}
7
myweb | FAILED! => {
8
    "module_stderr": "/bin/sh: 1: sudo: not found",
9
    ...
10
}

所有容器都失败 ❌

为什么？ ansible.cfg 里配了 become = true（开启 sudo 提权），Ansible 每次执行命令前都会先敲 sudo

但 Docker 容器里根本没有 sudo 这个命令——追求体积小的镜像（nginx、alpine）不可能装 sudo

⚠️ 更重要的是：容器里的进程本身就是 root，根本不需要提权

管理虚拟机 vs 管理容器，配置文件是不一样的：

配置项	虚拟机	容器
连接方式	SSH	Docker API
默认用户	test（普通用户）	root
需要 sudo？	是	否
privilege_escalation	需要	不要配！

✅ 修正

Terminal window

1
root@m01 ~# cat > /root/ansible.cfg << 'EOF'
2
[defaults]
3
inventory = /root/inventory/docker.docker.yml
4
interpreter_python = auto_silent
5
EOF
6
🐎 去掉整个 `[privilege_escalation]` 区块

报错 B：`/usr/bin/python3: not found`#

修正后再试：

Terminal window

1
root@m01 ~# ansible all -m ping
2
myweb | FAILED! => {
3
    "module_stderr": "/bin/sh: 1: /usr/bin/python3: not found\n",
4
    "rc": 127
5
}
6
mypy | SUCCESS => {
7
    "ping": "pong"
8
}
9
✅ python 容器通了，nginx 容器还是失败，但'报错内容变了'
10
——> 不是 `sudo` 问题了，是找不到 Python

为什么❓

ping 模块本质上是一个 Python 脚本
- Ansible 把它上传到目标主机，然后找一个 Python 解释器来执行

Terminal window

1
ansible ping 模块的执行过程：
2
  1. 把 ping 模块（Python 代码）传进容器
3
  2. 在容器里找 Python 解释器（由 interpreter_python 配置决定）
4
  3. 用 Python 执行这段代码
5
  4. 返回结果

mypy（python 镜像）→ 自带 Python → ✅
myweb（nginx 镜像）→ 没有 Python → ❌

Note

Docker 连接插件（community.docker.docker）只替换了传输层（“怎么把命令送进容器”），并没有替换执行层（“用什么来跑模块”）

Terminal window

1
SSH 连接：     ansible --网络--> SSH服务 --> 容器（需要 Python）
2
Docker 连接：   ansible --docker exec--> 容器（同样需要 Python）
3
                                   ↑
4
                                   唯一的例外：'raw 模块'

✅ 解决方案：raw 模块

Tip

raw 模块不传 Python 代码，直接跑 shell 命令——不需要 Python：

Terminal window展开收起

1
root@m01 ~# ansible all -m raw -a 'echo hello'
2
mypy | CHANGED | rc=0 >>
3
hello
4
myweb | CHANGED | rc=0 >>
5
hello
6
==============================================
7
root@m01 ~# ansible all -m raw -a 'whoami'
8
mypy | CHANGED | rc=0 >>
9
root
10
myweb | CHANGED | rc=0 >>
11
root
12
==============================================
13
root@m01 ~# ansible myweb -m raw -a 'nginx -v'
14
myweb | CHANGED | rc=0 >>
15
nginx version: nginx/1.31.1

展开收起

适用场景：操作 nginx、redis、mysql 等镜像——这些镜像追求体积小，不带 Python

✅ 日常管理它们就靠 raw 模块

汇总：

模块	需要 Python？	能用于 nginx 容器？
`raw`	❌ 不需要	✅
`ping`	✅ 需要	❌
`command` / `shell`	✅ 需要	❌
`setup`（收集信息）	✅ 需要	❌

Terminal window展开收起

1
'在nginx容器中安装python'
2
1)进入判断系统
3
root@m01 ~# docker exec -it myweb /bin/bash
4
root@ee5d00b5904c:/# ls /etc/ | grep -E 'apt|yum'
5
apt
6
root@ee5d00b5904c:/# cat /etc/apt/sources.list.d/debian.sources
7
Types: deb
8
# http://snapshot.debian.org/archive/debian/20260610T000000Z
9
URIs: http://deb.debian.org/debian 📌
10
............
11
Types: deb
12
# http://snapshot.debian.org/archive/debian-security/20260610T000000Z
13
URIs: http://deb.debian.org/debian-security 📌
14

15
2)替换源
16
root@ee5d00b5904c:/# sed -i 's#deb.debian.org#mirrors.aliyun.com#g' /etc/apt/sources.list.d/debian.sources
17
root@ee5d00b5904c:/# cat /etc/apt/sources.list.d/debian.sources
18
Types: deb
19
# http://snapshot.debian.org/archive/debian/20260610T000000Z
20
URIs: http://mirrors.aliyun.com/debian
21
Suites: trixie trixie-updates
22
Components: main
23
Signed-By: /usr/share/keyrings/debian-archive-keyring.pgp
24

25
Types: deb
26
# http://snapshot.debian.org/archive/debian-security/20260610T000000Z
27
URIs: http://mirrors.aliyun.com/debian-security
28
Suites: trixie-security
29
Components: main
30
Signed-By: /usr/share/keyrings/debian-archive-keyring.pgp
31

32
3)下载安装
33
root@ee5d00b5904c:/# apt update && apt -y install python3
34
root@ee5d00b5904c:/# python3 -V
35
Python 3.13.5
36
root@ee5d00b5904c:/# exit
37
exit
38

39
4)退出测试
40
root@m01 ~# ansible all -m ping
41
✅ ansible.cfg中配置了interpreter_python=auto_silent
42
# 可以自动识别受控节点的python环境
43
myweb | SUCCESS => {
44
    "ansible_facts": {
45
        "discovered_interpreter_python": "/usr/bin/python3.13" ⭕
46
    },
47
    "changed": false,
48
    "ping": "pong"
49
}
50
mypy | SUCCESS => {
51
    "ansible_facts": {
52
        "discovered_interpreter_python": "/usr/local/bin/python3.12"
53
    },
54
    "changed": false,
55
    "ping": "pong"
56
}

展开收起

动态分组（groups）#

==需求==：容器多了以后，需要分组管理——“web 容器归一组，python 容器归一组”：

Terminal window

1
ansible web_servers -m raw -a 'nginx -s reload'   # 只重载 web 组
2
ansible py_apps -m ping                           # 只 ping python 组

⚠️ 关键认知

filters（过滤器) 和 groups 共享同一套 full_facts，变量完全一样
- 区别在于角色：filters 控制谁入选，groups 控制入选后怎么分队
--host 输出只是 inventory 视图，groups 能用的变量远多于 --host

方法一：按名称 / 镜像分组#

full_facts 中已经包含了所有 inspect 数据，直接引用即可：

/root/inventory/docker.docker.yml展开收起

1
plugin: community.docker.docker_containers
2
docker_host: unix:///var/run/docker.sock
3

4
filters:
5
  - exclude: 'not docker_state.Running'
6

7
compose:
8
  ansible_connection: community.docker.docker
9
  # 显式指定连接方式
10

11
groups:
12
  web_servers: 'docker_name == "myweb"'
13
  py_apps: 'docker_name == "mypy"'
14
  nginx_hosts: '"nginx" in docker_config.Image'   # 镜像中in（包含）nginx
15
  # 所有基于 nginx镜像 创建的容器分一组

展开收起

Note

in — 子串包含，不是完全相等，“my” 能同时命中 mypy 和 myweb
== — ==完全相等==，但 filter 中不可靠（groups 中没问题）

groups（动态分组）要求没有那么严格 —> == 和 in 都可以用

== 在 filter 中不可靠

Terminal window

1
root@m01 ~# docker run -d --name web01 nginx:latest
2
'再创建一个web容器'
3
root@m01 ~# ansible-inventory --graph
4
@all:
5
  |--@ungrouped:
6
  |--@nginx_hosts:
7
  |  |--web01 ✅
8
  |  |--myweb ✅
9
  |--@web_servers:
10
  |  |--myweb
11
  |--@py_apps:
12
  |  |--mypy

方法二：按标签分组#

Docker 标签存在 docker_config.Labels 中，给容器打标签并分组：

Terminal window展开收起

1
'清理环境'
2
root@m01 ~# docker rm -f $(docker ps -aq)
3

4
1)创建容器 & 带标签
5
⚠️ Docker 不支持修改已有容器的标签，要删除标签只能 `docker rm -f` 后重建
6
root@m01 ~# docker run -d --name myweb --label group=web_servers nginx:latest
7
root@m01 ~# docker run -d --name test_web --label group=test nginx:latest
8
root@m01 ~# docker run -d --name mypy --label group=py_apps python:3.12-alpine tail -f /etc/hosts
9
# 得阻塞住进程
10

11
2)查看标签
12
root@m01 ~# docker inspect myweb --format '{{json .Config.Labels}}'
13
{"group":"web_servers","maintainer":"NGINX Docker Maintainers <docker-maint@nginx.com>"}
14
root@m01 ~# docker inspect test_web --format '{{json .Config.Labels}}'
15
{"group":"test","maintainer":"NGINX Docker Maintainers <docker-maint@nginx.com>"}
16
root@m01 ~# docker inspect mypy --format '{{json .Config.Labels}}'
17
{"group":"py_apps"}

展开收起

1
groups:
2
  py_apps: 'docker_config.Labels.group == "py_apps"'
3
  test_group: 'docker_config.Labels.group == "test"'
4
  # ==（完全相等）
5
  nginx_hosts: '"nginx" in docker_config.Image'
6
  # 镜像中in（包含）nginx

Warning

groups（动态分组）中直接 .group 不会报错
- 宽松求值，取不到返回 undefined，==不炸== ✅
filter（过滤器）必须用 .get("group", "")，不能直接 .group
- 没有该标签的容器 Labels 是空 dict {}，直接取属性会报错 ❌

💡 两者都可以用 .get() 👇 这种方式 —> 更显式

1
groups:
2
test_group: 'docker_config.Labels.get("group", "") == "test"'

Terminal window展开收起

1
3)测试运行
2
root@m01 ~# ansible-inventory --graph
3
@all:
4
  |--@ungrouped:
5
  |--@test_group:
6
  |  |--test_web 🔄
7
  |--@nginx_hosts:
8
  |  |--test_web 🔄
9
  |  |--myweb
10
  |--@py_apps:
11
  |  |--mypy
12
✅ 一个容器可以同时属于多个组 --> 'test_web'
13

14
4)创建一个'不带标签'的
15
# 并再次验证
16
root@m01 ~# docker run -d --name web01 nginx:latest
17
root@m01 ~# ansible-inventory --graph
18
@all:
19
  |--@ungrouped:
20
  |--@nginx_hosts:
21
  |  |--web01
22
  |  |--test_web 🔄
23
  |  |--myweb
24
  |--@test_group:
25
  |  |--test_web 🔄
26
  |--@py_apps:
27
  |  |--mypy
28

29
5)停止并再次验证
30
root@m01 ~# docker stop -t 0 web01
31
web01
32
root@m01 ~# ansible-inventory --graph
33
@all:
34
  |--@ungrouped:
35
  |--@test_group:
36
  |  |--test_web 🔄
37
  |--@nginx_hosts:
38
  |  |--test_web 🔄
39
  |  |--myweb
40
  |--@py_apps:
41
  |  |--mypy
42
✅ '没有web01了'

展开收起

⭐compose 的真正用途#

Terminal window

1
root@m01 ~# ansible-inventory  --host test_web
2
{
3
    "ansible_connection": "community.docker.docker_api",
4
    "ansible_docker_api_version": "auto",
5
    "ansible_docker_docker_host": "unix:///var/run/docker.sock",
6
    "ansible_docker_timeout": 60,
7
    "ansible_docker_tls": false,
8
    "ansible_docker_use_ssh_client": false,
9
    "ansible_docker_validate_certs": false,
10
    "ansible_host": "test_web",
11
    "docker_name": "test_web", 📌 # 容器名
12
    "docker_short_id": "0e4c6edb0722d" 📌 # 容器id
13
}  🤡 # 现在关于docker的变量只有这两个

Tip

简化别名：把 docker_config.Image 映射为 my_img，表达式更短
计算新变量：通过 Jinja2 模板组合多个字段
写入 inventory：compose 变量会出现在 --host 输出中，供 playbook 使用

1
compose:
2
  ansible_connection: community.docker.docker  # 指定连接方式
3
  my_img: docker_config.Image       # 简化变量
4
  is_test: 'docker_config.Labels.group == "test"'  # 计算布尔标记
5
  my_group: docker_config.Labels.group   # 暴露到 --host

Terminal window

1
root@m01 ~# vim inventory/docker.docker.yml
2
root@m01 ~# ansible-inventory  --host test_web
3
{
4
    ................................
5
    "ansible_host": "test_web",
6
    "docker_name": "test_web",
7
    "docker_short_id": "0e4c6edb0722d",
8
    "my_img": "nginx:latest" 😍
9
    "is_test": true, 😍
10
    "my_group": "test", 😍
11
}

✨变量速查#

变量	filters	groups	`--host`	类型	备注
`docker_name`	✅	✅	✅	字符串	内置
`docker_short_id`	✅	✅	✅	字符串	内置
`docker_state.Running`	✅	✅	❌	==布尔值==	`true` / `false`
`docker_state.Status`	✅（用 `in`）	✅	❌	字符串	`"running"` / `"exited"`
`docker_config.Image` 🥳	✅	✅	❌	字符串	`"nginx:latest"`
`docker_config.Labels.<key>`	✅（必须 `.get`）	✅	❌	字符串	没该标签的容器 `Labels` = `{}`
`docker_image` 🤡	✅	✅	❌	字符串 (SHA256)	⚠️ 是哈希，镜像名在 `docker_config.Image`

Tip

字符串判断差异：

filter：== 不可靠，用 "xxx" in var（双引号 + in）⚠️ 外面单引号包裹
group：== 和 in 都可以 ✅

groups 工作流程#

Terminal window

1
1. Docker 插件拿到所有容器
2
      ↓
3
2. filters 对 full_facts 筛一轮 → 决定哪些容器"入选"
4
      ↓
5
3. compose 把计算结果注入 full_facts
6
      ↓
7
4. groups 对 full_facts 逐个判断 → 表达式为 true 就加入对应组
8
      ↓
9
5. 一个容器可以同时属于多个组

✅ 最终配置汇总

Terminal window

1
'项目目录最终两个文件：'
2
root@m01 ~# tree ./
3
./
4
├── ansible.cfg ✅      # 项目级配置
5
└── inventory
6
    └── docker.docker.yml ✅  # 动态清单
7

8
2 directories, 2 files

ansible.cfg：

1
[defaults]
2
inventory = /root/inventory/docker.docker.yml
3
interpreter_python = auto_silent
4

5
# 注意：没有 [privilege_escalation]！
6
# 容器里是 root，没有 sudo，不需要提权

docker.docker.yml：

1
plugin: community.docker.docker_containers
2
docker_host: unix:///var/run/docker.sock
3

4
filters:
5
  - exclude: 'not docker_state.Running'
6

7
compose:
8
  ansible_connection: community.docker.docker  # 指定连接方式
9
  my_img: docker_config.Image           # 简化变量
10
  is_test: 'docker_config.Labels.group == "test"'  # 计算布尔标记
11
  my_group: docker_config.Labels.group  # 暴露到 --host
12

13
groups:
14
  py_apps: 'my_group == "py_apps"'
15
  test_group: 'my_group == "test"'
16
  # ==（完全相等）
17
  nginx_hosts: '"nginx" in my_img'
18
  # 镜像中in（包含）nginx

展开收起

Terminal window

1
root@m01 ~# vim ./inventory/docker.docker.yml
2
root@m01 ~# ansible-inventory --graph
3
@all:
4
  |--@ungrouped:
5
  |--@test_group:
6
  |  |--test_web
7
  |--@nginx_hosts:
8
  |  |--test_web
9
  |  |--myweb
10
  |--@py_apps:
11
  |  |--mypy

Tip

这套写法的优点：

compose 把又长又深的路径（docker_config.Labels.group、docker_config.Image）映射成短别名（my_group、my_img）
- groups 表达式立刻干净了 & 好读得多
而且 compose 变量会写进 inventory，--host 也能看到，调试和 playbook 引用都方便

📌 一句话：filters 控制”谁入选”，compose 给入选的容器起别名 / 算新值，groups 用这些简洁变量分队

✅ 一个容器属于多个组完全没问题

Podman ⬌ Docker 对照#

配置项	Podman	Docker
插件	`containers.podman.podman_containers`	`community.docker.docker_containers`
连接方式	`connection_plugin: containers.podman.podman`	`compose: ansible_connection: community.docker.docker`
控制启停	`include_stopped: false`	`filters: - exclude: 'not docker_state.Running'`
镜像变量	`podman_image`（镜像名）	`docker_config.Image`（镜像名，可直接用）；`docker_image` 是 SHA256
状态变量	`podman_status`	`docker_state`（对象，取 `.Status` 或 `.Running`）
标签变量	`podman_labels`	`docker_config.Labels.<key>`（直接可用）

主机模式（Host Patterns）#

Note

有了分组之后，下一步就是精准定位——“想对谁执行就对谁执行”

Ansible 提供了一套主机模式语法，支持单个主机、多个主机、组、排除、交集、切片等操作

模式速查表#

描述	模式	目标
所有主机	`all` 或 `*`	清单中的全部主机
单个主机	`host1`	指定主机名
多台主机	`host1:host2` 或 `host1,host2`	冒号或逗号分隔
一个组	`webservers`	该组所有成员
多个组（==并集==）	`group1:group2`	两组所有成员合并
排除主机	`group:!host`	从组中剔除某台主机
排除组	`group1:!group2`	从 group1 中踢掉 group2 所有成员
组的交集（==交集==）	`group1:&group2`	同时属于两个组的主机
组位置（切片）	`group[0]`、`group[0:2]`	按索引取组内主机
正==则==匹配	`~pattern`	匹配主机名符合正则的

Warning

模式中包含特殊字符（!、&、*、~）时，shell 可能会抢着解释，必须用引号包裹：

Terminal window展开收起

1
root@m01 ~# ansible-inventory --graph
2
@all:
3
  |--@ungrouped:
4
  |--@test_group:
5
  |  |--test_web
6
  |--@nginx_hosts:
7
  |  |--test_web
8
  |  |--myweb
9
  |--@py_apps:
10
  |  |--mypy
11
root@m01 ~# ansible nginx_hosts:!test_web -m raw -a 'echo hi'
12
'冒号 :! 感叹号'
13
-bash: !test_web: event not found
14
❌ 不加引号 — shell 把 ! 当历史展开
15

16
root@m01 ~# ansible 'nginx_hosts:!test_web' -m raw -a 'echo hi'
17
# nginx_hosts组中排除test_web --> 只剩myweb
18
myweb | CHANGED | rc=0 >>
19
hi
20
✅ 加引号

展开收起

基础定位：all / 单主机 / 多主机#

Terminal window

1
'环境确认 — 当前有 3 台运行中的容器'
2
[root@m01 ~]# ansible-inventory --graph
3
@all:
4
  |--@ungrouped:
5
  |--@test_group:
6
  |  |--test_web 🔄
7
  |--@nginx_hosts:
8
  |  |--test_web 🔄
9
  # 同时属于 test_group 和 nginx_hosts
10
  |  |--myweb
11
  |--@py_apps:
12
  |  |--mypy

① 所有主机 all

Terminal window

1
[root@m01 ~]# ansible all -m raw -a 'echo hello'
2
test_web | CHANGED | rc=0 >>
3
hello
4
mypy | CHANGED | rc=0 >>
5
hello
6
myweb | CHANGED | rc=0 >>
7
hello

② 单台主机

Terminal window

1
root@m01 ~# ansible mypy -m raw -a 'hostname'
2
mypy | CHANGED | rc=0 >>
3
d01c8848c7ea          # ← 容器 ID（hostname 在容器里就是容器 ID）

③ 多台主机 — 冒号 : 或逗号 ,

Terminal window

1
root@m01 ~# ansible 'myweb:test_web' -m raw -a 'hostname'
2
⚠️ '别忘记加单引号'
3
myweb | CHANGED | rc=0 >>
4
3c6b015c1a82
5
test_web | CHANGED | rc=0 >>
6
0e4c6edb0722
7

8
root@m01 ~# ansible 'myweb,test_web' -m raw -a 'hostname'
9
✅ '逗号效果完全一样'
10
myweb | CHANGED | rc=0 >>
11
3c6b015c1a82
12
test_web | CHANGED | rc=0 >>
13
0e4c6edb0722

Tip

, 和 : 效果相同，但 : 还能跟 !、& 组合 → 建议统一用冒号

组定位：单组 / 并集#

④ 针对某个组

Terminal window

1
root@m01 ~# ansible nginx_hosts -m raw -a 'echo nginx组'
2
test_web | CHANGED | rc=0 >>
3
nginx组
4
myweb | CHANGED | rc=0 >>
5
nginx组

⑤ 多个组的并集

Terminal window

1
root@m01 ~# ansible 'nginx_hosts:py_apps' -m raw -a 'echo 并集'
2
myweb | CHANGED | rc=0 >>
3
并集
4
test_web | CHANGED | rc=0 >>
5
并集
6
mypy | CHANGED | rc=0 >>
7
并集
8
✅ '3 台都在：nginx 组 2 台 + python 组 1 台'

排除：`!` 操作符#

从组中踢掉特定主机或组：

Terminal window

1
'⑥ 从组中排除单台主机'
2
root@m01 ~# ansible 'nginx_hosts:!test_web' -m raw -a 'echo 排除test_web后'
3
myweb | CHANGED | rc=0 >>
4
排除test_web后
5
# ✅ test_web 没了，只剩 myweb
6
=============================
7
'踢掉test_group'
8
root@m01 ~# ansible 'nginx_hosts:!test_group' -m raw -a 'echo 踢掉test_group'
9
myweb | CHANGED | rc=0 >>
10
踢掉test_group
11
# test_group只有test_web一台主机

步骤	集合
初始 `nginx_hosts`	{myweb, test_web}
执行 `:!test_web`	踢掉 test_web
最终	{myweb}

交集：`&` 操作符#

取两个组的公共成员：

Terminal window

1
'⑦ 组的交集'
2
root@m01 ~# ansible 'nginx_hosts:&test_group' -m raw -a 'echo 交集'
3
test_web | CHANGED | rc=0 >>
4
交集
5
# ✅ 只有 test_web：它同时属于 nginx_hosts 和 test_group

步骤	集合
`nginx_hosts`	{myweb, test_web}
`test_group`	{test_web}
交集	{test_web} ✅

组合运算：先交集再排除#

! 和 & 可以组合，按从左到右顺序执行：

Terminal window展开收起

1
'⑧ 组合 — 交集后排除'
2
root@m01 ~# docker run -d --name test02 --label group=test nginx:latest
3
root@m01 ~# ansible-inventory --graph
4
@all:
5
  |--@ungrouped:
6
  |--@test_group:
7
  |  |--test02
8
  |  |--test_web
9
  |--@nginx_hosts:
10
  |  |--test02
11
  |  |--test_web
12
  |  |--myweb
13
# 场景：取 nginx_hosts ∩ test_group 的交集, 再排除test_web
14
root@m01 ~# ansible 'nginx_hosts:&test_group:!test_web' -m raw -a 'echo 交集并排除后的结果'
15
test02 | CHANGED | rc=0 >>
16
交集并排除后的结果

展开收起

组位置 / 切片：`[n]` 语法#

索引从 0 开始 —> 单个索引 [n] 与 Python 一致，但切片有一个关键区别：

Warning

Ansible 切片 [start:stop] 的 stop 是包含的（inclusive），不是 Python 的排除（exclusive）！

	Python `list[0:1]`	Ansible `group[0:1]`
语义	`[0, 1)` 不含 stop	`[0, 1]` 含 stop
结果	1 个元素（索引 0）	2 个元素（索引 0 和 1）

Terminal window展开收起

1
'nginx_hosts 组共 3 台，按顺序：'
2
  [0] test02
3
  [1] test_web
4
  [2] myweb
5

6
'⑨ 单个索引 — 与 Python 完全一致'
7
[root@m01 ~]# ansible 'nginx_hosts[0]' -m raw -a 'echo 索引0'
8
test02 | CHANGED | rc=0 >>
9
索引0
10

11
[root@m01 ~]# ansible 'nginx_hosts[1]' -m raw -a 'echo 索引1'
12
test_web | CHANGED | rc=0 >>
13
索引1
14

15
[root@m01 ~]# ansible 'nginx_hosts[-1]' -m raw -a 'echo 倒数第一'
16
myweb | CHANGED | rc=0 >>
17
倒数第一
18

19
'⑩ 切片 — ⚠️ stop 也是包含的（两端都算！）'
20
# 用实验来证明，对照 Python 的预期：
21

22
[root@m01 ~]# ansible 'nginx_hosts[0:0]' -m raw -a 'echo 0:0'
23
test02 | CHANGED | rc=0 >>
24
0:0
25
# ← 1 台！Python [0:0] 是空的，Ansible 两端都包含 → {索引0}
26

27
[root@m01 ~]# ansible 'nginx_hosts[0:1]' -m raw -a 'echo 0:1'
28
test02 | CHANGED | rc=0 >>
29
0:1
30
test_web | CHANGED | rc=0 >>
31
0:1
32
# ← 2 台！Python [0:1] 只取索引0，Ansible stop=1 也包含 → {0,1}
33

34
[root@m01 ~]# ansible 'nginx_hosts[0:2]' -m raw -a 'echo 0:2'
35
test02 | CHANGED | rc=0 >>
36
0:2
37
test_web | CHANGED | rc=0 >>
38
0:2
39
myweb | CHANGED | rc=0 >>
40
0:2
41
✅ 3 台全部！Python [0:2] 只取 0,1，Ansible stop=2 包含 → {0,1,2}
42

43
[root@m01 ~]# ansible 'nginx_hosts[1:2]' -m raw -a 'echo 1:2'
44
test_web | CHANGED | rc=0 >>
45
1:2
46
myweb | CHANGED | rc=0 >>
47
1:2
48
# ← 2 台！Python [1:2] 只取索引1，Ansible → {1,2}

展开收起

⭐`--limit`：无需改命令，临时缩小范围#

模式可以直接写在命令行上，也可以通过 --limit 叠加过滤——不需要修改模式本身：

Terminal window展开收起

1
'⑪ --limit 排除主机'
2
root@m01 ~# ansible all -m raw -a 'echo hi' --limit 'all:!test_web'
3
myweb | CHANGED | rc=0 >>
4
hi
5
test02 | CHANGED | rc=0 >>
6
hi
7
mypy | CHANGED | rc=0 >>
8
hi
9
# test_web 被 limit 排除 ✅
10

11
'⑫ --limit 指定组'
12
[root@m01 ~]# ansible all -m raw -a 'echo mixed' --limit 'py_apps:nginx_hosts'
13
test02 | CHANGED | rc=0 >>
14
mixed
15
test_web | CHANGED | rc=0 >>
16
mixed
17
myweb | CHANGED | rc=0 >>
18
mixed
19
mypy | CHANGED | rc=0 >>
20
mixed
21

22
'⑬ --limit 正则排除'
23
📌 `~` 前缀 = 正则匹配
24
📌 `~` 还可以和排除 `!` 组合：
25
root@m01 ~# ansible all -m raw -a 'echo 排除以test开头的组' --limit 'all:!~test.*'
26
⚠️ 关键发现：`~` 隐式锚定开头（自带 `^`）  `~test` == `~^test`
27
myweb | CHANGED | rc=0 >>
28
排除以test开头的组
29
mypy | CHANGED | rc=0 >>
30
排除以test开头的组
31
# ✅ test 开头的主机全被排除（test_web、test02 都不见了）

展开收起

Tip

其实不用 --limit 更快：~ 可以直接写在命令行模式里，一行搞定：

📌 --limit 场景：命令行模式已经写好了不想改，临时叠加一个 --limit 做二次过滤

写法	效果
`'~test.*'`	匹配主机名符合正则的
`'~.*py$'`	匹配以 py 结尾的主机
`'all:!~test.*'`	排除匹配正则的主机
`'组名:!~test.*'`	组内排除

Terminal window

1
[root@m01 ~]# ansible '~test.*' -m raw -a 'echo 匹配正则'
2
test02 | CHANGED | rc=0 >>
3
匹配正则
4
test_web | CHANGED | rc=0 >>
5
匹配正则
6
# ← 只有 test 开头的主机被命中 ✅
7

8
[root@m01 ~]# ansible 'all:!~test.*' -m raw -a 'echo 排除test开头的'
9
⚠️ `~` 隐式锚定开头（自带 `^`）
10
myweb | CHANGED | rc=0 >>
11
排除test开头的
12
mypy | CHANGED | rc=0 >>
13
排除test开头的

从文件读取主机列表：`--limit @文件`#

Terminal window

1
'⑭ 把目标主机写进文件'
2
[root@m01 ~]# cat > /root/host.txt << 'EOF'
3
myweb
4
mypy
5
EOF
6

7
[root@m01 ~]# ansible all -m raw -a 'echo 来自文件' --limit @/root/host.txt
8
myweb | CHANGED | rc=0 >>
9
来自文件
10
mypy | CHANGED | rc=0 >>
11
来自文件
12
# ← test_web、test02 不在文件中，不执行 ✅

小结#

核心规则速记：

符号	含义	类比
`:`	并集（分隔）	集合 ∪
`:!`	排除	集合 −
`:&`	交集	集合 ∩
`[n]`	取单个，索引第 n 台	Python `list[n]`
`[m:n]` ⚠️	切片，两端都包含	Python `list[m:n+1]`
`--limit`	叠加过滤（不影响命令行里的模式）	二次筛选

Tip

实战建议：

日常操作：ansible <组名> -m raw -a '命令' 最常用
调试单台：ansible <主机名> -m raw -a '命令'
排除故障机：用 '组名:!故障机'
快速过滤：'~test.*' 直接正则匹配主机名，秒定位一类主机
批量排除：'all:!~test.*' 直接写在模式里即可，不用 --limit
批量读取：把主机名写进文件，--limit @文件
⚠️ 切片取 N 台：group[0:N-1]，stop 是包含的！

命令速查#

Terminal window展开收起

1
# -------- 清单 --------
2
ansible-inventory --graph                  # 树状图
3
ansible-inventory --list                   # JSON 详情
4
ansible-inventory --host myweb             # 某个主机的所有变量
5
ansible-inventory --list -vvv              # 详细模式排错
6

7
# -------- 执行 --------
8
ansible all -m ping                        # ping（需要 Python）
9
ansible all -m raw -a 'whoami'             # raw（不需要 Python）
10
ansible all -m debug -a "var=ansible_connection"  # 查看连接方式
11
ansible web_servers -m raw -a 'nginx -v'   # 针对某个组执行
12

13
# -------- 主机模式 --------
14
ansible 'group:!host' -m raw -a 'cmd'      # 从组中排除某台主机
15
ansible 'g1:&g2' -m raw -a 'cmd'           # 两个组的交集
16
ansible 'group[0]' -m raw -a 'cmd'         # 组内第一台
17
ansible 'group[0:1]' -m raw -a 'cmd'       # 前两台（⚠️ stop 包含，[0:1]=索引0和1）
18
ansible '~test.*' -m raw -a 'cmd'            # 正则过滤（直接模式，更快 ⚡）
19
ansible 'all:!~test.*' -m raw -a 'cmd'       # 正则排除（直接模式，不用 --limit）
20
ansible all -m raw -a 'cmd' --limit @file    # 从文件读取主机列表
21
ansible all -m raw -a 'cmd' --limit 'all:!~pattern.*'  # --limit 正则排除
22

23
# -------- 环境 --------
24
ansible --version                          # 版本 + 当前使用的配置文件
25
ansible-galaxy collection list | grep docker  # 确认 Docker 插件已安装

展开收起

Ansible角色

Wed, 10 Jun 2026 00:00:00 GMT

Ansible角色#

[TOC]

彩蛋#

Ansible 有一个非常有趣的小彩蛋：当它检测到你的系统中安装了 cowsay 时,就会自动调用它,把原本枯燥的任务名称（比如 PLAY RECAP、TASK [...]）放进小牛的对话气泡里,让输出界面变得生动有趣

Terminal window

1
 ____________
2
< PLAY RECAP >
3
 ------------
4
        \   ^__^
5
         \  (oo)\_______
6
            (__)\       )\/\
7
                ||----w |
8
                ||     ||
9
Client: ok=5  changed=3  failed=0  skipped=0  ignored=0
10
Server: ok=8  changed=6  failed=0  skipped=0  ignored=0

除了默认的小牛,cowsay 还有很多其他 ASCII 艺术图案

查看可用图案：你可以运行 cowsay -l 来查看所有可用的图案

Terminal window

1
[root@Zabbix ~]# cowsay -l
2
Cow files in /usr/share/cowsay:
3
cheese cower default dragon dragon-and-cow elephant elephant-in-snake eyes milk.....

指定图案：你可以通过修改 Ansible 的配置文件 /etc/ansible/ansible.cfg 来指定默认使用的图案

Terminal window

1
# 在 [defaults] 部分添加或修改
2
[defaults]
3
# 设置为 'dragon',下次运行就会看到一条龙在说话
4
cow_selection = dragon

🚫 觉得太花哨？关掉它！

个人觉得比默认的 * 好玩多了

编辑 Ansible 的主配置文件 /etc/ansible/ansible.cfg

Terminal window

1
# 在 [defaults] 部分
2
[defaults]
3
nocows = 1

概述#

==roles== 是对playbook的一种重新编排

Terminal window展开收起

1
🛠️ 如何创建角色？
2
'ansible-galaxy init 角色名'
3
# 它能一键生成标准的目录结构
4
[root@m01 ansible]# mkdir roles
5
[root@m01 ansible]# cd roles/
6
[root@m01 roles]# ansible-galaxy init backup
7
- Role backup was created successfully
8
# roles/backup--->专门用来备份
9
'当然我们还可以在roles目录下创建别的'
10
[root@m01 roles]# tree ./backup/
11
./backup/
12
├── defaults ❌️
13
│   └── main.yml
14
├── files
15
├── handlers
16
│   └── main.yml
17
├── meta ❌️
18
│   └── main.yml
19
├── README.md ❌️
20
├── tasks
21
│   └── main.yml
22
├── templates
23
├── tests ❌️
24
│   ├── inventory
25
│   └── test.yml
26
└── vars
27
    └── main.yml
28
# 我们先把没有用的删除掉!
29
[root@m01 roles]# cd backup/
30
[root@m01 backup]# rm -rf defaults/ meta/ tests/ README.md
31
[root@m01 backup]# tree
32
.
33
├── files    # 静态文件
34
├── handlers  # 触发器
35
│   └── main.yml✅️自动创建
36
├── tasks    # 核心任务
37
│   └── main.yml✅️自动创建
38
├── templates  # 模版文件(.j2)
39
└── vars    # 固定变量
40
    └── main.yml✅️自动创建
41
# 我们经常用的就这几个!
42
✅️我们直接在main.yml里面编写即可!

展开收起

backup重构#

Terminal window展开收起

1
1)拷贝配置文件
2
# 到template目录下
3
[root@m01 backup]# cp ~/rsyncd.conf ./templates/rsyncd.conf.j2
4
# rsync的配置文件
5
[root@m01 backup]# cd templates/
6
[root@m01 templates]# echo rsync_backup:123 > rsync.passwd.j2
7
[root@m01 templates]# ls
8
rsyncd.conf.j2  rsync.passwd.j2
9
# 配置文件和密码文件
10
[root@m01 templates]# tree ../templates/
11
../templates/
12
├── rsyncd.conf.j2
13
└── rsync.passwd.j2
14

15
2)编辑核心剧本
16
[root@m01 templates]# cd ..
17
[root@m01 backup]# cd ..
18
# 要在roles目录下创建playbook
19
[root@m01 roles]# vim site.yml
20
# 从hosts开始写
21
- hosts: backup
22
# 后面要改为all,会有不同的角色!
23
  roles:
24
    - role: backup
25
      when: ansible_hostname is match "backup"
26
      # when判断和role对齐
27
      # 只有主机为backup才执行
28

29
3)恢复快照&&免密登录
30
[root@m01 roles]# ssh-copy-id -i ~/.ssh/my_key.pub 172.16.1.41
31
[root@m01 roles]# ssh backup "hostname -I"
32
10.0.0.41 172.16.1.41
33
'密码成功'
34

35
4)检测与测试
36
[root@m01 roles]# ansible-playbook --syntax-check site.yml
37
playbook: site.yml
38
[root@m01 roles]# ansible-playbook site.yml
39
PLAY [backup]
40
**********************
41
TASK [Gathering Facts]
42
ok: [backup]
43
'收集信息'
44
**********************
45
TASK [backup : Install rsync server]
46
ok: [backup]
47
'安装rsync'
48
**********************
49
TASK [backup : Configure rsync file]
50
changed: [backup] => (item={'src': 'rsyncd.conf.j2', 'dest': '/etc/rsyncd.conf', 'mode': '0644'})
51
changed: [backup] => (item={'src': 'rsync.passwd.j2', 'dest': '/etc/rsync.passwd', 'mode': '0600'})
52
# 拷贝文件--->配置文&&密码文件
53
**********************
54
TASK [backup : Create group "www"]
55
changed: [backup]
56
"创建组"
57
**********************
58
TASK [backup : Create user "www"]
59
changed: [backup]
60
'创建用户'
61
**********************
62
TASK [backup : Create dir]
63
changed: [backup] => (item=/backup)
64
changed: [backup] => (item=/data)
65
'创建目录'
66
**********************
67
TASK [backup : Start rsync server]
68
changed: [backup]
69
'启动&&开机自启'
70

71
'测试验证'
72
[root@m01 roles]# rsync -avz /etc/passwd rsync_backup@172.16.1.41::backup
73
Password: ---'密码123'
74
sent 841 bytes  received 43 bytes  353.60 bytes/sec
75
[root@backup ~]#ls /backup/passwd
76
/backup/passwd

展开收起

roles/backup/vars/main.yml
- 存放着固定变量

1
user: www
2
uid: 888
3
rc_port: 873
4
dir_1: /backup
5
dir_2: /data

roles/backup/template/rsyncd.conf.j2
- 模版配置文件

1
uid = {{user}}
2
gid = {{user}}
3
port = {{rc_port}}
4
fake super = yes
5
use chroot = no
6
max connections = 200
7
timeout = 600
8
ignore errors
9
read only = false
10
list = false
11
auth users = rsync_backup
12
secrets file = /etc/rsync.passwd
13
pid file = /var/run/rsyncd.pid
14
lock file = /var/run/rsync.lock
15
log file =/var/log/rsyncd.log
16
############################
17
[backup]
18
path = {{dir_1}}
19
[data]
20
path = {{dir_2}}

展开收起

roles/backup/tasks/main.yml
- 任务核心

1
- name: Install rsync server
2
  yum:
3
    name: rsync
4
    state: present
5

6
- name: Configure rsync file
7
  template:
8
    src: "{{item.src}}"
9
    dest: "{{item.dest}}"
10
    mode: "{{item.mode}}"
11
  notify: Restart rsync
12
  # 只要修改了,就触发handler重启
13
  loop:
14
    # src能够自动识别template里面的模版文件
15
    - src: rsyncd.conf.j2
16
      dest: /etc/rsyncd.conf
17
      mode: "0644"
18
    - src: rsync.passwd.j2
19
      dest: /etc/rsync.passwd
20
      mode: "0600"
21

22
- name: Create group "{{user}}"
23
  group:
24
    name: "{{user}}"
25
    gid: "{{uid}}"
26

27
- name: Create user "{{user}}"
28
  user:
29
    name: "{{user}}"
30
    uid: "{{uid}}"
31
    group: "{{user}}"
32
    shell: /sbin/nologin
33
    create_home: false
34

35
- name: Create dir
36
  file:
37
    path: "{{item}}"
38
    state: directory
39
    owner: "{{user}}"
40
    group: "{{user}}"
41
  loop:
42
  # 因为变量没有在路径中所以要加引号
43
  # /tmp/{{dir}}-->这种不需要加引号
44
    - "{{dir_1}}"
45
    - "{{dir_2}}"
46

47
- name: Start rsync server
48
  systemd:
49
    name: rsyncd
50
    state: started
51
    enabled: yes

展开收起

roles/backup/handlers/main.yml
- 触发器,修改配置文件--->给handler发信号

1
- name: Restart rsync
2
# 和notify的名字相同
3
  systemd:
4
    name: rsyncd
5
    state: restarted

nfs重构#

Terminal window展开收起

1
1)恢复快照&&免密
2
[root@m01 roles]# ssh-copy-id -i ~/.ssh/my_key.pub 172.16.1.31
3
[root@m01 roles]# ssh nfs01 "hostname -I"
4
10.0.0.31 172.16.1.31
5

6
2)创建角色
7
[root@m01 roles]# ansible-galaxy init nfs
8
- Role nfs was created successfully
9
[root@m01 roles]# cd nfs/
10
[root@m01 nfs]# ls
11
defaults  files  handlers  meta  README.md  tasks  templates  tests  vars
12
[root@m01 nfs]# rm -rf defaults/ meta/ README.md tests/
13
[root@m01 nfs]# ls
14
files  handlers  tasks  templates  vars
15

16
3)拷贝配置文件
17
[root@m01 nfs]# cp /home/ansible/exports ./templates/exports.j2
18
[root@m01 nfs]# cat ./templates/exports.j2
19
{{dir}} 172.16.1.0/24(rw,sync,all_squash,anonuid={{ id }},anongid={{ id }})
20

21
4)编辑核心剧本
22
[root@m01 nfs]# cd ..
23
# 继续上一个的写!
24
[root@m01 roles]# vim site.yml
25
- hosts: all
26
# 注意看自己的主机清单!
27
  roles:
28
    - role: backup
29
      when: ansible_hostname is match "backup"
30
      # when判断和role对齐
31
      # 只有主机为backup才执行
32
    - role: nfs
33
      when: ansible_hostname is match "nfs"
34
[root@m01 roles]# tree nfs/
35
nfs/
36
├── files
37
├── handlers
38
│   └── main.yml
39
├── tasks
40
│   └── main.yml
41
├── templates
42
│   └── exports.j2
43
└── vars
44
    └── main.yml
45

46
5)测试&验证
47
[root@m01 roles]# ansible-playbook --syntax-check site.yml
48
playbook: site.yml
49
[root@m01 roles]# showmount -e 172.16.1.31
50
clnt_create: RPC: ❌️Unable to receive
51
[root@m01 roles]# ansible-playbook site.yml
52
TASK [backup : Install rsync server]
53
skipping: [db02]
54
skipping: [nfs01]
55
skipping: [web01]
56
skipping: [web02]
57
ok: [backup]
58
'只有backup执行,其他都跳过'
59
**********************
60
.................
61
'先跑第一个角色backup,再跑nfs'
62
**********************
63
TASK [nfs : Install nfs server]
64
skipping: [db02]
65
skipping: [backup]
66
skipping: [web02]
67
skipping: [web01]
68
ok: [nfs01]
69
'只有nfs执行!!'
70
**********************
71
nfs01  : ok=7    changed=6
72
[root@m01 roles]# showmount -e 172.16.1.31
73
Export list for 172.16.1.31:
74
/data/wp 172.16.1.0/24✅️
75
'没问题👌'

展开收起

1
user: www
2
dir: /data/wp
3
id : 888

1
- name: Install nfs server
2
  yum:
3
    name: nfs-utils
4
    state: present
5

6
- name: Configure nfs file
7
  template:
8
    src: exports.j2
9
    dest: /etc/exports
10
  notify: Restart nfs
11

12
- name: Create group "{{user}}"
13
  group:
14
    name: "{{user}}"
15
    gid: "{{id}}"
16

17
- name: Create user "{{user}}"
18
  user:
19
    name: "{{user}}"
20
    uid: "{{id}}"
21
    group: "{{user}}"
22
    shell: /sbin/nologin
23
    create_home: false
24

25
- name: Create dir "{{dir}}"
26
# 递归创建了目录/data/wp
27
# 这两个目录的属主都是www
28
  file:
29
    path: "{{dir}}"
30
    state: directory
31
    owner: "{{user}}"
32
    group: "{{user}}"
33

34
- name: Start NFS Server
35
  systemd:
36
    name: nfs
37
    state: started
38
    enabled: yes

展开收起

1
- name: Restart nfs
2
  systemd:
3
    name: nfs
4
    state: restarted

主配置文件#

Terminal window展开收起

1
[root@Zabbix ~]# tree /ansible/
2
/ansible/
3
└── roles
4
    ├── Client
5
    │ ......
6
    ├── Server
7
    │ ......
8
    └── site.yml
9

10
'hosts可以写在 - name '
11

12
- name: 配置 Server 主机
13
  hosts: Server
14
  roles:
15
    - Server
16

17
- name: 配置 Client 主机
18
  hosts: Client
19
  roles:
20
    - Client
21

22
- name: Server 测试验证
23
  hosts: Server
24
  tasks:
25
    - name: Result test
26
      shell: 'unbound-control dump_cache | grep jd.com'
27
      register: result_end
28

29
    - name: Print result_end
30
      debug:
31
        msg: "{{result_end.stdout_lines}}"

展开收起

nginx重构#

mysql重构#

wordpress重构#

面试题#

Terminal window

1
请问用过ansible吗？
2
你都用来干啥？
3
用过、--->配置变更、数据收集facts模块(资产管理)、批量安装部署服务
4
那你用过哪些模块？
5
file copy template yum systemd cron handles vars when loop
6
我执行一条命令、但是看不到结果怎么办？
7
使用变量注册 register

Ansible流程

Tue, 02 Jun 2026 00:00:00 GMT

Ansible流程#

[TOC]

when判断#

假设服务器主机名为 web01.example.com

表达式	含义	结果
等于 (==)	完全一样才算匹配	❌️不匹配 (因为 `web01.example.com` 不等于 `web01`)
is match	开头必须和你写的完全一样	✅️匹配 (因为 `web01.example.com` 确实是以 `web01` 开头的)
is search	主机名里面包含你写的这部分就行	✅️匹配 (因为 `web01.example.com` 里确实包含了 `web01`)

== (等于): 最严格！要求主机名一模一样,一字不差

用得少,因为实际主机名可能更复杂

is match: 比较严格,看开头

你想让所有以 web 开头的服务器执行任务

比如 web01, web02, web-db-backup

is search: 最宽松！适合==模糊查找==

你想让所有主机名里含有 web 的服务器执行任务

比如 web01, backup-web-data, web-db-server 都会匹配

Terminal window展开收起

1
1)主机名称为web01安装wget命令
2
# 这里使用的是==必须完全等于才行!
3
[root@m01 ansible]# vim when.yml
4
- hosts: webs
5
  tasks:
6
    - name: Install wget
7
      yum:
8
        name: wget
9
        state: present
10
      when: ansible_hostname == "web01"
11
      # 这个when模块和上面的yum模块对齐!
12
      # 这里内置变量不需要加"{{ }}"
13
      # 后面web01必须加上双引号" "
14
[root@m01 ansible]# ansible-playbook  --syntax-check when.yml
15
[root@m01 ansible]# ansible-playbook  when.yml
16
skipping: [web02]
17
ok: [web01]
18
'跳过web02,只在web01上执行'
19

20
2)web01下载wget  web02下载tree命令
21
[root@m01 ansible]# vim when.yml
22
- hosts: webs
23
  tasks:
24
    - name: Install wget
25
      yum:
26
        name: wget
27
        state: present
28
      when: ansible_hostname == "web01"
29

30
    - name: Install tree
31
      yum:
32
        name: tree
33
        state: present
34
      when: ansible_hostname == "web02"
35
[root@m01 ansible]# ansible-playbook  when.yml
36
TASK [Install wget]*****
37
skipping: [web02]
38
ok: [web01]    # 跳过web02
39
TASK [Install tree] *****
40
skipping: [web01]
41
ok: [web02]    # 跳过web01
42

43
3)并且关系
44
# 同时满足才行
45
[root@m01 ansible]# vim when.yml
46
- hosts: webs
47
  tasks:
48
    - name: Install wget
49
      yum:
50
        name: wget
51
        state: present
52
      when: (ansible_hostname == "web01") and (ansible_default_ipv4.address == "10.0.0.7" )
53
# 这个是and连接,两边用小括号连接起来!
54
'或者使用列表的方式'
55
    when:
56
      - ansible_hostname == "web01"
57
      - ansible_default_ipv4.address == "10.0.0.7"
58
# 并且关系,更加的清楚
59

60
4)或者关系 or
61
when: (ansible_hostname == "web01") or (ansible_default_ipv4.address == "10.0.0.8")
62
[root@m01 ansible]# ansible-playbook  when.yml
63
ok: [web01]
64
ok: [web02]

展开收起

Nginx判断实战#

1️⃣阶段一#

image-20260405110842170

1
- hosts: webs
2
  tasks:
3
    - name: Configure nginx repo
4
      yum_repository:
5
        name: nginx-stable
6
        description: nginx stable repo
7
        baseurl: https://nginx.org/packages/centos/7/$basearch/
8
        gpgcheck: no
9
        enabled: yes
10

11
    - name: Install nginx server
12
      yum:
13
        name: nginx
14
        state: present
15

16
    - name: Configure copy nginx file
17
      copy:
18
        src: ./nginx.conf
19
        dest: /etc/nginx/
20

21
    - name: Create group www
22
      group:
23
        name: www
24
        gid: 888
25

26
    - name: Create user www
27
      user:
28
        name: www
29
        uid: 888
30
        group: www
31
        shell: /sbin/nologin
32
        create_home: false
33

34
    - name: Start nginx server
35
      systemd:
36
        name: nginx
37
        state: started
38
        enabled: yes

展开收起

image-20260405111247319

重新执行一遍都是绿色的,说明没有任何的改变!!

Terminal window

1
[root@m01 ~]# vim nginx.conf
2
user  nginx;
3
# 启动用户由www-->nginx

我们改动一下配置文件!
- 再执行一遍会怎样❓️

image-20260405111909542

我们来看一下它的启动用户是谁??

Terminal window

1
[root@web01 ~]#ps aux | grep nginx
2
www  S    08:24   0:00 nginx: worker process
3
'依旧是www用户!'

2️⃣阶段二#

image-20260405144803358

Handler 是什么？

你可以把 Handler 想象成一个待命的“服务兵”

普通任务 (Task): 像勤劳的工人,Playbook 一运行,它们就立刻干活
Handler: 像是等待指令的特警队员,站在一旁待命
- 只有收到特定的“信号”,它才会行动

触发 (Notify): 在一个普通的 Task 里,比如“拷贝 nginx 配置文件”
- 你加上一个 notify: restart nginx
- 这个 notify 就是“信号”或“通知”

判断与执行: Ansible 执行*“拷贝 nginx 配置文件”*这个任务时

它会特别留意：这次操作有没有改变什么东西？
如果没有改变：
- 比如本地的配置文件和服务器上的文件一模一样
- 那么,notify 就像没听到一样,handler 不会被触发,服务不会重启
如果有改变：
- 比如本地的配置文件发生了改变,拷贝操作成功更新了服务器上的文件
- 这时,Ansible 认为这个任务“状态改变了”
- 它就会立刻向*“重启 nginx”*这个 handler 发送一个==“信号”==
  - 💡 注意：此时还没重启！只是“记住了要重启”

统一执行: 所有的 Tasks 都跑完后,在 Playbook 的最后阶段

Ansible 会检查有哪些 handler 收到了信号
它会把所有收到信号的 handlers 都按顺序执行一遍
- 🎯 重点：即使同一个 handler 被多个 task 触发了
  - 也只会执行一次
如果没人通知它,它就一直待命,啥也不干

🌟为什么要这么设计？ （好处）

避免不必要的操作：

盲目重启,不仅浪费资源,还可能导致短暂的服务中断

Handler 保证了只有在真正需要（配置变了）的时候才重启

提高效率：

即使你的 playbook 里有 10 个地方都修改了 nginx 配置

并且都想重启 nginx

使用 notify 也能确保 nginx 最终只被重启一次,而不是 10 次

1
- hosts: webs
2
  tasks:
3
    - name: Install nginx server
4
      yum:
5
        name: nginx
6
        state: present
7

8
    - name: Configure copy nginx file
9
      copy:
10
        src: ./nginx.conf
11
        dest: /etc/nginx/
12
      notify: Restart nginx
13
      # 只要有改变,就给名字为Res..的handler发信号
14
      # 和copy平级
15

16
    - name: Start nginx server
17
      systemd:
18
        name: nginx
19
        state: started
20
        enabled: yes
21

22
  handlers:
23
  # 跟tasks平级,前面没有-
24
    - name: Restart nginx
25
    # 这个name和上面的notify保持一致
26
    # 最后,不管收到几次信号,只重启一次
27
      systemd:
28
        name: nginx
29
        state: restarted

展开收起

上面的配置文件少了yum仓库配置, 创建组和用户!

Terminal window

1
现在webs的运行用户还是www
2
'www   nginx: worker process'
3
我们给配置文件首行加一个空行!
4
# 也算是配置文件发生了改变

image-20260405144616540

Terminal window

1
[root@web01 ~]#ps aux | grep nginx
2
nginx  nginx: worker process
3
'现在启动用户就是nginx了!'

Terminal window展开收起

1
但如果我的配置文件改错了!
2
那么它重启也会报错的❌️
3
[root@m01 ~]# head -1 nginx.conf
4
ser  nginx;
5
# 少一个u
6
[root@m01 ~]# ansible-playbook nginx.yml
7
TASK [Configure copy nginx file]
8
changed: [web01]
9
changed: [web02]
10
'配置文件依旧改变!'
11
....
12
RUNNING HANDLER [Restart nginx]
13
fatal: [web02]: FAILED! => {"changed": false, "msg": "Unable to restart service nginx:"
14
# 重启部分直接报错了!!
15
'webs的nginx也停止'
16
[root@web01 ~]#ps aux | grep nginx|grep -v grep | wc -l
17
0

展开收起

3️⃣阶段三#

image-20260405163346326

1
- hosts: webs
2
  gather_facts: no
3
  tasks:
4
    - name: Configure copy nginx file
5
      copy:
6
        src: ./nginx.conf
7
        dest: /etc/nginx/
8
      notify: Restart nginx
9
      # 只要有改变,就给名字为Res..的handler发信号
10
      # 和copy平级
11

12
    - name: Check nginx from ng_re
13
      command: "nginx -t"
14
      register: ng_re
15
      # 把这条命令的结果返回给变量ng_re
16
      ignore_errors: yes
17
      # 当结果错误时候忽略掉、继续向下执行
18

19
  handlers:
20
  # 跟tasks平级,前面没有-
21
    - name: Restart nginx
22
    # 这个name和上面的notify保持一致
23
    # 最后,不管收到几次信号,只重启一次
24
      systemd:
25
        name: nginx
26
        state: restarted
27
      when: ng_re.stderr_lines is search "successful"
28
      # 当返回的变量找到了successful
29
      # 且收到了notify的信号(配置文件修改)才能重启
30
===============================
31
      when: ng_re.rc is match "0"
32
      # 我们也可以通过状态码是否为0来判断是否执行成功
33
      # 上面是匹配以0开头的...
34
      这个 == 0 不成立!
35
      # 后面还有个逗号,
36
      "rc": 0,

展开收起

下面是 nginx -t 正常的返回结果
- 用debug模块中的 msg

Terminal window展开收起

1
- name: Print nginx_result
2
  debug:
3
    msg: "{{nginx_re}}"
4
===============================
5
    "msg": {
6
        "changed": true,
7
        "cmd": [
8
            "nginx",
9
            "-t"
10
        ],
11
        "delta": "0:00:00.004444",
12
        "end": "2026-04-04 15:04:48.508624",
13
        "failed": false,
14
        "msg": "",
15
        ✅️"rc": 0,
16
        "start": "2026-04-04 15:04:48.504180",
17
        "stderr": "nginx: the configuration file /etc/nginx/nginx.conf syntax is ok\nnginx: configuration file /etc/nginx/nginx.conf test is successful",
18
        ✅️"stderr_lines": [
19
            "nginx: the configuration file /etc/nginx/nginx.conf syntax is ok",
20
            "nginx: configuration file /etc/nginx/nginx.conf test is successful"
21
        ],
22
        "stdout": "",
23
        "stdout_lines": []
24
    }
25
}

展开收起

Terminal window展开收起

1
1)我们再次修改配置文件,触发notify
2
[root@m01 ~]# vim nginx.conf
3
user  nginx;
4
# 改正确!
5
[root@m01 ~]# ansible-playbook nginx.yml
6
web01  : ok=3    changed=3
7
web02  : ok=3    changed=3
8
# 三步都改变!
9
2)notify给handler发信号,我的配置文件修改了!请重启
10
# 是否真的重启,还要看when判断!
11
3)第二步nginx -t执行成功了-->变量里面有successful
12
4)handler收到信号,是否重启由when判断
13
5)when从变量中找到了successful,且handler收到了信号
14
6)重启Nginx
15
===============================
16
# 那我们试着把配置文件改错试试会怎么样!!
17
[root@m01 ~]# vim nginx.conf
18
ser  nginx;
19
[root@m01 ~]# ansible-playbook nginx.yml

展开收起

image-20260405155737147

Terminal window

1
'ignore_errors: yes'
2
# 当nginx -t执行失败,则不中断,继续往下走!
3
===============================
4
如果没有忽略,则直接中断!
5
# 跳出playbook,不往下执行了

image-20260405163250438

==最终版==

1
- hosts: webs
2
  tasks:
3
    - name: Configure nginx repo
4
      yum_repository:
5
        name: nginx-stable
6
        description: nginx stable repo
7
        baseurl: https://nginx.org/packages/centos/7/$basearch/
8
        gpgcheck: no
9
        enabled: yes
10

11
    - name: Install nginx server
12
      yum:
13
        name: nginx
14
        state: present
15

16
    - name: Create Group www
17
      group:
18
        name: www
19
        gid: 666
20
        state: present
21

22
    - name: Create User www
23
      user:
24
        name: www
25
        uid: 666
26
        group: www
27
        shell: /sbin/nologin
28
        create_home: false
29

30
    - name: Configure Nginx Server
31
      copy:
32
        src: nginx.conf
33
        dest: /etc/nginx/
34
      notify: Restart Nginx Server
35

36
    - name: nginx -t
37
      command: nginx -t
38
      register: ng_re
39
      ignore_errors: yes
40

41
    - name: Start Nginx Server
42
    # 开机启动&&自启
43
      systemd:
44
        name: nginx
45
        state: started
46
        enabled: yes
47

48
  handlers:
49
    - name: Restart Nginx Server
50
    # 配置文件修改重启
51
      systemd:
52
        name: nginx
53
        state: restarted
54
        enabled: yes
55
      when: ng_re.rc is match "0"

展开收起

字典循环#

Terminal window展开收起

1
[root@m01 ansible]# vim f.yml
2
- hosts: web01
3
  tasks:
4
    - name: Create many file
5
      file:
6
        path:
7
          - a.txt
8
          - b.txt
9
        state: touch
10
[root@m01 ansible]# ansible-playbook --syntax-check f.yml
11
playbook: f.yml
12
[root@m01 ansible]# ansible-playbook f.yml
13
changed: [web01]
14
# 也是执行成功了!
15
[root@web01 ~]#ls
16
'['\''a.txt'\'', '\''b.txt'\'']'
17
# ❌️回到web01进行验证,这是创建了个啥!
18
⚠️file不支持这样创建文件
19
[root@web01 ~]#rm -rf ./*
20
[root@web01 ~]#ls | wc -l
21
0
22
# 都删除了
23

24
1)创建多个文件
25
[root@m01 ansible]# vim f.yml
26
- hosts: web01
27
  tasks:
28
    - name: Create many file
29
      file:
30
        path: "{{item}}"
31
        # 固定用法,必须是item
32
        state: touch
33
      loop:
34
      # 和file对齐,loop就是循环的意思!
35
        - a.txt
36
        - b.txt
37
[root@web01 ~]#ls
38
a.txt  b.txt
39
[root@web01 ~]#ls | wc -l
40
2
41
# 成功创建出来两个文件
42
'权限不同,属主不同'
43
[root@m01 ansible]# cat f.yml
44
- hosts: web01
45
  tasks:
46
    - name: Create many files
47
      file:
48
        path: "{{item.path}}"
49
        state: touch
50
        owner: "{{item.owner}}"
51
        group: "{{item.group}}"
52
        mode: "{{item.mode}}"
53
      loop:
54
        - {path: a.txt, owner: root, group: root, mode: "0644"}
55
        - {path: b.txt, owner: www, group: www, mode: "0755"}
56
        # 这个权限(是数字)必须要加引号
57
        # 用大括号括起来
58
[root@m01 ansible]# ansible-playbook --syntax-check f.yml
59
playbook: f.yml
60
[root@m01 ansible]# ansible-playbook f.yml
61
changed: [web01] => (item={'path': 'a.txt', 'owner': 'root', 'group': 'root', 'mode': '0644'})
62
changed: [web01] => (item={'path': 'b.txt', 'owner': 'www', 'group': 'www', 'mode': '0755'})
63
[root@web01 ~]#ls -lh
64
total 0
65
-rw-r--r-- 1 root root 0 Apr  5 20:55 a.txt
66
-rwxr-xr-x 1 www  www  0 Apr  5 20:55 b.txt
67

68
2)拷贝多个文件
69
[root@m01 ansible]# vim c.yml
70
- hosts: web01
71
  tasks:
72
    - name: Copy many files
73
      copy:
74
        src: "{{item.src}}"
75
        dest: "{{item.dest}}"
76
        mode: "{{item.mode}}"
77
      loop:
78
      # 使用下面这种方法也是可以的,更加清晰!
79
        - src: rsyncd.conf
80
          dest: /home/
81
          mode: "0600"
82
        - src: info.txt
83
          dest: /home/
84
          mode: "0644"
85
[root@m01 ansible]# ansible-playbook --syntax-check c.yml
86
playbook: c.yml
87
[root@m01 ansible]# ansible-playbook c.yml
88
changed: [web01] => (item={'src': 'rsyncd.conf', 'dest': '/home/', 'mode': '0600'})
89
changed: [web01] => (item={'src': 'info.txt', 'dest': '/home/', 'mode': '0644'})
90
[root@web01 ~]#ls -lh /home/
91
-rw-r--r-- 1 root root 106 Apr  5 21:16 info.txt
92
-rw------- 1 root root 427 Apr  5 21:16 rsyncd.conf
93

94
3)创建多个组和用户
95
[root@m01 ansible]# vim g.yml
96
- hosts: web01
97
  tasks:
98
    - name: Create many groups
99
      group:
100
        name: "{{item.name}}"
101
        gid: "{{item.gid}}"
102
      loop:
103
        - name: test01
104
          gid: "778"
105
        - name: test02
106
          gid: "779"
107
        # 这些数字前面一定要加引号!
108

109
    - name: Create many users
110
      user:
111
        name: "{{item.name}}"
112
        uid: "{{item.uid}}"
113
        group: "{{item.group}}"
114
        shell: "{{item.shell}}"
115
        create_home: "{{item.home}}"
116
        # 后面这个点后面的东西随便写!
117
        # 只要能够与下面的loop对应就可以
118
      loop:
119
        - name: test01
120
          uid: "778"
121
          group: test01
122
          shell: /sbin/nologin
123
          home: false
124
          # 这个home与上面的item.home相对应!
125
        - name: test02
126
          uid: "779"
127
          group: test02
128
          shell: /bin/bash
129
          home: true
130
[root@m01 ansible]# ansible-playbook --syntax-check g.yml
131
[root@m01 ansible]# ansible-playbook g.yml
132
'测试验证部分'
133
[root@web01 ~]#id test01
134
uid=778(test01) gid=778(test01) groups=778(test01)
135
[root@web01 ~]#id test02
136
uid=779(test02) gid=779(test02) groups=779(test02)
137
[root@web01 ~]#grep test /etc/passwd
138
test01❌778:778::/home/test01:/sbin/nologin
139
test02❌779:779::/home/test02:/bin/bash
140
[root@web01 ~]#ls -d /home/test02/
141
/home/test02/
142

143
4)同时重启NGINX和PHP服务
144
[root@m01 ansible]# vim re.yml
145
- hosts: web01
146
  tasks:
147
    - name: Restart server
148
      systemd:
149
        name: "{{item}}"
150
        state: restarted
151
      loop:
152
        - nginx
153
        - php-fpm
154
[root@m01 ansible]# ansible-playbook re.yml
155
changed: [web01] => (item=nginx)
156
changed: [web01] => (item=php-fpm)

展开收起

Jinja2模版#

Jinja2 模板文件（.j2）里有两个“逻辑控制”

==for循环== 和 ==if判断==

你就把 .j2 文件想象成一个**“填空题试卷”**：

{{ }} 是用来填答案的（变量）
- template模块 的用法,参考 ==📚Ansible03==
  - 对比着 copy模块
{% %} 是用来写“解题指令”的（循环和判断）

在 Ansible 里,循环主要出现在两个地方,我们一个个来看：

🛠️ 场景一：在 ==任务playbook== 里循环（干活时用）

这是最常用的, 比如你要创建 3 个用户
配合 loop 关键字, 和 {{ item }} 变量
- 就是我们上面👆的字典循环

📄 场景二：在 ==模板.j2== 里循环（生成文件时用）

当你需要生成配置文件,里面有一堆重复的段落
只是 IP或端口不一样时,就用 {% for %}

特性	第一组：任务级循环	第二组：模板级逻辑
核心关键词	`loop` 和 `{{ item }}`	`{% for %}` 和 `{% if %}`
写在哪里？	Playbook (`.yml` 文件)	模板 (`.j2` 文件)
谁来配合？	任何模块都能配 (如 `yum`, `user`)	必须配合 `template` 模块使用
变量怎么传？	直接用 `loop` 列表	靠 Playbook 里的 `vars` 传进去

For 循环：#

Terminal window展开收起

1
{% for 变量名 in 列表数据 %}
2
    这里写重复的内容,用 {{ 变量名 }} 来引用当前的数据
3
{% endfor %}
4
===============================
5
1)列表数据我们经常用 range
6
# range(7,9)--->包含7,不包含9
7
# 7,8
8
2)模板里换行了,会出现空白
9
'可以加减号 - '
10
减号 - 贴着哪边,就吸掉哪边的“空白”（换行符或空格）
11
⚠️这个 - 写在里面
12
{%- for n in range(7,9) %}
13
{%- endfor %}
14
# 把前面的空白都吸走!
15
===============================
16
🦄案例: 生成负载均衡的配置文件
17
[root@m01 ansible]# vim lb.conf.j2
18
upstream {{server_name}} {
19
{%- for n in range(7,9) %}
20
  server 172.16.1.{{n}}:{{ up_port }}
21
{%- endfor %}
22
}
23
server {
24
    listen 80;
25
    server_name {{ server_name }};
26

27
    location / {
28
        root /code;
29
        index index.html;
30
        proxy_pass http://{{ server_name }};
31
        proxy_set_header Host $http_host;
32
        }
33
}
34
# 里面总共两个变量--->在剧本中定义vars变量
35
[root@m01 ansible]# vim l.yml
36
- hosts: web01
37
  vars:
38
    - server_name: wp.kpyun.com
39
    - up_port: 80
40
  # 先写vars变量,后写task任务
41
  # tasks和vars对齐
42
  tasks:
43
    - name: Configure lb file
44
      template:
45
        src: ./lb.conf.j2
46
        dest: /etc/nginx/conf.d/lb.conf
47

48
'测试验证!'
49
[root@web01 ~]#cat /etc/nginx/conf.d/lb.conf
50
upstream wp.kpyun.com {
51
    server 172.16.1.7:80
52
    server 172.16.1.8:80}  # 最后的大括号在这!
53
server {
54
    listen 80;
55
    server_name wp.kpyun.com;
56
...

展开收起

If 判断#

Terminal window展开收起

1
'基本语法结构：'
2
{% if 条件成立 %}
3
    写这段内容
4
{% elif 其他条件 %}
5
    写那段内容
6
{% else %}
7
    如果上面都不对,就写这个
8
{% endif %}
9
===============================
10
🦄案例.将keepalived.conf.j2拷贝到两台web
11
routeid--->都以自身主机名称生成
12
# web01生成是角色master 票数150
13
# web02生成的角色backup 票数100
14
===============================
15
[root@m01 ansible]# vim keepalived.conf.j2
16
global_defs {
17
    router_id {{ ansible_hostname }}
18
}
19

20
vrrp_instance VI_1 {
21
{% if ansible_hostname is match "web01" %}
22
    # 实际这里面应该是lb01
23
    state MASTER
24
    priority 150
25
{% else %}
26
# 这里用elif再进行判断也是可以的!
27
    state BACKUP
28
    priority 100
29
{% endif %}
30

31
    interface eth0
32
    virtual_router_id 50
33
    advert_int 1
34
    authentication {
35
        auth_type PASS
36
        auth_pass 1111
37
    }
38
    virtual_ipaddress {
39
        10.0.0.3
40
    }
41
}
42
# .j2模版文件只有if判断
43
[root@m01 ansible]# vim k.yml
44
- hosts: webs
45
  tasks:
46
    - name: Configure keepalived file
47
      template:
48
        src: ./keepalived.conf.j2
49
        dest: /root/keepalived.conf
50
[root@m01 ansible]# ansible-playbook k.yml
51
changed: [web02]
52
changed: [web01]
53
# 两台web都改变了,我们细看配置文件
54

55
'测试验证'
56
[root@web01 ~]# cat keepalived.conf
57
global_defs {
58
    router_id web01
59
}
60
# 主,优先级150
61
vrrp_instance VI_1 {
62
    state MASTER
63
    priority 150
64
    .....
65
[root@web02 ~]# cat keepalived.conf
66
global_defs {
67
    router_id web02
68
}
69
# 是备份,优先级100
70
vrrp_instance VI_1 {
71
    state BACKUP
72
    priority 100
73
    ......

展开收起

📚任务标签#

Terminal window展开收起

1
# 默认情况：当你运行一个playbook（一堆任务的集合）,Ansible就像一个忠实的机器人,会老老实实地把所有的任务都执行一遍
2
Ansible的标签(tag)功能可以给单独任务或者一部分任务打上标签
3
然后利用这些标签:
4
-t 🏷️      # 只做带标签的事,其他都跳过
5
--skip-tags 🏷️  # 跳过特定标签任务,除了它都运行
6
--list-tags     # 查看有哪些标签
7
=========================================
8
[root@m01 ansible]# vim t.yml
9
- hosts: web01
10
  tasks:
11
    - name: Configure nginx file
12
      copy:
13
        src: ./nginx.conf
14
        dest: /etc/
15
      tags: conf
16
      # 别忘记加s
17
      # 标签名随便起
18

19
    - name: nginx -t
20
      command: "nginx -t"
21
      ignore_errors: yes
22
      tags: nt
23

24
    - name: Restart nginx
25
      systemd:
26
        name: nginx
27
        state: restarted
28
[root@m01 ansible]# ansible-playbook --syntax-check t.yml
29
playbook: t.yml
30
[root@m01 ansible]# ansible-playbook t.yml
31
'先正常执行一遍!'
32
TASK [Configure nginx file]
33
changed: [web01]
34
*****************
35
TASK [nginx -t]
36
changed: [web01]
37
*****************
38
TASK [Restart nginx]
39
changed: [web01]
40
# 三个都执行了一遍!
41
=========================================
42
1)查看有哪些标签🏷️
43
[root@m01 ansible]# ansible-playbook t.yml --list-tags
44
  play #1 (web01): web01  TAGS: []
45
      TASK TAGS: [conf, nt]
46
'两个标签 conf和nt '
47

48
2)运行特定标签
49
[root@m01 ansible]# ansible-playbook t.yml -t nt
50
# 后接标签名
51
TASK [nginx -t]
52
changed: [web01]
53
'只运行了这个nt标签'
54

55
3)跳过标签
56
# 后面也必须跟标签名!🏷️
57
[root@m01 ansible]# ansible-playbook t.yml --skip-tags conf
58
TASK [nginx -t]
59
changed: [web01]
60
*******************
61
TASK [Restart nginx]
62
changed: [web01]
63
"跳过了配置这一步,只运行了-t检测和重启"
64
# 我们试着后面可不可以跟多个标签!
65
❌️--skip-tags conf nt  # 不能用空格隔开
66
✅️--skip-tags conf,nt  # 可以用逗号隔开
67
[root@m01 ansible]# ansible-playbook t.yml --skip-tags conf,nt
68
TASK [Restart nginx]
69
changed: [web01]
70
'这样的话只执行了重启的任务'
71
🦄# 但其实有更简便的方法🦄
72
1)可以给多个不同的任务打上相同的标签
73
2)这样用 --skip-tags 一次性跳过所有这些打了相同标签的任务

展开收起

1
- hosts: web01
2
  tasks:
3
    - name: Configure nginx file
4
      copy:
5
        src: ./nginx.conf
6
        dest: /etc/nginx/
7
      tags: test
8

9
    - name: nginx -t
10
      command: "nginx -t"
11
      ignore_errors: yes
12
      tags: test
13

14
    - name: Restart nginx
15
      systemd:
16
        name: nginx
17
        state: restarted

展开收起

Terminal window

1
# 都打上了test标签🏷️
2
[root@m01 ansible]# ansible-playbook t.yml --list-tags
3
  play #1 (web01): web01  TAGS: []
4
      TASK TAGS: [test]
5
[root@m01 ansible]# ansible-playbook t.yml --skip-tags test
6
TASK [Restart nginx]
7
changed: [web01]
8
# 同样只运行了Restart操作

📚文件复用#

Terminal window展开收起

1
以前写多个playbook没有办法,一键执行
2
# 需要按照顺序一个个去做,这很麻烦
3
1)现在可以把你常用的一些任务(比如安装Nginx、配置php)写在不同的文件里
4
# 让每个部分更清晰、更易于维护和复用
5
2)最后写一个主任务清单(main playbook),把它们包含在里面
6
3)我们只需要执行主任务清单,它会运行被包含进来的任务
7
# 从而实现真正的“一键部署”
8
=========================================
9
需求: web01配置并重启Nginx, web02配置并重启php
10

11
1)准备两个tasks文件
12
[root@m01 ansible]# vim n.yml
13
'直接从- name开始写'
14
# 被包含在all.yml中
15
- name: Copy Nginx server
16
  copy:
17
    src: ./nginx.conf
18
    dest: /etc/nginx/
19

20
- name: nginx -t
21
  command: "nginx -t"
22
  ignore_errors: yes
23

24
- name: Restart nginx server
25
  systemd:
26
    name: nginx
27
    state: restarted
28

29
[root@m01 ansible]# vim p.yml
30
- name: Copy php configure
31
  copy:
32
    src: ./www.conf
33
    dest: /etc/php-fpm.d/
34

35
- name: Restart php
36
  systemd:
37
    name: php-fpm
38
    state: restarted
39

40
2)编写主任务清单
41
# 将上面两个文件包含引入
42
[root@m01 ansible]# vim all.yml
43
- hosts: webs
44
  tasks:
45
    - name: Nginx part
46
    # 名字随便起
47
      include_tasks: n.yml
48
      when: ansible_hostname is match "web01"
49
      # 只有匹配到web01时执行nginx..
50

51
    - name: php part
52
      include_tasks: p.yml
53
      when: ansible_hostname is match "web02"
54
      # 只有匹配到web02时执行php..
55

56
3)检测&&执行
57
[root@m01 ansible]# ansible-playbook --syntax-check n.yml
58
# 检测的时候,不能单独检测n.yml和p.yml,它们俩是子文件
59
'肯定有问题呀!'--->它们是以 - name开头❌️
60
✅️应该直接检测all.yml文件
61
[root@m01 ansible]# ansible-playbook --syntax-check all.yml
62
playbook: all.yml
63
[root@m01 ansible]# ansible-playbook all.yml
64
PLAY [webs]
65
********************
66
TASK [Nginx part] --->"主任务清单"
67
skipping: [web02]
68
included: /home/ansible/n.yml for web01
69
'跳过web02,只执行web01'
70
********************
71
TASK [Copy Nginx server]
72
ok: [web01]
73
********************
74
TASK [nginx -t]
75
changed: [web01]
76
********************
77
TASK [Restart nginx server]
78
changed: [web01]
79
'web01依次执行以上三步!'
80
********************
81
TASK [php part] --->"主任务清单"
82
skipping: [web01]
83
included: /home/ansible/p.yml for web02
84
'跳过web01'
85
********************
86
TASK [Copy php configure]
87
ok: [web02]
88
********************
89
TASK [Restart php]
90
changed: [web02]
91
'web02执行php部分'
92
********************
93
web01   : ok=4    changed=2
94
web02   : ok=3    changed=1
95
⚠️主任务清单只有两个任务⚠️

展开收起

抑制changed#

在 Ansible 中,一个任务执行后,根据它是否真的改变了目标主机的状态,会在输出中显示不同的颜色：

绿色 (OK): 表示任务执行了,但目标主机的状态没有发生改变。
黄色 (Changed): 表示任务执行了,并且确实对目标主机做了修改

command 模块执行任何命令,默认情况下都会被认为是 changed 状态（黄色）

即使 nginx -t 只是测试配置,它确实是在目标主机上执行了一个操作
- 所以 Ansible 会认为这是一个“变化”（Changed）

changed_when: false

来强制覆盖其默认的 changed 状态,使其显示为 ok（绿色）

从而让整个 playbook 的执行结果更具可读性和准确性

像 df -h、ls、ps aux、free -m、cat /etc/hostname

它们的主要目的都是查询、查看或诊断系统状态,而不是去修改任何东西

可以让这些执行了操作但未改变系统状态的任务,能正确地显示为绿色 (OK)

Terminal window

1
[root@m01 ansible]# vim c.yml
2
- hosts: web01
3
  tasks:
4
    - name: nginx -t
5
      command: "nginx -t"
6
      register: ng_re
7
      ignore_errors: yes
8
      tags: check
9
# 没有抑制前
10
[root@m01 ansible]# ansible-playbook c.yml
11
TASK [nginx -t]
12
changed: [web01]
13
'每运行一次都会执行一遍!'

1
- hosts: web01
2
  tasks:
3
    - name: nginx -t
4
      command: "nginx -t"
5
      register: ng_re
6
      ignore_errors: yes
7
      tags: check
8
      changed_when: false

Terminal window

1
[root@m01 ansible]# ansible-playbook c.yml
2
TASK [nginx -t]
3
ok: [web01]
4
'现在运行都是OK✅️'
5
# 由changed(黄色)-->ok(绿色)

Ansible-->vars变量

Thu, 28 May 2026 00:00:00 GMT

Ansible—>vars变量#

[TOC]

概述#

变量提供了便捷的方式来管理 Ansible playbook 项目中的 动态值
- ==方便维护==
- ==易读==
- ==修改简单==

定义变量#

1️⃣直接在play定义变量#

Terminal window展开收起

1
'在tasks: 之前定义'
2
[root@m01 ~]# mkdir /home/ansible
3
[root@m01 ~]# cd /home/ansible/
4

5
1)单一变量
6
[root@m01 ansible]# vim a.yml
7
- hosts: web01
8
  gather_facts: no
9
  vars:
10
    - file1: /tmp/a.txt
11
  # 下面还有个tasks,别忘了
12
  tasks:
13
    - name: Create file /tmp/a.txt
14
      file:
15
        path: "{{ file1 }}"
16
        owner: www
17
        group: www
18
        mode: 0644
19
        state: touch
20
[root@m01 ansible]# ssh web01 "ls -lh /tmp/a.txt"
21
-rw-r--r-- 1 www www 0 Apr  3 14:41 /tmp/a.txt
22
# 成功创建这个文件!
23

24
2)多个变量
25
# vars: 使用列表的方式
26
      file:
27
      '一次性创建多个路径文件'
28
        path:
29
          - "{{ file1 }}"
30
          - "{{ file2 }}"
31
        state: touch
32
❌️这种方式行不通!
33
'也就只有yum下载软件包的时候,name:可以这么分!'
34
✅️正确方式⬇️
35
[root@m01 ansible]# vim a.yml
36
- hosts: web01
37
  gather_facts: no
38
  vars:
39
    - file1: /tmp/a.txt
40
    - file2: /tmp/b.txt
41
  # 下面还有个tasks,别忘了
42
  tasks:
43
    - name: Create file /tmp/a.txt
44
      file:
45
        path: "{{ file1 }}"
46
        state: touch
47

48
    - name: Create file /tmp/b.txt
49
      file:
50
        path: "{{ file2 }}"
51
        state: touch
52
[root@m01 ansible]# ansible-playbook --syntax-check a.yml
53
playbook: a.yml
54
[root@m01 ansible]# ansible-playbook  a.yml
55
web01: ok=2    changed=2
56

57
3)是否加引号❓️
58
# 注意如果path参数中携带路径,则变量不需要加双引号
59
[root@m01 ansible]# cat a.yml
60
- hosts: web01
61
  gather_facts: no
62
  vars:
63
    - file1: c.txt
64
  tasks:
65
    - name: Create file /tmp/a.txt
66
      file:
67
        path: /tmp/{{ file1 }}
68
        # 不需要加双引号
69
        state: touch
70
[root@m01 ansible]# ansible-playbook --syntax-check a.yml
71
playbook: a.yml
72
[root@m01 ansible]# ssh web01 "ls /tmp/c.txt"
73
ls: cannot access '/tmp/c.txt': No such file or directory
74
[root@m01 ansible]# ansible-playbook  a.yml
75
[root@m01 ansible]# ssh web01 "ls /tmp/c.txt"
76
/tmp/c.txt
77

78
4)一次安装多个软件
79
[root@m01 ansible]# cat a.yml
80
- hosts: web01
81
  gather_facts: no
82
  vars:
83
    - pack1: wget
84
    - pack2: lrzsz
85
  tasks:
86
    - name: Install pack
87
      yum:
88
        name:
89
          - "{{pack1}}"
90
          - "{{pack2}}"
91
        state: present
92
[root@m01 ansible]# ansible-playbook --syntax-check a.yml
93
playbook: a.yml
94
[root@m01 ansible]# ansible-playbook a.yml
95
'其实上面这个方法还是挺冗余的!'
96
✅️一个变量赋多个值
97
# 这个简便!
98
[root@m01 ansible]# cat a.yml
99
- hosts: web01
100
  gather_facts: no
101
  vars:
102
    pack:
103
      # 一个变量里面放多个值
104
      - wget
105
      - lrzsz
106
  tasks:
107
    - name: Install pack
108
      yum:
109
        name: "{{pack}}"
110
        state: present
111
[root@m01 ansible]# ansible-playbook --syntax-check a.yml
112
playbook: a.yml
113
[root@m01 ansible]# ansible-playbook a.yml

展开收起

2️⃣在文件中定义变量#

Terminal window展开收起

1
1)先在文件中定义变量
2
[root@m01 ansible]# vim vars1.yml
3
pk1: wget
4
pk2: tree
5

6
2)在剧本中调用变量文件
7
[root@m01 ansible]# vim a.yml
8
- hosts: web01
9
  gather_facts: no
10
  vars_files:
11
    # 这里是变量文件
12
    - vars1.yml
13
  tasks:
14
    - name: Install pack
15
      yum:
16
        name:
17
          - "{{pk1}}"
18
          - "{{pk2}}"
19
        state: present
20
[root@m01 ansible]# ansible-playbook a.yml
21

22
3)调用多个变量文件
23
[root@m01 ansible]# vim vars2.yml
24
pk3: lrzsz
25
# 又一个变量文件
26
[root@m01 ansible]# vim a.yml
27
- hosts: web01
28
  gather_facts: no
29
  vars_files:
30
    - vars1.yml
31
    - vars2.yml
32
  tasks:
33
    - name: Install pack
34
      yum:
35
        name:
36
          - "{{pk1}}"
37
          - "{{pk2}}"
38
          - "{{pk3}}"
39
        state: present
40
[root@m01 ansible]# ansible-playbook a.yml

展开收起

3️⃣在主机清单定义变量#

Terminal window展开收起

1
1)主机清单中定义
2
[root@m01 ansible]# vim /etc/ansible/hosts
3
[webs]
4
web0[1:2]
5

6
[webs:vars]
7
# 给webs组定义两个变量
8
pk1=wget
9
pk2=tree
10

11
2)调用变量
12
[root@m01 ansible]# vim a.yml
13
- hosts: webs
14
# 这里是webs
15
  gather_facts: no
16
  tasks:
17
    - name: Install pack
18
      yum:
19
        name:
20
          - "{{pk1}}"
21
          - "{{pk2}}"
22
        state: present
23
[root@m01 ansible]# ansible-playbook a.yml
24
web01  : ok=1
25
web02  : ok=1

展开收起

4️⃣官方推荐定义变量#

Terminal window展开收起

1
1)在当前运行playbook的目录下'创建两个目录'
2
group_vars
3
# 在目录下面,创建组名称命名的文件
4
# ✅️然后在文件中直接定义变量
5
hosts_vars
6
# 创建主机命名的文件
7
======================================
8
[root@m01 ansible]# mkdir group_vars host_vars
9
[root@m01 ansible]# ls | egrep ".*_vars"
10
group_vars
11
host_vars
12

13
2)在group_vars下创建webs文件
14
# 以组名-->命名文件
15
[root@m01 ansible]# vim /etc/ansible/hosts
16
# 先把原来主机清单里面的变量删除了
17
[root@m01 ansible]# vim group_vars/webs
18
pk1: wget
19
pk2: tree
20
[root@m01 ansible]# cat a.yml
21
- hosts: webs
22
  gather_facts: no
23
  tasks:
24
    - name: Install pack
25
      yum:
26
        name:
27
          - "{{pk1}}"
28
          - "{{pk2}}"
29
        state: present
30
# 还是上面的配置文件!
31
[root@m01 ansible]# ansible-playbook a.yml
32
ok: [web01]
33
ok: [web02]
34

35
3)对单台主机定义变量
36
[root@m01 ansible]# vim host_vars/db02
37
# 这里是db02
38
pk1: wget
39
pk2: tree
40
[root@m01 ansible]# vim a.yml
41
- hosts: db02
42
# 只有db02可以引用变量
43
# 下面还是一样的
44
[root@m01 ansible]# ansible-playbook a.yml
45
db02   : ok=1
46

47
4)all
48
'all表示所有主机'--->主机清单里面的所有主机!
49
[root@m01 ansible]# cat /etc/ansible/hosts
50
db02
51

52
[webs]
53
web0[1:2]
54
'所有主机都开着!'
55
[root@m01 ansible]# vim host_vars/all
56
pk1: wget
57
pk2: tree
58
[root@m01 ansible]# vim a.yml
59
- hosts: all
60
[root@m01 ansible]# ansible-playbook a.yml
61
ok: [db02]
62
ok: [web02]
63
ok: [web01]

展开收起

📚debug&变量注册#

通俗版解释：

“这就好比你在 Linux 里敲完命令,屏幕上会‘哗啦啦’显示一堆结果,你一看就知道刚才那步做没做成

但在 Ansible 里,默认情况下它只给你看个大概（比如‘变了’或‘没变’）,具体的输出结果它都藏在肚子里不给你看

这时候,变量注册就派上用场了！
它的作用就是把 Ansible 藏在肚子里的那些运行结果（比如命令的输出、报错信息、成功与否的状态码）全都抓取出来,存到一个你指定的变量里
存好之后,你想什么时候看就什么时候看,或者拿这些结果去判断下一步该干嘛,特别灵活”
==变量注册就是把 Ansible 运行时的“心里话”（返回值）掏出来,变成你能随时调用的变量==

Terminal window展开收起

1
我们以nginx举例,检查nginx的配置是否正确
2
需要用到nginx -t命令!!
3
[root@m01 ansible]# vim b.yml
4
- hosts: web01
5
  gather_facts: no
6
  tasks:
7
    - name: nginx check
8
      command: 'nginx -t'
9
[root@m01 ansible]# ansible-playbook --syntax-check b.yml
10
[root@m01 ansible]# ansible-playbook b.yml
11
changed: [web01]
12
# 你只知道它改变了,不知道最后结果如何!!
13
[root@web01 ~]# head -1 /etc/nginx/nginx.conf
14
ser  www;
15
'将web01的配置文件故意改错!!'
16
[root@m01 ansible]# ansible-playbook b.yml
17
fatal: [web01]: FAILED!
18
# 再次执行报错!
19
nginx: configuration file /etc/nginx/nginx.conf test failed
20
'改回来'
21
[root@web01 ~]# head -1 /etc/nginx/nginx.conf
22
user  www;
23
[root@m01 ansible]# vim b.yml
24
- hosts: web01
25
  gather_facts: no
26
  tasks:
27
    - name: nginx check
28
      command: 'nginx -t'
29
      register: nginx_re
30
      # 将nginx -t的结果赋值给nginx_re
31
      # 这个变量注册也是一个模块,和command模块平级!
32

33
    - name: Print nginx_result
34
      debug:
35
        msg: "{{nginx_re}}"
36
      # 这里需要用到debug模块中的msg,打印消息
37
[root@m01 ansible]# ansible-playbook --syntax-check b.yml
38
[root@m01 ansible]# ansible-playbook b.yml
39
PLAY [web01] *************
40
TASK [nginx check] ******************
41
changed: [web01]
42
TASK [Print nginx_result] *************
43
ok: [web01] => {
44
    "msg": {
45
        "changed": true,
46
        "cmd": [
47
            "nginx",
48
            "-t"
49
        ],
50
        "delta": "0:00:00.004444",
51
        "end": "2026-04-04 15:04:48.508624",
52
        "failed": false,
53
        "msg": "",
54
        ✅️"rc": 0,
55
        "start": "2026-04-04 15:04:48.504180",
56
        "stderr": "nginx: the configuration file /etc/nginx/nginx.conf syntax is ok\nnginx: configuration file /etc/nginx/nginx.conf test is successful",
57
        ✅️"stderr_lines": [
58
            "nginx: the configuration file /etc/nginx/nginx.conf syntax is ok",
59
            "nginx: configuration file /etc/nginx/nginx.conf test is successful"
60
        ],
61
        "stdout": "",
62
        "stdout_lines": []
63
    }
64
}
65
PLAY RECAP ******************
66
web01  : ok=2
67
'是打印出来了,就是东西太多了!!!'
68
======================================
69
✅️按照层级关系输出内容✅️
70
msg: "{{nginx_re.rc}}"
71
# 打印.rc可以获得是否执行成功!
72
ok: [web01] => {
73
    "msg": "0"
74
}
75

76
msg: "{{nginx_re.stderr_lines}}"
77
# 这个就是命令行中的内容
78
ok: [web01] => {
79
    "msg": [
80
        "nginx: the configuration file /etc/nginx/nginx.conf syntax is ok",
81
        "nginx: configuration file /etc/nginx/nginx.conf test is successful"
82
    ]
83
}
84
======================================
85
✅️df -h同理
86
[root@m01 ansible]# vim b.yml
87
    - name:  result
88
      command: 'df -h'
89
      register: re
90
      # 把结果赋值给re
91

92
    - name: Print result
93
      debug:
94
        msg: "{{re}}"
95
        #✅️ 先整个打印re
96
ok: [web01] => {
97
    "msg": {
98
        "changed": true,
99
        "cmd": [
100
            "df",
101
            "-h"
102
        ],
103
        "delta": "0:00:00.002389",
104
        "end": "2026-04-04 15:17:27.500815",
105
        "failed": false,
106
        "msg": "",
107
        "rc": 0,
108
        "start": "2026-04-04 15:17:27.498426",
109
        "stderr": "",
110
        "stderr_lines": [],
111
        "stdout": "...",
112
        ✅️"stdout_lines": [
113
            "Filesystem      Size  Used Avail Use% Mounted on",
114
            "devtmpfs        459M     0  459M   0% /dev",
115
            "tmpfs           475M     0  475M   0% /dev/shm",
116
            "tmpfs           475M   13M  462M   3% /run",
117
            "tmpfs           475M     0  475M   0% /sys/fs/cgroup",
118
            "/dev/sda3        49G  4.0G   45G   9% /",
119
            "/dev/sda1       195M  122M   74M  63% /boot",
120
            "tmpfs            95M     0   95M   0% /run/user/0"
121
        ]
122
    }
123
}
124
# 按照层级关系,只获取想要打印的详细信息
125
✅️msg: "{{re.stdout_lines}}"
126
[root@m01 ansible]# ansible-playbook b.yml
127
ok: [web01] => {
128
    "msg": [
129
        "Filesystem      Size  Used Avail Use% Mounted on",
130
        "devtmpfs        459M     0  459M   0% /dev",
131
        "tmpfs           475M     0  475M   0% /dev/shm",
132
        "tmpfs           475M   13M  462M   3% /run",
133
        "tmpfs           475M     0  475M   0% /sys/fs/cgroup",
134
        "/dev/sda3        49G  4.0G   45G   9% /",
135
        "/dev/sda1       195M  122M   74M  63% /boot",
136
        "tmpfs            95M     0   95M   0% /run/user/0"
137
    ]
138
}

展开收起

层级定义变量#

特性	点号表示法 (`lnmp.nginx.pk1`)	方括号表示法 (`lnmp['nginx']['pk1']`)
给人的感觉	简洁、清爽。写起来快,看着也舒服,像访问对象的属性	严谨、啰嗦。写起来要敲很多引号和括号,但看着很稳
适用场景	适合规规矩矩的变量名（纯字母、数字、下划线）	适合千奇百怪的变量名
容错率	==低== 变量名稍微有点特殊字符就报错	==高== 几乎通吃所有情况

在 Ansible 里,当你面对像 lnmp.nginx.pk1 和 lnmp['nginx']['pk1'] 这种多层级的变量时,确实容易犯嘀咕

为什么说**“点号”**有限制？（颜值派的烦恼）

它只能识别： 字母、数字、下划线

一旦你的变量名里出现了以下“刺头”,点号法就会直接报错：

连字符/减号 (-)：比如 lnmp.nginx-pk1（Ansible 会以为你要做减法运算）
空格：比如 lnmp.my key（Ansible 会懵圈,不知道哪里是结尾）
以数字开头：比如 lnmp.1st_package

为什么**“方括号”**是万能药？（实力派的担当）

方括号表示法（['key']）就像给变量名穿了件防弹衣
只要用引号包起来放在方括号里,Ansible 都能精准找到它

虽然点号写法（.）看着很爽,但在写复杂的 Playbook 时,为了避免因为变量名里突然多了个横杠（-）而导致报错

官方其实更推荐使用方括号写法（['key']）

别忘记引入变量文件

vars_files: 文件名

Terminal window展开收起

1
1)层级定义变量
2
[root@m01 ansible]# vim vars1.yml
3
lnmp:
4
  nginx:
5
    pk1: wget
6
# 同样是两个空格,进行缩进!
7

8
2)引用文件、调用变量
9
[root@m01 ansible]# vim a.yml
10
- hosts: web01
11
  gather_facts: no
12
  vars_files: vars1.yml
13

14
  tasks:
15
    - name: Install pack
16
      yum:
17
        name:
18
          - "{{lnmp['nginx']['pk1']}}"
19
        state: present
20
[root@m01 ansible]# ansible-playbook   a.yml
21
ok: [web01]
22
'当然我们也可以使用点.'
23
    name:
24
      - "{{lnmp.nginx.pk1}}"
25
[root@m01 ansible]# ansible-playbook   a.yml
26
ok: [web01]
27

28
3)多个层级列表的方式
29
[root@m01 ansible]# vim vars1.yml
30
lnmp:
31
  nginx:
32
    pk1: wget
33
    pk2: tree
34
[root@m01 ansible]# vim a.yml
35
# 调用
36
    name:
37
      - "{{lnmp.nginx.pk1}}"
38
      - "{{lnmp['nginx']['pk2']}}"
39
# 一个用点.一个用方括号+引号
40
[root@m01 ansible]# ansible-playbook a.yml
41
ok: [web01]

展开收起

Facts缓存#

🤔 什么是 **Ansible Facts **？（通俗版）

你可以想象成 Ansible 在干活之前,先给被管理主机做的一次**“全身体检”**

默认情况 (gather_facts: yes)：
- Ansible 就像个负责任的医生,每次去主机上执行任务前,都要先花几秒钟问一遍：“你叫什么名字？IP是多少？内存多大？系统啥版本？”
- 这就导致了你感觉到的**“卡顿”**
- 主机越多,体检时间越长
Ad-hoc 对应模块：setup模块
- 可以去参考 📚Ansible 01
- 在命令行直接用 ansible ... -m setup,就是在手动触发这个“体检”
为什么要缓存？：
- 如果主机信息不常变,我们没必要每次都体检
- 把第一次体检的结果存起来（缓存）
- 下次直接用,速度就会飞快

🚀 怎么开启缓存来解决 “卡顿” 问题❓️

这就像把体检报告复印一份存档,下次直接看存档,不用再问主机了

Terminal window展开收起

1
'最简单的方案（使用 JSON 文件缓存）'
2
1)找到ansible.cfg
3
# 配置文件!
4
[root@m01 ansible]# updatedb
5
[root@m01 ansible]# locate ansible.cfg
6
/etc/ansible/ansible.cfg
7

8
2)编辑修改
9
[root@m01 ansible]# vim /etc/ansible/ansible.cfg
10
# 在 [defaults] 下面加上这几行配置
11
[defaults]
12
✅️gathering = smart
13
# 开启智能模式：如果有缓存就用缓存,没有才去收集
14
✅️fact_caching = jsonfile
15
# 指定缓存方式为 jsonfile（存成本地文件）
16
✅️fact_caching_connection = /tmp/ansible_fact_cache
17
# 指定缓存文件存到哪里
18
✅️fact_caching_timeout = 86400
19
# 缓存多久失效（秒）,这里设置 24 小时

展开收起

1
[defaults]
2
host_key_checking = False
3
deprecation_warnings = False
4
interpreter_python = /usr/bin/python3
5
gathering = smart
6
fact_caching = jsonfile
7
fact_caching_connection = /tmp/ansible_fact_cache
8
fact_caching_timeout = 86400
9

10
[inventory]
11
[privilege_escalation]
12
[paramiko_connection]
13
[ssh_connection]
14
[persistent_connection]
15
[accelerate]
16
[selinux]
17
[colors]
18
[diff]

展开收起

配置后的效果：

第一次运行：Ansible 会慢一点,因为它在收集信息并存到 /tmp 目录下
第二次运行（24小时内）：Ansible 会直接读取文件,速度瞬间完成,不再卡顿！

这样既保留了获取信息的能力,又解决了速度慢的问题

Terminal window展开收起

1
[root@m01 ansible]# ll /tmp/ansible_fact_cache
2
ls: cannot access '/tmp/ansible_fact_cache': No such file or directory
3
# 刚开始没有这个!
4
[root@m01 ansible]# vim a.yml
5
- hosts: web01
6
[root@m01 ansible]# ansible-playbook a.yml
7
PLAY [web01] *************
8
TASK [Gathering Facts] ***
9
ok: [web01]
10
# 第一次进行了信息收集!
11
[root@m01 ansible]# ll /tmp/ansible_fact_cache
12
total 28
13
-rw------- 1 root root 25381 Apr  4 16:57 web01
14
# 执行一遍之后,就收集下来了!
15
[root@m01 ansible]# cat /tmp/ansible_fact_cache/web01
16
# 里面装的是web01的一些信息!
17
{
18
    "_ansible_facts_gathered": true,
19
    "ansible_all_ipv4_addresses": [
20
        "10.0.0.7",
21
        "172.16.1.7"
22
        ................
23
[root@m01 ansible]# ansible-playbook a.yml
24
PLAY [web01] *************
25
'再次执行就直接省略信息收集这一步了!'
26
🈚Gathering Facts🈚# 压根没有这一步!
27
TASK [Install pack] *******
28
ok: [web01]

展开收起

📊 常用 Facts 变量速查表

Tip

Ansible开篇对应的 setup 模块就是这个

ansible all -m setup -a “filter=ansible_default_ipv4”

频率	变量名	含义 (通俗解释)
🔥 极高	`ansible_hostname`	✅️主机名
🔥 极高	`ansible_all_ipv4_addresses`	✅所有 IPv4 地址(简短)
🔥 极高	`ansible_default_ipv4.address`	✅️默认的IPv4地址(信息全)
🔥 极高	`ansible_distribution`	✅️操作系统名称
🔥 极高	`ansible_processor_vcpus`	CPU 总核心数
🔥 极高	`ansible_memtotal_mb`	系统总内存
⭐ 常用	`ansible_distribution_major_version`	系统主版本号
⭐ 常用	`ansible_machine`	硬件架构
⭐ 常用	`ansible_mounts`	磁盘挂载情况
⭐ 常用	`ansible_processor`	CPU 详细型号
⭐ 常用	`ansible_memory_mb`	✅详细内存信息(信息全)
📉 低频	`ansible_devices`	磁盘设备详情
📉 低频	`ansible_kernel`	内核版本
📉 低频	`ansible_eth0`	eth0 网卡信息
📉 低频	`ansible_lvm`	LVM 逻辑卷信息
📉 低频	`ansible_memfree_mb`	当前可用内存
📉 低频	`ansible_swaptotal_mb`	Swap 总大小
📉 低频	`ansible_swapfree_mb`	Swap 可用大小
📉 低频	`ansible_distribution_version`	系统具体版本号

Terminal window展开收起

1
'facts可以获取到客户端的信息-->赋值给相对的变量'
2

3
案例1.输出两台web的操作系统版本
4
[root@m01 ansible]# vim os.yml
5
- hosts: webs
6
  tasks:
7
    - name: print os info
8
      debug:
9
        msg: "{{ansible_distribution}}"
10
[root@m01 ansible]# ansible-playbook os.yml
11
ok: [web02] => {
12
    "msg": "Kylin Linux Advanced Server"
13
}
14
ok: [web01] => {
15
    "msg": "Kylin Linux Advanced Server"
16
}
17

18
案例2.输出两台web的IP地址
19
# 默认的IP地址
20
    msg: "{{ansible_default_ipv4.address}}"
21
[root@m01 ansible]# ansible-playbook os.yml
22
ok: [web01] => {
23
    "msg": "10.0.0.7"
24
}
25
ok: [web02] => {
26
    "msg": "10.0.0.8"
27
}
28

29
案例3.需求创建出以主机名命名+IP地址的目录
30
WEB01: web01_10.0.0.7
31
WEB02: web02_10.0.0.8
32

33
[root@m01 ansible]# vim os.yml
34
- hosts: webs
35
  tasks:
36
    - name: Create dir /home/hostname_IP
37
      file:
38
        path: /home/{{ansible_hostname}}_{{ansible_default_ipv4.address}}
39
        # 中间有个_下划线
40
        state: directory
41
[root@m01 ansible]# ansible-playbook os.yml
42
changed: [web02]
43
changed: [web01]
44
[root@m01 ansible]# ssh web01 "ls -lh /home/"
45
total 0
46
drwxr-xr-x 2 root root 6 Apr  4 17:47 web01_10.0.0.7

展开收起

📚template模块#

==copy 模块==：就像“复印机”

它的逻辑：看到什么,就复制什么
你的情况：当你用 copy 模块去拷贝 info.txt 时,它根本不懂 {{ ansible_hostname }} 是什么意思
结果：它会把文件原封不动地搬过去
- 主机 A 收到的文件里写着：hostname: {{ ansible_hostname }}
- 主机 B 收到的文件里也写着：hostname: {{ ansible_hostname }}
- 就像复印身份证,复印件上的字是不会变的

==template 模块==：就像“智能填空题”

它的逻辑：先读懂内容,填好空,再打印
你的情况：当你用 template 模块时,它会先打开 info.txt（这时候它叫模板文件）,发现里面有 {{ ansible_hostname }}
- 它会立刻去查当前这台主机的信息：“哦,这台机器叫 web-server-01”,然后把空填上,最后生成一个新文件发给主机
结果：每个主机收到的都是“私人订制”的
- 主机 A 收到的文件里写着：hostname: web-server-01
- 主机 B 收到的文件里写着：hostname: db-server-02
- 就像老师发卷子,虽然题目一样,但每个人填进去的答案是自己的

模块	形象比喻	对待变量 `{{ xxx }}` 的态度	最终效果
copy	复印机	看不见：把它当成普通文字,直接复制粘贴	所有主机文件内容==一模一样==
template	填空题	能看懂：把它当成指令,替换成真实的值	每个主机文件内容==各不相同==

一句话口诀：如果文件里没有花括号变量,用 copy（快）如果文件里有花括号变量,必须用 template（灵）

Terminal window展开收起

1
[root@m01 ansible]# vim info.txt
2
# 我们使用模版的时候,最好以j2结尾!
3
'详细的jinja2模版参考📚Ansible04'
4
# ✅️info.txt.j2----->说明它是jinja2模版
5
ip: {{ansible_default_ipv4.address}}
6
hostname: {{ansible_hostname}}
7
total_memory: {{ansible_memtotal_mb}}
8
'这里面不需要给双引号'
9
[root@m01 ansible]# vim c.yml
10
- hosts: webs
11
  tasks:
12
  - name: Test template
13
    template:
14
      src: ./info.txt
15
      dest: /home/
16
[root@m01 ansible]# ansible-playbook --syntax-check c.yml
17
playbook: c.yml
18
[root@m01 ansible]# ansible-playbook c.yml
19
[root@m01 ansible]# ssh web01 "cat /home/info.txt"
20
ip: 10.0.0.7
21
hostname: web01
22
total_memory: 948
23
[root@m01 ansible]# ssh web02 "cat /home/info.txt"
24
ip: 10.0.0.8
25
hostname: web02
26
total_memory: 948
27
'他们的 IP地址 和 主机名 各不相同!'

展开收起

backup重构#

Terminal window展开收起

1
[root@m01 ansible]# cd ~
2
[root@m01 ~]# ll
3
-rw-r--r-- 1 root root      410 Mar 30 15:17 rsyncd.conf
4
[root@m01 ~]# cp rsyncd.conf /home/ansible/
5
[root@m01 ~]# cd /home/ansible/
6
[root@m01 ansible]# ls rsyncd.conf
7
rsyncd.conf
8

9
1)配置文件更换成变量
10
# 配合template模块
11
[root@m01 ansible]# vim rsyncd.conf
12
uid = {{user}}
13
gid = {{user}}
14
port = {{port}}
15
log file =/var/log/rsyncd.log
16
....
17
############################
18
....
19
[data]
20
path = {{dir}}
21

22
'恢复快照,免密登录省略'
23
# 10.0.0.41
24
2)重新编辑剧本
25
# 这里选择在剧本中定义变量
26
[root@m01 ansible]# vim backup.yml
27
- hosts: backup
28
  gather_facts: no
29
  vars:
30
    - user: www
31
    - port: 873
32
    - dir: /data
33
  tasks:
34
    - name: Install rsync server
35
      yum:
36
        name: rsync
37
        state: present
38

39
    - name: Configure rsync file
40
      template:
41
        src: ./rsyncd.conf
42
        dest: /etc/
43

44
    - name: Create group "{{user}}"
45
      group:
46
        name: "{{user}}"
47
        gid: 888
48

49
    - name: Create user "{{user}}"
50
      user:
51
        name: "{{user}}"
52
        uid: 888
53
        group: "{{user}}"
54
        shell: /sbin/nologin
55
        create_home: false
56

57
    - name: Create dir "{{dir}}"
58
      file:
59
        path: "{{dir}}"
60
        state: directory
61
        owner: "{{user}}"
62
        group: "{{user}}"
63

64
    - name: Create dir /backup
65
      file:
66
        path: /backup
67
        state: directory
68
        owner: "{{user}}"
69
        group: "{{user}}"
70

71
    - name: Touch passwd file
72
      copy:
73
        content: "rsync_backup:123"
74
        dest: /etc/rsync.passwd
75
        mode: 0600
76

77
    - name: Touch log file
78
      file:
79
        path: /var/log/rsyncd.log
80
        state: touch
81
        owner: "{{user}}"
82
        group: "{{user}}"
83

84
    - name: Start rsyncd server
85
      systemd:
86
        name: rsyncd
87
        state: started
88
        enabled: yes
89
[root@m01 ansible]# ansible-playbook --syntax-check backup.yml
90
playbook: backup.yml
91
[root@m01 ansible]# ansible-playbook backup.yml
92
[WARNING]: Found variable using reserved name: port
93
# 这个变量port,系统也在用!
94
# 它是紫色的警告!但是也能跑,无伤大雅
95
backup  : ok=9    changed=8
96
'测试'
97
[root@m01 ansible]# rsync -avz /etc/hosts rsync_backup@172.16.1.41::data
98
Password:
99
hosts
100
sent 225 bytes  received 43 bytes  76.57 bytes/sec
101
total size is 363  speedup is 1.35
102
[root@m01 ansible]# ssh backup "ls /data/"
103
hosts

展开收起

nfs重构#

Terminal window展开收起

1
'同样也是恢复快照!-->免密登录!'
2
1)配置文件中变量的修改
3
[root@m01 ansible]# vim exports
4
{{dir}} 172.16.1.0/24(rw,sync,all_squash,anonuid={{ id }},anongid={{ id }})
5

6
2)编写剧本
7
[root@m01 ansible]# vim nfs.yml
8
- hosts: nfs01
9
  gather_facts: no
10
  vars:
11
    - dir: /data/wp
12
    - id: 888
13
  tasks:
14
    - name: Install nfs server
15
      yum:
16
        name: nfs-utils
17
        state: present
18

19
    - name: Configure nfs file
20
      template:
21
        src: ./exports
22
        dest: /etc/
23

24
    - name: Create group www
25
      group:
26
        name: www
27
        gid: "{{id}}"
28

29
    - name: Create user www
30
      user:
31
        name: www
32
        uid: "{{id}}"
33
        group: www
34
        shell: /sbin/nologin
35
        create_home: false
36

37
    - name: Create dir {{dir}}
38
      file:
39
        path: "{{dir}}"
40
        state: directory
41
        owner: www
42
        group: www
43

44
    - name: Start NFS Server
45
      systemd:
46
        name: nfs
47
        state: started
48
        enabled: yes
49
[root@m01 ansible]# ansible-playbook --syntax-check nfs.yml
50
playbook: nfs.yml
51
[root@m01 ansible]# ansible-playbook nfs.yml

展开收起

Ansible剧本(playbook)

Sun, 24 May 2026 00:00:00 GMT

Ansible剧本(playbook)#

[TOC]

初认知#

image-20260330095958869

Ad-Hoc: 就像“单次命令”
- 你想让服务器马上执行一个简单的操作
- 它是一次性的、临时的
Playbook: 就像“剧本”或“清单”
- 如果你想完成一系列复杂的任务
- 你可以把这些任务写成一个文件（剧本）,然后让 Ansible 按照这个文件一步步去执行
- 它是可重复使用的,适合复杂的工作

Playbook 是 Ansible 的自动化脚本,采用 YAML 格式编写

与临时命令（ ad-hoc ）相比,Playbook 更强大

组成#

image-20250827090844876

红色框（playbook）：整个剧本文件

绿色框（play）：剧本里的一个“章节”或“场景”

黄色框（task）：具体的一个动作、每个 task 都是实际干活的命令

一个 Playbook（剧本）是由多个“Play”组成的
每个“Play”里又包含多个“Task”（任务）

==运行结果颜色==

颜色	意思	举例
🟢 绿色	成功了,但系统没变。常出现在读取信息或检查状态时,比如 `ping` 主机、查看文件是否存在、==没有发生改变==	`ansible all -m ping`
🟡 黄色	成功了,系统改变了。这是最常见的,因为我们执行 Ansible 通常都是为了改变系统比如安装软件、创建文件第一次黄色输出,有变化第二次==绿色==输出,幂等性	创建一个新文件、安装一个包
🔴 红色	出错了,失败了,得看日志	命令找不到、权限不足
💜 紫色	提了个警告,但还能继续跑	配置可能有问题,但不影响当前任务执行

YAML 语法（别写错）：

缩进用空格（2个）,不能用 Tab
键值对：key: value （⚠️冒号后 ==必须有空格== ）
列表：- item1、- item2
注释：# 这是注释
文件名推荐用 .yml,比如 my_playbook.yml
- 几乎所有 Ansible 示例和文档都使用 .yml
- .yaml 更正式、更完整的扩展名

实战#

Terminal window展开收起

1
[root@m01 ~]# rm -rf ./*
2
[root@m01 ~]# ll
3
total 0
4
[root@m01 ~]# vim a.yml
5
# 定义一个 Play
6
- hosts: web01
7
# 目标主机
8
  gather_facts: no
9
  # 默认是开着的,默认收集信息！
10
  # 不收集目标主机的信息,让任务更快
11
  tasks:
12
  # 任务列表开始
13
  - name: ping_test
14
  # 任务名称
15
    ping:
16
    # 使用 'ping' 模块
17
[root@m01 ~]# ansible-playbook  --syntax-check a.yml
18
# ✅️检查
19
playbook: a.yml
20
'语法没有问题！'
21
[root@m01 ~]# ansible-playbook a.yml
22
# 执行！
23
PLAY [web01] ********************************************************************
24

25
TASK [ping_test] ********************************************************************
26
ok: [web01]
27

28
PLAY RECAP ********************************************************************
29
web01  : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

展开收起

常用模块#

Terminal window展开收起

1
（1）创建文件
2
[root@m01 ~]# vim a.yml
3
- hosts: web01
4
  gather_facts: no
5
  tasks:
6
    - name: Create file
7
      file:
8
        path: /home/te_file
9
        state: touch
10
        owner: www
11
        group: www
12
        mode: 0755
13
        # 这里mode是四位数！
14
[root@m01 ~]# ansible-playbook --syntax-check a.yml
15
# 检查！
16
playbook: a.yml
17
[root@m01 ~]# ansible-playbook a.yml
18
changed: [web01]...
19
[root@m01 ~]# ssh web01 "ls -lh /home/te_file"
20
-rwxr-xr-x 1 www www 0 Mar 30 12:40 /home/te_file
21
# 文件权限755,属主属组都是www
22

23

24
（2）往里面写点东西
25
[root@m01 ~]# vim b.yml
26
- hosts: web01
27
  gather_facts: no
28
  tasks:
29
    - name: write something
30
      blockinfile:
31
        path: /home/te_file
32
        state: present
33
        block: |
34
          abcd
35
          efg
36
          aohou
37
[root@m01 ~]# ansible-playbook --syntax-check b.yml
38

39
playbook: b.yml
40
[root@m01 ~]# ssh web01 "cat /home/te_file"
41
# 查看一下,什么东西都没有！
42
[root@m01 ~]# ansible-playbook b.yml
43
# 运行后再查看一下！
44
[root@m01 ~]# ssh web01 "cat /home/te_file"
45
'默认在文件末尾创建！'
46
# BEGIN ANSIBLE MANAGED BLOCK
47
abcd
48
efg
49
aohou
50
# END ANSIBLE MANAGED BLOCK
51
=======================================
52
# 替换内容
53
'前提：文件中有标记！否则又会再一次的添加内容！'
54
# marker: "" 如果留空则会重复添加！
55
      blockinfile:
56
        path: /home/te_file
57
        block: |
58
          new
59
# 替换成new！！
60
[root@m01 ~]# ansible-playbook b.yml
61
[root@m01 ~]# ssh web01 "cat /home/te_file"
62
# BEGIN ANSIBLE MANAGED BLOCK
63
new
64
# END ANSIBLE MANAGED BLOCK
65
=======================================
66
自定义 marker 字符串
67
✅️需要用双引号包裹起来！
68
marker: "# {mark} ANSIBLE MANAGED BLOCK"
69
# 默认
70
marker: "# {mark} Ansible"
71
---------------------
72
'也可以留空,但是不建议'
73
🛑⚠️如果你设置 marker: ""❌️
74
Ansible 将不会在文件中写入任何标记行
75
后果：
76
1.Ansible 无法识别它之前写入的内容块
77
2.每次运行 Playbook 时,Ansible 都会认为文件里没有这个块,于是在文件末尾重复追加内容
78
3.你的配置文件会瞬间爆炸,充满重复的配置
79
什么时候可以留空？❓️
80
你只打算运行一次！但通常强烈不建议这样做！！❌️
81
---------------------
82
# 可以根据更改注释的样式！
83
比如xml的配置文件：
84
  marker: "<!-- {mark} Ansible -->"
85
=======================================
86
[root@m01 ~]# ssh web01 "cat /home/te_file"
87
# BEGIN ANSIBLE MANAGED BLOCK
88
new
89
# END ANSIBLE MANAGED BLOCK
90
'替换block && 更换marker标记'
91
[root@m01 ~]# vim b.yml
92
      blockinfile:
93
        state: present
94
        path: /home/te_file
95
        block: |
96
          New_block
97
          Hello
98
          world
99
        marker: "# {mark} Ansible"
100
[root@m01 ~]# ansible-playbook b.yml
101
[root@m01 ~]# ssh web01 "cat /home/te_file"
102
# BEGIN ANSIBLE MANAGED BLOCK
103
new
104
# END ANSIBLE MANAGED BLOCK
105
# BEGIN Ansible
106
New_block
107
Hello
108
world
109
# END Ansible
110
'因为这里标记发生了改变！所以不认识之前的标记了'
111
# 结果又添加了一遍！！
112
'我们再替换修改一下！'
113
      blockinfile:
114
        state: present
115
        path: /home/te_file
116
        block: |
117
          Successful
118
        marker: "# {mark} Ansible"
119
# 依旧是这个marker标记！
120
[root@m01 ~]# ansible-playbook b.yml
121
# BEGIN ANSIBLE MANAGED BLOCK
122
new
123
# END ANSIBLE MANAGED BLOCK
124
# BEGIN Ansible
125
Successful
126
# END Ansible
127
'成功替换！！'
128

129

130
（3）替换某一行
131
# 比如把Successful替换为Failed
132
[root@m01 ~]# vim c.yml
133
- hosts: web01
134
  gather_facts: no
135
  tasks:
136
    - name: sed ti huan
137
      lineinfile:
138
        path: /home/te_file
139
        regexp: ^Succ
140
        line: Failed
141
[root@m01 ~]# !ssh
142
ssh web01 "cat /home/te_file"
143
# BEGIN ANSIBLE MANAGED BLOCK
144
new
145
# END ANSIBLE MANAGED BLOCK
146
# BEGIN Ansible
147
Failed
148
# END Ansible
149
'成功替换'
150

151

152
（4）复制文件到web01
153
"如果有比较复杂的配置"
154
# 可以考虑现在我们本地进行编辑,然后再copy过去！
155
[root@m01 ~]# echo "Hello World" > hello.txt
156
[root@m01 ~]# vim d.yml
157
- hosts: web01
158
  gather_facts: no
159
  tasks:
160
    - name: copy
161
      copy:
162
        src: ~/hello.txt
163
        dest: /home/
164
[root@m01 ~]# ansible-playbook --syntax-check d.yml
165
playbook: d.yml
166
[root@m01 ~]# ssh web01 "ls -lh /home/hello.txt"
167
ls: cannot access '/home/hello.txt': No such file or directory
168
[root@m01 ~]# ansible-playbook d.yml
169
changed: [web01]
170
[root@m01 ~]# ssh web01 "ls -lh /home/hello.txt"
171
-rw-r--r-- 1 root root 12 Mar 30 14:45 /home/hello.txt
172
[root@m01 ~]# ssh web01 "cat /home/hello.txt"
173
Hello World
174
# 有了！
175

176

177
（5）创建虚拟用户
178
# 先创建组,再创建用户！
179
[root@m01 ~]# vim e.xml
180
- hosts: web01
181
  gather_facts: no
182
  tasks:
183
    - name: Create group
184
      group:
185
        name: jiu
186
        gid: 789
187

188
    - name: Create user
189
      user:
190
        group: 789
191
        uid: 789
192
        name: jiu
193
        shell: /sbin/nologin
194
        create_home: false
195
[root@m01 ~]# ansible-playbook --syntax-check e.xml
196
playbook: e.xml
197
[root@m01 ~]# ssh web01 "id jiu"
198
id: ‘jiu’: no such user
199
[root@m01 ~]# ansible-playbook e.xml
200
[root@m01 ~]# ssh web01 "id jiu"
201
uid=789(jiu) gid=789(jiu) groups=789(jiu)
202
# 成功创建！

展开收起

重构#

❤️帮助信息#

==ansible-doc== 是写 ad-hoc 命令或 playbook 时的内置参考手册

Terminal window展开收起

1
[root@m01 ~]# ansible-doc yum
2
"进入之后 --> /进入搜索模式!"
3
# 搜索EXAM回车!
4
😍 其实就是example 示例
5
'就可以出现下面的案例了!'
6
EXAMPLES:
7

8
- name: Install the latest version of Apache
9
  ansible.builtin.yum:
10
    name: httpd
11
    state: latest
12

13
- name: Install Apache >= 2.4
14
  ansible.builtin.yum:
15
    name: httpd>=2.4
16
    state: present
17
====================================
18
ansible-doc -s yum  # 查看yum模块的选项
19
"它是去介绍一个个选项的使用"
20
name:    # A package name or package specifier with version, like `name-1.0'.'
21
state:   # Whether to install (`present' or `installed', `latest'), or remove '

展开收起

📌 一句话：不知道模块怎么用 → ansible-doc -s <模块名>,要看完整文档 → 去掉 -s

backup#

Terminal window展开收起

1
修改目录属主属组
2
创建日志文件,属主www
3
4.启动rsync 加入开机自启
4

5
'先拷贝|编辑配置文件📃'
6
[root@m01 ~]# scp 172.16.1.41:/etc/rsyncd.conf .
7
rsyncd.conf   100%  410   595.7KB/s
8
# 拷贝到当前路径下
9
[root@m01 ~]# cat rsyncd.conf
10
uid = www
11
gid = www
12
port = 873
13
fake super = yes
14
use chroot = no
15
max connections = 200
16
timeout = 600
17
ignore errors
18
read only = false
19
list = false
20
auth users = rsync_backup
21
secrets file = /etc/rsync.passwd
22
pid file = /var/run/rsyncd.pid
23
lock file = /var/run/rsync.lock
24
log file =/var/log/rsyncd.log
25
############################
26
[backup]
27
comment = Welcome to oldboyedu backup!
28
path = /backup
29
[data]
30
path = /data
31

32

33
（1）初始化backup服务器！
34
'恢复快照！'
35

36
（2）配置主机清单
37
[root@m01 ~]# vim /etc/ansible/hosts
38
lb0[1:2]
39
db01
40
backup
41
nfs0a
42
[webs]
43
web0[1:2]
44
# 前提/etc/hosts有对应的IP映射
45

46
（3）配置免密钥
47
[root@m01 ~]# ssh-copy-id -i ~/.ssh/my_key.pub 172.16.1.41
48
[root@m01 ~]# ssh backup "hostname -I"
49
'测试查看！'
50
Authorized users only. All activities may be monitored and reported.
51
10.0.0.41 172.16.1.41
52
# 优化！
53
[root@m01 ~]# ssh backup "> /etc/issue && > /etc/issue.net"
54
[root@m01 ~]# ssh backup "hostname -I"
55
10.0.0.41 172.16.1.41
56

57
（4）编写剧本
58
[root@m01 ~]# ll
59
total 4
60
-rw-r--r-- 1 root root 410 Mar 30 15:17 rsyncd.conf
61
[root@m01 ~]# vim backup.yml
62
- hosts: backup
63
  gather_facts: no
64
  tasks:
65
    - name: Install rsync server
66
    # 安装rsync
67
      yum:
68
        name: rsync
69
        state: present
70

71
    - name: Configure rsync file
72
    # 拷贝配置文件
73
      copy:
74
        src: ./rsyncd.conf
75
        dest: /etc/
76

77
    - name: Create group www
78
    # 创建www组
79
      group:
80
        gid: 888
81
        name: www
82

83
    - name: Create user www
84
    # 创建虚拟用户
85
      user:
86
        group: 888
87
        uid: 888
88
        name: www
89
        shell: /sbin/nologin
90
        create_home: false
91

92
    - name: Create passwd file
93
    # 创建认证文件--》权限0600
94
      copy:
95
        content: rsync_backup:123
96
        dest: /etc/rsync.passwd
97
        mode: 0600
98

99
    - name: Create dir /data
100
    # 创建/data共享目录--》属主www
101
      file:
102
        path: /data
103
        state: directory
104
        owner: www
105
        group: www
106
        mode: 0755
107

108
    - name: Create dir /backup
109
    # 创建/backup共享目录--》属主www
110
      file:
111
        path: /backup
112
        state: directory
113
        owner: www
114
        group: www
115
        mode: 0755
116

117
    - name: Create log file
118
    # 创建日志文件--》属主www
119
      file:
120
        path: /var/log/rsyncd.log
121
        state: touch
122
        owner: www
123
        group: www
124
        mode: 0644
125

126
    - name: Start rsyncd server
127
    # 启动服务并开启自启
128
      systemd:
129
        name: rsyncd
130
        state: started
131
        enabled: yes
132
[root@m01 ~]# ansible-playbook --syntax-check backup.yml
133

134
playbook: backup.yml
135
[root@m01 ~]# ansible-playbook backup.yml
136
...
137
PLAY RECAP **********
138
backup : ok=9    changed=8    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
139
[root@m01 ~]# ssh backup "netstat -lntuo | grep 873"
140
tcp  0 0.0.0.0:873   0.0.0.0:*  LISTEN
141
tcp6 0 :::873        :::*       LISTEN
142
# 成功运行起来了
143
# 接着就是本地测试,服务端测试
144
[root@m01 ~]# rsync -avz /etc/passwd rsync_backup@172.16.1.41::backup
145
Password:
146
sending incremental file list
147
passwd
148
ss
149
sent 841 bytes  received 43 bytes  353.60 bytes/sec
150
total size is 1,845  speedup is 2.09
151
[root@m01 ~]# ssh backup "ls /backup/"
152
passwd
153
# 成功传送过去！

展开收起

nfs服务#

Terminal window展开收起

1
（1）拷贝配置文件
2
[root@nfs ~]# cat /etc/exports
3
# 先去nfs看一下配置文件
4
/data/wp 172.16.1.0/24(rw,sync,all_squash,anonuid=888,anongid=888)
5
[root@m01 ~]# scp 172.16.1.31:/etc/exports .
6
Authorized users only.
7
exports     100%  204   317.4KB/s
8
[root@m01 ~]# ls exports
9
exports
10
# 成功拷贝过来
11

12
（2）初始化31
13
'恢复快照'
14

15
（3）主机清单
16
[root@m01 ~]# grep nfs /etc/ansible/hosts
17
nfs01
18
[root@m01 ~]# grep nfs /etc/hosts
19
172.16.1.31 nfs01
20

21
（4）免密钥优化
22
# 得先做了免密钥
23
[root@m01 ~]# ssh nfs01 "> /etc/issue && > /etc/issue.net"
24
Authorized users only.
25
[root@m01 ~]# ssh nfs01 "hostname -I"
26
10.0.0.31 172.16.1.31
27

28
（5）编写playbook剧本
29
[root@m01 ~]# vim nfs.yml
30
- hosts: nfs01
31
  gather_facts: no
32
  tasks:
33
    - name: Install NFS server
34
    # 下载安装nfs-utils
35
      yum:
36
        name: nfs-utils
37
        state: present
38

39
    - name: Configure NFS server
40
    # 拷贝配置文件
41
      copy:
42
        src: ./exports
43
        dest: /etc/exports
44

45
    - name: Create Group www
46
    # 创建www组
47
      group:
48
        name: www
49
        gid: 888
50

51
    - name: Create User www
52
    # 创建www虚拟用户
53
      user:
54
        group: 888
55
        uid: 888
56
        name: www
57
        shell: /sbin/nologin
58
        create_home: false
59

60
    - name: Create dir /data/wp
61
    # 创建挂载目录&&改目录属主
62
      file:
63
        path: /data/wp
64
        state: directory
65
        owner: www
66
        group: www
67

68
    - name: Start nfs Server
69
    # 启动&&开机自启
70
      systemd:
71
        name: nfs
72
        # Rocky10是nfs-server
73
        state: started
74
        enabled: yes
75

76
- hosts: webs
77
# 这里是webs,一个组！
78
  gather_facts: no
79
  tasks:
80
  # web 下载nfs-utils
81
  # 为了能够挂载nfs文件系统
82
    - name: Webs Install NFS Server
83
      yum:
84
        name: nfs-utils
85
        state: present
86

87
（5）测试&&启动
88
[root@m01 ~]# ansible-playbook --syntax-check nfs.yml
89
playbook: nfs.yml
90
[root@m01 ~]# ansible-playbook nfs.yml
91
PLAY RECAP *************
92
nfs01
93
web01
94
web02

展开收起

📚mount 模块#

Terminal window展开收起

1
mount模块用于在远程主机上管理文件系统的挂载和卸载操作
2
# 可以设置为开机自动挂载
3
src: 指定挂载源（设备）
4
path: 指定挂载点路径（挂载目录,若不存在会自动创建）
5
fstype: 指定文件系统类型（必须指定）
6
state: 挂载状态
7
'State参数详解'
8
1. mounted
9
功能: 进行挂载,并修改/etc/fstab信息
10
行为:
11
  如果未挂载,则挂载设备
12
  在/etc/fstab中添加条目,实现永久挂载
13
  挂载点不存在时自动创建
14
2. absent
15
功能: 永久性卸载,并修改/etc/fstab信息
16
行为:
17
  卸载当前挂载的设备
18
  从/etc/fstab中删除对应的条目
19
  实现真正的永久卸载
20
====================================
21
我们用web01进行挂载测试！
22
nfs01的/data/wp挂载到--》web01的/mnt目录上！
23
[root@web01 ~]# df -h | grep mnt
24
#现在/mnt目录没有挂载任何的设备！
25
[root@web01 ~]# showmount -e 172.16.1.31
26
Export list for 172.16.1.31:
27
/data/wp 172.16.1.0/24
28
# 成功嗅探到！
29

30
[root@m01 ~]# vim mount.yml
31
'切回m01'
32
- hosts: web01
33
  gather_facts: no
34
  tasks:
35
    - name: Mount NFS /data/wp
36
      mount:
37
        src: 172.16.1.31:/data/wp
38
        # src：设备
39
        path: /mnt
40
        # path：要挂载的目录
41
        fstype: nfs
42
        state: mounted
43
[root@m01 ~]# ansible-playbook --syntax-check mount.yml
44
playbook: mount.yml
45
[root@m01 ~]# ansible-playbook mount.yml
46

47
[root@web01 ~]# df -h | grep /mnt
48
'切回web01'
49
172.16.1.31:/data/wp   49G  3.8G   45G   8% /mnt
50
# 成功挂载上去了！
51
[root@web01 ~]# grep '/mnt'  /etc/fstab
52
172.16.1.31:/data/wp /mnt nfs defaults 0 0
53
# 同时也被永久写入到了/etc/fstab
54
'永久挂载！'
55

56
[root@m01 ~]# vim mount.yml
57
[root@m01 ~]# grep absent mount.yml
58
        state: absent
59
'尝试卸载 ！'
60
[root@m01 ~]# ansible-playbook --syntax-check mount.yml
61
playbook: mount.yml
62
[root@m01 ~]# ansible-playbook  mount.yml
63

64
# 回到web01进行验证测试！卸载干净了！
65
[root@web01 ~]# df -h | grep /mnt
66
[root@web01 ~]# grep '/mnt'  /etc/fstab

展开收起

重构Nginx#

Terminal window展开收起

1
'我们这里以web01为例！'
2
（1）拷贝配置文件
3
[root@m01 ~]# scp 10.0.0.7:/etc/nginx/nginx.conf .
4
nginx.conf    100%  726   536.2KB/s
5
[root@m01 ~]# ls nginx.conf
6
nginx.conf
7

8
（2）初始化web01
9
# DNS服务器
10

11
（3）免密钥
12
[root@m01 ~]# ssh-copy-id -i ~/.ssh/my_key.pub 172.16.1.7
13
[root@m01 ~]# ssh web01 "> /etc/issue && > /etc/issue.net"
14
[root@m01 ~]# ssh web01 "hostname -I"
15
10.0.0.7 172.16.1.7

展开收起

📚yum_repository 模块#

Ansible `yum_repository` 模块参数	生成的 `.repo` 文件内容	实际含义与作用
`name: nginx`	`[nginx-stable]`	仓库 ID 这是仓库的唯一标识符
`description: nginx YUM repo`	`name=nginx stable repo`	仓库描述这是给人看的描述
`baseurl: ...`	`baseurl=...`	软件包地址两者完全一致
`gpgcheck: no`	`gpgcheck=0`	`no`/`yes` 转换为 `0`/`1`
`enabled: yes`	`enabled=1`	启用开关

Terminal window展开收起

1
它的作用就是帮你自动编辑 /etc/yum.repos.d/ 目录下的 .repo 文件
2
Ansible 默认会把 `name` 的值直接放在 `[]` 里
3
========================================
4
# 我们来看一下web02的Nginx仓库
5
[root@web02 ~]# cd /etc/yum.repos.d/
6
[root@web02 yum.repos.d]# cat nginx.repo
7
[nginx-stable]
8
name = nginx stable repo
9
baseurl = https://nginx.org/packages/centos/7/$basearch/
10
gpgcheck = 0
11
enabled = 1
12
'我们也试着编辑yml文件'
13
[root@m01 ~]# vim yum.yml
14
- hosts: web01
15
  gather_facts: no
16
  tasks:
17
    - name: Configure Nginx Repo
18
    # 配置Nginx的yum仓库
19
      yum_repository:
20
        name: nginx-stable
21
        # name对应着repo文件的[]
22
        description: nginx stable repo
23
        # description对应着repo文件的name
24
        baseurl: https://nginx.org/packages/centos/7/$basearch/
25
        gpgcheck: no
26
        enabled: yes
27
[root@m01 ~]# ansible-playbook --syntax-check yum.yml
28
playbook: yum.yml
29
[root@m01 ~]# ssh web01 "ls /etc/yum.repos.d/ | grep nginx"
30
[root@m01 ~]# ansible-playbook yum.yml
31
[root@m01 ~]# ssh web01 "ls /etc/yum.repos.d/ | grep nginx"
32
nginx-stable.repo
33
[root@m01 ~]# ssh web01 "cat /etc/yum.repos.d/nginx-stable.repo"
34
[nginx-stable]
35
async = 1
36
baseurl = https://nginx.org/packages/centos/7/$basearch/
37
enabled = 1
38
gpgcheck = 0
39
name = nginx stable repo
40
# 这些也都对应上了！！
41
========================================
42
现象：async = 1 是 Ansible yum_repository 模块自动生成的管理标记
43
影响：无,YUM 会忽略该行,不影响功能
44
========================================
45
# 其实我们也可以用copy模块,提前写好再拷贝过去！
46
'我们这里使用blockinfile模块'
47
# fatal: [web01]: FAILED! => {"changed": false, "msg": "Path /etc/yum.repos.d/nginx.repo does not exist !", "rc": 257}
48
'使用block块写入文件的时候,得有这个🧨文件！'
49
[root@m01 ~]# vim block.yml
50
- hosts: web01
51
  gather_facts: no
52
  tasks:
53
    - name: Rm The old repo
54
      file:
55
        path: /etc/yum.repos.d/nginx-stable.repo
56
        state: absent
57
        # 先把之前的删除了
58

59
    - name: Touch repo file
60
      file:
61
        path: /etc/yum.repos.d/nginx.repo
62
        state: touch
63
        # 再新建一个！
64

65
    - name: Write block to repo
66
      blockinfile:
67
        path: /etc/yum.repos.d/nginx.repo
68
        block: |
69
          [nginx-stable]
70
          name = nginx stable repo
71
          baseurl = https://nginx.org/packages/centos/7/$basearch/
72
          gpgcheck = 0
73
          enabled = 1
74
        state: present
75
        marker: "# {mark} Ansible"
76
[root@m01 ~]# ansible-playbook --syntax-check block.yml
77
playbook: block.yml
78
[root@m01 ~]# ansible-playbook  block.yml
79
[root@m01 ~]# ssh web01 "cat /etc/yum.repos.d/nginx.repo"
80
# BEGIN Ansible/
81
[nginx-stable]
82
name = nginx stable repo
83
baseurl = https://nginx.org/packages/centos/7/$basearch/
84
gpgcheck = 0
85
enabled = 1
86
# END Ansible
87
'现在也是一模一样了！'

展开收起

1
- hosts: web01
2
  gather_facts: no
3
  tasks:
4
    - name: Configure nginx repo
5
      yum_repository:
6
        name: nginx-stable
7
        description: nginx stable repo
8
        baseurl: https://nginx.org/packages/centos/7/$basearch/
9
        gpgcheck: no
10
        enabled: yes
11

12
    - name: Install nginx server
13
      yum:
14
        name: nginx
15
        state: present
16

17
    - name: Configure copy nginx file
18
      copy:
19
        src: ./nginx.conf
20
        dest: /etc/nginx/
21

22
    - name: Create group www
23
      group:
24
        name: www
25
        gid: 888
26

27
    - name: Create user www
28
      user:
29
        name: www
30
        uid: 888
31
        group: www
32
        shell: /sbin/nologin
33
        create_home: false
34

35
    - name: Start nginx server
36
      systemd:
37
        name: nginx
38
        state: started
39
        enabled: yes

展开收起

Terminal window

1
[root@m01 ~]# rm -rf block.yml
2
[root@m01 ~]# vim nginx.yml
3
'把上面配置文件的放过来'
4
[root@m01 ~]# ansible-playbook --syntax-check nginx.yml
5
playbook: nginx.yml
6
[root@m01 ~]# ansible-playbook nginx.yml
7
============================================
8
'测试验证!'
9
[root@web01 ~]# ps aux | grep nginx
10
root        5400  ...Ss   10:20   0:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
11
www         5401  S    10:20   0:00 nginx: worker process
12
[root@web01 ~]# ss -lntup| grep nginx
13
tcp     LISTEN  0.0.0.0:80  (("nginx",pid=5401,fd=9

重构PHP#

Terminal window展开收起

1
1)去web02拿PHP的配置文件
2
[root@m01 ~]# scp 10.0.0.8:/etc/php-fpm.d/www.conf .
3
Authorized users only.
4
www.conf  100%   19KB
5
[root@m01 ~]# ls www.conf
6
www.conf
7

8
2)编写配置文件
9
[root@m01 ~]# vim php.yml
10
- hosts: web01
11
  gather_facts: no
12
  tasks:
13
    - name: Install php server
14
      yum:
15
        name:
16
          - php
17
          - php-bcmath
18
          - php-cli
19
          - php-common
20
          - php-devel
21
          - php-embedded
22
          - php-fpm
23
          - php-gd
24
          - php-intl
25
          - php-mbstring
26
          - php-mysqlnd
27
          - php-opcache
28
          - php-pdo
29
          - php-process
30
          - php-xml
31
          - php-json
32
        state: present
33

34
    - name: Configure copy php
35
      copy:
36
        src: ./www.conf
37
        dest: /etc/php-fpm.d/
38

39
    - name: Start php server
40
      systemd:
41
        name: php-fpm
42
        state: started
43
        enabled: yes
44
[root@m01 ~]# ansible-playbook  --syntax-check php.yml
45
playbook: php.yml
46
[root@m01 ~]# ansible-playbook  php.yml
47
============================================
48
'测试验证!'
49
[root@web01 ~]# ss -lntup | grep php
50
tcp     LISTEN   0        128            127.0.0.1:9000          0.0.0.0:*       users:(("php-fpm",pid=6880,fd=13),("php-fpm",pid=6879,fd=13),("php-fpm",pid=6878,fd=13),("php-fpm",pid=6877,fd=13),("php-fpm",pid=6876,fd=13),("php-fpm",pid=6875,fd=11))
51
# 监听的是9000端口!

展开收起

静态页#

Terminal window展开收起

1
# 因为我们web有一些重要的配置!
2
'所以我们先自行拷贝过来'
3
# 不然恢复快照,很多东西都要重新搞!
4
[root@web02 conf.d]# ll
5
'/etc/nginx/conf.d'
6
total 20
7
-rw-r--r-- 1 root root 261 Mar 10 18:35 download.conf
8
-rw-r--r-- 1 root root 650 Mar 10 18:35 php.conf
9
-rw-r--r-- 1 root root 136 Aug 29  2025 php-fpm.conf
10
-rw-r--r-- 1 root root 124 Mar 20 16:46 test.conf
11
-rw-r--r-- 1 root root 382 Mar 21 16:39 wp.conf
12
[root@web02 conf.d]# cd /code/
13
[root@web02 code]# ll
14
total 4
15
drwxr-xr-x 5 www  www  4096 Mar 13 11:07 wordpress
16
drwxr-xr-x 3 root root   18 Mar 24 15:49 zrlog
17
============================================
18
[root@m01 ~]# scp -r 172.16.1.8:/etc/nginx/conf.d .
19
# 把整个目录拷贝过来!
20
Authorized users only.
21
download.conf  100%  261   403.8KB/s
22
php.conf   100%  650     1.5MB/s
23
php-fpm.conf  100%  136   304.6KB/s
24
test.conf    100%  124   247.8KB/s
25
wp.conf      100%  382   848.4KB/s
26
[root@m01 ~]# ll -d conf.d/
27
drwxr-xr-x 2 root root 95 Apr  2 11:38 conf.d/
28
[root@m01 ~]# scp -r 172.16.1.8:/code .
29
# /code整个目录拷贝过来!
30
[root@m01 ~]# ll -d code
31
drwxr-xr-x 4 root root 36 Apr  2 11:43 code
32
# 代码目录!
33
============================================
34
# web02也要恢复快照!
35
✅️也同样执行上面安装Nginx和php的步骤!
36
WEB01--------显示页面 web01....
37
WEB02------->显示页面 web02....
38
"没有学变量-需要一个个的书写✍️"
39
[root@m01 ~]# vim ./conf.d/test.conf
40
server {
41
    listen 80 default_server;
42
    # 手动默认指定
43
    server_name _;
44
    # _配合default_server使用!
45
    root /code/test;
46

47
    location / {
48
        index index.html;
49
    }
50
}
51
[root@m01 ~]# vim index.yml
52
- hosts: web01
53
  gather_facts: no
54
  tasks:
55
    - name: Configure test file
56
      copy:
57
        src: ./conf.d/test.conf
58
        dest: /etc/nginx/conf.d/
59

60
    - name: Create test dir /code/test
61
      file:
62
        path: /code/test
63
        state: directory
64
        owner: www
65
        group: www
66

67
    - name: Create index_page file
68
      copy:
69
        content: web01...
70
        dest: /code/test/index.html
71

72
    - name: Restart nginx server
73
      systemd:
74
        name: nginx
75
        state: restarted
76
"因为没有学习变量,所以在这个的基础上改为web02"
77
⚠️特别是默认页部分!
78
[root@m01 ~]# ansible-playbook --syntax-check index.yml
79
playbook: index.yml
80
[root@m01 ~]# ansible-playbook  index.yml
81
- hosts: web02
82
...
83
      copy:
84
        content: web02...
85
        dest: /code/test/index.html
86
....
87
# 重新执行index.yml脚本!
88
[root@m01 ~]# curl 10.0.0.7
89
web01...
90
[root@m01 ~]# curl 10.0.0.8
91
web02...
92
'成功访问到!'

展开收起

📚mysql#

Terminal window展开收起

1
"这里用db02来进行安装!"
2
# 先把db02恢复快照-->从头开始
3
1)免密登录
4
[root@m01 ~]# ssh-copy-id -i ~/.ssh/my_key.pub 172.16.1.52
5

6
2)主机清单
7
[root@m01 ~]# grep db02 /etc/ansible/hosts
8
db02
9

10
3)编写配置文件
11
[root@m01 ~]# vim mysql.yml
12
- hosts: db02
13
  gather_facts: no
14
  tasks:
15
    - name: Install mariadb server
16
      yum:
17
        name:
18
          - mariadb-server
19
          - python3-PyMySQL
20
          # 有了☝才能进入到mysql里面-->创建用户!
21
          # python3-mysqlclient --> 该驱动已被 Ansible 官方标记为弃用
22
        state: present
23

24
    - name: Start mariadb server
25
      systemd:
26
        name: mariadb
27
        state: started
28
        enabled: yes
29

30
    - name: Create wp database
31
    # 创建数据库
32
    # 创建数据库之前需要先登录
33
      mysql_db:
34
        login_unix_socket: /var/lib/mysql/mysql.sock
35
        # 显式指定认证方式 --> 用 socket 认证
36
        login_user: root
37
        # 新建数据库时,没有设置密码 --> socket 认证也不需要密码
38
        name: wp
39
        state: present
40
============================================
41
'下面有数据库导入部分!'
42
state: 设置为 import,明确指示模块执行导入操作
43
# （将 SQL 文件导入到数据库中）
44
target: 指定要导入的 SQL 文件的路径
45
# ⚠️要导入的sql文件得在目标主机上
46
# 所以我们得先用copy模块拷贝到目标主机上!!
47
name: 指定要导入sql文件的,目标数据库名称
48
# ⚠️如果你是导出整个all.sql(所有的数据)
49
# 那么这里名字依旧是all
50
============================================
51
    - name: Create db user jiuzhao
52
      mysql_user:
53
        login_unix_socket: /var/lib/mysql/mysql.sock
54
        # 同样改用 socket
55
        login_user: root
56
        name: jiuzhao
57
        password: oldboy123.com
58
        priv: '*.*:ALL'
59
        # 给所有的数据库和所有表授予所有权限
60
        # 这里给wp就够用了 'wp.*:ALL'
61
        host: '172.16.1.%'
62
        # 还要允许172.xxx网段连接
63
        state: present
64

65
[root@m01 ~]# ansible-playbook --syntax-check mysql.yml
66
playbook: mysql.yml
67
[root@m01 ~]# ansible-playbook mysql.yml
68
'登录测试&&查看数据'
69
# 直接在db02中查看!
70
[root@db02 ~]# mysql -h 172.16.1.52 -ujiuzhao -poldboy123.com -e "show databases;"
71
+--------------------+
72
| Database           |
73
+--------------------+
74
| information_schema |
75
| mysql              |
76
| performance_schema |
77
| wp                 |
78
+--------------------+

展开收起

重构wordpress#

Terminal window展开收起

1
"先引出来一个问题!!"
2
# 后面做实验可能一直跳HTTPS
3
[root@m01 ~]# cat conf.d/wp.conf
4
.....
5
    location ~ \.php$ {
6
        fastcgi_pass 127.0.0.1:9000;
7
    .........
8
        fastcgi_param HTTPS on;
9
        # 配置fastcgi支持https的请求功能!
10
"在wordpress中的配置文件里面!"
11
得把这条配置删除掉!不然老跳https
12
# 如果你不小心把这个配置带入到wordpress安装页面
13
# 也就是安装好了!
14
'就是把https写入到了数据库中'
15
# 你得把数据库中对应的wordpress库删除掉!

展开收起

1
server {
2
    listen 80;
3
    server_name wp.kpyun.com;
4
    root /code/wordpress;
5

6
    location / {
7
        index index.php index.html;
8
        }
9

10
    location ~ \.php$ {
11
        fastcgi_pass 127.0.0.1:9000;
12
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
13
        include fastcgi_params;
14
        }
15
}

展开收起

📚get_url && unarchive#

Terminal window展开收起

1
"下载&&解压"
2
get_url：负责把文件从网上（或内部服务器）下载到目标机器上
3
unarchive：负责把压缩包（如 zip, tar.gz）解压开
4
============================================
5
1.get_url 模块（下载文件）
6
url: 下载地址
7
dest: 保存位置(必须写绝对路径)
8
force: 如果文件已存在,是否强制重新下载？
9
    yes (总是下载), no (存在就不下)
10
============================================
11
2.unarchive 模块（解压文件）
12
src: 要解压的那个压缩包在哪里？
13
dest: 解压出来的内容放到哪个文件夹？
14
remote_src: ⚠️源文件在哪边？
15
    no (默认): 压缩包在控制端（你这边）
16
    yes: 压缩包已经在目标机器上了,直接解压✅️
17
creates: 🦄防重复解压
18
'如果这个文件存在,说明解压过了, 直接跳过'

展开收起

1
- hosts: web01
2
  gather_facts: no
3
  tasks:
4
    - name: Configure copy wp
5
     # 拷贝配置文件
6
      copy:
7
        src: ./conf.d/wp.conf
8
        dest: /etc/nginx/conf.d/
9

10
    - name: Create dir /code
11
    # 创建code目录-->主要是修改属主,属组
12
      file:
13
        path: /code/
14
        state: directory
15
        owner: www
16
        group: www
17

18
    - name: crul wp pack
19
    # 下载wordpress包
20
      get_url:
21
        url: https://cn.wordpress.org/wordpress-6.0-zh_CN.tar.gz
22
        dest: /tmp/
23
        # 下载到临时目录(回收站)
24
        force: no
25

26
    - name: unpackage wp
27
    # 解压它
28
      unarchive:
29
        src: /tmp/wordpress-6.0-zh_CN.tar.gz
30
        remote_src: yes
31
        # 在远程目标机器上!
32
        dest: /code/
33
        creates: /code/wordpress
34
        # 如果有这个目录则跳过解压步骤!
35

36
    - name: modify owner group
37
    # 递归修改wordpress目录下的属主,属组
38
      file:
39
        path: /code/wordpress
40
        owner: www
41
        group: www
42
        recurse: yes
43
        # 递归修改
44

45
    - name: Restart nginx server
46
    # 重启nginx服务
47
      systemd:
48
        name: nginx
49
        state: restarted

展开收起

Terminal window

1
[root@m01 ~]# vim wp.yml
2
# 把上面的复制过去
3
[root@m01 ~]# ansible-playbook --syntax-check wp.yml
4
playbook: wp.yml
5
'终于是不报错了!'
6
[root@m01 ~]# ansible-playbook wp.yml
7
web01  : ok=6
8

9
# Windows 解析!
10
10.0.0.7 wp.kpyun.com
11
'浏览器访问测试!'

image-20260402192245691

image-20260402192308270

image-20260402192658144

Terminal window展开收起

1
# 上面是web01
2
web02如何配置wordpress呢??❓️
3
1.拷贝配置文件(./conf.d/wp.conf)
4
2.把web01下的/code/wordpress目录拷贝过去
5
3.更改/code目录及文件下的属主属组为www
6
4.重启web02的nginx服务
7
============================================
8
[root@web02 ~]# scp web01:/etc/nginx/conf.d/wp.conf /etc/nginx/conf.d/
9
root@web01's password: '
10
wp.conf  100%  324   465.2KB/s
11
[root@web02 ~]# scp -r web01:/code/wordpress /code
12
# 把整个目录都拷贝过来!
13
[root@web02 ~]# chown -R www.www /code
14
[root@web02 ~]# systemctl restart nginx
15

16
# Windows 解析!
17
10.0.0.8 wp.kpyun.com
18
'浏览器访问测试!'

展开收起

image-20260402202905597

业务迁移#

Terminal window展开收起

1
业务背景: wp业务, 从一个老旧的设备迁移到新设备上
2
实现目标: 业务恢复, 迁移后直接登录就能看到原有的信息!
3
'以下步骤完成后,输入网址,直接恢复成原来的样子'
4
============================================
5
1)wordpress的配置文件导出
6
./conf.d/wp.conf
7
[root@m01 ~]# ls ./conf.d/wp.conf
8
./conf.d/wp.conf
9
# Ansible需要有!
10

11
2)原来/code/wordpress源码需要导出
12
[root@m01 ~]# scp -r 172.16.1.7:/code/wordpress .
13
[root@m01 ~]# ll -d wordpress/
14
drwxr-xr-x 5 root root 4096 Apr  2 20:50 wordpress/
15
'这里需要注意属主是root!!⚠️'
16
# ✅️东西比较多,我们压缩一下!
17
[root@m01 ~]# tar zcf wp.tar.gz ./wordpress/
18
[root@m01 ~]# ls wp.tar.gz
19
wp.tar.gz
20

21
3)数据库中的数据需要导出
22
# 方便后面导入的时候恢复业务!
23
'这里我只导出了一个wp库,后面数据库依旧要创建jiuzhao这个用户!'
24
[root@m01 ~]# ssh db02 "mysqladmin password 'oldboy123.com'"
25
# 给db01的root一个密码!
26
[root@m01 ~]# ssh db02 "mysqldump -uroot -poldboy123.com wp > /tmp/wp.sql"
27
# 把wp库导出
28
[root@m01 ~]# ssh db02 "ls /tmp/wp.sql"
29
/tmp/wp.sql
30
# 测试验证!
31
[root@m01 ~]# scp 172.16.1.52:/tmp/wp.sql .
32
wp.sql      100% 1077KB  96.3MB/s
33
'拷贝到当前目录来!'
34

35
4)配置文件的书写✍️

展开收起

1
- hosts: webs
2
  gather_facts: no
3
  tasks:
4
    - name: Configure nginx repo
5
      yum_repository:
6
        name: nginx-stable
7
        description: nginx stable repo
8
        baseurl: https://nginx.org/packages/centos/7/$basearch/
9
        gpgcheck: no
10
        enabled: yes
11

12
    - name: Install nginx server
13
      yum:
14
        name: nginx
15
        state: present
16

17
    - name: Configure copy nginx file
18
      copy:
19
        src: ./nginx.conf
20
        dest: /etc/nginx/
21

22
    - name: Create group www
23
      group:
24
        name: www
25
        gid: 888
26

27
    - name: Create user www
28
      user:
29
        name: www
30
        uid: 888
31
        group: www
32
        shell: /sbin/nologin
33
        create_home: false
34

35
    - name: Start nginx server
36
      systemd:
37
        name: nginx
38
        state: started
39
        enabled: yes

展开收起

1
- hosts: webs
2
  gather_facts: no
3
  tasks:
4
    - name: Install php server
5
      yum:
6
        name:
7
          - php
8
          - php-bcmath
9
          - php-cli
10
          - php-common
11
          - php-devel
12
          - php-embedded
13
          - php-fpm
14
          - php-gd
15
          - php-intl
16
          - php-mbstring
17
          - php-mysqlnd
18
          - php-opcache
19
          - php-pdo
20
          - php-process
21
          - php-xml
22
          - php-json
23
        state: present
24

25
    - name: Configure copy php
26
      copy:
27
        src: ./www.conf
28
        dest: /etc/php-fpm.d/
29

30
    - name: Start php server
31
      systemd:
32
        name: php-fpm
33
        state: started
34
        enabled: yes

展开收起

1
- hosts: db02
2
  gather_facts: no
3
  tasks:
4
    - name: Install mariadb server
5
      yum:
6
        name:
7
          - mariadb-server
8
          - python3-PyMySQL
9
          # 改用 PyMySQL --> 连接进入MySQL
10
        state: present
11

12
    - name: Start mariadb server
13
      systemd:
14
        name: mariadb
15
        state: started
16
        enabled: yes
17

18
    # 数据导入之前,需要copy到db02
19
    - name: Copy wp.sql db
20
      copy:
21
        src: ./wp.sql
22
        dest: /tmp/wp.sql
23

24
    - name: Imoport wp.sql db
25
    # 详细语法参考前面 mysql
26
      mysql_db:
27
        login_unix_socket: /var/lib/mysql/mysql.sock
28
        login_user: root
29
        name: wp
30
        # 导入的数据库名称是wp
31
        state: import
32
        # 导入
33
        target: /tmp/wp.sql
34
        # sql文件在db02中
35

36
    - name: Create db user jiuzhao
37
      mysql_user:
38
        login_unix_socket: /var/lib/mysql/mysql.sock
39
        login_user: root
40
        name: jiuzhao
41
        password: oldboy123.com
42
        priv: '*.*:ALL'
43
        # 给所有的数据库和所有表授予所有权限
44
        host: '172.16.1.%'
45
        # 还要允许172.xxx网段连接
46
        state: present
47

48
    - name: Restart mysql server
49
      systemd:
50
        name: mariadb
51
        state: restarted

展开收起

多出来 wp.sql 数据导入
- 详细语法参考前面 📚mysql
少建表部分!
因为我们没有导出整个sql语句, 所以用户 jiuzhao 不能少

1
- hosts: webs
2
  gather_facts: no
3
  tasks:
4
    - name: Configure copy wp
5
     # 拷贝配置文件
6
      copy:
7
        src: ./conf.d/wp.conf
8
        dest: /etc/nginx/conf.d/
9

10
    - name: Create dir /code
11
    # 创建code目录-->主要是修改属主,属组
12
      file:
13
        path: /code/
14
        state: directory
15
        owner: www
16
        group: www
17

18
    - name: unpackage wp
19
    # 解压它
20
      unarchive:
21
        src: ./wp.tar.gz
22
        remote_src: no
23
        # 压缩包在本地(m01)
24
        dest: /code/
25
        creates: /code/wordpress
26
        # 如果有这个目录则跳过解压步骤!
27

28
    - name: modify owner group
29
    # 递归修改wordpress目录下的属主,属组
30
      file:
31
        path: /code/wordpress
32
        owner: www
33
        group: www
34
        recurse: yes
35
        # 递归修改
36

37
    - name: Restart nginx server
38
    # 重启nginx服务
39
      systemd:
40
        name: nginx
41
        state: restarted

展开收起

少下载 wordpress软件包 部分
本地有,直接在本地解压至 webs

Terminal window展开收起

1
vim nginx.yml
2
vim php.yml
3
vim mysql.yml
4
vim wp.yml
5
# 把上面的东西都复制进去!
6
✅️web01 web02 db02 都恢复快照!
7
✅️别忘了做ssh免密登录
8
============================================
9
[root@m01 ~]# cd /home/
10
[root@m01 home]# ll
11
total 0
12
[root@m01 home]# ll
13
total 16
14
-rw-r--r-- 1 root root 1169 Apr  2 22:14 mysql.yml
15
-rw-r--r-- 1 root root  846 Apr  2 22:14 nginx.yml
16
-rw-r--r-- 1 root root  699 Apr  2 22:14 php.yml
17
-rw-r--r-- 1 root root  959 Apr  2 22:15 wp.yml
18
# 编写完后覆盖原来的配置!
19
[root@m01 home]# cp ./* ~
20
cp: overwrite '/root/mysql.yml'? y
21
cp: overwrite '/root/nginx.yml'? y
22
cp: overwrite '/root/php.yml'? y
23
cp: overwrite '/root/wp.yml'? y
24
[root@m01 home]# cd ~
25
[root@m01 ~]# ansible-playbook --syntax-check nginx.yml
26
playbook: nginx.yml
27
[root@m01 ~]# ansible-playbook --syntax-check php.yml
28
playbook: php.yml
29
[root@m01 ~]# ansible-playbook --syntax-check mysql.yml
30
playbook: mysql.yml
31
[root@m01 ~]# ansible-playbook --syntax-check wp.yml
32
playbook: wp.yml
33
'把命令编写成一个脚本!'
34
[root@m01 ~]# vim site.sh
35
ansible-playbook nginx.yml
36
ansible-playbook php.yml
37
ansible-playbook mysql.yml
38
ansible-playbook wp.yml
39
'运行脚本'
40
[root@m01 ~]# sh site.sh
41

42
🐴'浏览器测试验证'
43
# 分别解析到 web01 和 web02 试试看!
44
✅️http://wp.kpyun.com/

展开收起

Ansible开篇

Wed, 20 May 2026 00:00:00 GMT

Ansible开篇#

[TOC]

web服务回顾#

image-20260327081836438

架构图#

图片变清晰

🧱 Ansible 架构图
Ansible = 你写“剧本” + 它当“导演” + 服务器当“演员” → 全自动完成任务！

💡 关键优势（大白话）：

不用装客户端：省心省力
用 SSH 就行：大多数 Linux 都支持
写一次,到处用：标准化、可重复
安全又可控：你说了算,它只听你的

1️⃣ Users（用户）

就是你——运维、开发或管理员
你在电脑上写命令或剧本,告诉 Ansible 要干啥

2️⃣ Host Inventory（主机清单）

这是个“通讯录”：列出了你要管的所有服务器 IP 或名字
告诉 Ansible：“这些机器是我要操作的目标”

3️⃣ Playbooks（任务剧本）

就是“操作说明书”：你写的 YAML 文件,详细说明每一步该做什么
类似于“菜谱”：照着做就行,不会出错

4️⃣ Core Modules & Custom Modules（核心模块 + 自定义模块）

这些是 Ansible 的“工具箱”：
- core modules：自带的常用工具
- custom modules：你自己写的特殊功能,比如调某个 API 接口
简单说： Ansible 用这些“小工具”去执行具体任务

5️⃣ Connection Plugins（连接插件）

就是“通信方式”：Ansible 怎么和服务器说话？
默认用 SSH（最常见）,也可以用 Kubernetes 等
它负责建立连接,把命令发出去

6️⃣ Plugins（其他插件）

比如发邮件、记录日志、输出格式化结果等
可以让你在执行完任务后自动通知你：“部署成功啦！”或者“出错了！”

7️⃣ Hosts（目标服务器）

就是你管理的那些机器,可能是物理机、虚拟机
- 可能是云上的服务器（Public/Private Cloud）
它们不需要装任何东西（无代理）,只要能连上 SSH 就行！

🔁 整体流程一句话总结：

你写个剧本 → Ansible 根据主机清单找到目标 → 用 SSH 连上去 → 执行内置或自定义工具 → 完成任务 → 把结果告诉你

Python环境管理#

🌏 故事从 PEP 668 讲起

Ubuntu 24.04 严格执行 ==PEP 668==,禁止直接使用 pip install 安装全局包

Terminal window

1
root@m01 ~# pip install ansible
2
× This environment is externally managed
3
# 外部环境托管
4
❌️ 在 Ubuntu 24.04 上直接 pip install 会报错

📌 为什么会这样？

Ubuntu 系统自身很多==核心功能==（软件包管理器、系统工具）依赖 Python

如果你用 pip 全局乱装包,版本冲突可能直接把系统干崩

✅️ 所以 Ubuntu 24.04 一刀切：想装东西？先进虚拟环境,或者用 pipx（不需要进虚拟环境）

💡 所以就有了今天要讲的四个工具,它们分两派：

派别	成员	干什么的
环境隔离派	`venv` 、`uv`	创建独立的 Python 运行空间,装了啥都不影响系统
包安装派	`pip` 、`pipx`	往某个环境里装包,区别是一个装库、一个装 CLI 工具

这两派是配合关系,不是竞争关系：先用 venv（或 uv）开个房间 → 再用 pip（或 uv pip）往房间里搬东西或者直接用 pipx ——它自己把”开房间 + 搬东西”一步搞定,==专给 CLI 工具用==

四大工具通俗讲解#

pip — Python 的”万能安装器”#

Terminal window

1
# 没进 venv → 装到系统全局（Ubuntu 24.04 会拦截）
2
pip install requests
3
====================================
4
# 先进 venv → 装到虚拟环境里,不影响系统
5
source .venv/bin/activate
6
(.venv) pip install requests   # 只装在这个 venv 里
7
(.venv) pip install ansible    # 也只在这个 venv 里,退出就找不到了
8
====================================
9
📌 pip 现在主要在'虚拟环境里面'用,装到 venv 里而不是系统里

Note

🔹 pip 只管”送到当前环境”,不管隔离——当前环境是哪个就装到哪个 🔹 如果所有包都往系统塞 → 版本一冲突就炸锅 🔹 Ubuntu 24.04 禁止往系统塞：externally-managed-environment

💡 pip 装的东西分两种——搞清楚这个,后面 pipx 才好理解：

	`requests`（库）	`ansible`（CLI 工具）
本质	给 Python 代码 `import` 用的	在终端直接敲命令用的
怎么用	`import requests`	`ansible --version`
终端能敲吗	❌ `requests` → `command not found`	✅ 能敲,有可执行入口
谁装	`pip` / `uv pip`	`pip` / `uv pip` / ==pipx==

Terminal window

1
# requests 是库——终端敲不了
2
root@m01 ~# requests
3
bash: requests: command not found
4
====================================
5
# 只能在 Python 代码里 import
6
import requests
7
resp = requests.get("https://api.github.com")
8
print(resp.status_code)   # 200

Tip

📌 这就是 pip 和 pipx 的分界线：pipx 不装库,因为库装了也没命令可敲 pipx 只装 ansible、black、httpie 这种能直接在终端敲的 CLI 工具

venv — Python 的”房间隔离术”#

Terminal window展开收起

1
[root@Master ~]# python3 -V
2
Python 3.12.13
3
✅️ Rocky升级完软件包后(dnf update)
4
[root@Master ~]# mkdir /kpyun
5
[root@Master ~]# cd /kpyun
6

7
1)创建一个叫 myenv 的虚拟环境
8
[root@Master kpyun]# python3 -m venv myven
9
⚠️ 生成的时候,会明显觉得卡顿!比较慢
10
[root@Master kpyun]# ls -lh
11
total 0
12
drwxr-xr-x 5 root root 74 Jun  9 22:13 myven
13
[root@Master kpyun]# ls ./myven/
14
bin  include  lib  lib64  pyvenv.cfg
15

16
2)激活这个环境（走进这个房间）
17
[root@Master kpyun]# source ./myven/bin/activate
18
((myven) ) [root@Master kpyun]#
19
# 现在你在这个"房间"里,随便 pip install 都不会影响系统
20
((myven) ) [root@Master kpyun]# pip install ansible -i https://mirrors.aliyun.com/pypi/simple/
21
✅ 安全！
22
((myven) ) [root@Master kpyun]# ansible --version
23
ansible [core 2.21.0]
24
版本号  👆
25

26
3)退出房间
27
((myven) ) [root@Master kpyun]# deactivate
28
[root@Master kpyun]# ansible --version
29
-bash: ansible: command not found
30
📌 '只在虚拟环境生效'

展开收起

🔹 venv 是 Python 3.3+ 自带的,不需要额外安装 🔹 每个项目一个 venv,各自独立,互不干扰 🔹 缺点：每创建一个环境都要完整复制一遍 Python 和包文件,占磁盘

⚠️ 那个 (myenv) 前缀,就是告诉你”你现在在虚拟环境里”

pipx — CLI 工具的”单身公寓”#

Terminal window展开收起

1
1)安装 pipx
2
[root@Master kpyun]# yum -y install pipx
3
[root@Master kpyun]# pipx --version
4
1.12.0
5

6
2)用 pipx 装一个 CLI 工具（比如 uv）
7
[root@Master kpyun]# pipx install uv -i https://mirrors.aliyun.com/pypi/simple/
8
  installed package uv 0.11.19, installed using Python 3.12.13
9
  These apps are now available
10
    - uv
11
    - uvx
12
done! ✨ 🌟 ✨
13
✅️ '配置uv的shell命令补齐'
14
# tab键可以补全命令
15
[root@Master kpyun]# echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc
16
[root@Master kpyun]# echo 'eval "$(uvx --generate-shell-completion bash)"' >> ~/.bashrc
17
[root@Master kpyun]# source ~/.bashrc
18

19
3)现在 uv 命令在任何地方都能用,不需要进虚拟环境！
20
[root@Master kpyun]# uv --version
21
uv 0.11.19 (x86_64-unknown-linux-gnu)
22
# ✅ 不需要 activate！
23

24
4)即使在虚拟环境中也是可以找到的
25
[root@Master kpyun]# source ./myven/bin/activate
26
((myven) ) [root@Master kpyun]# uv --version
27
uv 0.11.19 (x86_64-unknown-linux-gnu)

展开收起

📌 pipx 的核心设计理念：

特性	说明
安装对象	只装 CLI 工具（ansible、black、httpie…）,不装库
隔离方式	每个工具一个独立虚拟环境,藏在 `~/.local/share/pipx/venvs/`
暴露方式	只在 `~/.local/bin/` 放一个链接,全局可直接敲命令
退出环境还能用吗	✅ 能！装完就是全局的,跟虚拟环境无关

Terminal window

1
[root@Master kpyun]# ls ~/.local/
2
bin  share  state
3
'虚拟环境'
4
[root@Master kpyun]# ls ~/.local/share/pipx/venvs/
5
uv
6
'链接位置📍'
7
[root@Master kpyun]# ls ~/.local/bin/
8
uv  uvx    ✅️ 全局可直接敲命令

对比维度	`pip`	`pipx`
主要用途	装库（可被 import）和 CLI 工具	只装 CLI 工具（ansible、black 等）
环境隔离	❌ 不隔离,全塞一起	✅ 每个工具独立环境
依赖冲突	高 — A 要 v1,B 要 v2,炸了	低 — 各住各的
全局可用	装在哪就在哪用	✅ 装完即全局可用
适用场景	在 venv 里给项目装依赖	全局装 Python 小工具
装库可以吗	✅ `pip install requests`	❌ pipx 不装库

📌 选哪个？

你在项目 venv 里装依赖 → pip（或 uv pip）
你想全局随时用 ansible / black / httpie → pipx

Tip

💡 pipx 解决了什么问题？

你想要全局敲 ansible 命令,但 Ubuntu 又禁止你全局 pip install

✅️ pipx 说：“我帮你装一个独立的 ansible 环境,再给你一把全局的钥匙,完美！”

Note

⚠️ pipx 只能装 CLI 工具,不能装库（比如 requests 你还是要用 pip 在 venv 里装）

🔹 pipx 在虚拟环境内 ==依然== 是全局安装 — 它的设计就是全局可用,跟你当前在不在 venv 没关系

uv — 极速版的 venv + pip 合体#

一句话：uv 就是把 venv 和 pip 用 Rust 重写了一遍,速度直接起飞
创建虚拟环境 + 装包,这两件事它干得比原版快 10-100 倍
顺便还能指定 Python 版本——创建环境时自动下载,不用你手动装

📌 uv 到底快在哪里？

对比维度	`venv` + `pip`	`uv`
底层语言	Python	Rust
创建环境	复制整个 Python 解释器（3-5 秒）	符号链接/硬链接（毫秒级）
装包速度	逐个下载解压安装	并行处理,全局缓存复用
包占用磁盘	每个环境复制一份	所有环境共享一份缓存,==硬链接==指向
Python 版本管理	❌ 需额外装 pyenv	✅ 内置 `uv python install 3.14`
依赖锁定	❌ 需配合 pip-tools	✅ 内置 `uv.lock` 精确锁定

📌 uv 的”零成本复用”是怎么做到的？

Tip

10 个虚拟环境都要用 requests 这个库：

venv + pip：下载 1 次,复制 10 次 → 10 份磁盘空间
uv：下载 1 次,10 个环境全部用硬链接指向同一份文件 → 1 份磁盘空间 + 10 个指针
- 省磁盘、省时间,而且每个环境看起来都”有自己的那份”

Terminal window展开收起

1
1)用 pipx 装 uv（全局可用）
2
[root@Master kpyun]# pipx install uv -i https://mirrors.aliyun.com/pypi/simple/
3
  installed package uv 0.11.19, installed using Python 3.12.13
4
  These apps are now available
5
    - uv
6
    - uvx
7
done! ✨ 🌟 ✨
8
✅️ '配置uv的shell命令补齐'
9
# tab键可以补全命令
10
[root@Master kpyun]# echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc
11
[root@Master kpyun]# echo 'eval "$(uvx --generate-shell-completion bash)"' >> ~/.bashrc
12
[root@Master kpyun]# source ~/.bashrc
13

14
2)创建虚拟环境（替代 python -m venv 还能指定 Python 版本）
15
[root@Master oldboy]# uv venv haha --python 3.14
16
cpython-3.14.5-linux-x86_64-gnu (download)
17
'自动下载 Python 3.14'
18
Using CPython 3.14.5
19
Creating virtual environment at: haha
20
Activate with: source haha/bin/activate
21
====================================
22
📌 '选哪个？'
23
  ✅️ 简单项目,不想多装东西 → `venv` 够用
24
  ✅️ 追求效率,需要多 Python 版本管理 → `uv`
25
====================================
26

27
3)激活环境
28
[root@Master oldboy]# source ./haha/bin/activate
29
(haha) [root@Master oldboy]# ansible --version
30
-bash: ansible: command not found
31

32
4)装包（替代 pip install）
33
(haha) [root@Master oldboy]# uv pip install ansible -i https://mirrors.aliyun.com/pypi/simple/
34
'比 pip 快 10-100 倍'
35
(haha) [root@Master oldboy]# ansible --version
36
ansible [core 2.21.0]
37
(haha) [root@Master oldboy]# deactivate
38
[root@Master oldboy]# ansible --version
39
-bash: ansible: command not found
40
✅️ 同样也是只能在虚拟环境中生效
41
'在哪里安装的在哪里生效'
42

43
5)直接在系统安装试一试
44
# Rocky Linux
45
[root@Master oldboy]# uv pip install ansible -i https://mirrors.aliyun.com/pypi/simple/
46
error: No virtual environment found; run `uv venv` to create an environment
47
'连 uv 也拒绝直接往系统里装！'
48
📌 uv 比 pip 更严格——没进 venv 直接报错,不给你误操作的机会
49
'pip 只是被 Ubuntu 拦了,在 Rocky 上还能装；uv 不管什么系统,一律要求进 venv'
50

51
6)直接在Rocky中pip安装ansible
52
[root@Master oldboy]# python3 -V
53
Python 3.12.13
54
[root@Master oldboy]# dnf install python3-pip python3-devel -y
55
# 安装Python包管理工具和其他必需组件
56
====================================
57
'只是安装Ansible的话上面就够了'
58
dnf install gcc openssl-devel bzip2-devel libffi-devel zlib-devel -y
59
# 安装编译工具（用于后续可能需要编译的Python包）
60
====================================
61
[root@Master oldboy]# pip3 --version
62
pip 23.3.2 from /usr/lib/python3.12/site-packages/pip (python 3.12)
63
[root@Master oldboy]# ansible --version
64
-bash: ansible: command not found
65
[root@Master oldboy]# pip3 install ansible -i https://mirrors.aliyun.com/pypi/simple/
66
[root@Master oldboy]# ansible --version
67
ansible [core 2.21.0]
68
✅️ pip可以直接安装在系统中

展开收起

推荐组合：Ubuntu 24.04 最佳实践#

📌 等等——Ansible 这类工具,真的需要进 venv 吗？

上面演示的是”在虚拟环境里装 Ansible”,但其实对于 Ansible 这类 CLI 工具,更推荐直接用 pipx 全局安装：

Terminal window展开收起

1
1)用 pipx 装 uv（全局可用,一次安装终身受益）
2
root@m01 ~# apt install pipx -y
3
====================================
4
✅️ 下面操作仅供演示在Ubuntu中安装uv
5
# 因为我们不在虚拟环境中安装, 只需要安装pipx👆即可
6
root@m01 ~# pipx install uv -i https://mirrors.aliyun.com/pypi/simple/
7
  installed package uv 0.11.19, installed using Python 3.12.3
8
⚠️  Note: '/root/.local/bin' is not on your PATH environment variable.
9
root@m01 ~# pipx ensurepath
10
'pipx ensurepath 把 ~/.local/bin 加入 PATH,不然 uv 命令找不到'
11
root@m01 ~# source ~/.bashrc
12
'使环境变量生效'
13
====================================
14

15
2)一键全局安装,无需 venv
16
root@m01 ~# pipx install --include-deps ansible -i https://mirrors.aliyun.com/pypi/simple/
17
'短命令 ansible + 完整社区模块 + 全局可用'
18
# 装完随处可用,不需要 source activate
19
 installed package ansible 14.0.0, installed using Python 3.12.3
20
  These apps are now globally available
21
    - ansible ✅️
22
    - ansible-community ✅️
23
    - ansible-config
24
    - ansible-console
25
    - ansible-doc ✅️
26
    - ansible-galaxy
27
    - ansible-inventory
28
    - ansible-playbook ✅️
29
    - ansible-pull
30
    - ansible-test
31
    - ansible-vault
32
done! ✨ 🌟 ✨
33
root@m01 ~# ansible --version
34
ansible [core 2.21.0]
35
'核心引擎,只有最基本的模块'
36
root@m01 ~# ansible-community --version
37
Ansible community version 14.0.0
38
'核心引擎 + 一堆 Collections（社区模块包）'
39
# 14.0.0 不是低版本,它俩的"14"和"2.21"是完全独立的编号体系
40

41
3)更改hosts文件
42
root@m01 ~# cat >> /etc/hosts <<EOF
43
10.0.0.111  node1
44
10.0.0.112  node2
45
10.0.0.113  node3
46
EOF
47
'测试了联通性'
48
root@m01 ~# ping -W2 -c3 node2
49
PING node2 (10.0.0.112) 56(84) bytes of data.
50
64 bytes from node2 (10.0.0.112): icmp_seq=1 ttl=64 time=0.564 ms
51
64 bytes from node2 (10.0.0.112): icmp_seq=2 ttl=64 time=0.254 ms
52
64 bytes from node2 (10.0.0.112): icmp_seq=3 ttl=64 time=0.204 ms
53

54
--- node2 ping statistics ---
55
3 packets transmitted, 3 received, 0% packet loss, time 2027ms
56
rtt min/avg/max/mdev = 0.204/0.340/0.564/0.159 ms

展开收起

Note

关机拍快照

📌 Ubuntu 24.04 完整工具链：

apt install pipx → pipx install uv → 日常用 pipx 装 CLI 工具,用 uv venv 管项目环境 & uv pip 安装软件

Tip

💡 为什么 Ansible 适合 pipx 全局装？

Ansible 是你天天要在终端敲的命令,不是某个项目的依赖库

pipx 给它一个独立的”单身公寓”,依赖隔离,但命令全局通——完美匹配

实战（旧版）：源码编译安装 Python + 全局 pip 安装 Ansible#

⚠️ 以下为旧版 kylin/CentOS 环境下的操作,Ubuntu 24.04 不适用,仅作参考

Terminal window展开收起

1
1)准备一台服务器kylin
2
# IP 10.0.0.81  主机名称 m01
3
'1核2G内存'
4
[root@m01 ~]# mkdir /server/tmp
5
[root@m01 ~]# cd /server/tmp/
6
[root@m01 tmp]# python3 -V
7
Python 3.7.9
8
# 大写的V
9
# 是 python3✅️ 命令；而不是python❌️
10
'不在支持3.8以下版本,需要安装更高的python版本'
11

12
2)下载并编译 Python 3.8
13
[root@m01 tmp]# wget https://www.python.org/ftp/python/3.8.16/Python-3.8.16.tgz
14
[root@m01 tmp]# tar xf Python-3.8.16.tgz -C .
15
# 解压为软件包！
16
[root@m01 tmp]# ls
17
Python-3.8.16  Python-3.8.16.tgz
18
[root@m01 tmp]# cd Python-3.8.16
19
# 进入软件包
20
[root@m01 Python-3.8.16]# mkdir /soft
21
[root@m01 Python-3.8.16]# ./configure --prefix=/soft/python3.8 --enable-optimizations
22
--prefix=/soft/python3.8：自定义安装路径
23
--enable-optimizations：用编译时间换取运行速度
24
'编译时间会长一点,但最终的 Python 解释器运行速度显著提升'
25

26
3)编译安装
27
[root@m01 Python-3.8.16]# make -j$(nproc) && make altinstall
28
make -j$(nproc)：多线程并行编译（全速运行）
29
# 别偷懒,把你所有的 CPU 核心都利用起来,以最快的速度把软件编译出来
30
make altinstall：安装新版本但不覆盖系统默认 Python
31
===============================================
32
# 我们Nginx之前用的都是 make && make install
33
'直接覆盖安装旧版'
34
📌自带的python不能覆盖安装
35
# CentOS, Ubuntu 的核心组件都依赖于系统自带的 Python 版本
36
# 如果你卸载了系统默认的 Python,极有可能导致系统崩溃
37
===============================================
38
# 新装的 Python 会以 python3.8 命令形式存在,pip3.8 也一并装好了
39
# pip3.8 是 Python 3.8 的标准组件
40
'看到 WARNING: The script pip3.8 is installed in /soft/python3.8/bin 这条信息不用慌'
41
# pip3.8 这个工具已经装好了,放在 /soft/python3.8/bin 这个文件夹里
42
# 但没在 PATH 环境变量里,所以你直接敲 pip3.8 可能会提示‘找不到命令’
43
===============================================
44
[root@m01 Python-3.8.16]# cd
45
[root@m01 ~]# python3.8 -V
46
-bash: python3.8: command not found
47
[root@m01 ~]# /soft/python3.8/bin/python3.8 -V
48
Python 3.8.16
49
[root@m01 ~]# python3 -V
50
Python 3.7.9
51
'新版的python3.8已经安装好了！但不影响自带的python3'
52
# 现在还是找不到环境变量！我们把它加入到环境变量！
53

54
4)加入环境变量
55
[root@m01 ~]# echo "export PATH=\$PATH:/soft/python3.8/bin/" >> /etc/profile
56
[root@m01 ~]# source /etc/profile
57
[root@m01 ~]# python3.8 -V
58
Python 3.8.16
59
'这次就找到了！'
60

61
5)用 pip 安装 Ansible
62
[root@m01 ~]# pip3.8 install ansible -i https://mirrors.aliyun.com/pypi/simple/
63
[root@m01 ~]# ansible --version
64
ansible [core 2.13.13]
65
'两个-'
66
# 查看版本号,验证是否安装！
67

68
6)创建 Ansible 配置文件
69
[root@m01 ~]# mkdir /etc/ansible
70
[root@m01 ~]# vim /etc/ansible/ansible.cfg
71
'配置文件'
72
# 默认没有、手动创建的
73
[defaults]
74
host_key_checking = False
75
deprecation_warnings = False
76
interpreter_python = /usr/bin/python3
77
[inventory]
78
[privilege_escalation]
79
[paramiko_connection]
80
[ssh_connection]
81
[persistent_connection]
82
[accelerate]
83
[selinux]
84
[colors]
85
[diff]

展开收起

1
[defaults]
2
# “总指挥部”
3
host_key_checking = False
4
# SSH 第一次连接一台新服务器时,会弹出来一个提示问你“这个主机的指纹你确认要信任吗？(yes/no)
5
# “设置为 False 就是告诉 Ansible：“别问我了,直接信任,继续干活！”
6
'便于自动化,牺牲少量安全性'
7
==================================
8
deprecation_warnings = False
9
# 警告信息太多,会干扰你看真正重要的输出
10
# “别老提醒我有些工具快过时了,专心干活！”
11
'让输出更干净'
12
==================================
13
interpreter_python = /usr/bin/python3
14
# 指定使用python3版本
15
interpreter_python 这个配置,就是用来告诉“总部”（控制节点）：“当你派任务到‘分部’（托管节点）去执行时,必须使用‘分部’自己机器上位于 /usr/bin/python3 的这个 Python 解释器来运行
16
==================================
17
[inventory]
18
# 默认位置：/etc/ansible/hosts(需要手动创建！)
19
“通讯录”
20
==================================
21
[privilege_escalation]
22
# sudo提权选项
23
# 如果普通权限不够用,就用sudo升级成管理员
24
==================================
25
“两种不同的连接插件“
26
[paramiko_connection]
27
# Ansible 自带的插件
28
[ssh_connection]
29
# ssh插件
30
[persistent_connection]
31
# ssh持久连接选项(默认选项)
32
“保持热线,说不定一会儿还有事“
33
==================================
34
[accelerate]
35
# 比较老的加速模式
36
“让它跑得更快“
37
[selinux]
38
[colors]
39
# Ansible命令行输出的颜色(默认)
40
[diff]
41
# 它会先显示文件修改前和修改后的内容差异

展开收起

主机清单#

Note

清单是 Ansible 管理节点的”通讯录”——告诉 Ansible 要操控哪些主机

📌 常见格式：==INI==（推荐,简洁,有高亮显示）和 ==YAML==

默认路径 /etc/ansible/hosts,pip 安装后需手动创建

Terminal window展开收起

1
默认配置文件: /etc/ansible/hosts
2
'需要手动创建！'
3
[root@m01 ~]# ll /etc/ansible/hosts
4
ls: cannot access '/etc/ansible/hosts': No such file or directory
5
==================================
6
定义主机清单的方式:
7
（1）单台定义
8
[root@m01 ~]# vim /etc/ansible/hosts
9
10.0.0.7 ansible_ssh_user=root ansible_ssh_port=22 ansible_ssh_pass='oldboy123.com'
10
# 默认端口就是22,可以不用写
11
[root@m01 ~]# ansible 10.0.0.7 -m ping
12
-m：使用ping这个模块
13
# 单台测试
14
10.0.0.7 | SUCCESS => {
15
    "changed": false,
16
    "ping": "pong"
17
}
18

19
（2）定义别名
20
[root@m01 ~]# cat /etc/ansible/hosts
21
'多出来 ansible_ssh_host'
22
# 尽量用内网172.xxx
23
web01 ansible_ssh_host=10.0.0.7 ansible_ssh_user=root ansible_ssh_port=22 ansible_ssh_pass='oldboy123.com'
24
# 第一个是别名！
25
[root@m01 ~]# ansible web01 -m ping
26
web01 | SUCCESS => {
27
    "changed": false,
28
    "ping": "pong"
29
}
30
[root@m01 ~]# ansible 10.0.0.7 -m ping
31
[WARNING]: Could not match ...ignoring: 10.0.0.7
32
[WARNING]: No hosts matched, nothing to do
33
# 当使用了别名,再次用IP就失效了
34

35
（3）定义组
36
1)定义多台：
37
[root@m01 ~]# cat /etc/ansible/hosts
38
web01 ansible_ssh_host=10.0.0.7 ansible_ssh_user=root ansible_ssh_port=22 ansible_ssh_pass='oldboy123.com'
39
web02 ansible_ssh_host=10.0.0.8 ansible_ssh_user=root ansible_ssh_port=22 ansible_ssh_pass='oldboy123.com'
40
web03 ansible_ssh_host=10.0.0.9 ansible_ssh_user=root ansible_ssh_port=22 ansible_ssh_pass='oldboy123.com'
41
[root@m01 ~]# ansible all -m ping | grep -i success
42
'all表示所有主机'
43
web02 | SUCCESS => {
44
web01 | SUCCESS => {
45
web03 | SUCCESS => {
46

47
2)将它们划分同一个小组
48
'当然也可以支持多个组'
49
[root@m01 ~]# cat /etc/ansible/hosts
50
[webs]
51
web01 ansible_ssh_host=10.0.0.7 ansible_ssh_user=root ansible_ssh_pass='oldboy123.com'
52
web02 ansible_ssh_host=10.0.0.8 ansible_ssh_user=root ansible_ssh_pass='oldboy123.com'
53
web03 ansible_ssh_host=10.0.0.9 ansible_ssh_user=root ansible_ssh_pass='oldboy123.com'
54
[root@m01 ~]# ansible webs -m ping | grep -i success
55
web01 | SUCCESS => {
56
web02 | SUCCESS => {
57
web03 | SUCCESS => {
58

59
（4）通过主机名定义
60
'新开一个机器lb01'
61
[root@m01 ~]# cat /etc/hosts | grep lb01
62
172.16.1.5 lb01
63
# 这里是172.xxx
64
[root@m01 ~]# grep 172.16.1.5 /etc/ansible/hosts
65
172.16.1.5 ansible_ssh_user=root ansible_ssh_pass='oldboy123.com'
66
# 没有ansible_ssh_host
67
[root@m01 ~]# ansible lb01 -m ping
68
[WARNING]: Could not match supplied host pattern, ignoring: lb01
69
[WARNING]: No hosts matched, nothing to do
70
'不能这样整！！'❌️
71
# 你ansible配置文件中(/etc/ansible/hosts)压根没有它lb01,自然是找不到的！
72
# ✅️ansible 172.16.1.5 -m ping
73
[root@m01 ~]# grep lb01 /etc/ansible/hosts
74
lb01 ansible_ssh_user=root ansible_ssh_pass='oldboy123.com'
75
# 但如果我们这样配置！依旧没有ansible_ssh_host
76
[root@m01 ~]# ansible lb01 -m ping
77
lb01 | SUCCESS => {
78
    "changed": false,
79
    "ping": "pong"
80
}
81
'但这个主机名可以从/etc/hosts中读取--》172.16.1.5'
82
# 域名解析
83

84

85
（5）支持序列的定义方式
86
[root@m01 ~]# grep 'web0[123]' /etc/hosts
87
172.16.1.7 web01
88
172.16.1.8 web02
89
172.16.1.9 web03
90
[root@m01 ~]# vim /etc/ansible/hosts
91
[webs]
92
web0[1:3] ansible_ssh_user=root ansible_ssh_pass='oldboy123.com'
93
':冒号分隔连续的'
94
# 不支持逗号 web01,web02,web03
95
# web01,web02,web03 | UNREACHABLE! => {
96
# ❌️会报错！
97
✅️不同的组得换行'参考(7)'
98

99

100
（6）多个组+子组'children’'
101
# 只想某几个组执行,排除其中的一两个组
102
[root@m01 ~]# egrep 'web0[123]|lb01|backup' /etc/hosts
103
172.16.1.5 lb01
104
172.16.1.7 web01
105
172.16.1.8 web02
106
172.16.1.9 web03
107
172.16.1.41 backup
108
[root@m01 ~]# cat /etc/ansible/hosts
109
[webs]
110
web0[1:3] ansible_ssh_user=root ansible_ssh_pass='oldboy123.com'
111

112
[lb]
113
lb01 ansible_ssh_user=root ansible_ssh_pass='oldboy123.com'
114

115
[back]
116
backup ansible_ssh_user=root ansible_ssh_pass='oldboy123.com'
117

118
[lnmp:children]
119
webs
120
back
121
# 我只想webs和backup执行,lb组不执行！
122
lnmp：组名（随便起）
123
children：⚠️固定写法,'子组'
124
[root@m01 ~]# ansible lnmp -m ping | grep -i success
125
web02 | SUCCESS => {
126
backup | SUCCESS => {
127
web01 | SUCCESS => {
128
web03 | SUCCESS => {
129
# 刚好是4台机器
130

131

132
（7）设置变量'vars’'
133
1)all给全部设置相同的变量
134
[root@m01 ~]# vim /etc/ansible/hosts
135
[webs]
136
web01
137
web02
138
web03
139

140
[lb]
141
lb01
142

143
[back]
144
backup
145

146
[all:vars]
147
ansible_ssh_user=root
148
ansible_ssh_pass='oldboy123.com'
149
'⚠️这两个不同的变量也得换行！'
150
[root@m01 ~]# ansible all -m ping| grep -i success
151
web02 | SUCCESS => {
152
lb01 | SUCCESS => {
153
web03 | SUCCESS => {
154
web01 | SUCCESS => {
155
backup | SUCCESS => {
156

157
2)给某几个组设置变量
158
# 前提是得有children(子组)
159
# 再给子组设置变量
160
[root@m01 ~]# cat /etc/ansible/hosts
161
[webs]
162
web01
163
web02
164
web03
165

166
[lb]
167
lb01 ansible_ssh_user=root ansible_ssh_pass='oldboy123.com'
168

169
[back]
170
backup
171

172
[lnmp:children]
173
webs
174
back
175

176
[lnmp:vars]
177
ansible_ssh_user=root
178
ansible_ssh_pass='oldboy123.com'
179
# 给组设置变量
180
# 在lnmp组中的所有主机共同使用定义好的vars变量
181
[root@m01 ~]# ansible lnmp -m ping| grep -i success
182
web02 | SUCCESS => {
183
web01 | SUCCESS => {
184
web03 | SUCCESS => {
185
backup | SUCCESS => {

展开收起

免密登录#

Terminal window展开收起

1
'后期学完shell脚本,一定要用脚本写免密登录！！'
2
========通过ssh免秘钥简化配置========
3
（1）ansible服务端生成密钥对
4
'非交互式生成'
5
[root@m01 ~]# ssh-keygen -t ed25519 -f ~/.ssh/my_key -N ''
6
Generating public/private ed25519 key pair.
7
Your identification has been saved in /root/.ssh/my_key
8
Your public key has been saved in /root/.ssh/my_key.pub
9
The key fingerprint is:
10
SHA256:Jgs3AXXpk4jIDguRhkDaeAc8AR1bAUzqzPR4nhiT8fo root@m01
11
The key's randomart image is:'
12
+--[ED25519 256]--+
13
|*O*++o. ..       |
14
|===+ . ..        |
15
|==+o...o .       |
16
|B.O.. ..+        |
17
|.% +. + S.       |
18
|. O .o =         |
19
| o o  .          |
20
|  .              |
21
|   E             |
22
+----[SHA256]-----+
23
[root@m01 ~]# ll ~/.ssh/
24
total 12
25
-rw-r--r-- 1 root root 1562 Mar 27 17:01 known_hosts
26
-rw------- 1 root root  399 Mar 27 19:59 my_key
27
-rw-r--r-- 1 root root   90 Mar 27 19:59 my_key.pub
28

29
（2）将公钥拷贝所有的客户端
30
ssh-copy-id -i ~/.ssh/my_key 172.16.1.5
31
密码：oldboy123.com
32
lb01：172.16.1.5
33
web01：172.16.1.7
34
web02：172.16.1.8
35
web03：172.16.1.9
36
backup：172.16.1.41
37

38
（3）修改默认连接的私钥
39
'客户端配置信息'
40
[root@m01 ~]# vim /etc/ssh/ssh_config
41
IdentityFile ~/.ssh/my_key
42
# 默认就用这个私钥连接！
43

44
（4）测试验证
45
'/etc/hosts主机有对应的解析！'
46
[root@m01 ~]# cat /etc/hosts
47
127.0.0.1   localhost
48
::1         localhost
49
172.16.1.5 lb01
50
172.16.1.6 lb02
51
172.16.1.7 web01
52
172.16.1.8 web02
53
172.16.1.9 web03
54
172.16.1.10 web04
55
172.16.1.31 nfs01
56
172.16.1.41 backup
57
172.16.1.51 db01
58
172.16.1.52 db02
59
172.16.1.53 db03
60
172.16.1.81 m01
61
[root@m01 ~]# ssh lb01
62
...
63
Last login: Fri Mar 27 17:33:31 2026 from 172.16.1.81
64
[root@lb01 ~]# exit
65
# 成功连接！
66

67
（5）重构ansible的主机清单
68
[root@m01 ~]# vim /etc/ansible/hosts
69
web0[1:3]
70
lb01
71
backup
72
[root@m01 ~]# ansible all -m ping | grep -i success
73
lb01 | SUCCESS => {
74
backup | SUCCESS => {
75
web02 | SUCCESS => {
76
web03 | SUCCESS => {
77
web01 | SUCCESS => {

展开收起

实战：Ansible 基础操作#

Terminal window展开收起

1
======'Ubuntu 24.04'======
2
1)创建全局配置文件
3
root@m01 ~# mkdir /etc/ansible
4
root@m01 ~# vim /etc/ansible/ansible.cfg
5
[defaults]
6
host_key_checking = False
7
deprecation_warnings = False
8
interpreter_python = /usr/bin/python3
9
[inventory]
10
[privilege_escalation]
11
[paramiko_connection]
12
[ssh_connection]
13
[persistent_connection]
14
[accelerate]
15
[selinux]
16
[colors]
17
[diff]
18

19
2)全局的主机清单
20
⚠️ '需要手动创建！'
21
root@m01 ~# cat /etc/ansible/hosts
22
10.0.0.113 ansible_ssh_user=root ansible_ssh_port=22 ansible_ssh_pass='1'
23
✅️ ping IP 是可以直接通的
24
root@m01 ~# ansible 10.0.0.113 -m ping
25
10.0.0.113 | SUCCESS => {
26
    "changed": false,
27
    "ping": "pong"
28
}
29

30
3)只有主机名这次
31
'无非是IP换为了主机名' --> 需配合/etc/hosts使用
32
root@m01 ~# vim /etc/ansible/hosts
33
node1 ansible_ssh_user=root ansible_ssh_port=22 ansible_ssh_pass='1'
34
node2 ansible_ssh_user=root ansible_ssh_port=22 ansible_ssh_pass='1'
35
node3 ansible_ssh_user=root ansible_ssh_port=22 ansible_ssh_pass='1'
36
root@m01 ~# ansible node3 -m ping
37
node3 | SUCCESS => {
38
    "changed": false,
39
    "ping": "pong"
40
}
41
root@m01 ~# ansible node3 -a id
42
node3 | CHANGED | rc=0 >>
43
uid=0(root) gid=0(root) groups=0(root)
44

45
4)创建sudo权限文件
46
root@m01 ~# tail -1 /etc/sudoers
47
@includedir /etc/sudoers.d
48
root@m01 ~# echo 'test  ALL=(ALL)  NOPASSWD:ALL' > /etc/sudoers.d/test
49
root@m01 ~# cat /etc/sudoers.d/test
50
test  ALL=(ALL)  NOPASSWD:ALL
51
'不需要在本地创建test用户 --> node节点创建'
52
# 用来后续的文件分发
53

54
5)node节点创建test用户
55
[root@node1 ~]# useradd test
56
[root@node1 ~]# echo "oldboy123" | passwd --stdin test
57
'其他两个节点重复'
58
✅️ 手动在node节点进行测试
59
[root@node1 ~]# echo 'test  ALL=(ALL)  NOPASSWD:ALL' > /etc/sudoers.d/test
60
[root@node1 ~]# su - test
61
Last failed login: Wed Jun 10 06:43:36 CST 2026 from 10.0.0.210 on ssh:notty
62
There was 1 failed login attempt since the last successful login.
63
[test@node1 ~]$ sudo -l
64
......................
65
    secure_path=/sbin\:/bin\:/usr/sbin\:/usr/bin
66
User test may run the following commands on node1:
67
    (ALL) NOPASSWD: ALL ✅️
68
[test@node1 ~]$ ls /root
69
ls: cannot open directory '/root': Permission denied
70
[test@node1 ~]$ ls /home
71
test
72
[test@node1 ~]$ sudo ls /root | wc -l
73
0  '使用sudo后可以正常访问'
74

75
6)免密登录
76
# master节点分发到node节点的test用户
77
root@m01 ~# ssh-keygen
78
root@m01 ~# ssh-copy-id test@node1
79
root@m01 ~# ssh-copy-id test@node2
80
root@m01 ~# ssh-copy-id test@node3
81
root@m01 ~# ssh test@node1 'ls /home/'
82
test
83
root@m01 ~# ssh test@node1 'ls /root/'
84
ls: cannot open directory '/root/': Permission denied
85
'权限不够' --> 拒绝
86
root@m01 ~# ssh test@node1 'sudo ls /root/ | wc -l'
87
0  '使用sudo后可以正常访问'
88

89
7)拷贝sudo配置文件至其他node节点
90
'node1我们刚才已经手动添加过了!'
91
root@m01 ~# scp /etc/sudoers.d/test node2:/etc/sudoers.d
92
root@node2's password:' ⚠️ 为什么还需要密码❓️
93
'我们只是对node节点的test用户实现免密登录, root用户依旧要使用密码'
94
test     100%   30    55.6KB/s   00:00
95
root@m01 ~# scp /etc/sudoers.d/test node3:/etc/sudoers.d
96
root@node3's password:'
97
test     100%   30    57.1KB/s   00:00
98

99
8)指定远程用户
100
root@m01 ~# grep node1 /etc/ansible/hosts
101
node1 ansible_ssh_user=root ansible_ssh_port=22 ansible_ssh_pass='1'
102
'我已经把root用户的密码输入在这里面了' --> 相当于对root免密登录
103
# 这是远程登录的是root用户
104
root@m01 ~# ansible node1 -a id
105
node1 | CHANGED | rc=0 >>
106
uid=0(root) gid=0(root) groups=0(root)
107
# 手动指定用户为test
108
root@m01 ~# cat > /etc/ansible/hosts <<EOF
109
node1 ansible_ssh_user=test
110
node2 ansible_ssh_user=test
111
node3 ansible_ssh_user=test
112
EOF
113
'做完免密可以不需要远程登录的密码了'
114
# 更换了远程登录用户为test
115
root@m01 ~# ansible node1 -a id
116
node1 | CHANGED | rc=0 >>
117
uid=1000(test) gid=1000(test) groups=1000(test)
118

119
9)远程能够执行的命令有限 --> 用户权限问题
120
root@m01 ~# ansible node1 -m shell -a 'ls /home/test | wc -l'
121
node1 | CHANGED | rc=0 >>
122
0
123
root@m01 ~# ansible node1 -m shell -a 'ls /root'
124
node1 | FAILED | rc=2 >>
125
ls: cannot open directory '/root': Permission denied
126
root@m01 ~# ansible node1 -m shell -a 'sudo ls /root | wc -l'
127
node1 | CHANGED | rc=0 >>
128
0 --> '加上sudo后可以正常访问'

展开收起

配置文件加载顺序#

Ansible 按以下优先级从高到低查找配置文件,找到第一个就用,后面的全忽略：

① ANSIBLE_CONFIG 环境变量（如果设置了的话）
② ./ansible.cfg（当前目录）
③ ~/.ansible.cfg（用户家目录）
④ /etc/ansible/ansible.cfg（全局默认）

Note

📌 规律：谁离项目近谁先用 —> 当前目录 > 家目录 > 全局默认,找到即停

项目级配置实战： 在当前目录放 ansible.cfg + inventory,覆盖全局配置

Terminal window

1
1)创建项目级 ansible.cfg
2
root@m01 ~# ansible --version | grep 'config file'
3
  config file = /etc/ansible/ansible.cfg
4
'当前走的是全局配置'
5
root@m01 ~# vim ansible.cfg

1
# /root/ansible.cfg — 项目级配置
2
[defaults]
3
inventory = ./inventory
4
interpreter_python = auto_silent
5
remote_user = test
6

7
[privilege_escalation]
8
become = true
9
become_method = sudo
10
become_user = root
11
become_ask_pass = false

配置项	所属区块	作用
`inventory = ./inventory`	`[defaults]`	指定主机清单路径,`./` 表示当前目录
`interpreter_python = auto_silent`	`[defaults]`	自动探测远程 Python 解释器,不打印警告
`remote_user = test`	`[defaults]`	SSH 连接远程主机时使用的默认用户
`become = true`	`[privilege_escalation]`	开启 sudo 提权
`become_method = sudo`	`[privilege_escalation]`	提权方式为 sudo
`become_user = root`	`[privilege_escalation]`	提权目标用户为 root
`become_ask_pass = false`	`[privilege_escalation]`	提权时不询问密码（需提前配置 NOPASSWD）

📌 简单说：用 test 用户连过去 → 自动 sudo 提权到 root → 不用输密码

Terminal window展开收起

1
root@m01 ~# ansible --version | grep 'config file'
2
  config file = /root/ansible.cfg
3
'当前目录的配置文件优先生效！全局的 /etc/ansible/ansible.cfg 被覆盖'
4

5
2)创建项目级 inventory
6
root@m01 ~# ansible node1 -a id
7
[WARNING]: provided hosts list is empty, only localhost is available
8
⚠️ 没有主机清单 --> 只有localhost可达
9
[WARNING]: Unable to parse /root/inventory as an inventory source
10
'因为我们指定了 inventory = ./inventory,但文件还不存在'
11
root@m01 ~# touch ./inventory
12
root@m01 ~# echo $(pwd)
13
/root
14
root@m01 ~# ls
15
ansible.cfg  inventory
16
✅️ 一个配置文件,一个主机清单
17
'全局的 /etc/ansible/ansible.cfg 和 /etc/ansible/hosts 不再生效'
18
# 对test用户做的免密是生效的
19

20
3)写入主机并验证
21
root@m01 ~# ansible node1 -a id
22
[WARNING]: Could not match supplied host pattern, ignoring: node1
23
'主机清单是空的,还没写内容'
24
root@m01 ~# echo 'node[1:3]' > ./inventory
25
root@m01 ~# cat ./inventory
26
node[1:3]
27
'node[1:3] 展开为 node1 node2 node3'
28
root@m01 ~# ansible node1 -a id
29
node1 | CHANGED | rc=0 >>
30
uid=0(root) gid=0(root) groups=0(root)
31
'remote_user=test 但 become=true 提权为 root,所以 uid=0'
32
root@m01 ~# ansible node1 -m shell -a 'ls /root | wc -l'
33
node1 | CHANGED | rc=0 >>
34
0
35
✅️ sudo 提权生效,/root 目录可访问

展开收起

Tip

命令行 -i 指定的清单优先级 > ansible.cfg 中定义的清单,多个 -i 可合并多个清单来源
ansible-inventory —list 查看清单结构

Terminal window展开收起

1
1)排查思路
2
root@m01 ~# ls
3
ansible.cfg  inventory
4
root@m01 ~# cat inventory
5
node[1:3]
6
root@m01 ~# ansible --version | grep 'config file'
7
  config file = /root/ansible.cfg
8
root@m01 ~# cat ./ansible.cfg | grep inventory
9
inventory = ./inventory
10
✅️ 配置文件中的主机清单就是这个
11
✅ '先确定配置文件 --> 再找对应的主机清单'
12

13
2)查看清单结构
14
root@m01 ~# ansible-inventory --list
15
#  查看的就是上面的主机清单
16
{
17
    "_meta": {
18
    📌 内部的元数据 ✅️
19
    # 记录每台主机绑了什么变量、用的什么解析方式
20
        "hostvars": {},
21
        "profile": "inventory_legacy"
22
    },
23
    "all": {
24
        "children": [
25
            "ungrouped"
26
        ]
27
    },
28
    "ungrouped": {
29
        "hosts": [
30
            "node1",
31
            "node2",
32
            "node3"
33
        ]
34
    }
35
}

展开收起

Tip

Ansible 有两个内置组,不用定义就存在：

组名	包含
`all`	清单中所有主机
`ungrouped`	没有分到任何组的主机

Terminal window展开收起

1
3)改名字
2
# 清单以.ini结尾(有语法高亮)
3
'我们就是以ini格式书写的主机清单'
4
root@m01 ~# mv ./inventory ./inventory.ini
5
root@m01 ~# ansible-inventory --list
6
[WARNING]: Unable to parse /root/inventory as an inventory source
7
✅️ 因为我们改名字了 --> 但是配置文件中的主机清单依旧是它'原来的'
8
root@m01 ~# ansible-inventory --list -i inventory.ini
9
✅️ -i 指定一下就可以了
10
{  .....xxxx
11
    "ungrouped": {
12
        "hosts": [
13
            "node1",
14
            "node2",
15
            "node3"
16
        ]
17
    }
18
}

展开收起

命令行实现#

file模块#

Terminal window展开收起

1
[root@m01 ~]# cat /etc/ansible/hosts
2
web0[1:3]
3
lb01
4
backup
5
==================================
6
[root@m01 ~]# ssh web01 "> /etc/issue"
7
'会有一些没用的登录信息！'
8
Authorized users only. All activities may be monitored and reported.
9
[root@m01 ~]# ssh web01 "> /etc/issue.net"
10

11
Authorized users only. All activities may be monitored and reported.
12
# 把这两个文件都清空！
13
[root@m01 ~]# ssh web01 "hostname -I"
14
10.0.0.7 172.16.1.7
15
'现在就干干净净的了！'
16

17
（1）创建一个空文件
18
    path: /path/to/myfile.txt
19
    state: touch
20
    owner: www
21
    group: www
22
    mode: '0644'
23
# 类似于 Linux 中的 touch 命令
24
# 如果文件不存在则创建；若存在,则更新其时间戳
25
[root@m01 ~]# ssh web01 "id www"
26
uid=666(www) gid=666(www) groups=666(www)
27
[root@m01 ~]# ansible web01 -m file -a 'path=/server/jiu.txt state=touch mode=0600 owner=www group=www'
28
-m：指定模块file
29
-a：向模块传递参数
30
'创建文件的同时指定权限、属主、属组'
31
web01 | CHANGED => {
32
    "changed": true,
33
    "dest": "/server/jiu.txt",
34
    "gid": 666,
35
    "group": "www",
36
    "mode": "0600",
37
    "owner": "www",
38
    "size": 0,
39
    "state": "file",
40
    "uid": 666
41
}# www用户的uid和gid都是666
42
'假如发现自己mode权限改错了！'又如何修改呢❓️
43
[root@m01 ~]# ansible web01 -m file -a 'path=/server/jiu.txt mode=0644 owner=root group=root'
44
'无非少写一个选项！state'
45
# 我们不创建它touch,就是单纯修改权限和属主
46
[root@m01 ~]# ssh web01 "ls -lh /server/jiu.txt"
47
-rw-r--r-- 1 root root 0 Mar 28 09:10 /server/jiu.txt
48
==================================
49
对于Ansible 的 file 模块,只要你不加 state: absent（删除）
50
✅️'文件里的数据就是安全的'
51
file模块 执行时,逻辑是这样的：
52
1)检查目标：
53
它首先会去服务器上找 /server/jiu.txt 这个文件
54
2)对比状态：
55
🈶如果文件存在：它会对比当前的权限/属主和你要求的是否一致。
56
  如果不一致,它只运行 '类似' Linux 下的 chmod 和 chown 命令
57
  这两个命令只修改元数据,不动文件内容
58
🈚如果文件不存在：
59
  如果你没写 state 选项（默认是 file）：Ansible 会报错,❌️提示文件不存在,什么都不会做
60
  如果你写了 state: touch：它会创建一个空文件（这时候内容才会变空）
61
==================================
62

63
（2）创建目录
64
    path: /path/to/mydir
65
    state: directory
66
    owner: www
67
    group: www
68
    mode: '0755'
69
💡无非是'state'由touch ---》directory
70
[root@m01 ~]# ansible web01 -m file -a 'path=/server/dire state=directory  mode=0755 owner=www group=www'
71
# 创建目录的同时,指定权限、属主、属组
72
web01 | CHANGED => {
73
    "changed": true,
74
    "gid": 666,
75
    "group": "www",
76
    "mode": "0755",
77
    "owner": "www",
78
    "path": "/server/dire",
79
    "size": 6,
80
    "state": "directory",
81
    "uid": 666
82
}
83
[root@m01 ~]# ssh web01 "ls -ld /server/dire"
84
drwxr-xr-x 2 www www 6 Mar 28 09:35 /server/dire
85
# 权限、属主、属组都对得上
86
✅️'我们ssh免密是用的root用户'
87
# 如果不写属主、属组、mode是有默认值的
88
# root:root 0644\0755
89
 1)如何修改目录的属性❓️
90
'如果目录不存在则创建；若已存在,则只修改其属性（如权限、属主等）'
91
# 依旧使用state ---》directory
92
[root@m01 ~]# ansible web01 -m file -a 'path=/server/dire state=directory  mode=0511 owner=root group=root'
93
web01 | CHANGED => {....
94
[root@m01 ~]# ssh web01 "ls -ld /server/dire"
95
dr-x--x--x 2 root root 6 Mar 28 09:35 /server/dire
96
# 依旧是那个目录,只不过属性变了！
97
2)如何递归修改目录及其下文件的属性❓️
98
recurse: yes ---》相当于( chmod chown)  -R 选项！
99
# 我们用ansible在/server/dire/这个目录下创建点文件！
100
ansible web01 -m file -a 'path=/server/dire/1.txt state=touch mode=0600 owner=www group=www'
101
ansible web01 -m file -a 'path=/server/dire/2.txt state=touch mode=0644 owner=nobody group=nobody'
102
[root@m01 ~]# ssh web01 "ls -ld /server/dire"
103
dr-x--x--x 2 root root 32 Mar 28 09:53 /server/dire
104
# 0511
105
[root@m01 ~]# ssh web01 "ls -ls /server/dire"
106
total 0
107
0 -rw------- 1 www    www    0 Mar 28 09:52 1.txt
108
0 -rw-r--r-- 1 nobody nobody 0 Mar 28 09:53 2.txt
109
# 0600、0644
110
[root@m01 ~]# ansible web01 -m file -a 'path=/server/dire state=directory recurse=yes mode=0755 owner=root group=root'
111
'目录及下面的文件的属性都修改为0755,root:root'
112
[root@m01 ~]# ssh web01 "ls -ld /server/dire"
113
drwxr-xr-x 2 root root 32 Mar 28 09:53 /server/dire
114
[root@m01 ~]# ssh web01 "ls -ls /server/dire"
115
total 0
116
0 -rwxr-xr-x 1 root root 0 Mar 28 09:52 1.txt
117
0 -rwxr-xr-x 1 root root 0 Mar 28 09:53 2.txt
118
🧱但我们通常递归修改目录及下文件的属主和属组
119
# chown -R www:www
120
# mod权限,⚠️目录和文件不会设置一样的！
121

122
（3）删除文件或目录
123
    path: /path/to/unwanted_file.txt
124
    state: absent
125
# path+state,这个简单！
126
[root@m01 ~]# ansible web01 -m file -a "path=/server/dire/1.txt state=absent"
127
web01 | CHANGED => {
128
    "changed": true,
129
    "path": "/server/dire/1.txt",
130
    "state": "absent"
131
}
132
[root@m01 ~]# ssh web01 "ls -lh /server/dire/1.txt"
133
ls: cannot access '/server/dire/1.txt': No such file or directory
134
'目录也是一样的！'
135
[root@m01 ~]# ansible web01 -m file -a "path=/server/dire state=absent"
136
[root@m01 ~]# ssh web01 "ls -d /server/dire"
137
ls: cannot access '/server/dire': No such file or directory
138

139
（4）创建软链接
140
    src: /path/to/target
141
    dest: /path/to/symlink
142
    state: link
143
# 可以是目录也可以是文件！
144
[root@m01 ~]# ansible web01 -m file -a "src=/server/tmp state=link dest=/home/link_tmp"
145
web01 | CHANGED => {
146
    "changed": true,
147
    "dest": "/home/link_tmp",
148
....
149
# 像属主、属组、mode权限、在链接之前就应该修改好！
150
    "src": "/server/tmp",
151
    "state": "link",
152
}
153
[root@m01 ~]# ssh web01 "ls -ld /home/link_tmp"
154
lrwx... 1 root root.../home/link_tmp -> /server/tmp

展开收起

group & user模块#

Terminal window展开收起

1
group:
2
   name: test      # 定义小组的名称
3
   gid: 777        # 小组的gid号
4

5
1)创建test组
6
# 同时指定组名和组id
7
[root@m01 ~]# ansible web01 -m group -a "name=test gid=777"
8
web01 | CHANGED => {
9
    "changed": true,
10
    "gid": 777,
11
    "name": "test",
12
    "state": "present",
13
    "system": false
14
}
15
⚠️我们创建组的时候没有用state,因为他默认就是present创建
16
# 下面创建用户也是,✅️默认state就是创建！
17
[root@m01 ~]# ssh web01 "tail -1 /etc/group"
18
test❌777:
19
==================================
20
user:
21
   name: test      # 定义用户名
22
   uid: 777
23
   group: test     # 组名or组ID
24
   state: present  # 创建
25
         absent   # 删除用户
26
   remove: yes     # 删除家目录 类似userdel -r 参数
27
   shell: /sbin/nologin
28
          /bin/bash
29
   create_home: true
30
           false
31
# Unsupported ... for (user) module: gid
32
⚠️没有gid这个选项！
33
'但是可以group=组ID'
34
✅️写组名也是可以的！
35

36
1)创建test虚拟用户
37
[root@m01 ~]# ansible web01 -m user -a "group=777 uid=777 state=present shell=/sbin/nologin create_home=false name=test"
38
'✅️这个state可以省略,默认就是创建！'
39
web01 | CHANGED => {
40
    "changed": true,
41
    "comment": "",
42
    "create_home": false,
43
    "group": 777,
44
    "home": "/home/test",
45
    "name": "test",
46
    "shell": "/sbin/nologin",
47
    "state": "present",
48
    "system": false,
49
    "uid": 777
50
}
51
[root@m01 ~]# ssh web01 "id test"
52
uid=777(test) gid=777(test) groups=777(test)
53

54
2)删除test用户
55
[root@m01 ~]# ansible web01 -m user  -a "state=absent name=test remove=yes"
56
[root@m01 ~]# ssh web01 "id test"
57
id: ‘test’: no such user
58
[root@m01 ~]# ssh web01 "tail /etc/group | grep test"
59
[root@m01 ~]# ssh web01 "tail -1 /etc/group"
60
mysql❌27:
61
'我们在删除用户的时候,会把对应的组也给删除了！'
62

63
3)创建普通用户jiu
64
[root@m01 ~]# ansible web01 -m user -a "name=jiu"
65
web01 | CHANGED => {
66
    "changed": true,
67
    "comment": "",
68
    "create_home": true,
69
    "group": 1001,
70
    "home": "/home/jiu",
71
    "name": "jiu",
72
    "shell": "/bin/bash",
73
    "state": "present",
74
    "system": false,
75
    "uid": 1001
76
}
77
# 默认状态就是present创建
78
# 自动创建组、家目录、可以登录...
79
[root@m01 ~]# ssh web01 "id jiu"
80
uid=1001(jiu) gid=1001(jiu) groups=1001(jiu)
81
[root@m01 ~]# ssh web01 "ls -d /home/jiu"
82
/home/jiu
83
[root@m01 ~]# ansible web01 -m user -a "state=absent remove=yes name=jiu"
84
[root@m01 ~]# ssh web01 "id jiu"
85
id: ‘jiu’: no such user

展开收起

yum & systemd模块#

Terminal window展开收起

1
yum:
2
  name: wget    # 服务、命令名称
3
        xxx.rpm # 也可以是本地的rpm包
4
  state: present  # 安装
5
       absent   # 卸载
6
  download_only: true  # 只下载不安装
7
  download_dir: /opt   # 下载到哪个目录
8

9
1)卸载wget
10
[root@m01 ~]# ssh web01 "rpm -qa wget"
11
wget-1.20.3-6.ky10.x86_64
12
[root@m01 ~]# ansible web01 -m yum -a "name=wget state=absent"
13
web01 | CHANGED => {
14
    "ansible_facts": {
15
        "pkg_mgr": "dnf"
16
    },
17
    "changed": true,
18
    "msg": "",
19
    "rc": 0,
20
    "results": [
21
        "Removed: wget-1.20.3-6.ky10.x86_64"
22
    ]
23
}
24
[root@m01 ~]# ssh web01 "rpm -qa wget"
25
# 没有这个包了！
26

27
2)安装wget
28
[root@m01 ~]# ansible web01 -m yum -a "name=wget state=present"
29
"Installed: wget-1.20.3-6.ky10.x86_64"
30
[root@m01 ~]# ssh web01 "rpm -qa wget"
31
wget-1.20.3-6.ky10.x86_64
32
==================================
33
systemd:
34
   name: nginx      # 服务名称
35
   state: started   # 启动服务
36
       stopped   # 停止服务
37
       restarted # 重启服务
38
       reloaded  # 重新加载
39
   enabled: yes     # 开机自动启动
40
            no       # 开机禁止运行
41
   '这个no就是disabled'🈲禁止开机自启动
42
[root@m01 ~]# ssh web01 "systemctl is-active nginx"
43
active
44
# 查看Nginx的状态！是否活跃
45

46
1)关闭服务
47
[root@m01 ~]# ansible web01 -m systemd -a "name=nginx state=stopped"
48
⚠️是stopped
49
web01 | CHANGED => {
50
    "changed": true,
51
    "name": "nginx",
52
    "state": "stopped",
53
    ......
54
# 把它关闭了！
55
[root@m01 ~]# ssh web01 "systemctl is-active nginx"
56
inactive
57
# 就是关闭了的！
58

59
2)启动&开机自启
60
[root@m01 ~]# ansible web01 -m systemd -a "name=nginx state=started enabled=yes"
61
web01 | CHANGED => {
62
    "changed": true,
63
    "name": "nginx",
64
    "state": "started",
65
[root@m01 ~]# ssh web01 "systemctl is-active nginx"
66
active
67
[root@m01 ~]# ssh web01 "systemctl is-enabled nginx"
68
enabled

展开收起

command模块#

Ansible 的 command 模块不支持 Shell 的管道符（|）

shell 模块会通过系统的 /bin/sh 来执行命令,因此它完全支持管道、重定向等 Shell 特性
|、>、< 等操作不能直接依赖 command 模块完成
你只需要将 command 替换为 shell 即可

Terminal window展开收起

1
❌️不建议使用command和shell
2
违背了 Ansible 的设计哲学、只有在万不得已的情况下使用✅️
3
💡-m command -a "只读、无副作用的命令"
4
hostname -I
5
free -h
6
df -h
7
uptime
8
.......
9
[root@m01 ~]# ansible web01 -m command -a 'hostname -I'
10
web01 | CHANGED | rc=0 >>
11
10.0.0.7 172.16.1.7
12
[root@m01 ~]# ansible web01 -m command -a 'uptime'
13
web01 | CHANGED | rc=0 >>
14
 14:34:14 up  6:12,  2 users,  load average: 0.00, 0.00, 0.00
15
==================================
16
它只看到命令返回码是0,就认为“成功”.....
17
# 无法感知状态变化！

展开收起

copy模块#

Terminal window展开收起

1
copy:
2
   src: a.txt   # 源文件
3
   dest: /root/ # 目标路径
4
   owner: www   # 属主
5
   group: www   # 文件属组
6
   mode: 0644   # 文件权限
7
   backup: yes  # 拷贝前是否需要备份
8
   content: 字符串 # 将content后面的内容写入到目标文件
9
'不仅可以拷贝,还可以现创建文件touch,并写入一段内容！'
10
==================================
11
1)拷贝hosts文件
12
[root@m01 ~]# ansible web01 -m copy -a "src=/etc/hosts dest=/home/the_hosts"
13
⚠️复制到/home目录并重命名！
14
# 没有设置权限、属主、属组...
15
✅️'在下面我们也可以清晰的观察到'
16
web01 | CHANGED => {
17
    "changed": true,
18
    "checksum": "ecf730686d9142019bdb34d4c8a67ee7e0bcc63d",
19
    "dest": "⚠️/home/the_hosts",
20
    "gid": 0,
21
    "group": "root",
22
    "md5sum": "90802db3d7cda085cf31d7e479886858",
23
    "mode": "0644",
24
    "owner": "root",
25
    "size": 363,
26
    "src": "/root/.ansible/tmp/ansible-tmp-1774682652.0671225-4390-83497777325810/source",
27
    "state": "file",
28
    "uid": 0
29
}
30
[root@m01 ~]# ssh web01 "ls /home/the_hosts"
31
/home/the_hosts
32
[root@m01 ~]# ssh web01 "tail -1 /home/the_hosts"
33
172.16.1.81 m01
34
[root@m01 ~]# ansible web01 -m copy -a "src=/etc/hosts dest=/home/ owner=www group=www mode=600"
35
⚠️仅复制到/home目录
36
web01 | CHANGED => {
37
    "changed": true,
38
    "checksum": "ecf730686d9142019bdb34d4c8a67ee7e0bcc63d",
39
    "dest": "⚠️/home/hosts",
40
    "gid": 666,
41
    "✅️group": "www",
42
    "md5sum": "90802db3d7cda085cf31d7e479886858",
43
    "✅️mode": "0600",
44
    "✅️owner": "www",
45
    "size": 363,
46
    "src": "/root/.ansible/tmp/ansible-tmp-1774683020.2063756-4447-276209329430854/source",
47
    "state": "file",
48
    "uid": 666
49
}
50
[root@m01 ~]# ssh web01 "ls -lh /home/hosts"
51
-rw------- 1 www www 363 Mar 28 15:30 /home/hosts
52

53
2)如果目标主机有,进行备份！
54
[root@m01 ~]# ssh web01 "cat /home/hosts" | wc -l
55
14
56
# 本来就有,共14条记录！
57
[root@m01 ~]# echo 192.168.219.128 Centos-7 > ./hosts
58
[root@m01 ~]# cat ./hosts
59
192.168.219.128 Centos-7
60
[root@m01 ~]# ansible web01 -m copy -a "src=./hosts dest=/home backup=yes"
61
# 还是把hosts文件拷贝到/home目录下
62
web01 | CHANGED => {
63
    "✅️backup_file": "/home/hosts.18160.2026-03-28@15:39:50~",
64
    "changed": true,
65
    "checksum": "a7522db1bc78f77c4ac136aa064712d8fafd4e82",
66
    "🐷dest": "/home/hosts",
67
    "gid": 666,
68
    "⚠️group": "www",
69
    "md5sum": "463094b6a3f5b92504dcd83e64854ffa",
70
    "⚠️mode": "0600",
71
    "⚠️owner": "www",
72
[root@m01 ~]# ssh web01 "cat /home/hosts"
73
192.168.219.128 Centos-7
74
# 拷贝过去的文件！
75
# 我拷贝过去的时候并没有指定属主,权限！
76
'保留了原文件的权限！'
77
[root@m01 ~]# ssh web01 "ls -lh /home/hosts*"
78
-rw------- 1 www www  25 Mar 28 15:39 /home/hosts
79
-rw------- 1 www www 363 Mar 28 15:30 /home/hosts.2026-03-28@15:39:50~
80
# 第二个是备份文件
81
[root@m01 ~]# ssh web01 "cat /home/hosts.18160.2026-03-28@15:39:50~ |wc -l"
82
14
83
# 备份文件依旧是14条记录📝
84

85
3)指定字符串写入到目标主机！
86
# content=“指定字符串”
87
⚠️'没有src了 --> 取而代之的是content'
88
[root@m01 ~]# ansible web01  -m copy -a "content='Hello World' dest=/home/my_passwd mode=600"
89
# 将字符串写入到目标主机！
90
'后期可以生成rsync的密码文件'
91
content=rsync_backup:123
92
# 虽然没有指定属主和属组
93
# 但从下面的显示我们能看出来是root
94
web01 | CHANGED => {
95
    "changed": true,
96
    "checksum": "0a4d55a8d778e5022fab701977c5d840bbc486d0",
97
    "dest": "/home/my_passwd",
98
    "gid": 0,
99
    "group": "root",
100
    "md5sum": "b10a8db164e0754105b7a99be72e3fe5",
101
    "mode": "0600",
102
    "owner": "root"
103
[root@m01 ~]# ssh web01 "ls -lh /home/my_passwd"
104
-rw------- 1 root root 11 Mar 28 15:55 /home/my_passwd
105
[root@m01 ~]# ssh web01 "cat /home/my_passwd"
106
Hello World

展开收起

cron模块#

Terminal window展开收起

1
cron:
2
   name: # 定时任务的名字
3
   user：# 该定时任务属于哪个用户
4
   'user可省略,免密登录的就是root'
5
   minute: 1-59 # 分钟
6
   hour:  0-23  # 小时
7
   day\month\weekday：#具体参考定时任务
8
   job:  # 具体执行的命令
9
   state： # present（默认就是它）
10
          # absent（删除定时任务）
11
'cron 模块用于在远程主机上管理用户的定时任务（crontab）'
12
[root@m01 ~]# ssh web01 "crontab -l"
13
no crontab for root
14
# 我们远程登录的是root,查看的自然是root的定时任务
15
==================================
16

17
1)打印当前时间并写入文件
18
[root@m01 ~]# date +"%F_%H:%M"
19
2026-03-28_17:06
20
[root@m01 ~]# ansible web01 -m cron -a "name=w_da user=root minute=*/1 job='date +"\%F_\%H:\%M" >/home/date.txt'"
21
# root可以省略！
22
web01 | CHANGED => {
23
    "changed": true,
24
    "envs": [],
25
    "jobs": [
26
        "w_da"
27
    ]
28
}
29
[root@m01 ~]# ssh web01 "crontab -l"
30
#Ansible: w_da
31
*/1 * * * * date +%F_%H:%M >/home/date.txt
32
'明显是有问题的,定时任务不识别%需要加撬棍！'
33
# 但我明明加的有,没有生效,那我们再加一个！
34
[root@m01 ~]# ansible web01 -m cron -a "name=w_da minute=*/1 job='date +"\\%F_\\%H:\\%M" >/home/date.txt'"
35
web01 | CHANGED => {
36
    "changed": true,
37
    "envs": [],
38
    "jobs": [
39
        "w_da"
40
    ]
41
}
42
[root@m01 ~]# ssh web01 "crontab -l"
43
#Ansible: w_da
44
*/1 * * * * date +\%F_\%H:\%M >/home/date.txt
45
# 这次加上了！
46
[root@m01 ~]# ssh web01 "ls /home/date.txt"
47
ls: cannot access '/home/date.txt': No such file or directory
48
[root@m01 ~]# ssh web01 "ls /home/date.txt"
49
/home/date.txt
50
[root@m01 ~]# ssh web01 "cat /home/date.txt"
51
2026-03-28_17:21
52

53
2)实时同步任务
54
# 每分钟执行1次
55
[root@m01 ~]# ansible webs -m cron -a 'name=时间同步 minute=* hour=* job="ntpdate ntp1.aliyun.com &>/dev/null"'
56
[root@m01 ~]# ssh web01 "crontab -l"
57
#Ansible: w_da
58
*/1 * * * * date +\%F_\%H:\%M >/home/date.txt
59
#Ansible: 时间同步
60
*/1 * * * * ntpdate ntp1.aliyun.com &>/dev/null
61
==================================
62
🌰每间隔2小时执行一次命令
63
00 */2 * * *
64
🌰每天凌晨4点执行
65
00 04 * * *
66
🌰每月1号凌晨4点执行
67
00 04 01 * *
68
'更详细的请参考定时任务'
69
[root@m01 ~]# ansible webs -m cron -a 'name=时间同步 minute=00 hour=04 day=01 job="date >/dev/null"'
70
[root@m01 ~]# ssh web01 "crontab -l"
71
#Ansible: 时间同步
72
00 04 01 * * date >/dev/null
73
==================================
74

75
3)删除定时任务
76
[root@m01 ~]# ansible web01 -m cron -a "name=时间同步 state=absent"
77
web01 | CHANGED => {
78
    "changed": true
79
[root@m01 ~]# ssh web01 "crontab -l |wc -l"
80
0

展开收起

setup模块#

Terminal window展开收起

1
ansible web01(主机) -m setup
2
# 它的主要作用是收集 目标主机 的各种系统信息
3
'收集包括操作系统、硬件配置、网络设置、已安装的软件包等详细信息'
4
# ✅️并以 JSON 格式返回
5
==================================
6
😭默认会返回海量的信息
7
[root@m01 ~]# ansible web01 -m setup
8
web01 | SUCCESS => {
9
    "ansible_facts": {
10
        "ansible_all_ipv4_addresses": [
11
            "10.0.0.7",
12
            "172.16.1.7"
13
        ],
14
        "ansible_architecture": "x86_64",
15
# 为了高效地获取特定信息
16
# 通常会配合 -a "filter=..." 参数使用
17
# 通过通配符来筛选出所关心的信息
18
'通配符 * '
19

20
1)列出主机的所有 IPv4 地址
21
[root@m01 ~]# ansible web01 -m setup -a "filter=ansible_all_ipv4_addresses"
22
web01 | SUCCESS => {
23
    "ansible_facts": {
24
        "ansible_all_ipv4_addresses": [
25
            "10.0.0.7",
26
            "172.16.1.7"
27
        ]
28
    },
29
    "changed": false
30
}
31
==================================
32
⚠️ 下面这个也是IP地址 --> '但信息更全'
33
root@m01 ~# ansible all -m setup -a "filter=ansible_default_ipv4"
34
node2 | SUCCESS => {
35
    "ansible_facts": {
36
        "ansible_default_ipv4": {
37
            "address": "192.168.122.102",
38
            "alias": "ens1",
39
            "broadcast": "192.168.122.255",
40
            "gateway": "192.168.122.1",
41
            "interface": "ens1",
42
            "macaddress": "52:54:00:0c:8f:a3",
43
            "mtu": 1500,
44
            "netmask": "255.255.255.0",
45
            "network": "192.168.122.0",
46
            "prefix": "24",
47
            "type": "ether"
48
        },
49
        "discovered_interpreter_python": "/usr/bin/python3.12"
50
    },
51
    "changed": false
52
}
53

54

55
2)获取主机名
56
[root@m01 ~]# ansible web01 -m setup -a "filter=ansible_hostname"
57
web01 | SUCCESS => {
58
    "ansible_facts": {
59
        "ansible_hostname": "web01"
60
    },
61
    "changed": false
62
}
63

64
3)获取CPU核心数
65
[root@m01 ~]# ansible web01 -m setup -a "filter=ansible_processor_vcpus"
66
web01 | SUCCESS => {
67
    "ansible_facts": {
68
        "ansible_processor_vcpus": 1
69
    },
70
    "changed": false
71
}
72

73
4)获取总内存大小
74
[root@m01 ~]# ansible web01 -m setup -a "filter=ansible_memtotal_mb"
75
web01 | SUCCESS => {
76
    "ansible_facts": {
77
        "ansible_memtotal_mb": 948
78
        # 返回主机的总内存容量,单位为 MB
79
    },
80
    "changed": false
81
}
82
==================================
83
⚠️ 下面这个是详细内存大小
84
root@m01 ~# ansible all -m setup -a "filter=ansible_memory_mb"
85
node2 | SUCCESS => {
86
    "ansible_facts": {
87
        "ansible_memory_mb": {
88
            "nocache": {
89
                "free": 1809,
90
                "used": 151
91
            },
92
            "real": {
93
                "free": 1660,
94
                "total": 1960,
95
                "used": 300
96
            },
97
            "swap": {
98
                "cached": 0,
99
                "free": 2047,
100
                "total": 2047,
101
                "used": 0
102
            }
103
        },
104
        "discovered_interpreter_python": "/usr/bin/python3.12"
105
    },
106
    "changed": false
107
}
108

109

110
5)获取所有eth0网卡的信息.
111
[root@m01 ~]# ansible web01 -m setup -a "filter=ansible_eth0"
112
web01 | SUCCESS => {
113
    "ansible_facts": {
114
        "ansible_eth0": {
115
            "active": true
116
            "ipv4": {
117
                "address": "10.0.0.7",
118
                "broadcast": "10.0.0.255",
119
                "netmask": "255.255.255.0",
120
                "network": "10.0.0.0",
121
                "prefix": "24"
122
            }
123
            .......
124

125
6)获取操作系统发行版信息
126
[root@m01 ~]# ansible web01 -m setup -a "filter=ansible_distribution*"
127
web01 | SUCCESS => {
128
    "ansible_facts": {
129
        "ansible_distribution": "Kylin Linux Advanced Server",
130
        "ansible_distribution_file_parsed": true,
131
        "ansible_distribution_file_path": "/etc/os-release",
132
        "ansible_distribution_file_variety": "NA",
133
        "ansible_distribution_major_version": "V10",
134
        "ansible_distribution_release": "Lance",
135
        "ansible_distribution_version": "V10"
136
    },
137
    "changed": false
138
}

展开收起

扩展模块#

lineinfile模块#

Terminal window展开收起

1
'只修改特定行,而不会破坏文件的其他内容'
2
✅ 核心逻辑是：在目标文件中查找匹配的行,如果存在则替换,如果不存在则添加
3
path: 指定要修改的文件路径
4
regexp: 用于匹配文件中现有行的正则表达式
5
regexp='.*old_config.*'：匹配到包含old_config的行
6
line: 你希望文件中最终存在的那一行内容
7
state: present（创建行、默认）或 absent（删除行）
8
insertafter=EOF：显式指定插入文件末尾
9
'它后面也可以跟正则表达式！'
10
insertafter='^Match'：在以Match开头的行,下面插入
11
✅️用单引号把正则表达式括起来!✅️
12
==================================
13
# 环境准备
14
[root@m01 ~]# ansible web01 -m file -a "path=/home/test.txt state=touch"
15
'在创建的时候规划好,权限、属组'
16
web01 | CHANGED => {
17
    "changed": true,
18
    "dest": "/home/test.txt",
19
    "gid": 0,
20
    "group": "root",
21
    "mode": "0644",
22
    "owner": "root",
23
    "size": 0,
24
    "state": "file",
25
    "uid": 0
26
}
27
[root@m01 ~]# ssh web01 "ls /home/test.txt"
28
/home/test.txt
29
# 创建这个文件！
30
[root@m01 ~]# ssh web01 "echo pip3.8 >/home/test.txt"
31
[root@m01 ~]# ssh web01 "echo install >>/home/test.txt"
32
[root@m01 ~]# ssh web01 "echo https >>/home/test.txt"
33
[root@m01 ~]# ssh web01 "cat /home/test.txt"
34
pip3.8
35
install
36
https
37
# 往里面写点东西！！
38

39
1)在文件末尾写入Hello World
40
'添加指定行'
41
[root@m01 ~]# ansible web01 -m lineinfile -a "path=/home/test.txt line='Hello World' insertafter=EOF"
42
# 只需要三个参数：路径、最终那一行的内容、插入的位置
43
web01 | CHANGED => {
44
    "backup": "",
45
    "changed": true,
46
    "msg": "line added"
47
}
48
[root@m01 ~]# ssh web01 "cat /home/test.txt"
49
pip3.8
50
install
51
https
52
Hello World
53

54
2)在指定位置插入jiu
55
'添加指定行'
56
[root@m01 ~]# ansible web01 -m lineinfile -a "path=/home/test.txt line=jiu insertafter='^install'"
57
'在以install开头的行,下面插入一行！'
58
web01 | CHANGED => {
59
    "backup": "",
60
    "changed": true,
61
    "msg": "line added"
62
}
63
[root@m01 ~]# ssh web01 "cat /home/test.txt"
64
pip3.8
65
install
66
✅️jiu
67
https
68
Hello World
69

70
3)修改（替换）指定行
71
[root@m01 ~]# ansible web01 -m lineinfile -a "path=/home/test.txt regexp=^jiu line=shi"
72
# 先正则找到jiu,最后line换成指定行的内容
73
web01 | CHANGED => {
74
    "backup": "",
75
    "changed": true,
76
    "msg": "line replaced"
77
}
78
[root@m01 ~]# ssh web01 "cat /home/test.txt"
79
pip3.8
80
install
81
shi
82
https
83
Hello World
84

85
4)删除匹配到的行
86
# 用absent
87
[root@m01 ~]# ansible web01 -m lineinfile -a "path=/home/test.txt regexp=^https state=absent"
88
# 也是只需要三个参数：路径、regexp匹配行、absent删除行
89
web01 | CHANGED => {
90
    "backup": "",
91
    "changed": true,
92
    "found": 1,
93
    "msg": "1 line(s) removed"
94
}
95
[root@m01 ~]# ssh web01 "cat /home/test.txt"
96
pip3.8
97
install
98
shi
99
Hello World

展开收起

blockinfile模块#

Terminal window展开收起

1
'专门用来管理一大段配置块的'
2
path: 目标文件路径
3
# 目标文件得存在！！touch
4
block: 你要写入的那一大段内容
5
  在 Playbook 中通常用 | (管道符) 来定义多行文本
6
  在 命令行 中,通常需要用引号包裹,并用 \n 表示换行
7
marker: 标记行（可自定义）
8
  默认是 # {mark} ANSIBLE MANAGED BLOCK
9
  ⚠️这个标记行必须有！
10
  '自定义标记,参考下一篇笔记！📚'
11
state: present (创建块) 或 absent (删除块)
12
insertafter='^pip' 先正则匹配在插入block
13
'默认在文件末尾创建！'
14
✅️用单引号把正则表达式括起来!✅️
15
指定位置：'仅对“新块”有效'
16
第二次及以后,都是直接替换marker标记中的块
17
==================================
18
[root@m01 ~]# ssh web01 "cat /home/test.txt"
19
pip3.8
20
install
21
shi
22
Hello World
23
# 还是它
24

25
1)创建block（整段内容）
26
'默认在文件末尾创建！'
27
[root@m01 ~]# ansible web01 -m blockinfile -a "path=/home/test.txt block='01\n 02\n'"
28
# 中间有个空格！
29
web01 | CHANGED => {
30
    "changed": true,
31
    "msg": "Block inserted"
32
}
33
[root@m01 ~]# ssh web01 "cat /home/test.txt"
34
pip3.8
35
install
36
shi
37
Hello World
38
# BEGIN ANSIBLE MANAGED BLOCK
39
01
40
 02
41
# END ANSIBLE MANAGED BLOCK
42
'它把空格也写入进去了'
43

44
2)替换块
45
# 因为有标记marker（自动创建）
46
# 所以替换起来非常方便！
47
[root@m01 ~]# ansible web01 -m blockinfile -a "path=/home/test.txt block='new_01\nnew_02\n'"
48
'命令行敲起来容易搞混'
49
# 两个n,哪个用来换行❓️
50
web01 | CHANGED => {
51
    "changed": true,
52
    "msg": "Block inserted"
53
}
54
[root@m01 ~]# ssh web01 "cat /home/test.txt"
55
pip3.8
56
install
57
shi
58
Hello World
59
# BEGIN ANSIBLE MANAGED BLOCK
60
new_01
61
new_02
62
# END ANSIBLE MANAGED BLOCK
63

64
3)删除块
65
[root@m01 ~]# ansible web01 -m blockinfile -a "path=/home/test.txt state=absent"
66
# 只需要路径、absent删除;会根据marker标记寻找！
67
web01 | CHANGED => {
68
    "changed": true,
69
    "msg": "Block removed"
70
}
71
[root@m01 ~]# ssh web01 "cat /home/test.txt"
72
pip3.8
73
install
74
shi
75
Hello World
76

77
4)指定位置插入块
78
'仅对“新块”有效'
79
[root@m01 ~]# ansible web01 -m blockinfile -a "path=/home/test.txt insertafter=^pip block='new_01\nnew_02\n'"
80
'默认是在文件末尾！'
81
# 指定位置插入
82
web01 | CHANGED => {
83
    "changed": true,
84
    "msg": "Block inserted"
85
}
86
[root@m01 ~]# ssh web01 "cat /home/test.txt"
87
pip3.8
88
# BEGIN ANSIBLE MANAGED BLOCK
89
new_01
90
new_02
91
# END ANSIBLE MANAGED BLOCK
92
install
93
shi
94
Hello World

展开收起

Markdown常用语法

Tue, 12 May 2026 00:00:00 GMT

Markdown常用语法#

[TOC]

Markdown是一种简单而强大的标记语言,广泛用于写作、笔记和博客等领域

基本设置#

基本设置1

基本设置2

基本设置3

基本设置4

markdown中的图片和文字部分它是分开的

图片设置

图片路径

改完后,退出重启

①标题#

使用 # 符号表示标题,数量表示标题级别

Terminal window

1
# 标题一        快捷键ctrl+1
2
## 标题二        Ctrl+2
3
### 标题三       Ctrl+3

②代码块#

使用三个反引号（```）表示代码块

例如：

Terminal window

1
```sh   回车
2
```语言  回车

内联代码#

使用单个反引号（`）将文本标记为内联代码

Terminal window

1
这是一段包含`code`的文本。

输出：

这是一段包含code的文本

③列表#

使用 - 或 + 或 * 表示无序列表

Terminal window

1
- 无序列表项1
2
- 无序列表项2

输出：

无序列表项1
无序列表项2

使用数字和 . 表示有序列表

Terminal window

1
1. 有序列表项1
2
2. 有序列表项2

输出：

有序列表项1
有序列表项2

④表格#

使用 | 和 - 来创建表格

Terminal window

1
| 姓名   | 年龄 |
2
| ------ | ---- |
3
| 小明   | 20   |
4
| 小红   | 22   |

第一行表示表头
- 默认会进行加黑加粗
第二行用于分隔表头和主题部分
从第三行开始每一行代表一个表格行

输出：

姓名	年龄
小明	20
小红	22

可以看出来非常的冗余,有更好办法！

Ctrl + t#

快捷键来创建

✅ 记这一个就可以了

Ctrl+T

表格不够用：Ctrl+回车 添加
表格删除：右键表格

表格操作

⑤特殊的显示#

⭐快捷键#

[TOC]#

放置目录

TOC

回车后

TOC效果

:后跟英文#

各种小图标

Terminal window

1
:one
2
# 就会有相对应的图标

小图标

F11#

进入全屏模式

再次按F11退出这个模式

建议配合着F9打字机模式使用

让所编辑的部分一直处于中心

Ctrl + l#

这里是小l,不是i；Ctrl+i斜体

选中整行

Shift + 回车#

换小行

这个换行间距没有那么大

Shift+回车

换行效果

Ctrl + /#

斜线

进入源代码模式

源代码模式

再按一次退出

Ctrl + \#

撬棍（反斜线）

清除格式

清除格式1

清除格式2

命令#

1）斜体#

使用 * 将文本设置为斜体

Terminal window

1
这是*斜体文本*。
2
# 快捷键Ctrl + i

输出：

这是斜体文本

2）加粗#

使用 ** 将文本加粗

Terminal window

1
这是**加粗的文本**。
2
# 快捷键Ctrl + b

输出：

这是加粗的文本

3）引用#

使用 > 表示引用块

Terminal window

1
> 这是引用的文本。

输出：

这是引用的文本

4）超链接#

使用 [链接文本](链接地址) 表示链接

Terminal window

1
[Google](https://www.google.com)
2
# 快捷键Ctrl + k

输出：

Google

5）水平线#

使用三个或更多的连字符（-）或星号（*）创建水平线

Terminal window

1
---
2
***

输出：

6）高亮#

使用 == 将文本高亮

Terminal window

1
这是==高亮的文本==。

输出：

这是==高亮的文本==

7）任务列表#

使用 - [ ] 来插入任务列表

Terminal window

1
- [ ] 学习
2
# - 后面要有空格,刚开始识别为无序列表,没事继续往后写
3
# [ ] 中括号里面也是空格隔开
4
# 接着空格接文字

输出：

学习

下载优化#

1
之前我下载的版本是旧版的,正常写是没有什么问题的
2
只是导出pdf很卡,甚至是导出不了
3

4
但其实它的正版是买断制,89元。资金充裕的话可以支持一下
5
我翻的吾爱破解,找的无限免费使用的版本

主题优化#

【最美Markdown主题—Phycat-color发布！】https://www.bilibili.com/video/BV1CcBaBxExX

主题预览

下载链接：

Terminal window

1
https://cdn.gh-proxy.org/https://github.com/sumruler/typora-theme-phycat/releases/latest/download/typora-theme-phycat.zip

添加主题#

添加主题

把下载好的文件直接拖进去就好了

拖入文件

重启应用后生效,在主题框,就能找到对应的主题了

主题列表

导出html#

导出html

导出选项

YAML Frontmatter && Markdown 元数据

Wed, 06 May 2026 00:00:00 GMT

YAML Frontmatter && Markdown 元数据#

[TOC]

概述#

是什么#

Markdown 文件最开头用 --- 包裹的一段 YAML 格式数据,叫做 ==Frontmatter==（前置信息/元数据）

1
---
2
title: docker compose容器编排  # 标题
3
published: 2026-05-06
4
updated: 2026-05-06
5
description: 文章描述         # 描述
6
tags: [YAML, Frontmatter, 元数据]
7
category: 知识扩展
8
author: 久棹           # 作者
9
---

📌 注意：它不是 ```yaml 代码块！

Frontmatter 的 --- 是裸写的,直接放在文件第 1 行,前后不加反引号

格式规则#

规则	说明
位置	必须在文件最开头,第一行就是 `---`
分隔符	开头一个 `---`,结束一个 `---`
内容格式	标准 YAML 语法（键值对、列表、嵌套）
可选性	不是必须的,没有也行
⚠️ ==字符串==	大部分不用,但值含 : # & [ { 时必须加==双引号==

YAML 语法速查#

类型	写法	说明
字符串	`key: value`	==可以不加引号==
数字	`count: 42`	直接写
布尔	`draft: true`	true=草稿不发布 false=不是草稿
数组（行内）	`tags: [a, b, c]`	方括号
数组（多行）	`tags:\n(换行) - a\n - b`	缩进后紧跟 `-`

📌 推荐字段总结#

字段	说明
`title`	文章标题
`description`	SEO 描述,兼顾搜索引擎和文章摘要
`summary`	文章列表卡片上的简短导语(👆的足够了)
`date`	发布日期(创建)
`updated`	最后更新日期,区别于创建日期
`tags`	标签列表,用于检索和相关推荐
`category`	分类,用于文章归类
`badge`	文章角标（New / Hot / Beta）
`platform`	默认blog(博客平台)/Wechat(微信)
`author`	作者名
`cover`	封面图文件名,程序自动从图片目录读取
`articleId`	唯一标识,用于编辑时定位文件
`draft`	true=草稿不发布 false=不是草稿

badge 文章角标#

文章列表卡片上显示的状态小标签,不是标准字段,是自己和程序约定好的”暗号”

角标值	视觉效果	适用场景
`New`	🟢 绿色小标签	最近发布的新文章（通常 7 天内）
`Hot`	🔴 红色小标签	访问量高、读者关注的热门内容
`Top`	📌 置顶标记	长期挂在列表最前面的重要文章
`Featured`	⭐ 金色精选	编辑推荐的高质量内容
`Beta`	🟡 黄色小标签	内容还在完善中,仅供参考
`Updated`	🔵 蓝色小标签	旧文章有重大修订,提示读者回看

1
---
2
title: "docker stack 部署应用实战"
3
---

💡 角标本质就是你自己定义的分类标记,想加什么类型都可以,只要代码里对应处理就行

cover 封面的工作方式#

写图片的文件名即可：cover: counter-app-cover.png
程序读取后自动拼完整路径：./笔记名/counter-app-cover.png
也支持 CSS 渐变当纯色背景：cover: "linear-gradient(135deg, #667eea 0%, #764ba2 100%)"

1
---
2
title: "docker stack 部署应用实战"
3
image: "api"
4
# 封面图放在同目录的 笔记名/ 文件夹下,程序自动读取
5
---

articleId 文章唯一标识#

给每篇文章一个身份证号,跟文件名解耦

对比	靠文件名	靠 articleId
改名后编辑	❌ 找不到	✅ 仍能精准定位
文件移动目录	❌ 链接失效	✅ 不受影响
唯一性	可能重名	✅ UUID 全球唯一

1
---
2
title: "docker stack 部署应用实战"
3
---

新建文章时程序帮你生成一串 UUID（如 crypto.randomUUID()）,你不用手写

自建博客实例#

1
---
2
title: docker stack 部署应用实战
3
description: 在 Swarm 集群上使用 docker stack 部署 Flask + Redis 计数器应用
4
published: 2026-05-06
5
updated: 2026-05-06
6
tags: [YAML, Frontmatter, 元数据]
7
category: 知识扩展
8
author: 久棹
9
image: "api"
10
---

💡 这就是你以后搭博客时,Frontmatter 的最小可用集,每个 md 文件顶部写好这些,程序就能自动生成文章列表、标签页、搜索索引

💡 解惑#

这些元数据有什么用❓️

就像快递包裹上的快递单
不看包裹内容就能知道里面是什么、谁寄的、什么时候发的

中文值需要加引号吗❓️#

==大部分情况不需要==,但以下情况必须加引号：

场景	错误写法 ❌	正确写法 ✅
值含冒号 `:`	`title: Docker：入门`	`title: "Docker：入门"`
值含 `#`	`desc: 关于#标签的用法`	`desc: "关于#标签的用法"`
值以 `{` `[` 开头	`text: [重要] 通知`	`text: "[重要] 通知"`
值含 `&` `*` `!`	`title: 安装 & 配置`	`title: "安装 & 配置"`
纯数字值想当字符串	`id: 001`(变成数字1)	`id: "001"`

💡 保险做法：中文描述类字段（title、description、summary）一律加双引号,省心

description 和 summary 并存还是二选一❓️#

两个可以并存,各有分工：

字段	用途	长度建议
`description`	给搜索引擎看（SEO）,显示在搜索结果里	120-160 字符
`summary`	给读者看,显示在文章列表/卡片里	一句话,30-50 字

1
---
2
title: "docker stack 部署应用实战"
3
description: "在 Docker Swarm 集群上使用 docker stack 命令部署 Flask + Redis 计数器应用,涵盖镜像构建、私有仓库推送、滚动更新与 routing mesh 负载均衡"
4
---

如果只保留一个,优先用 description,它兼顾 SEO 又能当摘要用

⚠️ 常见坑#

Frontmatter 必须从第 1 行第 1 列开始写 ---,前面不能有空行或空格
结束的 --- 不能忘,否则整个文件都被当成 YAML 解析
YAML 对缩进敏感,子级必须缩进 2 个空格（不要用 Tab）
不要在 Frontmatter 里写 markdown 语法,它是纯 YAML
中文值含 ： # & 等特殊字符时必须加双引号,否则 YAML 解析报错

VS Code 安装

Sat, 02 May 2026 00:00:00 GMT

VS Code 安装#

[TOC]

下载#

进入VS Code官网：https://code.visualstudio.com,点击 DownLoad for Windows下载windows版本

image-20260502113329096

备注：
- Stable：==稳定版==
- Insiders：内测版

安装 —> 双击安装包,选择我同意此协议,再点击下一步

==默认下一步== —> 更改安装路径
安装完成,运行VS Code

插件安装#

image-20260502114446229

VS Code提供了非常丰富的插件功能

根据你的需要,安装对应的插件可以大大提高开发效率

完成前端开发,常见插件介绍：

Chinese (Simplified) Language Pack

适用于 VS Code 的中文（简体）语言包

image-20260502113924302

安装完毕之后
点击右下角的 “Change Language and Restart” 按钮,==重新启动服务==

image-20260502114558748

HTML CSS Support

在编写样式表的时候,==自动补全功能==

大大缩减了编写时间

image-20260502114940795

JavaScript (ES6) code snippets

支持ES6语法提示

image-20260502115108846

Mithril Emmet

一个能大幅度提高前端开发效率的一个工具

==用于补全代码==

image-20260502115225170

Path Intellisense

路径提示插件

image-20260502115319811

Vue 3 Snippets

在 Vue 2 或者 Vue 3 开发中提供代码片段,语法高亮和格式化的 VS Code 插件

能极大提高你的开发效率

image-20260502115441042

Auto Close Tag

自动闭合HTML/XML标签

image-20260502115538146

Auto Rename Tag

自动完成另一侧标签的==同步修改==

image-20260502115649719

open in browser

该插件支持快捷键与==鼠标右键==快速在浏览器中打开html文件

支持自定义打开指定的浏览器
- 包括：Firefox,Chrome,Opera,IE以及Safari

image-20260502115903655

Live Server

一个具有==实时加载功能==的小型服务器

实时查看开发的网页或项目效果

image-20260502120104547

Vue (Official)

这个插件包含了完整的 Volar 功能集
- Vue Language Features (Volar)
  - 核心语言特性插件
- TypeScript Vue Plugin (Volar)
  - TypeScript 类型检查的插件

image-20260502121507451

File Utils

可以方便快捷的来创建、复制、移动、重命名文件和目录

image-20260502121431874

IntelliJ IDEA Keybindings

可在VSCode中使用IDEA的快捷键

image-20260502121618137

==主题颜色==

点击左下角的 “设置” -> “主题” -> “主题颜色”
然后可以根据自己的喜好,选择喜欢的主题颜色

VS Code 配置#

打开配置面板,根据自己的喜好,可以修改字体、背景样式等偏好设置

点击 “设置” —> 点击右上角 “打开设置”

image-20260502122141139

然后在打开的 settings.json 中增加如下配置信息：

1
{
2
  "workbench.colorTheme": "Solarized Dark",
3
  "workbench.statusBar.visible": false,
4
  "editor.fontFamily": "'Courier New', Consolas, monospace",
5
  "editor.fontSize": 15,
6
  "editor.lineHeight": 1.8,
7
  "editor.tabSize": 2,
8
  "editor.codeActionsOnSave": {
9
    "source.fixAll": "explicit"
10
  },
11
  "editor.minimap.enabled": true,
12
  "liveServer.settings.donotShowInfoMsg": true,
13
  "git.confirmSync": false,
14
  "terminal.integrated.defaultProfile.windows": "Command Prompt"
15
}

展开收起

具体配置项的含义,鼠标放在配置项上,会自动悬浮展示出来

image-20260502123103307

Claude Code 插件#

Claude Code for VS Code

image-20260502170321499

image-20260502170418029

在 settings.json 中增加如下配置信息：

第一句是自动添加的 —> 别忘了添加逗号

1
"claudeCode.preferredLocation": "panel",
2
  "claudeCode.environmentVariables":[
3
  { "name": "ANTHROPIC_BASE_URL", "value": "https://xxxx" },
4
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "xxxx" }
5
]
6
}

image-20260502171035490

再次点击开 —> 跳过认证登录

中转设置( cc-switch )#

https://github.com/farion1231/cc-switch/releases

image-20260502171247041

image-20260502171357293

image-20260502171620605

API接口#

DeepSeek 开放平台

网址 —> 实名认证 —> 充值(10元试试水)

image-20260502172552068

image-20260502172749606

image-20260502173029445

==复制 API key==

sk-324xxx…

返回 cc-switch#

右上角创建 —> 选中DeepSeek —> 复制API key

请求地址就是用 anthropic(默认) 格式就行

修改==主模型== —> deepseek-v4-pro[1m]

image-20260502173851366

右下角==添加==

image-20260502174010011

重启 ==VS code== —> 并简单测试

image-20260502174449857

Windows安装#

Terminal window

1
1)Git安装
2
C:\Windows\System32>git -v
3
git version 2.53.0.windows.2

image-20260507234432858

📝 总结：如果你不确定,就勾选它 —— 这是官方安装器为方便用户提供的“一键解决依赖”方案,虽然耗时稍长,但能避免后续 npm install 时因缺少编译工具而报错（如 gyp ERR!）

✅ 勾选 → 省心、自动化,适合绝大多数用户
❌ 不勾选 → 自定义灵活,适合有经验或特殊环境的用户

Terminal window展开收起

1
2)node.js安装
2
C:\Windows\System32>node -v
3
v24.15.0
4

5
3)切换下载源
6
C:\Windows\System32>npm config set registry https://registry.npmmirror.com/
7
# 将 npm 的默认源切换为 国内镜像源：npmmirror.com,用于加速下载包
8

9
4)下载claude-code
10
C:\Windows\System32>npm install -g @anthropic-ai/claude-code
11
'出现下面这两行说明安装成功 ✅️'
12
changed 2 packages in 18s
13

14
5)测试验证
15
# 重新打开一个窗口(管理员身份)
16
C:\Windows\System32>claude --version
17
2.1.132 (Claude Code)
18

19
6)跳过登录步骤
20
# 需要找到json文件(显示隐藏文件)
21
C:\Users\LENOVO(用户名)
22
'当前目录下,找这个文件'
23
  📌 .claude.json
24
# 添加👇下面这个(英文逗号)
25
"hasCompletedOnboarding": "true"

展开收起

image-20260508001044473

PVE开源虚拟化管理平台

Sat, 25 Apr 2026 00:00:00 GMT

PVE-开源虚拟化管理平台#

[TOC]

环境准备#

使用官方的iso镜像部署三个PVE节点
1. 部署1个Backup server
尽量使用==相同类型的cpu==

部署PVE节点#

Note

默认下一步
- CPU:共4个核心运行内存 8G

image-20260602151330225

image-20260602151704378

image-20260602151946318

Warning

别忘记勾选虚拟化

image-20260603130952737

Tip

每个虚拟机六张网卡，一张nat，五张桥接
每个节点5块硬盘
1. 一块硬盘装系统
2. 三块硬盘作为osd —> ceph集群
3. 一块硬盘备用

三块网卡给不同的MAC地址!

image-20260602153810394

Note

拍一次快照

image-20260602153133182

图形化安装#

image-20260602153505943

image-20260602154240404

image-20260602154313251

image-20260602154508534

image-20260608145657212

📌 安装页面到底在配什么？

Terminal window

1
Proxmox 安装程序 → 「管理网络」页面
2
       │
3
       │ 你填的 IP、掩码、网关、DNS
4
       │
5
       ▼
6
  自动写入 /etc/network/interfaces → vmbr0 的配置
7
       │
8
       ▼
9
  安装完成后，这个 IP 就是 Web UI 的访问地址
10
===============================================
11
💡 这个页面本质上就是一个'图形化的网络配置向导'
12
✅️ PVE Web UI (pveproxy) → 监听 0.0.0.0:8006（所有网卡）

⭐节点规划#

g2-host1.pve.com — PVE 节点 + Ceph 节点

项目	配置
网络	nic0（NAT）：10.0.0.211（DHCP），网关 10.0.0.2 nic1（桥接）：10.2.1.101 — PVE 管理网络 nic2（桥接）：10.2.2.101 — PVE 集群网络 nic3（桥接）：10.2.3.101 — OSD Public nic4（桥接）：10.2.4.101 — OSD Cluster nic5（桥接）：10.2.5.101 — OVS 网桥 vmbr1
磁盘	sda：系统盘 sdb–sdd：Ceph OSD（共 3 块） sde：本地目录存储

g2-host2.pve.com — PVE 节点 + Ceph 节点

项目	配置
网络	nic0（NAT）：10.0.0.222（DHCP），网关 10.0.0.2 nic1（桥接）：10.2.1.102 — PVE 管理网络 nic2（桥接）：10.2.2.102 — PVE 集群网络 nic3（桥接）：10.2.3.102 — OSD Public nic4（桥接）：10.2.4.102 — OSD Cluster nic5（桥接）：10.2.5.102 — 额外网桥 vmbr1
磁盘	sda：系统盘 sdb–sdd：Ceph OSD（共 3 块） sde：本地 ZFS 存储

g2-host3.pve.com — PVE 节点 + Ceph 节点

项目	配置
网络	nic0（NAT）：10.0.0.233（DHCP），网关 10.0.0.2 nic1（桥接）：10.2.1.103 — PVE 管理网络 nic2（桥接）：10.2.2.103 — PVE 集群网络 nic3（桥接）：10.2.3.103 — OSD Public nic4（桥接）：10.2.4.103 — OSD Cluster nic5（桥接）：10.2.5.103 — OVS 网桥 vmbr1
磁盘	sda：系统盘 sdb–sdd：Ceph OSD（共 3 块） sde：本地 LVM_Thin 存储 ⚠️ sdf：本地 ZFS 存储

g2-pbs.pve.com — Proxmox Backup Server 节点

项目	配置
网络	nic0（NAT）：10.0.0.244（DHCP），网关 10.0.0.2 nic1（桥接）：10.2.1.104 — PVE 管理网络
磁盘	sda：系统盘 sdb：备份存储磁盘

gX-node.pve.com — 管理操作节点

项目	配置
网络	nic0（NAT）：10.0.0.210（DHCP），网关 10.0.0.2 nic1（桥接）：10.2.1.105 — PVE 管理网络
磁盘	nvme0n1：系统盘 + 数据盘
用途	浏览器访问 WebUI、配置 NFS/Samba 共享、上传镜像

Terminal window展开收起

1
Vir-02 --> '另一台Rocky虚拟机'
2
# 添加一张桥接网卡,和它处于同一网段
3

4
root@Vir-02:~# vim /etc/NetworkManager/system-connections/eth1.nmconnection
5
'10.2.1.105'
6
root@Vir-02:~# nmcli connection reload
7
root@Vir-02:~# nmcli con up eth1
8
Connection successfully activated
9
[root@Vir-02 ~]# ip a s eth1 | grep inet | head -1
10
    inet 10.2.1.105/24 brd 10.11.0.255 scope global noprefixroute eth1
11
root@Vir-02:~# ping 10.2.1.101
12
PING 10.2.1.101 (10.2.1.101) 56(84) bytes of data.
13
64 bytes from 10.2.1.101: icmp_seq=1 ttl=64 time=0.502 ms
14
64 bytes from 10.2.1.101: icmp_seq=2 ttl=64 time=0.303 ms
15
🌰 '远程登录管理'
16
root@Vir-02:~# ssh root@10.2.1.101
17
Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
18
permitted by applicable law.
19
root@pve:~#

展开收起

实操#

Terminal window展开收起

1
1)备份软件源
2
root@pve:~# mkdir /sourcebak
3
root@pve:~# cp -p /etc/apt/sources.list.d/* /sourcebak
4

5
2)更改默认的软件源
6
=========================
7
# 修改文件默认没有vim命令
8
Debian 预装的 vim-tiny 为了兼容老式 vi，默认开启了一个“兼容模式”（compatible）
9
所以一些现代编辑器的习惯就不起作用了
10
📝执行:set nocompatible，关闭兼容模式
11
=========================
12
'我们改用cat进行修改'
13
root@pve:~# cat > /etc/apt/sources.list.d/debian.sources <<'EOF'
14
Types: deb
15
URIs: http://mirrors.aliyun.com/debian/
16
Suites: trixie trixie-updates
17
Components: main contrib non-free-firmware
18
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
19

20
Types: deb
21
URIs: http://mirrors.aliyun.com/debian-security/
22
Suites: trixie-security
23
Components: main contrib non-free-firmware
24
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
25
EOF
26

27
3)更换pve企业源
28
root@pve:~# rm -rf /etc/apt/sources.list.d/pve-enterprise.sources
29
root@pve:~# cat > /etc/apt/sources.list.d/proxmox.sources <<'EOF'
30
Types: deb
31
URIs: http://download.proxmox.com/debian/pve
32
Suites: trixie
33
Components: pve-no-subscription
34
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
35
EOF
36

37
4)更换ceph源
38
root@pve:~# cat > /etc/apt/sources.list.d/ceph.sources <<'EOF'
39
Types: deb
40
URIs: http://download.proxmox.com/debian/ceph-tentacle
41
Suites: trixie
42
Components: no-subscription
43
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
44
EOF
45

46
5)配置网络配置
47
root@pve:~# cat > /etc/network/interfaces <<'EOF'
48
auto lo
49
iface lo inet loopback
50

51
iface nic1 inet manual
52
# pve管理网络
53

54
auto nic0
55
# 物理网卡(NAT)-->用来上网
56
iface nic0 inet static
57
  address 10.0.0.101/24
58
  gateway 10.0.0.2
59

60
auto nic2
61
# pve集群网络
62
iface nic2 inet static
63
  address 10.2.2.101/24
64

65
auto nic3
66
# ceph集群公网
67
iface nic3 inet static
68
  address 10.2.3.101/24
69

70
auto nic4
71
# ceph集群内网
72
iface nic4 inet static
73
  address 10.2.4.101/24
74

75
auto nic5
76
# 备用桥接网卡
77
iface nic5 inet static
78
  address 10.2.5.101/24
79

80
auto vmbr0
81
# pve管理网络
82
# 物理网卡 nic1（作为 vmbr0 的桥接端口）
83
# 这里物理网卡是桥接的那张网卡
84
iface vmbr0 inet static
85
  address 10.2.1.101/24
86
  bridge-ports nic1
87
  bridge-stp off
88
  bridge-fd 0
89

90
source /etc/network/interfaces.d/*
91
EOF

展开收起

Terminal window

1
💡 '语法要点：'
2
auto vmbr0
3
# pve管理网络
4
# 物理网卡 nic1（作为 vmbr0 的桥接端口）
5
# 这里物理网卡是桥接的那张网卡
6
iface vmbr0 inet static
7
  address 10.2.1.101/24
8
  bridge-ports nic1
9
  bridge-stp off
10
  bridge-fd 0

配置行	含义
`auto vmbr0`	开机自动启动这个 bridge
`iface vmbr0 inet static`	静态 IP（不是 DHCP）
`address 10.2.1.101/24`	IP 地址 + 子网掩码（/24）
`bridge-ports nic1`	把 nic1 插到这个 bridge 上
`bridge-stp off`	关闭生成树协议（单链路上不需要，省资源）
`bridge-fd 0`	转发延迟设为 0（立即转发，不等待）
没有 `gateway`	不上网，不需要网关！

📌 问题：vmbr0 到底是什么？它和物理网卡关系？

🧱 物理网卡 (eth0) vs Linux Bridge (vmbr)

🧱 vmbr0 到底是什么？
通俗类比：把物理网卡 eth0 想象成一根”网线”，vmbr0 就是这根网线另一头插的那个 ==虚拟交换机==

eth0 只负责收发数据帧，自己不拿 IP（你看 ip a 里 eth0 只有 MAC 地址，没有 inet）

vmbr0 是 Linux 内核创建的虚拟交换机，它拿 IP 地址，它才是通信的”身份”

bridge-ports eth0 的意思是：把 eth0 这根网线插到 vmbr0 这个交换机上

inet manual 的意思是：“这张网卡本身不拿 IP，它只是给上面的 bridge 当物理出口”
就像交换机的端口不需要 IP 一样，eth 作为物理口也不需要 IP，IP 配在 vmbr 上

📌 一句话总结：

eth 是物理网线，vmbr 是插网线的交换机，IP 配在交换机上，不配在网线上
⚠️ 注意：vmbr0 的 MAC 地址 = eth0 的 MAC 地址，因为它们是一对”交换机-上联口”

Terminal window展开收起

1
6)重启网络让配置生效
2
root@pve:~# systemctl restart networking
3
root@pve:~# cat /etc/resolv.conf
4
search localhost
5
nameserver 223.6.6.6
6
root@pve:~# ping -W2 -c2 www.baidu.com
7
PING www.a.shifen.com (180.101.49.44) 56(84) bytes of data.
8
64 bytes from 180.101.49.44: icmp_seq=1 ttl=128 time=24.8 ms
9
64 bytes from 180.101.49.44: icmp_seq=2 ttl=128 time=24.4 ms
10

11
--- www.a.shifen.com ping statistics ---
12
2 packets transmitted, 2 received, 0% packet loss, time 1001ms
13
rtt min/avg/max/mdev = 24.384/24.603/24.823/0.219 ms
14

15
7)升级软件源 & 安装必要软件
16
root@pve:~# apt-get update
17
root@pve:~# apt-get install -y vim tree wget bash-completion lrzsz net-tools sysstat iotop iftop htop unzip netcat-openbsd nmap telnet bc psmisc apache2-utils dnsutils nethogs sshpass expect cowsay sl
18

19
8)PS1 变量
20
root@pve:~# cat >> ~/.bashrc <<EOF
21
# 我的PS1变量
22
PS1='\[\e[34;1m\]\u@\[\e[0m\]\[\e[32;1m\]\H\[\e[0m\]\[\e[31;1m\] \W\[\e[0m\]\\$ '
23
EOF
24
root@pve:~# source ~/.bashrc
25

26
9)娱乐时间⌚️
27
===============
28
在 Debian/Ubuntu 系统中，sl、cowsay、fortune 等娱乐性质的程序传统上被归类为 "games"，安装路径是 /usr/games/ 而不是常规的 /usr/bin/
29
而 root 用户的默认 $PATH 有时并不包含 /usr/games
30
✅ 永久解决方法
31
将 /usr/games 添加到 root 用户的 PATH 中：
32
===============
33
root@pve ~# echo 'export PATH=$PATH:/usr/games' >> ~/.bashrc
34
root@pve ~# source ~/.bashrc
35
root@pve ~# cowsay "Hello"
36
 _______
37
< Hello >
38
 -------
39
        \   ^__^
40
         \  (oo)\_______
41
            (__)\       )\/\
42
                ||----w |
43
                ||     ||
44
root@pve ~# rm -f /etc/update-motd.d/10-uname
45
root@pve ~# cat > /etc/update-motd.d/99-local << 'SCRIPT'
46
#!/bin/bash
47
cat << 'EOF'
48
          (@) * (@) * (@)
49
        : * (@) * (@) * .;
50
        (@) * (@) * (@) * (@)
51
        * ; * ; (@) * ; * :
52
         ;\ \ \ \| /  / /;
53
            \\ \ Y/ / /
54
             `_\ |/ _'        '
55
             / \\Y// \
56
            ( ,-}={-, )
57
             \_//((\_/
58
              //))(\
59
               (/  ))
60
                   (/
61
EOF
62
SCRIPT
63
root@pve ~# chmod +x /etc/update-motd.d/99-local
64
root@pve ~# > /etc/issue && > /etc/issue.net
65

66
10)其他优化
67
root@pve ~# cat >>/etc/ssh/sshd_config<<EOF
68
UseDNS no
69
# 相当于网络命令的-n选项，这个就是说不解析为主机名，直接成IP地址.
70
GSSAPIAuthentication no
71
# 关闭GSS认证.
72
EOF
73
root@pve ~# systemctl restart ssh.service
74

75
11)系统盘挂载
76
'UUID挂载'
77
root@host01 ~# blkid
78
/dev/mapper/pve-root: UUID="b2666a2a-a057-4de1-9aa6-cdb1211809a5"
79
/dev/mapper/pve-swap: UUID="aba324d1-3307-4d83-88e2-5e9698138e20"
80
root@host01 ~# vim /etc/fstab
81
UUID="b2666a2a-a057-4de1-9aa6-cdb1211809a5" / ext4 errors=remount-ro 0 1
82
UUID="aba324d1-3307-4d83-88e2-5e9698138e20" none swap sw 0 0

展开收起

Terminal window

1
浏览器测试访问
2
https://10.11.0.111:8006
3
'👆是我们桥接这张网卡' <-- Rocky中的火狐浏览器可以正常访问
4
=============================
5
https://10.0.0.211:8006
6
'👆是我们NAT这张网卡' <-- Windows中的edge浏览器可以正常访问

image-20260603144424139

image-20260603144206838

backup#

Terminal window展开收起

1
'两块硬盘' --> 系统盘 & 备份存储磁盘
2
'两张网卡' --> 额外添加一张桥接
3
# 10.2.1.104
4
'主机名' --> g2-pbs.pve.com
5

6
'访问web UI'
7
删除网关,添加IP配置(NAT)
8

9
'替换源'
10
cat > /etc/apt/sources.list.d/debian.sources <<'EOF'
11
Types: deb
12
URIs: http://mirrors.aliyun.com/debian/
13
Suites: trixie trixie-updates
14
Components: main contrib non-free-firmware
15
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
16

17
Types: deb
18
URIs: http://mirrors.aliyun.com/debian-security/
19
Suites: trixie-security
20
Components: main contrib non-free-firmware
21
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
22
EOF
23

24
==========================
25

26
cat > /etc/apt/sources.list.d/pbs-enterprise.sources <<'EOF'
27
Types: deb
28
URIs: http://download.proxmox.com/debian/pbs
29
Suites: trixie
30
Components: pbs-no-subscription
31
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
32
EOF
33

34
==========================
35

36
apt-get update
37

38
apt-get install -y vim tree wget bash-completion lrzsz net-tools sysstat iotop iftop htop unzip netcat-openbsd nmap telnet bc psmisc apache2-utils dnsutils nethogs sshpass expect cowsay sl
39

40
cat >> ~/.bashrc <<EOF
41
# 我的PS1变量
42
PS1='\[\e[34;1m\]\u@\[\e[0m\]\[\e[32;1m\]\H\[\e[0m\]\[\e[31;1m\] \W\[\e[0m\]\\$ '
43
EOF
44

45
echo 'export PATH=$PATH:/usr/games' >> ~/.bashrc
46

47
source ~/.bashrc
48

49
cat > /etc/update-motd.d/99-local << 'SCRIPT'
50
#!/bin/bash
51
cat << 'EOF'
52
          (@) * (@) * (@)
53
        : * (@) * (@) * .;
54
        (@) * (@) * (@) * (@)
55
        * ; * ; (@) * ; * :
56
         ;\ \ \ \| /  / /;
57
            \\ \ Y/ / /
58
             `_\ |/ _'        '
59
             / \\Y// \
60
            ( ,-}={-, )
61
             \_//((\_/
62
              //))(\
63
               (/  ))
64
                   (/
65
EOF
66
SCRIPT
67

68
chmod +x /etc/update-motd.d/99-local
69

70
> /etc/issue && > /etc/issue.net
71

72
cat >>/etc/ssh/sshd_config<<EOF
73
UseDNS no
74
# 相当于网络命令的-n选项，这个就是说不解析为主机名，直接成IP地址.
75
GSSAPIAuthentication no
76
# 关闭GSS认证.
77
EOF
78

79
systemctl restart ssh.service

展开收起

Note

关机拍快照

加入集群#

image-20260605100633414

image-20260605100653917

加入集群

image-20260605100805832

Note

集群状态 —> 断开连接 —> 另外两台重新登录

任务二#

在 PVE 集群上部署 Ceph Tentacle，创建 OSD 并配置 CephFS 和 RBD 共享存储

在 WebUI 中点击 Datacenter → g2-host1 → Ceph，进行安装

在 WebUI 中点击 Datacenter → g2-host2 → Ceph，进行安装

在 WebUI 中点击 Datacenter → g2-host3 → Ceph，进行安装

等待安装完成

image-20260605102924282

无订阅

image-20260605103127310

Terminal window

1
'另外两台'同样也是需要添加Ceph集群
2
# 只需要安装即可! 配置已经在Host1中配置选择过了 公网 & 私网

image-20260605110507662

现在的状态是”不健康”❌️ —> 先不管它

Note

添加mon & mgr

创建mon

点击 g2-host1 → Ceph → Monitor
点击 Monitor → Create
重复操作，分别在 host2、host3 上创建 Monitor
等待所有 Monitor 启动完成

创建mgr

点击 g2-host1 → Ceph → Monitor
点击 Manager → Create
在 host2、host3 也创建一个（用于高可用）

image-20260605110743058

把另外两台都添加上去!

image-20260605110917767

Note

添加 OSD 硬盘

在每个节点上创建 3 个 OSD（sdb、sdc、sdd），共 9 个

image-20260605111210805

image-20260605111416284

image-20260605111435175

Tip

这次再添加完 mon & mgr & OSD磁盘就行健康了💚✅️

Note

创建RBD池 & CephFS

image-20260605112130448

创建完之后, 就可以在==左上角==创建cephFS了

image-20260605112645402

image-20260605113017460

image-20260605113103289

查看器群状态健康✅️

任务三#

image-20260605114530624

image-20260605114719821

image-20260605145307167

image-20260605145944061

image-20260605150015266

image-20260605152154469

任务四#

在三台 PVE 节点上分别使用 sde 磁盘创建不同类型的本地存储

image-20260605152741084

image-20260605152853088

image-20260605153117447

image-20260608161853507

image-20260605153301422

任务五#

在管理操作节点（node）上部署 NFS 和 Samba 服务，并将共享目录添加到 PVE 集群

Terminal window

1
1)nfs下载安装
2
[root@node-200 ~]# dnf -y install nfs-utils
3
[root@node-200 ~]# mkdir -p /srv/nfs/share
4
[root@node-200 ~]# echo '/srv/nfs/share  10.11.0.0/24(rw,sync,no_subtree_check,no_root_squash)' >> /etc/exports
5
[root@node-200 ~]# systemctl enable --now nfs-server
6
Created symlink '/etc/systemd/system/multi-user.target.wants/nfs-server.service' → '/usr/lib/systemd/system/nfs-server.service'
7
[root@node-200 ~]# showmount -e 10.11.0.128
8
Export list for 10.11.0.128:
9
/srv/nfs/share 10.11.0.0/24

image-20260606082808206

node节点接着安装samba

Terminal window展开收起

1
'下载samb'
2
[root@node-200 ~]# yum -y install samba
3
[root@node-200 ~]# mkdir -p /srv/samba/share
4
[root@node-200 ~]# groupadd -g 888 smbuser
5
[root@node-200 ~]# useradd -g 888 -u 888 smbuser
6
[root@node-200 ~]# pdbedit -a smbuser
7
New password:
8
Retype new password:
9
[root@node-200 ~]# chown smbuser:smbuser /srv/samba/share/
10
[root@node-200 ~]# cat >> /etc/samba/smb.conf <<'EOF'
11
[samba-share]
12
    path = /srv/samba/share
13
    write list = smbuser
14
    valid users = smbuser
15
EOF
16
[root@node-200 ~]# getenforce
17
Disabled
18
[root@node-200 ~]# systemctl is-active firewalld.service
19
inactive
20
[root@node-200 ~]# systemctl enable --now smb nmb

展开收起

image-20260606085921119

image-20260608161932196

任务六#

在三台 PVE 节点上使用 nic5 创建 Open vSwitch 网桥 vmbr1

Terminal window

1
'安装 Open vSwitch'
2
root@host01 ~# apt -y install openvswitch-switch
3
root@host02 ~# apt -y install openvswitch-switch
4
root@host03 ~# apt -y install openvswitch-switch

image-20260606095119856

Note

最后别忘记了应用配置

image-20260606095310298

image-20260606095359401

Note

把原来nic5里面的IP地址可以清除掉!

三台都清理掉

image-20260606095916393

image-20260606100033702

image-20260606100111594

Warning

关机拍快照
- 先启动node & backup
- 在启动host

任务7#

image-20260606103222013

image-20260606103532304

image-20260606103648077

Note

这个子网最后并没有用到 —> 后面我们用的==静态的==(非DHCP) —> 手动指定172.17.2.xxx

image-20260606103947960

任务八#

image-20260606104441363

Terminal window

1
✅️ 上传两个镜像到node节点的根目录下/root
2
# 用Xshell上传
3

4
[root@node-200 ~]# ls /root/ | grep Rocky
5
Rocky-10.2-x86_64-minimal.iso
6
Rocky-10-GenericCloud-Base.latest.x86_64.qcow2

Note

上传至 —> CephFS存储

在一个节点(hots1)上传后, 别的节点在cephfs也可以看到!

image-20260606104801804

上传完毕后, 等一会

image-20260606105100298

任务九#

Terminal window展开收起

1
'node节点操作'
2
[root@node-200 ~]# dnf -y install guestfs-tools
3
[root@node-200 ~]# dnf -y install qemu-kvm libvirt virt-install virt-viewer
4
[root@node-200 ~]# for drv in qemu network nodedev nwfilter secret storage interface; do \
5
    systemctl enable --now virt${drv}d.socket; \
6
done
7
[root@node-200 ~]# systemctl daemon-reload
8
[root@node-200 ~]# for drv in qemu network nodedev nwfilter secret storage interface; do \
9
    systemctl enable --now virt${drv}d.socket; \
10
done
11
[root@node-200 ~]# systemctl list-units --type=socket | grep virt
12
  virtinterfaced.socket           loaded active listening libvirt
13
  virtnetworkd.socket             loaded active listening libvirt
14
  virtnodedevd.socket             loaded active listening libvirt
15
  virtnwfilterd.socket            loaded active listening libvirt
16
  virtqemud.socket                loaded active listening libvirt
17
  virtsecretd.socket              loaded active listening libvirt
18
  virtstoraged.socket             loaded active listening libvirt
19
[root@node-200 ~]# guestfish -i --network -a /root/Rocky-10-GenericCloud-Base.latest.x86_64.qcow2
20
⚠️ 我的镜像在/root目录下
21
[root@node-200 ~]# ls -lhd /root
22
dr-xr-x---. 15 root root 4.0K Jun  6 10:44 /root
23
✅️ 它的这个目录/root权限有点特殊,我们移动到别的地方!
24
[root@node-200 ~]# cp /root/Rocky-10-GenericCloud-Base.latest.x86_64.qcow2 /var/lib/libvirt/images/
25
[root@node-200 ~]# chown root:qemu /var/lib/libvirt/images/Rocky-10-GenericCloud-Base.latest.x86_64.qcow2
26
[root@node-200 ~]# chmod 644 /var/lib/libvirt/images/Rocky-10-GenericCloud-Base.latest.x86_64.qcow2
27
[root@node-200 ~]# guestfish -i --network -a /var/lib/libvirt/images/Rocky-10-GenericCloud-Base.latest.x86_64.qcow2
28
Welcome to guestfish
29
Type: ‘help’ for help on commands
30
      ‘man’ to read the manual
31
      ‘quit’ to quit the shell
32

33
Operating system: Rocky Linux 10.2 (Red Quartz)
34
/dev/sda4 mounted on /
35
/dev/sda3 mounted on /boot
36
/dev/sda2 mounted on /boot/efi
37

38
><fs> command "yum -y install httpd"
39
...........
40
Complete!
41

42
><fs> touch /var/www/html/index.html
43
><fs> write /var/www/html/index.html "rocky-index"
44
><fs> cat /var/www/html/index.html
45
rocky-index
46
><fs> command "systemctl enable httpd"
47

48
><fs> command "systemctl is-enabled httpd"
49
enabled
50
><fs> selinux-relabel /etc/selinux/targeted/contexts/files/file_contexts /
51
><fs> exit

展开收起

Note

把这个 qcow2镜像拷贝出来
- 拷贝到桌面 —> 添加上去
  - 这个镜像里面预装了 ==httpd服务==
  - ⚠️ 一定不要上传错误

image-20260606162907766

image-20260606115911859

image-20260606120116939

image-20260606120149826

任务十#

使用 Rocky Linux 10 ISO 安装虚拟机 vm1，安装 qemu-guest-agent 后转换为 PVE 模板

image-20260606120610840

image-20260606120708728

image-20260606120744531

image-20260606120939058

image-20260606122042426

让虚拟机 CPU 尽量匹配宿主机
将 “类型” 改为：
- kvm64（最推荐！通用、安全、兼容性强，自动适配宿主机能力）

场景	CPU 类型
宿主机真实 CPU	AMD Ryzen 5 5600H

内存、网络都默认即可

image-20260606121548830

Terminal window展开收起

1
'host1节点'
2
1)查看配置文件信息
3
root@host01 ~# cat /etc/pve/qemu-server/100.conf
4
✅️ 这里面装的是配置文件
5
boot: order=scsi0;ide2;net0
6
cores: 2
7
cpu: kvm64
8

9
2)过滤CPU信息
10
root@host01 ~# cat /etc/pve/qemu-server/100.conf | grep -E '^cpu:'
11
cpu: kvm64
12

13
3)启动虚拟机
14
root@host01 ~# qm start 100
15
start failed: QEMU exited with code 1
16
❌️ '最后依旧是起不来'

展开收起

既然 PVE 的原生 cpu: 参数走不通，我们必须绕过 PVE 的解析器

直接使用底层的 args: 参数向 QEMU 传递完整的 CPU 定义

🎯 终极解决方案：纯 `args` 透传法#

Terminal window展开收起

1
✅ 步骤 1：清理配置文件中的 cpu 和 args
2
root@host01 ~# vim /etc/pve/qemu-server/100.conf
3
  删除 所有的 cpu: ... 行
4
  删除 所有的 args: ... 行
5

6
✅ 步骤 2：添加精准的 QEMU 底层参数
7
'在配置文件中添加以下唯一一行 args'
8
# 整行复制，不要换行
9
args: -cpu host,+invtsc,-pcid,-cmp-legacy,-perfctr-core,-amd-stibp,-xsaveerptr
10

11
✅ 步骤 3：重启虚拟机
12
qm stop 100
13
qm start 100
14
kvm: warning: ...xxx
15
kvm: warning: ...xxx
16
'警告⚠️信息不用管'

展开收起

image-20260606133534052

image-20260606134914910

Terminal window

1
[C:\~]$ ssh root@172.31.31.159
2
'可以从Xshell中成功登录进来!'
3
Connecting to 172.31.31.159:22...
4
Connection established.
5
=======================
6
Last login: Sat Jun  6 13:46:18 2026
7

8
1)安装并启动
9
[root@jiuzhao ~]# dnf -y install qemu-guest-agent
10
[root@jiuzhao ~]# systemctl enable --now qemu-guest-agent
11
'卡住了!'
12
^C
13
[root@jiuzhao ~]# reboot
14
'重启一下!'

image-20260606140721386

image-20260606140959476

Note

手动启动后,再重启一下虚拟机

image-20260606141233603

关机 —> 更多 —> 装换模版 —> 是

image-20260606141412241

image-20260606141829543

任务十一#

Note

右上更多 —> 克隆

image-20260606142002367

image-20260606142057647

image-20260606142442584

Note

必须关机做快照

快照名称必须得是英文

image-20260606143226897

Important

开机 —> 删除用户

image-20260606143741947

Important

关机 —> 恢复快照 —> 验证用户

image-20260606143936489

image-20260606144047569

任务十二#

Important

这次是在host02节点上创建虚拟机

image-20260606145750898

image-20260606145815675

image-20260606150021876

image-20260606150242037

image-20260606150143850

内存 & 网络都==默认==就行

修改硬件#

image-20260606154416965

image-20260606154503620

image-20260606154953681

image-20260606155600111

image-20260606155100323

image-20260606155202694

image-20260606155416311

image-20260606155439956

image-20260606155729328

Important

依旧是Cpu架构选的有问题!
- ==host2==

Terminal window

1
root@host02 ~# cd /etc/pve/qemu-server/
2
root@host02 qemu-server# ls
3
102.conf
4
root@host02 qemu-server# cd
5
root@host02 ~# vim /etc/pve/qemu-server/102.conf
6
'把CPU行删除了 --> 行尾加上这个'
7
args: -cpu host,+invtsc,-pcid,-cmp-legacy,-perfctr-core,-amd-stibp,-xsaveerptr
8
root@host02 ~# qm stop 102
9
root@host02 ~# qm start 102
10
generating cloud-init ISO
11
✅️ 现在就能够启动起来了

image-20260606164305694

Note

它和上面 vm1-clone 在同一网段!
- 启动 vm1-clone

image-20260606160322309

image-20260606164336177

image-20260606164926086

image-20260606165047225

任务十三#

在 PVE 中下载 LXC 容器模板和 OCI 标准容器镜像

image-20260606165306424

image-20260606165354818

image-20260606165526674

Terminal window

1
引用： docker.m.daocloud.io/busybox
2
标签： latest
3
文件名： busybox_latest

image-20260606170428840

image-20260606170450837

image-20260606171038240

任务十四#

基于 LXC 模板创建两个容器 c1 和 c2，部署在不同主机，使用 OVS 网桥 vmbr1，VLAN Tag = 200

image-20260606171346417

image-20260606171421371

image-20260606171458777

Cpu & 内存都默认下一步

image-20260606171558719

image-20260606171821961

image-20260606172249323

image-20260606174648626

静态IP & vlan#

network

Terminal window展开收起

1
========================================
2
'下面这两个都是vmbr0🌐' <-- Rocky Linux 10
3
❗ 没有Vlan
4
========================================
5
1)vm1-clone
6
[root@jiuzhao ~]# nmcli con modify ens18 ipv4.method manual ipv4.addresses 172.17.2.101/24
7
'没法补全只能手打' ✅️ 注意后面/24 <-- 子网掩码
8
⚠️ method √ ⚠️ methon × ⚠️
9
[root@jiuzhao ~]# nmcli con up ens18
10
Connection successfully activated
11

12
2)vm2
13
[root@vm2 ~]# nmcli con show
14
NAME                UUID       TYPE      DEVICE
15
Wired connection 1  caa7d4xxx  ethernet  ens18
16
lo                  ad4c71xxx  loopback  lo
17
⚠️ 'Wired connection 1' <-- 单引号括起来
18
[root@vm2 ~]# nmcli con modify 'Wired connection 1' ipv4.method manual ipv4.address 172.17.2.102/24
19
[root@vm2 ~]# nmcli con up 'Wired connection 1'
20
Connection successfully activated
21
[root@vm2 ~]# ping -W2 -c2 172.17.2.101
22
PING 172.17.2.101 (172.17.2.101) 56(84) bytes of data.
23
64 bytes from 172.17.2.101: icmp_seq=1 ttl=64 time=1.09 ms
24
64 bytes from 172.17.2.101: icmp_seq=2 ttl=64 time=0.640 ms
25

26
--- 172.17.2.101 ping statistics ---
27
2 packets transmitted, 2 received, 0% packet loss, time 1000ms
28
rtt min/avg/max/mdev = 0.640/0.862/1.085/0.222 ms
29
'✅️ 可以成功ping通'

展开收起

Terminal window

1
========================================
2
'下面两个容器都是vmbr1🌐' <-- Alpin-3.23
3
❗ Vlan200 ❗
4
========================================
5
3)修改c1网络(静态) --> 172.17.2.103
6
✅️ c1创建在host1中, 'c2创建在host2中'

image-20260606201050680

Terminal window

1
4)创建c2的同时'指定Vlan200'
2
⚠️ 依旧是Alpine镜像

image-20260606195527511

alpin —> 磁盘(默认下一步) —> … —> ==网络==

image-20260606200722774

DNS —> 确认

👆 默认下一步!

Terminal window展开收起

1
c2:~# ip a
2
1: lo: xxx
3
    inet 127.0.0.1/8 scope host lo
4
2: eth0@if35: xxx
5
    link/ether bc:24:11:9c:c7:ce brd ff:ff:ff:ff:ff:ff
6
    inet 172.17.2.104/24 scope global eth0
7
=========================
8
①测试和vm1-clone联通性 ❌️
9
c2:~# ping -W2 -c2 172.17.2.101
10
PING 172.17.2.101 (172.17.2.101): 56 data bytes
11

12
--- 172.17.2.101 ping statistics ---
13
2 packets transmitted, 0 packets received, 100% packet loss ❌️
14
=========================
15
②测试和c1的联通性 ✅️
16
c2:~# ping -W2 -c2 172.17.2.103
17
PING 172.17.2.103 (172.17.2.103): 56 data bytes
18
64 bytes from 172.17.2.103: seq=0 ttl=64 time=4.449 ms
19
64 bytes from 172.17.2.103: seq=1 ttl=64 time=0.373 ms
20

21
--- 172.17.2.103 ping statistics ---
22
2 packets transmitted, 2 packets received, 0% packet loss ✅️
23
round-trip min/avg/max = 0.373/2.411/4.449 ms

展开收起

任务十五#

基于 OCI 容器镜像创建 c3 和 c4，使用 VXLAN 网络（VNI 100），部署在不同节点

image-20260606213001631

等一会就行了

image-20260606213117094

Terminal window

1
========================================
2
'下面两个容器都是mynet🌐' <-- busybox
3
⚠️ Vlan100 ⚠️ c3 & c4
4
========================================
5
root@host01 ~# ip -d link show | grep vxlan
6
100: vxlan_myvnet: xxx
7
  vxlan id 100 srcport 0 0 dstport 4789 ttl auto ageing
8

9
5)c3创建
10
# 172.17.2.105
11
✅️ 我们这次在host2创建 --> C3
12
busybox --> 172.17.2.105/24(mynet)'无需vlan已经设置过了'

image-20260606214345414

Note

⚠️ 控制台由 console —> shell

image-20260606214831208

Terminal window展开收起

1
~ # ip a
2
1: lo: xxx
3
    inet 127.0.0.1/8 scope host lo
4
2: eth0@if44: xxx
5
    link/ether bc:24:11:af:fd:83 brd ff:ff:ff:ff:ff:ff
6
    inet 172.17.2.105/24 brd 172.17.2.255 scope global eth0
7
===================
8
~ # ping -W2 -c2 172.17.2.1
9
PING 172.17.2.1 (172.17.2.1): 56 data bytes
10

11
--- 172.17.2.1 ping statistics ---
12
2 packets transmitted, 0 packets received, 100% packet loss
13
===================
14
~ # ping -W2 -c2 172.17.2.3
15
PING 172.17.2.3 (172.17.2.3): 56 data bytes
16

17
--- 172.17.2.3 ping statistics ---
18
2 packets transmitted, 0 packets received, 100% packet loss

展开收起

Terminal window

1
6)'c4创建'
2
# 172.17.2.106
3
✅️ 我们这次在host3创建 --> C4
4
busybox --> 172.17.2.106/24(mynet)'无需vlan已经设置过了'

image-20260606214945892

Note

⚠️ 控制台由 console —> shell

Terminal window展开收起

1
~ # ip a
2
1: lo: xxx
3
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
4
    inet 127.0.0.1/8 scope host lo
5
2: eth0@if17: xxx
6
    link/ether bc:24:11:c7:f4:1e brd ff:ff:ff:ff:ff:ff
7
    inet 172.17.2.106/24 brd 172.17.2.255 scope global eth0
8
===================
9
~ # ping -W2 -c3 172.17.2.101
10
PING 172.17.2.101 (172.17.2.101): 56 data bytes
11

12
--- 172.17.2.101 ping statistics ---
13
3 packets transmitted, 0 packets received, 100% packet loss
14
===================
15
~ # ping -W2 -c3 172.17.2.103
16
PING 172.17.2.103 (172.17.2.103): 56 data bytes
17

18
--- 172.17.2.103 ping statistics ---
19
3 packets transmitted, 0 packets received, 100% packet loss
20
===================
21
~ # ping -W2 -c3 172.17.2.105
22
PING 172.17.2.105 (172.17.2.105): 56 data bytes
23
64 bytes from 172.17.2.105: seq=0 ttl=64 time=0.522 ms
24
64 bytes from 172.17.2.105: seq=1 ttl=64 time=0.431 ms
25
64 bytes from 172.17.2.105: seq=2 ttl=64 time=0.307 ms
26

27
--- 172.17.2.105 ping statistics ---
28
3 packets transmitted, 3 packets received, 0% packet loss
29
round-trip min/avg/max = 0.307/0.420/0.522 ms

展开收起

任务十六#

配置 PVE 安全组，控制 vm1 的端口访问（允许 HTTP/SSH，拒绝其他）

Tip

vm2(qcow2云镜像) —> 里面有httpd服务

那么这些防火墙的规则就是最终要在vm2上面生效

上面的实验我们已经把vm1-clone和vm2放在了同一个网段(172.17.2.xxx/24)
为了我用Xshell连接方便,我们给==vm1-clone==再添加一张网卡(桥接)
我们在vm1里面验证防火墙是否生效

image-20260607091041238

image-20260607091148157

Terminal window展开收起

1
[C:\~]$ ssh root@172.31.31.91
2

3
Connecting to 172.31.31.91:22...
4
Connection established.
5
[root@jiuzhao ~]# hostname -I
6
172.17.2.101 172.31.31.91
7
'两个IP地址!'
8
===================
9
[root@jiuzhao ~]# ping -W2 -c3 172.17.2.102
10
PING 172.17.2.102 (172.17.2.102) 56(84) 字节的数据。
11
64 字节，来自 172.17.2.102: icmp_seq=1 ttl=64 时间=5.16 毫秒
12
64 字节，来自 172.17.2.102: icmp_seq=2 ttl=64 时间=0.688 毫秒
13
64 字节，来自 172.17.2.102: icmp_seq=3 ttl=64 时间=0.598 毫秒
14

15
--- 172.17.2.102 ping 统计 ---
16
已发送 3 个包， 已接收 3 个包, 0% packet loss, time 2060ms
17
rtt min/avg/max/mdev = 0.598/2.147/5.155/2.127 ms
18
===================
19
[root@jiuzhao ~]# ping -W2 -c3 172.17.2.104
20
PING 172.17.2.104 (172.17.2.104) 56(84) 字节的数据。
21
来自 172.17.2.101 icmp_seq=1 目标主机不可达
22
来自 172.17.2.101 icmp_seq=2 目标主机不可达
23
来自 172.17.2.101 icmp_seq=3 目标主机不可达
24

25
--- 172.17.2.104 ping 统计 ---
26
已发送 3 个包， 已接收 0 个包, +3 错误, 100% packet loss, time 2063ms
27
pipe 3
28
===================
29
[root@jiuzhao ~]# ping -W2 -c3 172.17.2.106
30
PING 172.17.2.106 (172.17.2.106) 56(84) 字节的数据。
31
来自 172.17.2.101 icmp_seq=1 目标主机不可达
32
来自 172.17.2.101 icmp_seq=2 目标主机不可达
33
来自 172.17.2.101 icmp_seq=3 目标主机不可达
34

35
--- 172.17.2.106 ping 统计 ---
36
已发送 3 个包， 已接收 0 个包, +3 错误, 100% packet loss, time 2082ms
37
===================
38
[root@jiuzhao ~]# ssh root@172.17.2.102
39
root@172.17.2.102: Permission denied ❌️
40
[root@jiuzhao ~]# ssh-keygen
41
[root@jiuzhao ~]# ssh-copy-id root@172.17.2.102
42
'因为这个vm2云镜像默认禁止密码登录'
43
# 所以我们没有办法通过这种方式拷贝公钥
44
✅️ 手动查看公钥
45
[root@jiuzhao ~]# cat /root/.ssh/id_ed25519.pub
46
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEUfzvfEr7ANkqmxNMQnQzjw3stC6WC40B4ubOxRc6Fj 'root@jiuzhao'
47
⚠️ 后面的 'root@..' 不复制
48
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEUfzvfEr7ANkqmxNMQnQzjw3stC6WC40B4ubOxRc6Fj
49
✅️ 只能手动在vm2中添加公钥

展开收起

image-20260607091905841

Note

添加完成之后重启一下虚拟机

Terminal window展开收起

1
[root@jiuzhao ~]# ssh root@172.17.2.102
2
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
3
@    WARNING: REMOTE HOST IDENTIFICATIO
4
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
5
[root@jiuzhao ~]# > /root/.ssh/known_hosts
6
'再次尝试登录'
7
[root@jiuzhao ~]# ssh root@172.17.2.102
8
Web console: https://vm2:9090/
9

10
Last login: Sat Jun  6 11:30:07 2026
11
[root@vm2 ~]# hostname -I
12
172.17.2.102
13
[root@vm2 ~]# curl localhost
14
rocky-index
15
✅️ 里面有httpd服务
16
[root@vm2 ~]# exit
17
'ssh退出vm2后, 依旧可以通过IP访问服务'
18
[root@jiuzhao ~]# curl 172.17.2.102
19
rocky-index
20
✅️ 此时'数据中心'防火墙没有生效

展开收起

image-20260607093241127

创建安全群组#

Terminal window

1
root@host01 ~# systemctl stop pve-firewall
2
root@host02 ~# systemctl stop pve-firewall
3
root@host03 ~# systemctl stop pve-firewall

Note

我这里只要把数据中心的防火墙开启, 我的web页面就连不上了! Xshell也连不上了!

所以先手动把它们的防火墙关了

image-20260607093331125

我们这里先默认拒绝所有

目的IP 172.17.2.102

image-20260607102739041

启动数据中心的防火墙

插入安全组 —> vm2

启动vm2的防火墙

image-20260607094547597

image-20260607103444400

image-20260607103358384

image-20260607103509254

Terminal window

1
root@host02 ~# systemctl start pve-firewall
2
===================
3
[root@jiuzhao ~]# curl 172.17.2.102
4
curl: (7) Failed to connect to 172.17.2.102 port 80
5
===================
6
[root@jiuzhao ~]# ping -W2 -c2 172.17.2.102
7
PING 172.17.2.102 (172.17.2.102) 56(84) 字节的数据。
8

9
--- 172.17.2.102 ping 统计 ---
10
已发送 2 个包， 已接收 0 个包, 100% packet loss, time 1007ms
11
===================
12
root@host02 ~# systemctl stop pve-firewall

image-20260607103929231

image-20260607103959964

把80和22端口添加进去!

image-20260607104056250

Terminal window展开收起

1
root@host02 ~# systemctl start pve-firewall
2
'需要手动重启一下ssh服务'
3
===================
4
[root@jiuzhao ~]# ssh root@172.17.2.102
5
Web console: https://vm2:9090/
6

7
Last login: Sun Jun  7 03:16:38 2026 from 172.17.2.101
8
[root@vm2 ~]# exit
9
logout
10
Connection to 172.17.2.102 closed.
11
===================
12
[root@jiuzhao ~]# curl 172.17.2.102
13
rocky-index
14
===================
15
[root@jiuzhao ~]# ping -W2 -c2 172.17.2.102
16
PING 172.17.2.102 (172.17.2.102) 56(84) 字节的数据。
17

18
--- 172.17.2.102 ping 统计 ---
19
已发送 2 个包， 已接收 0 个包, 100% packet loss, time 1001ms
20
===================
21
root@host02 ~# systemctl stop pve-firewall

展开收起

Note

ping不通 ---> ICMP协议

image-20260607112618311

Terminal window

1
root@host02 ~# systemctl start pve-firewall
2
===================
3
[root@jiuzhao ~]# ping -W2 -c2 172.17.2.102
4
PING 172.17.2.102 (172.17.2.102) 56(84) 字节的数据。
5
64 字节，来自 172.17.2.102: icmp_seq=1 ttl=64 时间=1.41 毫秒
6
64 字节，来自 172.17.2.102: icmp_seq=2 ttl=64 时间=0.587 毫秒
7

8
--- 172.17.2.102 ping 统计 ---
9
已发送 2 个包， 已接收 2 个包, 0% packet loss, time 1002ms
10
rtt min/avg/max/mdev = 0.587/0.998/1.410/0.411 ms
11
✅️ 现在就能ping通了!
12
===================
13
root@host02 ~# systemctl stop pve-firewall

任务十七#

迁移vm2 —> host3中

我们得 ==在线迁移==(热迁移)

image-20260607124109249

Note

‘TASK ERROR: migration problems’ ❌️ 第一次迁移失败,因为CPU标志会阻止热迁移!

那我们关机 —> 试试冷迁移

image-20260607125236416

我们开机试一试

image-20260607125618926

Note

我们==新建==C7容器 **热迁移 **

✅️ 新建的目的是为了有共享存储

从host1 —> host3
- 在线迁移

image-20260607132450669

image-20260607131837611

Important

rbd 共享存储池

image-20260607132516252

image-20260607132552409

启动C2 <— host2

Alpine vmbr1 vlan200

172.17.2.104/24

Terminal window展开收起

1
c7:~# ip a
2
1: lo: xxx
3
    inet 127.0.0.1/8 scope host lo
4
2: eth0@if19: xxx
5
    link/ether bc:24:11:7f:02:60 brd
6
    inet 172.17.2.107/24 scope global eth0
7
===================
8
c7:~# ping -W2 -c2 172.17.2.104
9
PING 172.17.2.104 (172.17.2.104): 56 data bytes
10
64 bytes from 172.17.2.104: seq=0 ttl=64 time=2.678 ms
11
64 bytes from 172.17.2.104: seq=1 ttl=64 time=0.306 ms
12

13
--- 172.17.2.104 ping statistics ---
14
2 packets transmitted, 2 packets received, 0% packet loss
15
round-trip min/avg/max = 0.306/1.492/2.678 ms

展开收起

image-20260607133434722

image-20260607133505679

image-20260607133532844

Terminal window

1
c7:~# ip a
2
2: eth0@if19: xxx
3
    link/ether bc:24:11:7f:02:60 brd
4
    inet 172.17.2.107/24
5
===================
6
c7:~# ping -W2 -c2 172.17.2.104
7
PING 172.17.2.104 (172.17.2.104): 56 data bytes
8
64 bytes from 172.17.2.104: seq=0 ttl=64 time=2.678 ms
9
✅️ 迁移后依旧可以ping通

任务十八#

将容器 c7 配置为 HA 模式，模拟节点故障测试自动恢复

image-20260607145412506

image-20260607150129739

手动==暂停(关机)==host3节点

image-20260607151936101

image-20260607152052549

任务十九#

在 PVE 集群中配置存储复制，将虚拟机/容器存储定期复制到目标节点

Note

只有ZFS才可以复制!
- 在 hsots3 添加一块磁盘

image-20260607153037803

image-20260607153615186

image-20260607160246630

Tip

重启生效

image-20260607160041237

Note

创建zfs存储（此zfs的命名要跟移动容器所在的zfs的命名一样）

image-20260607160319088

image-20260607163921979

我自己做的时候, 添加错了 —> 名字一样才行!
- 有的用的是后面作业的文档📄

把c2 —> 从host2 复制到 hosts3

image-20260607160605239

启动c2容器

过三分钟 —> 复制到host03

image-20260607161145683

Tip

过一会就有信息了!

image-20260608162651094

任务二十#

创建 PVE 到 PBS 的备份任务，执行备份和恢复测试

image-20260607161754413

image-20260607161916547

image-20260607162007351

image-20260607162050378

存储管理与快照迁移

Tue, 21 Apr 2026 00:00:00 GMT

存储管理 && 快照迁移 && 高级运维#

[TOC]

🧱 知识点总结#

从”手动挡”到”自动挡”#

Note

在上篇笔记📚中，我们用 qemu-img create + virsh define 完成批量创建

但这些操作 ==libvirt 并不完全”知情”==
- 你用 qemu-img 创建的磁盘、用 rm 删除的镜像，libvirt 的存储池并不会自动感知

🧱 为什么 libvirt “不知情”？

libvirt 内部维护了一份元数据”登记表”，它并不直接盯着文件系统看：

Terminal window

1
qemu-img create 创建磁盘：
2
/guest_images/vm-disk1.qcow2  ← 文件确实在磁盘上 ✅️
3
但 libvirt 的"登记表"里没有它  ← libvirt 不知道 ❌️
4

5
virsh vol-create-as 创建磁盘：
6
/guest_images/vm-disk1.qcow2  ← 文件在磁盘上 ✅️
7
libvirt 同时在登记表里记了一笔 ← libvirt 知道 ✅️

通俗类比：

qemu-img create = 你偷偷把一箱货搬进仓库，仓库管理员没收到入库单，==账本上没有==

virsh vol-create-as = 你走正规流程入库，管理员登记了货物名称、大小、位置，==账本上记了==

📌 ==virsh pool-refresh== 就是管理员去仓库实地盘点一圈，把账本和实物对齐 —> 发现多了一箱货，补登进去

本质区别是 qemu-img ==绕过了 libvirt 的”记账”环节==，libvirt 的元数据没有被更新

✅️ 把”管理权”交还给 libvirt —— 用受管的存储池和存储卷替代 qemu-img 的裸操作，让一切变得可控、可追踪

📌 管理工具演进路线：

阶段	创建磁盘方式	管理方式	可见性
原始版	`qemu-img create`	手动 `rm`	libvirt 不可见 ❌️
受管版	`virsh vol-create-as`	`virsh vol-delete`	libvirt 全可见 ✅️

📦 存储池 (Storage Pool)#

概念#

==存储池== 就是 libvirt 管理的”仓库”，虚拟机磁盘、ISO 镜像都放在池子里

通俗解释：qemu-img 创建的磁盘就像你自己在仓库里堆货物 —— 仓库管理员 (libvirt) 不知道你放了什么

存储池就是让管理员接手管理，他知道仓库里有什么、还剩多少空间、哪个货物归谁

就是 libvirt 对磁盘的”正式管理方式”

存储池类型#

类型	说明	适用场景
`dir`	目录型，最常用	本地磁盘镜像存放
`lvm`	基于 LVM 卷组	需要快照、高性能的场景
`nfs`	基于 NFS 共享	共享存储、迁移场景

💡 这里我们以 ==dir 目录型== 为重点，生产环境中 LVM 和 NFS 同样重要

创建目录型存储池#

Terminal window展开收起

1
1)定义存储池
2
[root@vhost1 ~]# virsh pool-define-as guest_images_dir dir --target "/guest_images"
3
Pool guest_images_dir defined
4
# pool-define-as: 定义存储池
5
# guest_images_dir: 存储池名称
6
# dir: 类型为目录型
7
# --target: 存储池对应的物理目录路径
8

9
2)构建存储池(自动创建目标目录)
10
[root@vhost1 ~]# ls /guest_images
11
ls: cannot access '/guest_images': No such file or directory   '目录还不存在'
12
[root@vhost1 ~]# virsh pool-build guest_images_dir
13
Pool guest_images_dir built
14
[root@vhost1 ~]# ls -ld /guest_images
15
drwx--x--x. 2 root root 6 Jun  1 08:44 /guest_images        '目录已自动创建'
16

17
3)启动存储池
18
[root@vhost1 ~]# virsh pool-start guest_images_dir
19
Pool guest_images_dir started
20

21
4)设置开机自启
22
[root@vhost1 ~]# virsh pool-autostart guest_images_dir
23
Pool guest_images_dir marked as autostarted
24

25
5)查看存储池详细信息
26
[root@vhost1 ~]# virsh pool-info guest_images_dir
27
Name:           guest_images_dir
28
UUID:           0f07bb21-b726-4da1-86fd-34ed7fcdb884
29
State:          running            '✅️ 活跃状态'
30
Persistent:     yes                '✅️ 持久化'
31
Autostart:      yes                '✅️ 开机自启'
32
Capacity:       69.94 GiB          '总容量'
33
Allocation:     21.94 GiB          '已分配'
34
Available:      48.00 GiB          '可用空间'

展开收起

📌 四步走：pool-define-as → pool-build → pool-start → pool-autostart

💡 类比对照：存储池的操作和上篇笔记 ==虚拟网络== 的操作几乎一模一样

操作	虚拟网络	存储池
定义	`virsh net-define`	`virsh pool-define-as`
启动	`virsh net-start`	`virsh pool-start`
自启	`virsh net-autostart`	`virsh pool-autostart`
查看	`virsh net-list --all`	`virsh pool-list --all`
停止	`virsh net-destroy`	`virsh pool-destroy`
删除	`virsh net-undefine`	`virsh pool-undefine`

默认存储池#

Terminal window

1
[root@vhost1 ~]# virsh pool-list --all
2
 Name               State    Autostart
3
----------------------------------------
4
 default            active   yes
5
 guest_images_dir   active   yes
6
 images             active   yes
7

8
[root@vhost1 ~]# virsh pool-dumpxml default | grep path
9
    <path>/var/lib/libvirt/images</path>
10
# 这就是 day02 中我们一直放磁盘的地方！

Note

📌 default 池会自动管理目录中的镜像：重启后或 pool-refresh 后，目录里的 .qcow2 文件会被自动识别为存储卷

--------------格式有要求吗??? 上篇笔记并没有要求的!! .qcow2 ???

这就是为什么 day02 中我们用 qemu-img create 创建的磁盘，在 virsh vol-list default 里也能看到

📦 存储卷 (Storage Volume)#

概念#

==存储卷== 是存储池中的具体”货物” —— 一个虚拟磁盘文件
通俗解释：池子是仓库，卷就是仓库里的每个箱子 (磁盘镜像)

🧱 与 day02 的联动：

day02 方式 (手动)	day03 方式 (受管)
`qemu-img create -f qcow2 node.img 15G`	`virsh vol-create-as --pool guest_images_dir --name vm-disk1 --capacity 20GB --format qcow2`
`qemu-img create -f qcow2 -b node.img node1.qcow2 20G`	`virsh vol-create-as --pool ... --backing-vol vm-disk1 --backing-vol-format qcow2`
`rm -rf /var/lib/libvirt/images/node1.qcow2`	`virsh vol-delete vm-disk1 guest_images_dir`

创建存储卷#

Terminal window展开收起

1
1)在存储池中创建卷
2
[root@vhost1 ~]# virsh vol-create-as \
3
  --pool guest_images_dir \
4
  --name vm-disk1 \
5
  --capacity 20GB \
6
  --format qcow2
7
Vol vm-disk1 created
8

9
2)验证卷已创建
10
[root@vhost1 ~]# ls /guest_images/
11
vm-disk1
12
[root@vhost1 ~]# qemu-img info /guest_images/vm-disk1
13
image: "api"
14
file format: qcow2
15
virtual size: 18.6 GiB (20000000000 bytes)
16
disk size: 196 KiB            '精简置备，实际只占 196K'
17

18
3)查看存储池中的卷列表
19
[root@vhost1 ~]# virsh vol-list guest_images_dir
20
 Name       Path
21
------------------------------------
22
 vm-disk1   /guest_images/vm-disk1
23

24
4)查看卷详细信息
25
[root@vhost1 ~]# virsh vol-info vm-disk1 guest_images_dir
26
Name:           vm-disk1
27
Type:           file
28
Capacity:       18.63 GiB
29
Allocation:     196.00 KiB

展开收起

📌 virsh vol-create-as 参数速查：

参数	含义
`--pool`	目标存储池名称
`--name`	卷名称
`--capacity`	容量 (支持 G/M/K 单位)
`--format`	格式 (qcow2 / raw)
`--backing-vol`	后端盘名称 (创建前端盘时用)
`--backing-vol-format`	后端盘格式

使用 virsh 创建前端盘#

回顾 day02 COW 概念：前端盘依赖后端盘，只存差异数据

Terminal window展开收起

1
[root@vhost1 ~]# virsh vol-create-as \
2
  --pool guest_images_dir \
3
  --name vm-disk1-front \
4
  --capacity 30G \
5
  --format qcow2 \
6
  --backing-vol vm-disk1 \
7
  --backing-vol-format qcow2
8
Vol vm-disk1-front created
9

10
[root@vhost1 ~]# qemu-img info /guest_images/vm-disk1-front
11
image: "api"
12
file format: qcow2
13
virtual size: 30 GiB (32212254720 bytes)
14
disk size: 196 KiB
15
backing file: /guest_images/vm-disk1          '后端盘已关联 ✅️'
16
backing file format: qcow2

展开收起

✅️ 对比 day02 的 qemu-img create -b：效果完全一样，但 libvirt 现在”知道”这个前端盘的存在

使 qemu-img 创建的磁盘受管#

Terminal window展开收起

1
1)用 qemu-img 手动创建磁盘
2
[root@vhost1 ~]# cd /guest_images/
3
[root@vhost1 /guest_images]# qemu-img create -f qcow2 test.qcow2 10G
4
[root@vhost1 /guest_images]# ls
5
test.qcow2  vm-disk1  vm-disk1-front
6

7
2)当前 libvirt 看不到这个磁盘
8
[root@vhost1 /guest_images]# virsh vol-list guest_images_dir
9
 Name             Path
10
------------------------------------------------
11
 vm-disk1         /guest_images/vm-disk1
12
 vm-disk1-front   /guest_images/vm-disk1-front
13
# test.qcow2 不在列表中 ❌️
14

15
3)刷新存储池
16
[root@vhost1 /guest_images]# virsh pool-refresh guest_images_dir
17
Pool guest_images_dir refreshed
18

19
4)再次查看——已经受管了
20
[root@vhost1 /guest_images]# virsh vol-list guest_images_dir
21
 Name             Path
22
------------------------------------------------
23
 test.qcow2       /guest_images/test.qcow2     '✅️ 出现了!'
24
 vm-disk1         /guest_images/vm-disk1
25
 vm-disk1-front   /guest_images/vm-disk1-front
26

27
5)删除卷
28
[root@vhost1 /guest_images]# virsh vol-delete test.qcow2 guest_images_dir
29
Vol test.qcow2 deleted

展开收起

📌 pool-refresh：让 libvirt 重新扫描存储池目录，把不认识的文件”登记入册”

default 池在重启后会自动 refresh，自定义池需要手动执行

⚙️ XML 配置管理 (高级)#

三种修改 XML 的方式#

在 day02 中我们用 vim 直接编辑 XML 文件，day03 介绍更优雅的方式

方式	命令	优点	缺点
直接 vim	`vim /etc/libvirt/qemu/test.xml`	最灵活	语法错误风险高、需手动生效
virsh edit	`virsh edit test`	自动语法校验	还是手写 XML
virt-xml	`virt-xml test --edit --memory 4096`	==不用写 XML==，一行命令搞定	部分复杂场景仍需手写

Terminal window

1
1)语法校验
2
[root@vhost1 ~]# virt-xml-validate /etc/libvirt/qemu/test.xml
3
/etc/libvirt/qemu/test.xml validates      '✅️ 语法正确'

内存管理#

Terminal window展开收起

1
1)查看当前内存配置
2
[root@vhost1 ~]# virsh dumpxml test | grep -i mem
3
  <memory unit='KiB'>2097152</memory>           '最大内存 2G'
4
  <currentMemory unit='KiB'>2097152</currentMemory>  '当前内存 2G'
5

6
2)关机状态下修改最大内存
7
[root@vhost1 ~]# virsh setmaxmem --size 1G test
8
[root@vhost1 ~]# virsh dumpxml test | grep -i mem
9
  <memory unit='KiB'>1048576</memory>           '最大内存 → 1G'
10
  <currentMemory unit='KiB'>1048576</currentMemory>
11

12
3)开机后动态调整当前内存(不能超过 maxmem)
13
[root@vhost1 ~]# virsh start test
14
[root@vhost1 ~]# virsh setmem --size 512M test     '运行时缩小到 512M ✅️'
15
[root@vhost1 ~]# virsh dumpxml test | grep -i mem
16
  <memory unit='KiB'>1048576</memory>              '最大 还是 1G'
17
  <currentMemory unit='KiB'>524288</currentMemory>  '当前 512M'
18

19
[root@vhost1 ~]# virsh setmem --size 2G test       '❌️ 超过 maxmem'
20
error: invalid argument: cannot set memory higher than max memory

展开收起

⚠️ 关键区别：

命令	作用	运行时可用?
`virsh setmaxmem`	修改最大内存上限	❌️ 关机才能改
`virsh setmem`	修改当前使用内存	✅️ 可以热调整 (但不能超 maxmem)

CPU 管理#

Terminal window展开收起

1
1)查看当前 vCPU 配置
2
[root@vhost1 ~]# virsh dumpxml test | grep -i vcpu
3
  <vcpu placement='static' current='1'>1</vcpu>
4

5
2)关机状态下修改最大 vCPU
6
[root@vhost1 ~]# virsh setvcpus test 3 --config --maximum
7
[root@vhost1 ~]# virsh dumpxml test | grep -i vcpu
8
  <vcpu placement='static' current='1'>3</vcpu>
9
# 最大 3 核，当前使用 1 核
10

11
3)修改当前使用的 vCPU 数量
12
[root@vhost1 ~]# virsh setvcpus test 2 --current
13
[root@vhost1 ~]# virsh dumpxml test | grep -i vcpu
14
  <vcpu placement='static' current='2'>3</vcpu>
15
# 当前 2 核，最大 3 核
16

17
4)查看 vCPU 数量
18
[root@vhost1 ~]# virsh vcpucount test
19
maximum      config         3
20
current      config         2

展开收起

📌 参数区分：

参数	含义
`--config`	修改持久化配置 (关机生效)
`--current`	修改当前状态
`--maximum`	修改的是最大上限而非当前值
`--live`	热修改 (需 VM 运行中)

virt-xml 一行搞定#

==virt-xml== 让你不用手写 XML 就能修改虚拟机配置

Terminal window展开收起

1
# 基本语法
2
virt-xml DOMAIN XML-ACTION XML-OPTION [选项]
3

4
1)修改内存
5
[root@vhost1 ~]# virt-xml test --edit --memory 4096
6
Domain 'test' defined successfully.
7
[root@vhost1 ~]# virsh dumpxml test | grep -i mem
8
  <memory unit='KiB'>4194304</memory>
9
# 一行命令，内存变成 4G ✅️
10

11
2)添加磁盘(磁盘自动创建)
12
[root@vhost1 ~]# virt-xml test --add-device --disk /var/lib/libvirt/images/newdisk.qcow2,format=qcow2,size=20 --update
13
Allocating 'newdisk.qcow2'                                   |  20 GB  00:00:00
14
Domain 'test' defined successfully.
15
# 磁盘自动创建 + 附加，一步到位
16

17
3)修改网卡
18
[root@vhost1 ~]# virt-xml test --edit --network network=default
19
Domain 'test' defined successfully.
20
# 把 VM 从 vbr 网络切到 default 网络
21

22
4)移除磁盘设备
23
[root@vhost1 ~]# virsh shutdown test
24
[root@vhost1 ~]# virsh detach-disk test --config --target sda
25
Disk detached successfully
26
# --config: 持久化删除
27
# --target: 指定磁盘设备名
28

29
5)热添加磁盘(VM 运行中)
30
[root@vhost1 ~]# virsh vol-create-as --pool default --name vm-disk-test --capacity 20GB --format qcow2
31
[root@vhost1 ~]# virsh attach-disk test /var/lib/libvirt/images/vm-disk-test vdb
32
Disk attached successfully
33
# 在 VM 里 lsblk 就能看到新磁盘 vdb ✅️

展开收起

📌 virt-xml 四大动作：

动作	作用	示例
`--edit`	修改已有配置	`--edit --memory 4096`
`--add-device`	添加新设备	`--add-device --disk ...`
`--remove-device`	移除设备	`--remove-device --disk target=vdb`
`--build-xml`	只输出 XML 不修改	预览用

⚠️ 磁盘设备名与 bus 类型的关系：

Terminal window

1
<disk type="file" device="disk">
2
  <target dev="vda" bus="virtio"/>    '设备名 vda ← bus=virtio'
3
</disk>
4
<disk type="file" device="disk">
5
  <target dev="sda" bus="sata"/>      '设备名 sda ← bus=sata'
6
</disk>
7
# 同样的磁盘，bus 不同 → 在 VM 里看到的设备名不同

📸 快照与克隆#

快照 (Snapshot)#

==快照== 就是给虚拟机当前状态拍一张”照片”，以后随时可以回到这个状态
通俗解释：打游戏时存个档 —— 后面玩崩了就读档重来

Terminal window展开收起

1
1)创建快照
2
[root@vhost1 ~]# virsh snapshot-create-as test snap1
3
Domain snapshot snap1 created
4
[root@vhost1 ~]# virsh snapshot-create-as test snap2
5
Domain snapshot snap2 created
6
# snap1 → snap2 形成链式关系
7

8
2)查看快照树
9
[root@vhost1 ~]# virsh snapshot-list --tree test
10
snap1
11
  |
12
  +- snap2
13
# snap2 是在 snap1 基础上创建的
14

15
3)查看当前快照
16
[root@vhost1 ~]# virsh snapshot-current test --name
17
snap2
18

19
4)恢复到 snap1
20
[root@vhost1 ~]# virsh snapshot-revert test snap1
21
Domain snapshot snap1 reverted
22
[root@vhost1 ~]# virsh snapshot-current test --name
23
snap1
24
# 回到 snap1 后，snap2 还在但不再是"当前"状态
25

26
5)删除快照
27
[root@vhost1 ~]# virsh snapshot-delete test snap2
28
Domain snapshot snap2 deleted
29

30
6)查看快照 XML 详情
31
[root@vhost1 ~]# virsh snapshot-dumpxml test snap1

展开收起

📌 快照命令速查：

操作	命令
创建	`virsh snapshot-create-as <VM> <快照名>`
查看列表	`virsh snapshot-list <VM>`
查看树	`virsh snapshot-list --tree <VM>`
恢复	`virsh snapshot-revert <VM> <快照名>`
当前快照	`virsh snapshot-current <VM> --name`
删除	`virsh snapshot-delete <VM> <快照名>`
查看详情	`virsh snapshot-dumpxml <VM> <快照名>`

💡 与 day02 virt-sysprep 的区别：

virt-sysprep：永久清理个性化信息，用于制作模板
virsh snapshot：临时保存状态，用于实验/回滚

克隆 (Clone)#

==克隆== 就是基于一台现有虚拟机制作一份完整的副本

Terminal window

1
1)自动克隆(libvirt 自动命名、自动分配磁盘路径)
2
[root@vhost1 ~]# virt-clone --original test --auto-clone
3
Allocating 'test-clone.qcow2'                                |  20 GB  00:00:13
4
Clone 'test-clone' created successfully.
5

6
2)手动指定克隆参数
7
[root@vhost1 ~]# virt-clone \
8
  --original example-VM-2 \
9
  --name example-VM-3 \
10
  --file /var/lib/libvirt/images/disk-1-example-VM-2.qcow2 \
11
  --file /var/lib/libvirt/images/disk-2-example-VM-2.qcow2

📌 virt-clone 会自动处理：UUID 去重、MAC 地址去重、个性化信息清理 —— 不用再手动搞

⚠️ 克隆 vs 前端盘方案：

	virt-clone 克隆	day02 前端盘 + COW
磁盘占用	==完整复制== (每台独立一份数据)	==增量== (共享后端盘)
空间效率	低 ❌️	高 ✅️
独立性	完全独立 ✅️	依赖后端盘
适合场景	少量、完全隔离的场景	批量快速部署

Terminal window

1
# 验证克隆的磁盘是完整复制
2
[root@vhost1 ~]# du -sh /var/lib/libvirt/images/test-clone.qcow2
3
1.5G    /var/lib/libvirt/images/test-clone.qcow2
4
# 1.5G → 完整复制，不是前端盘(前端盘一般只有几百K)

🐟 guestfish 和 guestmount#

概念#

==libguestfs 工具集== 让你 ==不启动虚拟机就能操作磁盘内部==
在 day02 知识补充中我们提到了这个工具集，day03 深入实战

📌 一句话：VM 死机了？照样能看日志、改配置、捞数据

工具	模式	适合场景
`guestmount`	挂载模式 (类似 `mount`)	浏览文件、结合宿主机命令操作
`guestfish`	交互式 Shell	脚本化操作、复杂定制

guestmount —— 把镜像挂载成目录#

Terminal window展开收起

1
1)安装工具
2
[root@vhost1 ~]# yum -y install libguestfs
3

4
2)创建挂载目录
5
[root@vhost1 ~]# mkdir /vmdir
6

7
3)挂载镜像(-a 指定磁盘, -i 自动检测并挂载分区)
8
[root@vhost1 ~]# guestmount -a /var/lib/libvirt/images/test-clone.qcow2 -i /vmdir
9
[root@vhost1 ~]# df -h /vmdir
10
Filesystem      Size  Used Avail Use% Mounted on
11
/dev/fuse        19G  1.5G   17G   8% /vmdir
12

13
4)现在可以像操作普通目录一样操作镜像内部了
14
[root@vhost1 ~]# ls /vmdir/
15
afs  boot  etc   lib    media  opt   root  sbin  sys  usr
16
bin  dev   home  lib64  mnt    proc  run   srv   tmp  var
17

18
[root@vhost1 ~]# mkdir /vmdir/testdir
19
[root@vhost1 ~]# echo 123 > /vmdir/testdir/123.txt
20
[root@vhost1 ~]# cp /vmdir/etc/hosts /mnt
21

22
5)卸载
23
[root@vhost1 ~]# guestunmount /vmdir

展开收起

💡 注意：guestmount 底层会创建临时 VM 来访问磁盘 (在 virt-manager 中可见)，卸载后自动删除

guestfish —— 交互式定制磁盘#

这次我们在镜像里安装 httpd、创建用户、定制网站首页

Terminal window展开收起

1
1)进入 guestfish 交互式 Shell
2
[root@vhost1 ~]# guestfish -i --network -a /var/lib/libvirt/images/test-clone.qcow2
3
# -i: 自动挂载
4
# --network: 启用网络 (安装软件需要)
5
# -a: 指定磁盘镜像
6

7
2)查看文件(Fish 自带命令)
8
><fs> wc-l /etc/hosts
9
7
10

11
3)调用操作系统的命令(需加 command 前缀)
12
><fs> command "wc -l /etc/hosts"
13
7 /etc/hosts
14

15
4)安装 httpd 服务(走网络, 较慢)
16
><fs> command "yum -y install httpd"
17

18
5)定制首页
19
><fs> touch /var/www/html/index.html
20
><fs> vi /var/www/html/index.html       'fish 内置 vi 编辑器'
21
><fs> cat /var/www/html/index.html
22
index
23

24
6)创建用户并设密码
25
><fs> command "useradd user1"
26
><fs> command "echo redhat | passwd --stdin user1"
27

28
7)设置 httpd 开机自启
29
><fs> command "systemctl enable httpd"
30
><fs> command "systemctl is-enabled httpd"
31
enabled                                '✅️ 已设为自启'
32

33
8)重新打 SELinux 标签(重要!)
34
><fs> selinux-relabel /etc/selinux/targeted/contexts/files/file_contexts /
35

36
9)退出
37
><fs> exit

展开收起

⚠️ guestfish 的两套命令体系：

类型	来源	示例	特点
Fish 内置命令	libguestfs	`cat`, `vi`, `touch`, `wc-l`	直接操作文件
系统命令	VM 磁盘内的 OS	`command "yum install ..."`	需要 `command` 前缀

Warning

command "vim ..." 不能用 —— guestfish 不会给 vim 分配终端，会卡住

要编辑文件请用 Fish 内置的 vi 命令

📌 guestfish vs guestmount 对比：

对比维度	guestfish	guestmount
核心特性	交互式 Shell	文件系统挂载点
底层原理	基于 libguestfs 库	基于 FUSE
使用方式	单一工具内操作	挂载后用任何宿主机命令
适合场景	脚本化批量处理	浏览文件、结合外部工具

验证定制结果#

Terminal window

1
# 基于定制好的磁盘创建 VM
2
[root@vhost1 ~]# ssh root@192.168.122.207     '登进去验证'
3
[root@localhost ~]# curl 127.0.0.1/index.html
4
index                                          '首页 ✅️'
5
[root@localhost ~]# id user1
6
uid=1001(user1) gid=1001(user1) groups=1001(user1)   '用户 ✅️'

🌐 桥接网络 (非 NAT)#

概念#

回顾 day01：default 网络使用 NAT 模式，虚拟机通过 virbr0 (192.168.122.0/24) 上网，==外面无法直接访问虚拟机==
day02 我们创建了自定义 my_net (192.168.219.0/24)，仍然基于 NAT
==桥接网络== 让虚拟机直接”插”在物理交换机上，获取和宿主机同网段的 IP

创建桥接网卡#

Terminal window展开收起

1
1)查看宿主机物理网卡
2
[root@vhost1 ~]# ip a s ens161
3
24: ens161: <BROADCAST,MULTICAST,UP,LOWER_UP> ...
4
    link/ether 00:0c:29:8d:09:0c ...
5
# 这是我们的物理网卡，后面要作为 br0 的 port
6

7
2)创建桥接(br0)
8
[root@vhost1 ~]# nmcli connection add type bridge ifname br0 con-name br0
9
[root@vhost1 ~]# nmcli connection add type ethernet port-type bridge ifname ens161 con-name br0-ens161 controller br0
10
[root@vhost1 ~]# nmcli connection up br0
11

12
3)验证 br0 获取到了教室网段的 IP
13
[root@vhost1 ~]# ip a s br0
14
25: br0: <BROADCAST,MULTICAST,UP,LOWER_UP> ...
15
    inet 10.2.35.218/22 brd 10.2.35.255 ...     '教室网段 IP ✅️'

展开收起

📌 nmcli 三步建桥：

步骤	命令	作用
①	`nmcli connection add type bridge`	创建桥设备 br0
②	`nmcli connection add type ethernet port-type bridge ... controller br0`	把物理网卡 ens161 设为 br0 的端口
③	`nmcli connection up br0`	激活桥接

🧱 类比：桥接 br0 就像是把虚拟机和宿主机插在同一个交换机上 —— IP 同网段、互相可见

将 VM 网络改为桥接#

Terminal window展开收起

1
1)VM 当前网络是 NAT (vbr)
2
[root@vhost1 ~]# virsh domiflist test
3
 Interface   Type      Source   Model    MAC
4
------------------------------------------------------------
5
 -           network   vbr      virtio   52:54:00:48:da:9d
6

7
2)使用 virt-xml 改为桥接
8
[root@vhost1 ~]# virt-xml test --edit --network bridge=br0,model=virtio
9
Domain 'test' defined successfully.
10

11
3)验证网卡已切换
12
[root@vhost1 ~]# virsh domiflist test
13
 Interface   Type     Source   Model    MAC
14
-----------------------------------------------------------
15
 -           bridge   br0      virtio   52:54:00:48:da:9d
16
# Type 从 network 变成 bridge ✅️
17

18
4)开机验证
19
[root@vhost1 ~]# virsh start test
20
[root@vhost1 ~]# virsh console test
21
[root@localhost ~]# ip a s
22
2: enp1s0: <BROADCAST,MULTICAST,UP,LOWER_UP> ...
23
    inet 10.2.33.2/22 ...               '获取到了教室网段 IP ✅️'
24
# 此时跨节点的虚拟机之间可以直接通信!

展开收起

Note

💡 NAT vs 桥接适用场景：

	NAT (virbr0 / my_net)	桥接 (br0)
IP 来源	libvirt DHCP (192.168.x.x)	教室/公司 DHCP
外部访问 VM	❌️ 需要端口转发	✅️ 直接可达
VM 间跨节点通信	❌️ 需要额外配置	✅️ 同网段直接通
安全性	高 (隔离在内网)	低 (暴露在物理网络)

🚢 虚拟机迁移#

概念#

==迁移== 就是把一台物理机上的虚拟机”搬”到另一台物理机上

📌 迁移的本质：

Terminal window

1
vhost1 (源主机)                     vhost2 (目标主机)
2
┌──────────────┐                  ┌──────────────┐
3
│  test (运行)  │  ───迁移───>    │  test (运行)  │
4
│  内存状态    │                  │  内存状态    │
5
│  磁盘数据    │                  │  磁盘数据    │
6
└──────────────┘                  └──────────────┘

迁移类型对比#

类型	存储	VM 状态	停机时间	命令参数
非共享存储热迁移	各自独立	running	极短	`--live --persistent`
共享存储实时迁移	NFS 共享	running	几乎为零	`--live --persistent`
离线迁移	共享存储	shut off	整个迁移过程	`--offline --persistent`

非共享存储热迁移#

磁盘在源主机上，需要手动把镜像拷贝到目标主机

Terminal window展开收起

1
# ===== 准备工作 =====
2

3
1)源主机和目标主机都需要同样的后端盘
4
[root@vhost1 ~]# scp /var/lib/libvirt/images/.node.img vhost2:/var/lib/libvirt/images/
5
[root@vhost2 ~]# virsh pool-refresh default
6

7
2)两边要有同样的网络
8
[root@vhost1 ~]# scp /etc/libvirt/qemu/networks/vbr.xml vhost2:/etc/libvirt/qemu/networks/vbr.xml
9
[root@vhost2 ~]# virsh net-define /etc/libvirt/qemu/networks/vbr.xml
10
[root@vhost2 ~]# virsh net-start vbr
11
[root@vhost2 ~]# virsh net-autostart vbr
12

13
3)迁移以 qemu 用户身份执行(uid=107)
14
[root@vhost1 ~]# chown -R qemu:qemu /var/lib/libvirt/images/
15
[root@vhost2 ~]# chown -R qemu:qemu /var/lib/libvirt/images/
16

17
4)放行迁移端口
18
[root@vhost1 ~]# firewall-cmd --add-port=49152/tcp
19
[root@vhost1 ~]# firewall-cmd --add-port=49152/tcp --permanent
20
[root@vhost2 ~]# firewall-cmd --add-port=49152/tcp
21
[root@vhost2 ~]# firewall-cmd --add-port=49152/tcp --permanent
22

23
5)手动拷贝前端盘到目标主机
24
[root@vhost1 ~]# scp /var/lib/libvirt/images/test.qcow2 vhost2:/var/lib/libvirt/images/test.qcow2
25

26
# ===== 执行迁移 =====
27
# 在 virt-manager 中: 右键运行中的 VM → 迁移 → 选目标主机 → 勾选 "Allow unsafe" → 点击 Migrate
28

29
# ===== 验证 =====
30
[root@vhost1 ~]# virsh -c qemu+ssh://root@vhost2/system list
31
 Id   Name   State
32
----------------------
33
 1    test   running         '在 vhost2 上了 ✅️'
34

35
[root@vhost1 ~]# virsh list --all
36
 Id   Name   State
37
--------------------
38
                              'vhost1 上已经没了 ✅️'

展开收起

共享存储实时迁移 (NFS)#

磁盘放在 NFS 共享上，两边都能访问，不用手动拷贝

Terminal window展开收起

1
# ===== NFS 服务端 (vhost1) =====
2
1)创建共享目录并放好后端盘
3
[root@vhost1 ~]# mkdir /shared_images
4
[root@vhost1 ~]# cp -p /var/lib/libvirt/images/.node.img /shared_images
5
[root@vhost1 ~]# cp -p /var/lib/libvirt/images/* /shared_images
6

7
2)配置 NFS 导出
8
[root@vhost1 ~]# cat /etc/exports
9
/shared_images  192.168.100.0/24(rw)
10

11
3)启动 NFS 并放行防火墙
12
[root@vhost1 ~]# systemctl restart nfs-server
13
[root@vhost1 ~]# firewall-cmd --add-service=nfs
14
[root@vhost1 ~]# firewall-cmd --add-service=nfs --permanent
15
[root@vhost1 ~]# firewall-cmd --add-service=rpc-bind
16
[root@vhost1 ~]# firewall-cmd --add-service=rpc-bind --permanent
17
[root@vhost1 ~]# firewall-cmd --add-service=mountd
18
[root@vhost1 ~]# firewall-cmd --add-service=mountd --permanent
19
[root@vhost1 ~]# exportfs -rv
20

21
# ===== 两边都挂载 NFS =====
22
[root@vhost1 ~]# mount vhost1:/shared_images /var/lib/libvirt/images/
23
[root@vhost2 ~]# mount vhost1:/shared_images /var/lib/libvirt/images/
24
# 两边看到的是同一份磁盘数据! ✅️
25

26
# ===== 迁移(在 virt-manager 中操作) =====
27
# 右键 VM → 迁移 → 选目标主机 → 点击 Migrate
28
# 不用再手动 scp 磁盘了 ✅️
29

30
# ===== 命令行热迁移 =====
31
[root@vhost1 ~]# virsh migrate --live test qemu+ssh://root@vhost2/system --persistent --undefinesource
32
# --live: 在线迁移
33
# --persistent: 目标端持久化
34
# --undefinesource: 迁移后从源端删掉定义
35

36
[root@vhost1 ~]# virsh list                       'vhost1 空了 ✅️'
37
[root@vhost1 ~]# virsh -c qemu+ssh://root@vhost2/system list
38
 Id   Name   State
39
----------------------
40
 3    test   running                              'vhost2 上运行中 ✅️'
41

42
# ===== 命令行离线迁移 =====
43
[root@vhost2 ~]# virsh shutdown test
44
[root@vhost2 ~]# virsh migrate test qemu+ssh://root@vhost1/system --offline --persistent
45
# --offline: 离线迁移 (VM 必须关机)

展开收起

📌 迁移命令参数速查：

参数	含义
`--live`	在线/热迁移 (VM 保持运行)
`--offline`	离线迁移 (VM 关机状态)
`--persistent`	目标端持久化配置
`--undefinesource`	迁移成功后在源端删除 VM 定义
`--verbose`	显示迁移进度

☁️ 官方云镜像#

概念#

OS 官方提供预装好的云镜像 (Cloud Image)，体积小、即下即用
和 day02 模板制作的区别：不用自己 virt-install 安装了，直接拿官方做好的镜像就行

使用流程#

Terminal window展开收起

1
1)下载云镜像(以 Rocky Linux 10 为例)
2
[root@vhost1 ~]# ls /images/*qcow2
3
/images/Rocky-10-GenericCloud-Base.latest.x86_64.qcow2
4

5
2)复制到存储池
6
[root@vhost1 ~]# cp /images/Rocky-10-GenericCloud-Base.latest.x86_64.qcow2 /var/lib/libvirt/images/rocky10.qcow2
7
[root@vhost1 ~]# virsh pool-refresh default
8

9
3)在 virt-manager 中导入
10
# 选择 "Import existing disk image"
11
# 选择 rocky10.qcow2，系统类型选 Rocky Linux 10
12
# 其余配置自定义
13

14
4)此时不知道 root 密码 ❌️
15
[root@vhost1 ~]# virsh console testrocky
16
localhost login: root
17
Password: ???       '云镜像没有预设密码!'

展开收起

virt-customize 设置密码#

Terminal window展开收起

1
1)先关机
2
[root@vhost1 ~]# virsh shutdown testrocky
3

4
2)使用 virt-customize 设置 root 密码
5
[root@vhost1 ~]# cd /var/lib/libvirt/images/
6
[root@vhost1 /var/lib/libvirt/images]# virt-customize -a rocky10.qcow2 --root-password password:redhat123
7
[   0.0] Examining the guest ...
8
[  33.0] Setting a random seed
9
[  33.1] Setting passwords
10
[  35.0] SELinux relabelling
11
[  39.9] Finishing off
12

13
3)开机验证
14
[root@vhost1 ~]# virsh start testrocky
15
[root@vhost1 ~]# virsh console testrocky
16
localhost login: root
17
Password: redhat123
18
[root@localhost ~]#         '✅️ 成功登录'

展开收起

📌 云镜像三种破密码方案：

方法	工具	特点
破密码	进入单用户模式	操作繁琐，不推荐
cloud-init	注入 cloud-init 配置	==云环境首选==，批量自动化
virt-customize	`virt-customize --root-password`	==最直接==，一行命令搞定

💡 virt-customize 和 guestfish 的关系：底层都基于 libguestfs，virt-customize 是更高层的封装，专为”定制云镜像”这个场景设计

📝 作业练习#

基于 day03 所学内容，完成以下练习

练习清单#

使用 Rocky Linux 10 云镜像，将 root 密码设为 huawei123
添加一块硬盘，创建基于 LVM 的存储池 guest_images_lvm
将官方云镜像复制到存储池目录中，使其受管
在存储池中，基于官方云镜像创建前端盘 (使用 virsh 命令创建受管的前端盘)
在 virt-manager 中使用前端盘创建虚拟机 (导入已存在的镜像)，采用默认配置
创建一个新的磁盘 testdisk.qcow2 (使用 virsh 命令创建受管的磁盘)，将磁盘添加到虚拟机中，名为 /dev/vdc
添加一张仅主机的网卡，创建网桥 br1，桥接到此仅主机的网卡
为虚拟机添加一张网卡，使用 br1 网桥
使用 virsh 或 virt-xml 命令，调整 CPU 和内存
运行虚拟机验证，验证后关机删除

参考命令速查#

Terminal window展开收起

1
# 设置密码
2
virt-customize -a <镜像> --root-password password:<密码>
3

4
# 创建 LVM 存储池
5
virsh pool-define-as guest_images_lvm logical --source-dev=<PV> --source-name=<VG> --target /dev/<VG>
6

7
# 存储池四步走
8
virsh pool-define-as <池名> dir --target "<目录>"
9
virsh pool-build <池名>
10
virsh pool-start <池名>
11
virsh pool-autostart <池名>
12

13
# 创建受管磁盘
14
virsh vol-create-as --pool <池名> --name 磁盘名 --capacity 大小 --format qcow2
15

16
# 创建受管前端盘
17
virsh vol-create-as --pool <池名> --name 前端盘名 --capacity 大小 --format qcow2 \
18
  --backing-vol 后端盘名 --backing-vol-format qcow2
19

20
# 附加磁盘(需指定正确的 target 设备名)
21
virsh attach-disk <VM> <磁盘路径> vdc
22

23
# 调整 CPU/内存
24
virt-xml <VM> --edit --memory <大小>
25
virsh setvcpus <VM> <数量> --config --maximum

展开收起

🔁 Day01 → Day03 知识串联#

能力	day01	day02	day03
安装 VM	`virt-install` 手动安装	模板机装一次，后续克隆	直接用官方云镜像
管理磁盘	`qemu-img create`	`qemu-img create -b` 前端盘	`virsh vol-create-as` 受管
网络	`default` NAT (virbr0)	自定义 NAT (my_net)	==桥接 (br0)==
管理方式	本地 `virsh`	远程 `qemu+ssh://`	远程 + 迁移
批量	❌️	shell 脚本 for 循环	脚本 + 受管存储池
备份恢复	❌️	❌️	==快照 + 克隆==
高级运维	❌️	guestfish 初识	==guestfish + guestmount 实战==

⚠️ 常见坑点#

问题	原因	解决
`qemu-img` 创建的磁盘 `virsh vol-list` 看不到	存储池没有 refresh	`virsh pool-refresh <池名>`
`virsh setmem` 报 “cannot set memory higher than max memory”	当前内存不能超过 maxmem	先关机 → `setmaxmem` → 开机 → `setmem`
`virt-clone` 磁盘占用和原 VM 一样大	克隆是完整复制，不是 COW	用 day02 前端盘方式替代
guestfish 中 `command "vim ..."` 卡住	fish 不给 vim 分配终端	用 fish 内置的 `vi` 命令
桥接 VM 获取不到 IP	br0 未正确桥接到物理网卡	检查 `nmcli connection show br0`
迁移报权限错误	镜像文件 owner 不是 qemu	`chown -R qemu:qemu /var/lib/libvirt/images/`
云镜像登录不了	官方镜像没有预设密码	`virt-customize --root-password` 设置

虚拟化管理与快速创建虚拟机

Fri, 17 Apr 2026 00:00:00 GMT

虚拟化管理 && 快速创建虚拟机#

[TOC]

🧱 常用命令速查#

命令	分类	主要功能	常用示例
`virsh list --all`	生命周期	==列出所有虚拟机==（含关机）	`virsh list --all`
`virsh start`	生命周期	==启动虚拟机==	`virsh start node`
`virsh shutdown`	生命周期	==正常关机==	`virsh shutdown node`
`virsh destroy`	生命周期	强制断电(关机)	`virsh destroy node`
`virsh undefine`	生命周期	删除定义（XML 也删，==磁盘保留==）	`virsh undefine node`
`virsh define`	定义	从 XML 注册虚拟机	`virsh define node1.xml`
`virsh domblklist`	查看	指定虚拟机（域）当前挂载的所有块设备（磁盘）	`virsh domblklist centos7.0`
`virsh dominfo`	查看	查看虚拟机详细信息（UUID、内存、CPU…）	`virsh dominfo node`
`virsh dumpxml`	查看	导出 XML 配置	`virsh dumpxml node > backup.xml`
`virsh console`	连接	串口直连 VM（不依赖网络）	`virsh console node`
`virsh domifaddr --source agent`	网络	通过 Guest Agent 查 VM 的 IP	`virsh domifaddr --source agent node`
`virsh domstate`	查看	看 VM 当前是 running 还是 shut off	`virsh domstate node`
`virsh uri`	连接	查看当前连接的是本地还是远程	`virsh uri`
`virsh net-list`	网络	查看虚拟网络	`virsh net-list --all`
`virsh net-edit`	网络	编辑网络配置	`virsh net-edit default`
`virsh net-destroy`	网络	强制停止网络(用于重启)	“
`virsh net-define/start`	网络	定义并启动虚拟网络	`virsh net-define vbr.xml && virsh net-start vbr`
`virt-install`	创建	命令行安装新 VM	`virt-install --name node --memory 2048 --disk ...`
`qemu-img create`	磁盘	创建镜像（后端盘/前端盘）	`qemu-img create -f qcow2 -b node.img node1.qcow2`
`qemu-img info`	磁盘	查看镜像信息	`qemu-img info node.qcow2`
`virt-sysprep`	模板	清理 VM 个性化信息（SSH 密钥、UUID 等）	`virt-sysprep -d node`

⚙️ 远程连接管理#

📌 核心目标：在一台机器上，管理另一台机器里的虚拟机

Terminal window展开收起

1
'环境准备'
2
✅️ 两台虚拟机
3
[root@Vir-01 ~]#
4
[root@Vir-02 ~]#
5
====================
6
[root@Vir-01 ~]# rpm -qa qemu-kvm libvirt virt-install
7
qemu-kvm-10.0.0-14.el10_1.5.x86_64
8
libvirt-11.5.0-4.8.el10_1.x86_64
9
virt-install-5.0.0-1.el10.noarch
10
[root@Vir-01 ~]# systemctl is-active libvirtd
11
active
12

13
1)配置免密连接
14
[root@Vir-01 ~]# ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa_test -N ''
15
[root@Vir-01 ~]# echo 'IdentityFile ~/.ssh/id_rsa_test' >> /etc/ssh/ssh_config
16
[root@Vir-01 ~]# ssh-copy-id -i ~/.ssh/id_rsa_test.pub root@10.0.0.199
17
[root@Vir-01 ~]# ssh 10.0.0.199 'hostname'
18
Vir-02
19
'成功' --> ✅️ 远程执行命令不需要输入密码
20
📌 Vir-02 也要执行类似的操作 --> '互相免密登录' ✅
21
[root@Vir-02 ~]# ssh 10.0.0.199 'hostname'
22
Vir-01
23

24
2)配置hosts表
25
# 每次输入那么长的IP, 太累了
26
[root@Vir-02 ~]# cat >> /etc/hosts <<'EOF'
27
10.0.0.198 v1 Vir-01
28
10.0.0.199 v2 Vir-02
29
EOF
30
[root@Vir-02 ~]# scp /etc/hosts v1:/etc/
31

32
3)需要提前在Vir-01上面准备一台虚拟机
33
✅️ Vir-01上操作
34
[root@Vir-01 ~]# virsh list --all
35
 Id   Name           State
36
------------------------------
37
 12   rocky10-test   running
38
 'Vir-01 上本地确认'
39
 ====================
40
 [root@Vir-01 ~]# virsh -c qemu:///system list --all
41
 Id   Name           State
42
------------------------------
43
 12   rocky10-test   running
44
 # ⬆️上面这两条命令是完全等价的
45
   1.`-c` 是 `--connect` 的缩写，告诉 virsh "我这次要连谁"
46
   2.'不写 -c 时，libvirt 自动帮你补上 qemu:///system'（连本地）

展开收起

Note

📌 其实每一条 virsh 命令背后都有一个 URI，你之前一直不写，就是用了默认值：

Terminal window

1
4)查看本地 libvirt 连接 URI
2
[root@Vir-01 ~]# virsh uri
3
qemu:///system
4
'默认连接本地 qemu 系统实例'

📌 核心要记住的 URI 格式：

连接目标	URI
本地系统实例	`qemu:///system`
本地会话实例	`qemu:///session`
远程 (SSH) ✅️	`qemu+ssh://root@<IP>/system`

Terminal window展开收起

1
5)Vir-02 上远程连过来查
2
✅️ Vir-02操作
3
[root@Vir-02 ~]# virsh -c qemu+ssh://root@v1/system list --all
4
# 这里v1就是Vir-01的IP地址
5
# 10.0.0.198 v1 Vir-01
6
 Id   Name           State
7
------------------------------
8
 12   rocky10-test   running
9
'通过 SSH 隧道远程管理 libvirt'
10
====================
11
'远程管理本质上就是换个地址而已'
12
virsh -c qemu+ssh://root@v1/system list --all
13
               ↑
14
         把默认的本地 URI 换成远程 URI
15
    整条命令的本质就是：`virsh --connect <目标机器> list --all`

展开收起

核心优势#

virsh 和 libvirtd 是什么关系？

Terminal window

1
virsh (客户端)  ──通信──>  libvirtd (守护进程)
2
'你敲的命令'               '后台 systemd 服务'
3
✅️总在你本机             ⚠️可以在本机，也可以在对面机器上

virsh = 遥控器（你手里拿的工具）
libvirtd = 电视机（真正干活的东西）
你按遥控器 → 电视机收到信号 → 换台

完整流程（把 virsh 补进来）：

Terminal window

1
你(Vir-02) 在终端敲 virsh
2
    ↓
3
virsh(本机客户端) 解析 URI，发现目标是远程
4
    ↓
5
走 SSH 隧道
6
    ↓
7
Vir-01 上的 libvirtd(远程服务端) 收到指令
8
    ↓
9
libvirtd 真正干活：查虚拟机、启动、关机...
10
    ↓
11
结果原路返回 → virsh → 显示在你终端上

你之前本地操作时，virsh 自动连的是本地 libvirtd（qemu:///system）
远程管理就是把 virsh 的目标换成对面机器上的 libvirtd（qemu+ssh://）

Tip

==全程不需要先 SSH 登录到 Vir-01 再敲命令==

✅️ 相当于：你家服务器放客厅，你坐卧室用笔记本就能开关那台服务器上的==虚拟机==

传统方式	virsh 远程
先 `ssh v1` 登录过去，在远程 shell 里敲命令	坐在自己机器上，`-c qemu+ssh://` 一步到位
10 台机器？那就登录 10 次、敲 10 次	10 台机器？写个 `for` 循环，脚本一次性跑完

Note

📌 一句话：让远程的 libvirtd 就像安装在本地一样

你写的脚本循环 100 台机器，每条命令自动通过 SSH 隧道飞过去执行、结果飞回来

virsh 交互式#

前面每次都要带一长串 -c qemu+ssh://...，太累了

==交互式模式==就是：==先挂上去，然后连续敲命令==，不用每条都加 -c

Terminal window

1
'对比两种方式'
2
1)一次性命令（每条都要带 -c）
3
virsh -c qemu+ssh://root@v1/system list --all
4
virsh -c qemu+ssh://root@v1/system dominfo rocky10-test
5
      ↑ 每条都带这串，烦死
6

7
2)交互式切换（进去，切一次，后面不用带了）
8
virsh ✅️ '进入 virsh 小 shell'
9
virsh # connect qemu+ssh://root@v2/system '切一次就行'
10
virsh # list --all                        '不用带 -c'
11
virsh # dominfo rocky10-test              '不用带 -c'
12
virsh # start rocky10-test                '不用带 -c'
13
virsh # connect qemu:///system            '切回本地'
14
virsh # exit                              '退出'

🌏 ==场景类比==：

一次性命令	交互式切换
每次打电话都要拨完整的号码	✅️ 打开通讯录，点一下联系人就开始通话

Terminal window展开收起

1
'实际实验'
2
[root@Vir-02 ~]# virsh
3
Welcome to virsh, the virtualization interactive terminal.
4
Type:  'help' for help with commands
5
       'quit' to quit
6

7
virsh # list --all
8
 Id   Name   State
9
--------------------
10
🈳 '因为Vir-02 机器上并没有虚拟机'
11

12
virsh # connect qemu+ssh://root@v1/system
13
# 切到 Vir-01
14
virsh # list --all
15
 Id   Name           State
16
------------------------------
17
 12   rocky10-test   running
18
virsh # dominfo rocky10-test
19
Id:             12
20
Name:           rocky10-test
21
UUID:           4b4478bd-d7d7-48c2-98b5-db9dd79db6c3
22
OS Type:        hvm
23
State:          running
24
.......................
25

26
virsh # connect qemu:///system
27
# 切回本地
28
virsh # list --all
29
 Id   Name   State
30
--------------------
31
virsh # exit

展开收起

💡 交互式模式的好处：一次连接后可连续执行多条 virsh 命令，不用每条命令都带 -c 参数

🧱 嵌套虚拟化#

概念#

通俗解释：嵌套虚拟化就是 ==“虚拟机里跑虚拟机”==

你想在 VMware 虚拟机里再装一个 KVM 跑虚拟机？那就需要嵌套虚拟化

嵌套虚拟化术语：

层级	说明
第 0 级 (L0)	物理主机，裸机
第 1 级 (L1)	在 L0 上运行的标准虚拟机，可充当额外的虚拟主机
第 2 级 (L2)	在 L1 虚拟主机上运行的嵌套虚拟机

⚠️ 注意：嵌套虚拟化==严重限制 L2 虚拟机的性能==，主要用于开发和测试场景

两层开关#

我们不是在 VMware 里早就开了虚拟化吗，怎么这里还要开一次？

Terminal window

1
VMware --> 勾选"虚拟化 Intel VT-x/AMD-V"
2
  Vir-01 (L1) --> nested=1
3
    rocky10-test (L2) --> 里面还能跑虚拟机

开关	在哪设	作用
第一层 VMware 勾选 ✅️	VMware 虚拟机设置	让 L1 能用 CPU 虚拟化功能，==没有它 KVM 根本用不了==
第二层 `nested=1`	Linux 内核模块参数	让 L1 把虚拟化能力继续往下传给 L2，==默认不开==

Tip

📌 一句话：没有第一层 → KVM 不工作；没有第二层 → KVM 能工作，但虚拟机里不能再跑虚拟机

启用方法#

无论 Intel 还是 AMD，流程一样：看 CPU 标志 → 看内核模块状态 → 没开 → 就开

Terminal window展开收起

1
1)验证 CPU 是否支持嵌套虚拟化
2
[root@Vir-01 ~]# cat /proc/cpuinfo | grep -E 'vmx|svm'
3
'Intel 看 vmx，AMD 看 svm'
4

5
2)检查当前启用状态
6
# 内核模块状态
7
[root@Vir-01 ~]# cat /sys/module/kvm_intel/parameters/nested
8
# ⬆️ Intel
9
[root@Vir-01 ~]# cat /sys/module/kvm_amd/parameters/nested
10
# ⬆️ AMD
11
Y 或 1 → '✅️ 已启用'
12
N 或 0 → '❌ 未启用，需执行以下步骤'
13

14
3)启用嵌套虚拟化
15
⚠️ 先停掉所有运行中的虚拟机
16
📌 '为了让kvm中的虚拟机也可以嵌套虚拟机'
17
# 临时：重启后失效
18
'Intel'
19
  modprobe -r kvm_intel && modprobe kvm_intel nested=1
20
'AMD'
21
  modprobe -r kvm_amd && modprobe kvm_amd nested=1
22

23
# 永久：写配置文件
24
'Intel'
25
  echo 'options kvm_intel nested=1' >> /etc/modprobe.d/kvm.conf
26
'AMD'
27
  echo 'options kvm_amd nested=1'   >> /etc/modprobe.d/kvm.conf

展开收起

📌 Intel vs AMD 速查：

	Intel	AMD
CPU 标志	`vmx`	`svm`
内核模块	`kvm_intel`	`kvm_amd`
配置行	`options kvm_intel nested=1`	`options kvm_amd nested=1`

📦 虚拟机组成 && 模版机制作#

虚拟机 = XML 文件 + 镜像文件#

通俗解释：

XML 文件 → 相当于==机箱配置单==，定义了 CPU、内存、网卡、磁盘等信息

镜像文件 → 相当于==硬盘==，存操作系统和数据

Terminal window

1
[root@Vir-01 ~]# ls /etc/libvirt/qemu/
2
autostart  networks  rocky10.xml     'XML 定义文件在这'
3
[root@Vir-01 ~]# ls /var/lib/libvirt/images/
4
rocky10.qcow2                         '磁盘镜像文件在这'

📌 关键目录速查：

内容	路径
虚拟机 XML 定义	`/etc/libvirt/qemu/`
网络 XML 定义	`/etc/libvirt/qemu/networks/`
自动启动链接	`/etc/libvirt/qemu/autostart/`
磁盘镜像	`/var/lib/libvirt/images/`

Terminal window

1
jiuzhao@Ubuntu 桌面$ ls /etc/libvirt/qemu
2
centos7.0.xml   networks ......
3
jiuzhao@Ubuntu 桌面$ ls /etc/libvirt/qemu/networks/
4
# Ubuntu的都在这个目录下
5
autostart  default.xml

虚拟网络创建#

默认的 default 网络使用 NAT 模式，网段 192.168.122.0/24，这里我们新建一个 my_net 网络

Terminal window展开收起

1
1)查看当前网络
2
[root@Vir-01 ~]# virsh net-list --all
3
 Name      State    Autostart   Persistent
4
--------------------------------------------
5
 default   active   yes         yes
6

7
2)查看默认网络配置
8
[root@Vir-01 ~]# cat /etc/libvirt/qemu/networks/default.xml
9
<network>
10
  <name>default</name>
11
  <uuid>505069fc-7e13-4102-bb4c-ce60d33c822d</uuid>
12
  <forward mode='nat'/>
13
  <bridge name='virbr0' stp='on' delay='0'/>
14
  <mac address='52:54:00:74:59:5b'/>
15
  <ip address='192.168.122.1' netmask='255.255.255.0'>
16
    <dhcp>
17
      <range start='192.168.122.2' end='192.168.122.254'/>
18
    </dhcp>
19
  </ip>
20
</network>
21
'libvirt 使用 dnsmasq 服务为虚拟机提供 DNS 和 DHCP'
22

23
3)复制并修改，创建 my_net 网络
24
[root@Vir-01 ~]# ls -lh /etc/libvirt/qemu/networks/default.xml
25
-rw------- 1 root root 576 May 28 18:54 /etc/libvirt/qemu/networks/default.xml
26
[root@Vir-01 ~]# cp /etc/libvirt/qemu/networks/default.xml /etc/libvirt/qemu/networks/my_net.xml
27
[root@Vir-01 ~]# vim /etc/libvirt/qemu/networks/my_net.xml
28
📌 在这里面, 我手动更改了 'IP地址' 和 'DHCP分配的地址'
29
[root@Vir-01 ~]# cat /etc/libvirt/qemu/networks/my_net.xml
30
<network>
31
  <name>❌️default❌️</name>
32
  <uuid>❌️505069fc-7e13-4102-bb4c-ce60d33c822d❌️</uuid>
33
  <forward mode='nat'/>
34
  <bridge ❌️name='virbr0'❌️ stp='on' delay='0'/>
35
  <mac ❌️address='52:54:00:74:59:5b'❌️/>
36
  <ip address='192.168.219.1' netmask='255.255.255.0'>
37
    <dhcp>
38
      <range start='192.168.219.2' end='192.168.219.254'/>
39
    </dhcp>
40
  </ip>
41
</network>
42
============================
43
⚠️ 再来说问题❌️ --> <uuid>、<mac address>、<name>重复🔁
44
🦄<name> 是 libvirt 管理的网络名称 --> virsh net-list 里显示的名字
45
🦄<bridge name> 是系统实际创建的网桥设备名 --> ip addr show my_net 看到的网卡名
46
============================
47
[root@Vir-01 ~]# uuidgen
48
3a9e9bcb-9313-49bf-b36e-822deb0d5c85
49
# 手动生成新的UUID
50
✅️ MAC 地址 — libvirt 默认用 52:54:00 开头
51
# 把后面三段随便改就行
52
✅️ 网络名称 --> my_net
53
[root@Vir-01 ~]# vim /etc/libvirt/qemu/networks/my_net.xml
54
<network>
55
  <name>my_net</name>
56
  <uuid>3a9e9bcb-9313-49bf-b36e-822deb0d5c85</uuid>
57
  <forward mode='nat'/>
58
  <bridge name='my_net' stp='on' delay='0'/>
59
  <mac address='52:54:00:aa:bb:cc'/>
60
  <ip address='192.168.219.1' netmask='255.255.255.0'>
61
    <dhcp>
62
      <range start='192.168.219.2' end='192.168.219.254'/>
63
    </dhcp>
64
  </ip>
65
</network>
66

67
4)定义并启动新网络
68
[root@Vir-01 ~]# virsh net-define /etc/libvirt/qemu/networks/my_net.xml
69
Network my_net defined from /etc/libvirt/qemu/networks/my_net.xml
70
✅️ 注册一个新网络让 libvirt 认识它
71
[root@Vir-01 ~]# virsh net-list --all
72
 Name      State         Autostart  Persistent
73
--------------------------------------------
74
 default  active         yes         yes
75
 my_net   ❌️'inactive'  'no'❌️       yes
76
⚠️ 现在是不活跃的, 开机不会启动
77
[root@Vir-01 ~]# virsh net-start my_net
78
Network my_net started
79
✅️ 启动(应用)自定义网络
80
[root@Vir-01 ~]# virsh net-autostart my_net
81
Network my_net marked as autostarted
82
✅️ 使网络开机自启
83
[root@Vir-01 ~]# virsh net-list --all
84
 Name      State    Autostart   Persistent
85
--------------------------------------------
86
 default   active   yes         yes
87
 my_net    active   yes         yes
88

89
5)验证网卡已创建
90
[root@Vir-01 ~]# ip a s my_net
91
16: my_net: <NO-CARRIER,BROADCAST,MULTICAST,UP> ...
92
    inet 192.168.219.1/24 brd 192.168.219.255 scope global my_net

展开收起

💡 用 XML 定义出来的网络自带 DHCP（由 dnsmasq 服务提供）

如果用 nmcli 或图形化工具创建 bridge，默认不带 DHCP，需要手动配置 ❌️
- 所以在 KVM 里肯定用 XML 定义网络，方便太多 ✅️

操作	命令	含义
停止虚拟网络	`virsh net-destroy my_net`	（不是”摧毁”，是”停止服务”）停掉 bridge + dnsmasq
删除虚拟网络 (含 XML)	`virsh net-undefine my_net`	删 XML 文件，自动消失，不用手动 rm

Tip

网络和虚拟机不一样，没有”优雅关闭” shutdown 的说法，因为网络里没系统、没数据
要彻底删除一个网络，==两步都要执行==：先 net-destroy 停止，再 net-undefine 删除定义

Terminal window

1
[root@Vir-01 ~]# virsh net-destroy my_net
2
Network my_net destroyed
3
[root@Vir-01 ~]# virsh net-undefine my_net
4
Network my_net has been undefined
5
[root@Vir-01 ~]# virsh net-list --all
6
 Name      State    Autostart   Persistent
7
--------------------------------------------
8
 default   active   yes         yes
9
[root@Vir-01 ~]# ls /etc/libvirt/qemu/networks/my_net.xml
10
ls: cannot access ...xxx No such file or directory

后端盘 (Backing File)#

Terminal window

1
1)创建后端盘（没有系统，'后缀随意，格式为 qcow2'）
2
[root@Vir-01 ~]# cd /var/lib/libvirt/images/
3
[root@Vir-01 images]# ls
4
rocky10-test.qcow2
5
[root@Vir-01 images]# qemu-img create -f qcow2 node.img 15G
6
Formatting 'node.img', fmt=qcow2 cluster_size=65536 ... size=8589934592
7
⚠️ '8G系统盘空间太少了 --> 15G'

📌 ==参数拆解==：

选项	含义
`qemu-img create`	qemu-img 的 create 子命令，用来创建新镜像
`-f qcow2`	`-f` = format，指定镜像格式为 qcow2（精简置备 + COW 支持）
`node.img`	镜像文件名，后缀无所谓，libvirt 不靠后缀识别格式
`15G`	虚拟磁盘上限，实际不会立即占满（精简置备）

image-20260530180101188

Note

空间给小了❓️
- 重新给空间试试给15G 这次肯定够用了

Terminal window展开收起

1
[root@Vir-01 images]# ls -lh ./
2
total 3.1G ✅️
3
-rw------- 1 qemu qemu '21G' May 30 17:26 rocky10-test.qcow2
4
-rw-r--r-- 1 root root 193K  May 30 17:29 node.img
5
'虽然创建了 15G，实际只占 196K — 这就是 qcow2 的精简置备'
6
[root@Vir-01 images]# du -sh rocky10-test.qcow2
7
3.1G  rocky10-test.qcow2
8
'上面写的21G实际上也没有占用那么多'
9

10
2)查看镜像信息
11
[root@vhost1 images]# qemu-img info node.img
12
image: "./Virt02/image-20260530175843424.png"
13
file format: qcow2
14
virtual size: 15 GiB (16106127360 bytes)
15
disk size: 196 KiB
16
'virtual size → 虚拟大小 15G'
17
'disk size    → 实际占用 196K'

展开收起

📌 qemu-img 常用子命令：

子命令	作用
`create`	==创建镜像==
`info`	==查看镜像信息==
`convert`	转换镜像格式
`snapshot`	快照管理
`resize`	调整镜像大小

模版机安装与配置#

基于创建好的后端盘 node.img 和虚拟网络 my_net，用 virt-install 安装虚拟机

重点讲 ==安装后的模版配置==

Terminal window

1
[root@Vir-01 ~]# virt-install \
2
    --name node \
3
    --memory 2048 \
4
    --vcpus 2 \
5
    --disk path=/var/lib/libvirt/images/node.img \
6
    --osinfo rocky10 \
7
    --network network=my_net \
8
    --location ftp://192.168.219.1/rocky10/ \
9
    --graphics vnc,listen=0.0.0.0 \
10
    --wait -1

📌 关键选项说明：

选项	含义	⚠️ 易错点
`--disk path=.../node.img`	使用已创建的后端盘	不能写 `--disk size=20`，那是创建新磁盘 👆等于白做了 `qemu-img create`
`--network network=my_net`	指定虚拟机接入 `my_net`	不写默认走 `default` 网络 (192.168.122.0/24)
`--location ftp://192.168.219.1/...`	FTP 安装源地址	IP 必须跟指定的网络一致 (`my_net` 网关 = 192.168.219.1)
`--graphics vnc,listen=0.0.0.0`	VNC 图形控制台，监听所有地址	方便远程连接虚拟机图形界面
`--wait -1`	等待安装完成后才退出	不加的话命令立刻返回，看不到安装进度

image-20260530175843424

image-20260531092217136

Terminal window展开收起

1
1)SSH 连接到新安装的虚拟机
2
[root@Vir-01 ~]# ssh root@192.168.219.10
3
root@192.168.219.10's password': <-- 1
4
Last login: Sun May 31 09:17:39 2026
5
[root@jiuzhao ~]# ping -W2 -c2 www.baidu.com
6
'测试连通性'
7
PING www.a.shifen.com (180.101.49.44) 56(84) 字节的数据。
8
64 字节，来自 180.101.49.44: icmp_seq=1 ttl=127 时间=27.9 毫秒
9
64 字节，来自 180.101.49.44: icmp_seq=2 ttl=127 时间=25.5 毫秒
10

11
--- www.a.shifen.com ping 统计 ---
12
已发送 2 个包， 已接收 2 个包, 0% packet loss, time 1002ms
13
rtt min/avg/max/mdev = 25.502/26.718/27.935/1.216 ms
14
[root@jiuzhao ~]# ip route
15
'查看网关'
16
default via 192.168.219.1 dev enp1s0 proto dhcp src 192.168.219.10 metric 100
17

18
2)来波系统优化
19
[root@jiuzhao ~]# mkdir -p /server/{sh,repo}
20
[root@jiuzhao ~]# touch /server/sh/base_config.sh
21
[root@jiuzhao ~]# vi /server/sh/base_config.sh

展开收起

1
#!/bin/bash
2
# author=Jiuzhao
3

4
cd /etc/yum.repos.d/
5
ls | xargs -i cat {} > /server/repo/Rocky.repo
6
# 把原来的源都写到一个文件中
7
cd -
8

9
# yum仓库优化
10
sed -e 's|^mirrorlist=|#mirrorlist=|g' \
11
    -e 's|^#baseurl=http://dl.rockylinux.org/$contentdir|baseurl=https://mirrors.sjtug.sjtu.edu.cn/rocky|g' \
12
    -i.bak \
13
    /etc/yum.repos.d/rocky*.repo
14
dnf clean all
15
dnf makecache
16
dnf install epel-release -y
17
# 扩展仓库
18
dnf makecache
19
dnf install -y vim-enhanced tree wget bash-completion lrzsz net-tools sysstat iotop htop unzip nmap-ncat nmap telnet bc psmisc httpd-tools bind-utils openssh-clients expect cowsay sl
20
# 安装必要的软件
21

22
# PS1变量
23
echo 'PS1="[\[\e[34;1m\]\u@\[\e[0m\]\[\e[32;1m\]\H\[\e[0m\]\[\e[31;1m\] \W\[\e[0m\]]\\$ "' >> /etc/profile
24
source /etc/profile
25

26
# ssh优化
27
cat >>/etc/ssh/sshd_config<<EOF
28
UseDNS no
29
#相当于网络命令的-n选项，这个就是说不解析为主机名，直接成IP地址.
30
GSSAPIAuthentication no
31
#关闭GSS认证.
32
EOF
33
systemctl restart sshd
34

35
# 防火墙&&SElinux
36
sed -i 's#enforcing#disabled#g' /etc/selinux/config
37
# 重启生效
38
systemctl disable --now firewalld &> /dev/null
39

40
# 文件描述符
41
echo "* - nofile 65535" >> /etc/security/limits.conf
42

43
# 其他优化
44
> /etc/issue && > /etc/issue.net
45
cat > /etc/motd << 'EOF'
46
          (@) * (@) * (@)
47
        : * (@) * (@) * .;
48
        (@) * (@) * (@) * (@)
49
        * ; * ; (@) * ; * :
50
         ;\ \ \ \| /  / /;
51
            \\ \ Y/ / /
52
             `_\ |/ _'        '
53
             / \\Y// \
54
            ( ,-}={-, )
55
             \_//((\_/
56
              //))(\
57
               (/  ))
58
                   (/
59
EOF
60

61
reboot
62
# 重启生效配置

展开收起

Terminal window

1
[root@jiuzhao ~]# sh /server/sh/base_config.sh
2
'执行脚本'
3
.................
4
完毕！
5
[root@jiuzhao ~]# Connection to 192.168.219.10 closed by remote host.
6
Connection to 192.168.219.10 closed.

image-20260531093249756

QEMU Guest Agent#

==QEMU Guest Agent== 在虚拟机内部运行，就像是给宿主机开了一个通向虚拟机内部的”传话通道”

使其能从外部获取虚拟机 IP、冻结文件系统等

Terminal window展开收起

1
[root@jiuzhao ~]# dnf -y install qemu-guest-agent
2
[root@jiuzhao ~]# systemctl enable --now qemu-guest-agent
3
[root@jiuzhao ~]# poweroff
4

5
1)手动启动验证
6
[root@Vir-01 ~]# virsh list --all
7
 Id   Name           State
8
-------------------------------
9
 -    node           shut off
10
[root@Vir-01 ~]# virsh start node
11
Domain 'node' started
12
[root@Vir-01 ~]# virsh domifaddr --source agent node
13
domifaddr = domain interface address
14
# 👆 子命令 --> 查看IP
15
--source   # 指定从哪获取 IP 信息
16
agent = 走 Guest Agent 通道
17
node    # 虚拟机名称
18
================================
19
 Name    MAC address        Protocol   Address
20
--------------------------------------------------------
21
 lo      00:00:00:00:00:00  ipv4       127.0.0.1/8
22
 enp1s0  52:54:00:97:9d:96  ipv4       192.168.219.10/24

展开收起

📌 通过 Guest Agent 获取信息的两种方式：

方式	本质	适合场景
`virsh domifaddr --source agent <VM>`	virsh 封装好的子命令，直接查 IP	日常简单查询
`virsh qemu-agent-command <VM> '{"execute":"..."}'`	直接发 JSON 指令给 Guest Agent 更底层，功能更全	查 IP、查磁盘、冻结文件系统…啥都能干

Terminal window

1
2)更底层的命令
2
[root@Vir-01 ~]# virsh qemu-agent-command node '{"execute":"guest-ping"}'
3
qemu-agent-command    # 原始 QEMU Agent 命令接口
4
node          # 虚拟机名称
5
'{"execute":"..."}'    # 发给 Agent 的 JSON 指令
6
================================
7
{"return":{}}
8
'返回 return 说明通信正常'
9

10
3)查 IP
11
virsh qemu-agent-command node '{"execute":"guest-network-get-interfaces"}'
12

13
4)冻结文件系统（做快照前用）
14
virsh qemu-agent-command node '{"execute":"guest-fsfreeze-freeze"}'

Note

💡 domifaddr --source agent 是高层封装，✅️ qemu-agent-command 更底层，能做的事更多

cloud-init#

==cloud-init== 用于在虚拟机==首次启动时==自动完成主机名、用户、SSH 密钥、网络和软件包等初始化配置
- cloud-init 不只是装一下，它解决的是一个实际问题：

Terminal window

1
模板机 --克隆--> node1 --开机--> cloud-init 自动帮你：
2
                                        ├── 设个新主机名（node1，不是 localhost）
3
                                        ├── 注入 SSH 公钥（不用每次手动 ssh-copy-id）
4
                                        ├── 配好网络
5
                                        └── 装好你指定的软件包

Caution

不装 cloud-init → 每克隆一台都得手动登进去改主机名、配 SSH…100 台要疯装了之后 → 模板做好、virt-sysprep 清理完，克隆出来的机器第一次开机自动搞定，开机即用

Terminal window

1
[root@Vir-01 ~]# ssh root@192.168.219.10
2
root@192.168.219.10's password':
3
[root@jiuzhao ~]# dnf install -y cloud-init
4
完毕！

📌 一句话：cloud-init 就是每台新虚拟机的”==自动入职流程==“，开机即用

virsh console 串口控制台#

console 配置是配在 ==KVM 虚拟机内部==（不是配在 Vir-01 上）
配好之后，宿主机 (Vir-01) 可以==绕过网络==直接连进去

Terminal window

1
SSH 是前门：宿主机 → 网络 → VM 的 IP → 进去     （网络挂了就歇菜）
2
console 是后门：宿主机 → virsh console → 直接进去  （只要 VM 活着就能进）
3
===================================================
4
🌰 层级关系：
5
你的笔记本 (物理机)
6
└── VMware 虚拟机 (Vir-01) ← 对 KVM 来说，它就是"宿主机"
7
     └── KVM 虚拟机 (node) ← console 配在这台里面

Terminal window展开收起

1
1)先检测：内核参数里有没有 console❓️
2
[root@jiuzhao ~]# grubby --info=ALL | grep console | wc -l
3
0
4
'如果没有，才需要配置：'（在 KVM 虚拟机里面执行，配一次就行）
5
[root@jiuzhao ~]# grubby --update-kernel=ALL --args="console=ttyS0,115200n8"
6
'grubby 本身安全，参数已存在就不会重复添加'
7
[root@jiuzhao ~]# grubby --info=ALL | grep console
8
args="... console=ttyS0,115200n8"   ✅ 已经有了，跳过配置
9
args="... console=ttyS0,115200n8"
10
# 显示两条是因为 --info=ALL 显示了两个内核条目（正常 + rescue），不是配重了
11
[root@jiuzhao ~]# reboot
12

13
2)等待重启后，在宿主机上通过 console 连接
14
[root@Vir-01 ~]# virsh console node
15
Connected to domain 'node'
16
Escape character is ^] (Ctrl + ]) ✅️ 退出
17
  <-- '回车'
18
jiuzhao login: root
19
密码：
20
Last login: Sun May 31 10:06:44 from 192.168.219.1
21
          (@) * (@) * (@)
22
        : * (@) * (@) * .;
23
        (@) * (@) * (@) * (@)
24
        * ; * ; (@) * ; * :
25
         ;\ \ \ \| /  / /;
26
            \\ \ Y/ / /
27
             `_\ |/ _'        '
28
             / \\Y// \
29
            ( ,-}={-, )
30
             \_//((\_/
31
              //))(\
32
               (/  ))
33
                   (/
34
[root@jiuzhao ~]# ip a s
35
'按 Ctrl+] 退出 console'

展开收起

⚠️ 退出 console 和退出 shell 是两回事：

操作	效果	之后你在哪
`exit`	==退出登录==，下次再连要重新输密码同时退出 KVM 虚拟机里的 shell 会话	回到登录界面，console 还连着虚拟机
`Ctrl+]`	彻底断开 virsh console 连接	回到宿主机也就是 Vir-01

Terminal window

1
[root@jiuzhao ~]# exit
2
注销
3
jiuzhao login: 'console 还挂着，没真正退出去'
4
✅️ '要再按 Ctrl+] 才回到宿主机'

Terminal window

1
3)启动时直接从 console 看启动过程
2
[root@Vir-01 ~]# virsh shutdown node
3
# 先关机
4
[root@Vir-01 ~]# virsh start --console node
5
'可以在终端看到完整的启动过程'

Tip

💡 virsh console 的优势：不需要等网络配好、不需要 SSH，机器只要能启动就能连进去，排障利器

开机自动扩容#

Note

⚠️ 这个配置不是给模板机用的，是给未来所有克隆机用的

Terminal window

1
后端盘 node.img = 15G（模板机）
2
├── 模板机本身：15G 刚好够用，根分区 12.5G ✅
3
└── 克隆机 node1.qcow2 = 30G
4
                      └─ 开机 → 根分区还是 12.5G？❌ 浪费了 17.5G！
5
===================================================
6
配了 rc.local → 每台克隆机开机自动撑满自己的磁盘上限
7
不配 → 给多少 G 都只能用到模板机的 12.5G

Terminal window展开收起

1
1)安装分区扩展工具(在KVM虚拟机中操作)
2
[root@jiuzhao ~]# yum -y install cloud-utils-growpart
3

4
2)查看当前分区布局
5
[root@jiuzhao ~]# lsblk
6
NAME        MAJ:MIN RM  SIZE RO TYPE MOUNTPOINTS
7
vda         252:0    0   15G  0 disk
8
├─vda1      252:1    0    1M  0 part
9
├─vda2      252:2    0    1G  0 part /boot
10
└─vda3      252:3    0   14G  0 part
11
  ├─rl-root 253:0    0 12.5G  0 'lvm'✅️/'根'
12
  '使用LVM逻辑卷管理技术进行扩充'    ⬇️ 交换分区不要管它
13
  └─rl-swap 253:1    0  1.5G  0 lvm  [SWAP] ❌️
14
[root@jiuzhao ~]# df -hT
15
文件系统            类型      大小  已用  可用 已用% 挂载点
16
/dev/mapper/rl-root xfs        13G  1.8G   11G   14% /
17
👆 '逻辑卷名称'    ⬆️ 文件类型
18
 ⚠️ 如果是 ext4 文件系统，用 resize2fs 命令扩容
19
     # 扩文件系统(重写账本，让文件系统认领新空间)

展开收起

Tip

① growpart 扩分区 → ② pvresize 扩 PV → ③ lvextend 扩 LV → ④ xfs_growfs 扩文件系统*(重写账本，让文件系统认领新空间)*

📌 为什么先 growpart？ 磁盘是一整块，分区是上面画的”格子”：

Terminal window

1
克隆前 vda = 15G：       克隆后 vda = 30G：
2
┌─────────────────┐     ┌──────────────────────────────┐
3
│ vda1│vda2│ vda3 │     │ vda1│vda2│  vda3   │  空着    │
4
│  1M │ 1G │ 14G  │     │  1M │ 1G │  14G    │  15G    │
5
└─────────────────┘     │   growpart 把格子推到这 →      │
6
                        └──────────────────────────────┘
7
磁盘 30G 但 vda3 卡在 14G → 后面三步根本没空间可扩
8
growpart 先把"格子"推满 → pvresize/lvextend/growfs 才有空间可用

Terminal window展开收起

1
3)编辑 rc.local 实现开机自动扩容
2
[root@Vir-01 ~]# ll /etc/rc.local
3
lrwxrwxrwx. 1 root root 13 2025年 8月15日 /etc/rc.local → /etc/rc.d/rc.local
4
 '这次我们直接更改本体'            ✅️ (软连接)        📌 (本体)
5
⚠️ 软连接 lrwxrwxrwx  这个 rwx 是虚假的❌️，软连接权限永远 777
6
'最后别忘记给本体赋 执行x 权限'
7
[root@jiuzhao ~]# vim /etc/rc.d/rc.local
8
.....................
9
touch /var/lock/subsys/local
10
###
11
/usr/bin/growpart /dev/vda 3
12
# ①扩分区：把 vda3 这个"格子"推到磁盘末尾
13
/usr/sbin/pvresize /dev/vda3
14
# ②扩 PV：让 LVM 知道"格子"变大了
15
/usr/sbin/lvextend -l +100%FREE /dev/mapper/rl-root
16
# ③扩 LV：逻辑卷吃掉新增空间
17
/usr/sbin/xfs_growfs /dev/mapper/rl-root
18
# ④让文件系统识别新空间 --> 根分区真正能用上新空间
19
/usr/bin/sed '/^###/,$d' -i /etc/rc.d/rc.local
20
  # /^###/ --> 匹配 以###开头的行
21
  # $d &代表最后一行,d代表删除 --> 删除 ### 以下,至最后一行
22
# 执行后删除自身，防止重复扩容
23

24
4)赋权
25
# Please note that you must run 'chmod +x /etc/rc.d/rc.local'
26
[root@jiuzhao ~]# ls -l /etc/rc.d/rc.local
27
-rw-r--r-- 1 root root 485  5月31日 17:49 /etc/rc.d/rc.local
28
'它并没有执行权限'
29
[root@jiuzhao ~]# chmod +x /etc/rc.d/rc.local
30
[root@jiuzhao ~]# poweroff
31
'关机'

展开收起

Warning

🤡 到这里建议拍个快照 🤡

virt-sysprep 制作模板#

Note

==virt-sysprep== 它处理的是镜像文件 (node.img)，==不是 XML==

它直接读写磁盘 —> 清理里面的个性化信息
- 我们的 UUID/MAC 是后来==简化XML模版==后才清理干净的
让克隆出来的每台虚拟机都是”干净”的

⚠️ 在宿主机 (Vir-01) 上执行，VM 必须关机 (shut off)

开机执行会损坏磁盘数据，因为 virt-sysprep 直接读写镜像文件

Terminal window展开收起

1
1)确认 VM 已关机
2
[root@Vir-01 ~]# virsh list --all | grep node
3
 -    node     shut off   '必须是 shut off，不能是 running'
4

5
2)安装工具（宿主机上执行）
6
[root@Vir-01 ~]# yum -y install guestfs-tools
7
jiuzhao@Ubuntu 桌面$ sudo apt install libguestfs-tools
8

9
3)列出所有能做的清理项目
10
[root@Vir-01 ~]# virt-sysprep --list-operations
11
'带 * 的是默认会执行的' --> 比如：
12
  ssh-hostkeys * → 默认清除 SSH 密钥
13
  bash-history * → 默认清除 bash 历史
14
✅️ 你可以 --enable '只执行'某几个、--disable 排除某几个
15

16
4)预演模式（只显示，不执行）
17
[root@Vir-01 ~]# virt-sysprep --dry-run -d node
18
-d = --domain  # 指定虚拟机名字
19
-n = --dry-run  # 演练(干跑)
20

21
5)执行清理（过程较长，中途不要结束命令）
22
[root@Vir-01 ~]# virt-sysprep -d node
23
......
24
[  20.3] Performing "lvm-uuids" ...
25

26
6)也可直接对镜像文件操作
27
[root@Vir-01 ~]# virt-sysprep -a /var/lib/libvirt/images/node.img

展开收起

📌 virt-sysprep 常用参数速查：

类别	参数	核心说明
指定目标	`-a, --add <磁盘镜像>`	直接指定磁盘镜像文件
指定目标	`-d, --domain <名称/UUID>`	指定 libvirt 管理的虚拟机
预演	`-n, --dry-run`	仅显示将执行的操作，不实际修改
自定义选择	`--enable <操作列表>`	精确启用指定操作
自定义选择	`--disable <操作列表>`	从默认操作中排除指定操作
系统配置	`--hostname <主机名>`	设定客户机主机名
系统配置	`--root-password <密码文件>`	设置 root 密码
系统配置	`--ssh-inject <用户:密钥文件>`	注入 SSH 公钥
文件操作	`--upload <文件:目标路径>`	上传文件到客户机
文件操作	`--delete <路径>`	删除客户机内文件/目录
文件操作	`--run <脚本>`	在客户机内执行自定义脚本
高级	`--selinux-relabel`	强制重新标记 SELinux 文件
高级	`-v, --verbose`	输出详细执行过程日志

Tip

默认操作集：不加 --enable/--disable 时
- virt-sysprep 运行一组标记为”默认”的安全清理操作（SSH 主机密钥、MAC 地址等）

✅️ 预演优先：执行关键操作前，强烈建议先用 --dry-run 确认操作范围 通过 --enable 可以精确指定==只运行==哪些操作，--disable 则在默认操作集基础上排除某些操作

📦 前端盘 && 批量创建#

前端盘 (Frontend Disk)#

Important

通俗解释 COW (Copy-On-Write)：

三个人共用一本教科书，谁都不在书上写字 → 一本就够了，==共享==
某天小明要在第 10 页做笔记 → 把那页==复印一份==给他，他在复印件上写，其他人继续用原书
只读时共享，修改时才复制 → 省空间、省内存、提升效率

Note

通俗解释：

==后端盘== (node.img) → 装了系统的基础”模具”，==所有虚拟机共享==
==前端盘== (node1.qcow2) → 每个虚拟机自己的”增量层”，==只存差异数据==

✅️ 前端盘依赖后端盘，前端盘记录了对后端盘的”修改”

📌 COW 在磁盘上的体现：

读: 前端盘有数据？→ 直接用自己的
- 前端盘没有？→ 去后端盘找
写: 永远只写前端盘，后端盘不变

Terminal window展开收起

1
1)创建前端盘
2
[root@Vir-01 ~]# cd /var/lib/libvirt/images/
3
[root@vhost1 images]# qemu-img create -f qcow2 -b node.img -F qcow2 node1.qcow2 20G
4
Formatting 'node1.qcow2', fmt=qcow2 ... backing_file=node.img backing_fmt=qcow2
5
===================================
6
参数解读：
7
-f qcow2         '前端盘的格式' --> （正在创建的这个新镜像）
8
-b node.img     '指定后端盘（模板）文件'
9
-F qcow2         '后端盘的格式' --> （-b 指定的那个模板）
10
node1.qcow2     '镜像文件名，后缀无所谓，.qcow2 自己好认'
11
20G              '前端盘的虚拟大小上限（可以大于后端盘，配合开机自动扩容）'
12
[root@Vir-01 images]# ls | grep node
13
node1.qcow2
14

15
2)查看前端盘信息
16
[root@vhost1 images]# qemu-img info node1.qcow2
17
image: "./Virt02/image-20260530175843424.png"
18
file format: qcow2
19
virtual size: 20 GiB (21474836480 bytes)  '虚拟上限 20G'
20
disk size: 196 KiB        '实际才 196K，基于 COW 按需增长'
21
backing file: node.img   '对应的后端盘'
22
backing file format: qcow2   '后端盘的格式'

展开收起

📌 后端盘 vs 前端盘对比：

	后端盘 (Backing)	前端盘 (Frontend)
角色	==模板/模具==，存操作系统	==增量层==，存差异数据
是否独立	独立完整镜像	依赖后端盘
修改	==不会变==（被所有前端盘共享）	只记录本机的修改

XML 模板 && 定义虚拟机#

Terminal window展开收起

1
1)复制模板机的 XML 作为模板（⚠️ 在 undefine 之前执行！）
2
[root@Vir-01 ~]# cp -p /etc/libvirt/qemu/node.xml /home/template.xml
3
[root@Vir-01 ~]# ls /home/template.xml
4
/home/template.xml
5
[root@Vir-01 ~]# sed -i 's@<name>node</name>@<name>template</name>@g' /home/template.xml
6
✅️ 把里面的 <name>node</name> 改成 <name>template</name> '占位符'
7
[root@Vir-01 ~]# sed -ri 's#(/var/lib/libvirt/images/)node.img#\1template.qcow2#' /home/template.xml
8
⚠️ 改磁盘路径为 template.qcow2（占位符）
9
📌 原因：sed 'template→node1' 时，磁盘路径也自动变成 node1.qcow2（前端盘）
10

11
2)用 sed 替换模板中的占位符，生成新虚拟机的 XML
12
[root@Vir-01 ~]# sed 's@template@node1@' /home/template.xml
13
'把 template 替换成实际 VM 名'
14
'默认全部输出至屏幕'
15
[root@Vir-01 ~]# sed 's@template@node1@' /home/template.xml > /etc/libvirt/qemu/node1.xml
16
'把屏幕中的内容重定向到新的XML模版中'
17

18
3)基于 XML 定义虚拟机
19
[root@Vir-01 ~]# cd /etc/libvirt/qemu/
20
'先切换至XML文件目录中'
21
[root@Vir-01 qemu]# virsh define node1.xml
22
domain 'node' is already defined with 'uuid' ❌️3f4...xxx❌️
23
❌️ UUID 重复
24
[root@Vir-01 qemu]# uuidgen
25
a8a2a4e2-f918-44a6-a720-f635101d830e
26
[root@Vir-01 qemu]# grep uuid node1.xml
27
  <uuid>a8a2a4e2-f918-44a6-a720-f635101d830e</uuid>
28
⚠️ 进行更换
29
[root@Vir-01 qemu]# virsh define node1.xml
30
Domain 'node1' defined from node1.xml
31
✅️ '基于XML文件定义虚拟机'
32
  📌 拿着这份"配置单" --> 告诉 libvirt："记住这台虚拟机"
33
[root@Vir-01 qemu]# virsh list --all
34
 Id   Name    State
35
------------------------
36
 -    node    shut off
37
 -    node1   shut off
38

39
5)启动并验证
40
[root@Vir-01 ~]# virsh start --console node1
41
......
42
jiuzhao login: root
43
密码：
44
[root@jiuzhao ~]# ip a s | grep 192.168.219
45
    inet 192.168.219.113/24 brd 192.168.219.255 scope
46
[root@jiuzhao ~]# lsblk | grep vda3
47
└─vda3      252:3    0   19G  0 part
48
'分区已自动扩容'      👆
49
[root@jiuzhao ~]# df -h /
50
文件系统             大小  已用  可用 已用% 挂载点
51
/dev/mapper/rl-root   18G  1.8G   16G   11% /
52
'文件系统也已扩容'     👆
53
[root@jiuzhao ~]# ping -W2 -c2 www.baidu.com
54
PING www.a.shifen.com (180.101.51.73) 56(84) 字节的数据。
55
64 字节，来自 180.101.51.73: icmp_seq=1 ttl=127 时间=28.3 毫秒
56
64 字节，来自 180.101.51.73: icmp_seq=2 ttl=127 时间=29.2 毫秒
57

58
--- www.a.shifen.com ping 统计 ---
59
已发送 2 个包， 已接收 2 个包, 0% packet loss, time 1002ms
60
rtt min/avg/max/mdev = 28.300/28.767/29.234/0.467 ms
61
'网络正常'
62
[root@localhost ~]# poweroff

展开收起

批量创建与删除#

Terminal window

1
✅️ 保留模板机，不隐藏镜像
2
  策略：模板机 node 不变，node.img 可见
3
  好处：随时 virsh start --console node 开机调整镜像，调完 virt-sysprep 重新清理
4
[root@Vir-01 ~]# virsh list --all
5
 Id   Name      State
6
--------------------------
7
 -    node      shut off    '模板机保留'
8
 -    node1     shut off
9
[root@Vir-01 ~]# ls /var/lib/libvirt/images/
10
node.img  node1.qcow2       '后端盘可见，方便调整'

Terminal window展开收起

1
'环境准备'
2
# 为后面批量创建做准备
3

4
1)取消 node1 定义
5
[root@Vir-01 ~]# virsh undefine node1
6
Domain 'node1' has been undefined
7
[root@Vir-01 ~]# ls /etc/libvirt/qemu/ | grep node1 | wc -l
8
0 ---> 'XML文件也被删除'
9
[root@Vir-01 ~]# virsh list --all | grep node1 | wc -l
10
0
11

12
2)手动删除前端盘
13
[root@Vir-01 ~]# ls /var/lib/libvirt/images/ | grep node1 | wc -l
14
1
15
[root@Vir-01 ~]# rm -rf /var/lib/libvirt/images/node1.qcow2

展开收起

Tip

⚠️ 迭代修改流程（模板机 node 保留不动，随时可开机调整）：

① virsh undefine node1 取消定义（XML 一起被删，无需手动处理） ② rm -rf /var/lib/libvirt/images/node1.qcow2 (前端盘由 qemu-img 创建，不受 libvirt 管理，需手动删除) ③ virsh start --console node 开启模板机，修正问题 ④ virt-sysprep -d node 重新清理镜像 ⑤ 从重新生成前端盘和 XML 进行测试

创建#

Terminal window

1
[root@Vir-01 ~]# vim /home/create_vm.sh

Terminal window展开收起

1
# ===== 批量创建（模板机 node 不动、node.img 不隐藏） =====
2
for i in $(seq 3)
3
do
4
  # 1)创建前端盘
5
  qemu-img create -f qcow2 -b /var/lib/libvirt/images/node.img -F qcow2 \
6
    /var/lib/libvirt/images/node${i}.qcow2 20G > /dev/null
7

8
  # 2)生成 XML（sed 替换占位符 template → nodeN）
9
  sed "s@template@node${i}@" /home/template.xml > /etc/libvirt/qemu/node${i}.xml
10

11
  # 3)替换 UUID（sed 替换完每台 XML 的 UUID 还跟模板一样，必须换）
12
  NEW_UUID=$(uuidgen)
13
  sed -i "s@<uuid>.*</uuid>@<uuid>${NEW_UUID}</uuid>@" /etc/libvirt/qemu/node${i}.xml
14

15
  # 4)定义虚拟机
16
  virsh define /etc/libvirt/qemu/node${i}.xml > /dev/null
17
done

展开收起

Terminal window

1
[root@Vir-01 ~]# sh /home/create_vm.sh
2
[root@Vir-01 ~]# virsh list --all
3
 Id   Name    State
4
------------------------
5
 -    node    shut off
6
 -    node1   shut off
7
 -    node2   shut off
8
 -    node3   shut off
9
 ✅️ '瞬间创建三台'
10
[root@Vir-01 ~]# virsh start --console node3
11
'随便登进去一台看看怎样?'
12
  ✅️ 能上网、也能自动扩容
13
  ❌️ 就是 IP地址重复❓️ MAC地址重复❓️(IPv4 & IPv6)
14
'优化后的 template.xml 已删硬编码 UUID/MAC，define 时 libvirt 自动生成，不会冲突'

删除#

Terminal window

1
[root@Vir-01 ~]# vim /home/clean_vm.sh

Terminal window

1
# ===== 批量删除（模板机 node 保留不动） =====
2
for i in $(seq 3)
3
do
4
  virsh undefine node${i}                          # 删定义 + XML
5
  rm -rf /var/lib/libvirt/images/node${i}.qcow2    # 删前端盘
6
done

Terminal window

1
[root@Vir-01 ~]# sh /home/clean_vm.sh
2
Domain 'node1' has been undefined
3
Domain 'node2' has been undefined
4
Domain 'node3' has been undefined
5
[root@Vir-01 ~]# ls /var/lib/libvirt/images/
6
node.img
7
[root@Vir-01 ~]# ls /etc/libvirt/qemu/
8
autostart  networks  node.xml
9
# 把模板机的配件都保留下来了

📝 练习#

优化 template.xml#

⚠️ 原始模板的问题：15 个 PCIe root port、所有设备带硬编码 address、多余的 CD-ROM / 音频 / 看门狗 / 平板输入
精简原则：==删掉 libvirt 能自动生成的、删掉用不上的设备==

1
<domain type='kvm'>
2
  <name>template</name>
3
  <memory unit='KiB'>2097152</memory>
4
  <currentMemory unit='KiB'>2097152</currentMemory>
5
  <vcpu placement='static'>2</vcpu>
6
  <os>
7
    <type arch='x86_64' machine='pc-q35-rhel10.0.0'>hvm</type>
8
    <boot dev='hd'/>
9
  </os>
10
  <features>
11
    <acpi/>
12
    <apic/>
13
  </features>
14
  <cpu mode='host-passthrough' check='none' migratable='on'/>
15
  <clock offset='utc'>
16
    <timer name='rtc' tickpolicy='catchup'/>
17
    <timer name='pit' tickpolicy='delay'/>
18
    <timer name='hpet' present='no'/>
19
  </clock>
20
  <on_poweroff>destroy</on_poweroff>
21
  <on_reboot>restart</on_reboot>
22
  <on_crash>destroy</on_crash>
23
  <devices>
24
    <emulator>/usr/libexec/qemu-kvm</emulator>
25

26
    <!-- 磁盘：占位符 template.qcow2，sed 替换成 node1.qcow2 等 -->
27
    <disk type='file' device='disk'>
28
      <driver name='qemu' type='qcow2'/>
29
      <source file='/var/lib/libvirt/images/template.qcow2'/>
30
      <target dev='vda' bus='virtio'/>
31
    </disk>
32

33
    <!-- 网络 -->
34
    <interface type='network'>
35
      <source network='my_net'/>
36
      <model type='virtio'/>
37
    </interface>
38

39
    <!-- console 串口 -->
40
    <serial type='pty'>
41
      <target type='isa-serial' port='0'>
42
        <model name='isa-serial'/>
43
      </target>
44
    </serial>
45
    <console type='pty'>
46
      <target type='serial' port='0'/>
47
    </console>
48

49
    <!-- Guest Agent 通道 -->
50
    <channel type='unix'>
51
      <target type='virtio' name='org.qemu.guest_agent.0'/>
52
    </channel>
53

54
    <!-- VNC 图形 -->
55
    <graphics type='vnc' port='-1' autoport='yes' listen='0.0.0.0'>
56
      <listen type='address' address='0.0.0.0'/>
57
    </graphics>
58
    <video>
59
      <model type='virtio' heads='1' primary='yes'/>
60
    </video>
61

62
    <memballoon model='virtio'/>
63
    <rng model='virtio'>
64
      <backend model='random'>/dev/urandom</backend>
65
    </rng>
66
  </devices>
67
</domain>

展开收起

📌 精简前后对比：

项目	精简前	精简后	效果
PCIe root port	15 个	0 个（libvirt 自动）	MAC/UUID 冲突风险大降
硬编码 address	每条设备一个	全部删除	libvirt 自动分配
CD-ROM / SATA	有	删	用不到
tablet/mouse/keyboard	3 条	删	用不到
audio / watchdog	有	删	用不到
metadata / pm	有	删	不影响功能
UUID 和 MAC	固定值	删（define 时自动生成）	批量不用手动换

📌 精简效果：从 170 行臃肿 XML 砍到 70 行，核心就 7 件东西：

磁盘 + 网络 + console + Guest Agent + VNC + memballoon + rng
删掉的：PCIe 地址、15 个 root port、CD-ROM、USB 控制器、输入设备、音频、看门狗、metadata、pm、硬编码 UUID/MAC
原因：==libvirt 能自动生成的，就别写死——写了反而冲突==

Terminal window

1
1)更换我们的xml
2
[root@Vir-01 ~]# vim /home/template.xml
3

4
2)优化我们的创建脚本
5
[root@Vir-01 ~]# vim /home/create_vm.sh

Terminal window

1
# ===== 批量创建（模板机 node 不动、node.img 不隐藏） =====
2
# 优化后的 template.xml 已删硬编码 UUID/MAC，define 时 libvirt 自动生成，不会冲突
3
for i in $(seq 3)
4
do
5
  # 1)创建前端盘
6
  qemu-img create -f qcow2 -b /var/lib/libvirt/images/node.img -F qcow2 \
7
    /var/lib/libvirt/images/node${i}.qcow2 20G > /dev/null
8

9
  # 2)生成 XML（sed 替换占位符 template → nodeN）
10
  sed "s@template@node${i}@" /home/template.xml > /etc/libvirt/qemu/node${i}.xml
11

12
  # 3)定义虚拟机（UUID 和 MAC 自动生成）
13
  virsh define /etc/libvirt/qemu/node${i}.xml > /dev/null
14
done

Terminal window展开收起

1
[root@Vir-01 ~]# sh /home/create_vm.sh
2
[root@Vir-01 ~]# virsh list --all
3
 Id   Name    State
4
------------------------
5
 -    node    shut off
6
 -    node1   shut off
7
 -    node2   shut off
8
 -    node3   shut off
9

10
1)node3
11
[root@Vir-01 ~]# virsh start --console node3
12
jiuzhao login: root
13
密码：
14
[root@jiuzhao ~]# hostname -I
15
192.168.219.134 📌
16
[root@jiuzhao ~]# lsblk | grep vda3
17
└─vda3      252:3    0   19G 📌  0 part
18
[root@jiuzhao ~]# ping -W2 -c2 www.baidu.com
19
PING www.a.shifen.com (180.101.51.73) 56(84) 字节的数据。
20
64 字节，来自 180.101.51.73: icmp_seq=1 ttl=127 时间=30.4 毫秒
21
64 字节，来自 180.101.51.73: icmp_seq=2 ttl=127 时间=29.4 毫秒
22

23
2)node2
24
[root@Vir-01 ~]# virsh start --console node2
25
[root@jiuzhao ~]# hostname -I
26
192.168.219.35 ✅️ IP变了
27
[root@jiuzhao ~]# ping -W2 -c2 www.baidu.com
28
PING www.a.shifen.com (180.101.51.73) 56(84) 字节的数据。
29
64 字节，来自 180.101.51.73: icmp_seq=1 ttl=127 时间=27.6 毫秒
30
64 字节，来自 180.101.51.73: icmp_seq=2 ttl=127 时间=28.0 毫秒
31
✅️ 也能ping通外网
32

33
3)UUID也各不相同
34
[root@Vir-01 ~]# virsh dominfo node1 | grep UUID
35
UUID:           ccd0fa09-ff7c-4eae-b0f8-9c2f5801d9b5
36
[root@Vir-01 ~]# virsh dominfo node2 | grep UUID
37
UUID:           fa248514-3cea-45fb-83e1-9de69a9c6687
38
[root@Vir-01 ~]# virsh dominfo node3 | grep UUID
39
UUID:           e8ffb621-655b-4d8d-b960-7d396e000aff

展开收起

批量管理 Shell 脚本#

📌 两个脚本、功能不重叠：

脚本	用途	用法
`create_vm.sh`	创建	`sh create_vm.sh` (3台) / `sh create_vm.sh web01 db01` (按名)
`clean_vm.sh`	删除	`sh clean_vm.sh node1` / `sh clean_vm.sh all` (全删，保留模板机)

📌 脚本设计要点：

两个脚本各管一面：create_vm.sh 管建、clean_vm.sh 管删

启动和关机用 virsh start / virsh shutdown 直接敲就行，没必要写脚本

真正的批量场景（100 台），for 循环足够了

1
# ===== /home/create_vm.sh =====
2
# 用法：sh create_vm.sh           → 批量创建 3 台 (node1~node3)
3
#       sh create_vm.sh web01 db01 → 按名称创建
4
#!/bin/bash
5
TEMPLATE="/home/template.xml"
6
BACKING="/var/lib/libvirt/images/node.img"
7
COUNT=${1:-3}
8

9
if [ $# -eq 0 ]; then
10
  for i in $(seq $COUNT); do
11
    echo -n "创建 node${i} ... "
12
    # 1)创建前端盘（> /dev/null 屏蔽成功输出，错误仍会显示）
13
    qemu-img create -f qcow2 -b $BACKING -F qcow2 \
14
      /var/lib/libvirt/images/node${i}.qcow2 20G > /dev/null
15
    # 2)生成 XML
16
    sed "s@template@node${i}@" $TEMPLATE > /etc/libvirt/qemu/node${i}.xml
17
    # 3)定义虚拟机
18
    virsh define /etc/libvirt/qemu/node${i}.xml > /dev/null && echo "✅️ 完成" || echo "❌️ 失败"
19
  done
20
else
21
  for name in "$@"; do
22
    echo -n "创建 ${name} ... "
23
    qemu-img create -f qcow2 -b $BACKING -F qcow2 \
24
      /var/lib/libvirt/images/${name}.qcow2 20G > /dev/null
25
    sed "s@template@${name}@" $TEMPLATE > /etc/libvirt/qemu/${name}.xml
26
    virsh define /etc/libvirt/qemu/${name}.xml > /dev/null && echo "✅️ 完成" || echo "❌️ 失败"
27
  done
28
fi

展开收起

1
# ===== /home/clean_vm.sh =====
2
# 用法：sh clean_vm.sh node1 node2 → 删指定 VM
3
#       sh clean_vm.sh all         → 删全部（模板机 node 除外）
4
#!/bin/bash
5
IMAGES="/var/lib/libvirt/images"
6

7
if [ "$1" = "all" ]; then
8
  for name in $(virsh list --all --name | grep -v '^node$'); do
9
    echo -n "删除 ${name} ... "
10
    virsh destroy $name 2>/dev/null     # ①强制关机（running → shut off）
11
    virsh undefine $name > /dev/null    # ②取消定义（删 XML）
12
    rm -rf $IMAGES/${name}.qcow2        # ③删前端盘
13
    echo "✅️ 完成"
14
  done
15
else
16
  for name in "$@"; do
17
    echo -n "删除 ${name} ... "
18
    virsh destroy $name 2>/dev/null     # ①强制关机
19
    virsh undefine $name > /dev/null    # ②取消定义（同时删除 XML）
20
    rm -rf $IMAGES/${name}.qcow2        # ③删前端盘
21
    echo "✅️ 完成"
22
  done
23
fi

展开收起

🔁 全流程串联#

📌 从零到批量部署的完整链路：

Terminal window

1
① 创建虚拟网络 my_net  -->  virsh net-define/start，配好 DHCP
2
② 创建后端盘 node.img  -->  qemu-img create -f qcow2 node.img 15G
3
③ 安装模板机 node      --> virt-install --disk path=node.img --network=my_net ...
4
④ 模板机内部配置       --> qemu-guest-agent、cloud-init、console、rc.local 开机扩容
5
⑤ virt-sysprep 清理  -->  去个性化，模板机 node 保留不动（方便日后开机调整）
6
⑥ 备份优化模板 XML    -->  cp node.xml --> /home/template.xml --> 精简瘦身
7
⑦ 批量创建           -->  sh create_vm.sh --> for 循环：前端盘 + XML + define
8
⑧ 按需迭代           -->  模板机开机 --> 调整 --> virt-sysprep --> 重新批量

Tip

模板机 node 始终保留、node.img 不隐藏，可随时开机修正，整个流程闭环

📚 知识补充：两大工具集#

day02 实验中用到的绝大多数是 libvirt 系命令，但 libguestfs 系同样重要——==无需启动虚拟机就能操作磁盘==

📌 一句话：==libvirt 系管生命周期==，==libguestfs 系管磁盘内部==

libvirt 管理工具#

以 virsh 和 virt-install 为核心

类别	命令	实验中用到
生命周期	`virsh list` `start` `shutdown` `destroy` `undefine` `define`	✅️ 全部
查看	`virsh dominfo` `dumpxml` `domstate` `domifaddr`	✅️ 全部
连接	`virsh uri` `console`	✅️ 全部
网络	`virsh net-list` `net-edit` `net-define` `net-start` `net-destroy`	✅️ 全部
资源	`virsh setmem` `setvcpus`	了解即可
图形	`virt-viewer`	了解即可

libguestfs 工具集#

无需启动 VM 就能动磁盘

命令	作用	一句话
`virt-cat`	不启动 VM 查看磁盘内文件	类似 `cat`，但目标是 VM 磁盘
`virt-edit`	不启动 VM 编辑磁盘内文件	类似 `vim`，VM 死机也能改配置
`virt-ls`	不启动 VM 列出磁盘内目录	类似 `ls`
`virt-copy-in/out`	不启动 VM 向磁盘复制/复制出文件	VM 死机了也能捞出数据
`virt-sysprep`	清理 VM 个性化信息	✅️ 实验中已用到
`virt-resize`	调整磁盘镜像大小	线下扩容
`virt-sparsify`	回收磁盘空闲空间	节省宿主机存储
`virt-inspector`	深入分析磁盘镜像	查看 OS 版本、文件系统等
`virt-p2v` / `virt-v2v`	物理机/其他平台 → KVM	迁移场景

💡 核心优势：VM 死机了？直接在宿主机 virt-cat 看日志、virt-edit 改配置，相当于给虚拟机开了一个”后门”

虚拟化环境配置与KVM虚拟机管理

Sun, 12 Apr 2026 00:00:00 GMT

虚拟化环境配置 && KVM 虚拟机管理#

[TOC]

🧱 知识点总结#

虚拟化核心概念#

==虚拟化== 就是在一台物理机上，用软件模拟出多台”假”的机器，每台假机器都能跑独立的操作系统

Hypervisor (VMM)：虚拟化的核心管理层，负责把物理 CPU/内存/磁盘”切”给虚拟机用
KVM (Kernel-based Virtual Machine)：Linux 内核自带的虚拟化模块，把 Linux 变成一个 Hypervisor
QEMU：模拟硬件设备（网卡、磁盘、显卡等），和 KVM 搭配使用
libvirt：一套管理虚拟化的 API/守护进程，提供了统一的命令行和编程接口

📌 一句话：KVM 负责”算”，QEMU 负责”装”，libvirt 负责”管”

环境准备检查清单#

检查项	命令	预期结果
CPU 是否支持虚拟化	`cat /proc/cpuinfo	grep -E ‘vmx
虚拟化包是否安装	`rpm -q qemu-kvm libvirt`	显示版本号
服务是否启动	`systemctl status libvirtd`	active (running)

💡 小技巧：虚拟化引擎需要在 VMware/虚拟机设置中勾选”==虚拟化 Intel VT-x/EPT 或 AMD-V/RVI==“，否则 KVM 无法使用硬件加速

image-20260528184412580

Terminal window展开收起

1
1)支持虚拟化
2
[root@R199 ~]# cat /proc/cpuinfo | egrep 'vmx|svm'
3
flags    : fpu xxx svm xxx ✅️
4

5
2)安装虚拟化包
6
[root@R199 ~]# dnf -y install qemu-kvm libvirt
7
[root@R199 ~]# rpm -q qemu-kvm libvirt
8
qemu-kvm-10.0.0-14.el10_1.5.x86_64
9
libvirt-11.5.0-4.8.el10_1.x86_64
10
==================================
11
virt-viewer 是一个轻量级的图形控制台查看器
12
# 用来在你的桌面上显示虚拟机的图形界面
13
安装阶段：✅️ 用 virt-viewer 看安装向导
14
装完之后（假设装了桌面版）：✅️ 用 virt-viewer 看 GNOME 桌面
15
'只要有图形界面要显示，它就负责弹窗给你看'
16
📌 我的需求是 --> 在安装阶段 --> 有图形化显示
17

18
3)必要管理工具
19
[root@R199 ~]# dnf -y install virt-install
20
'下面有介绍管理工具'
21
✅️ 我们选择用命令行去管理
22
# 不推荐用virt-manager --> 这个不如自带的cockpit(Web控制台)

展开收起

三大管理工具对比

特性	`virt-manager`	`virt-install`	`cockpit`
类型	GUI 桌面应用	命令行	Web 控制台
适合场景	本地图形化操作	脚本/自动化	远程 Web 管理
学习曲线	⭐ 简单	⭐⭐⭐ 中等	⭐⭐ 较低
批量部署	❌ 不方便	✅ 适合	❌ 不方便

Terminal window

1
4)启动服务(开启自启)
2
[root@R199 ~]# systemctl is-active libvirtd
3
inactive            ⚠️ '多了个d'
4
[root@R199 ~]# systemctl enable --now libvirtd
5
[root@R199 ~]# systemctl is-active libvirtd
6
active

虚拟网络架构#

KVM 默认创建 virbr0 网桥，相当于一个 ==NAT 虚拟交换机==，虚拟机通过它上网

Terminal window

1
[root@R199 ~]# ip add show virbr0
2
3: virbr0: xxx
3
    link/ether 52:54:00:74:59:5b brd ff:ff:ff:ff:ff:ff
4
    inet '192.168.122.1/24' brd 192.168.122.255 scope global virbr0
5
  ✅️ 这张网卡默认IP地址为 192.168.122.1/24 📌

🧱 虚拟机是怎么 ping 通外网的？

virbr0 做了一个”地址翻译” —> ==NAT==

虚拟机用假 IP 出门，宿主机帮它换成真 IP，回包来了再换回去
- 虚拟机完全无感

🧱 类比对照：KVM 的 virbr0 ≈ VMware 的 VMnet8

💡 你完全可以这么理解：

KVM 里的 virbr0 就是你 VMware 里的 VMnet8 网卡

它们在架构中的角色完全一样——都是一台 ==NAT 虚拟交换机==

虚拟机想上网，先走虚拟交换机，再经过 NAT 转发到物理网卡，最后出公网

唯一的区别：VMware 叫 VMnet8，KVM 叫 virbr0，本质是同一个东西

防火墙区域：virbr0 属于 libvirt 区域，有独立的防火墙规则
关键点：宿主机提供的 HTTP/FTP 服务，需要同时在==默认区域==和 ==libvirt== 区域放行
- 因为虚拟机通过 virbr0 进来，走的是 libvirt 区域规则

✅ 编辑默认网络配置#

Terminal window展开收起

1
'我这里是Ubuntu系统'
2
# 编辑之前可以先查看一下都有那些网络🛜
3
jiuzhao@Ubuntu 桌面$ virsh net-list --all
4
 Name      State    Autostart   Persistent
5
--------------------------------------------
6
 default   active   yes         yes
7
# 只有这个默认的网络
8

9
1)编辑默认网络配置
10
jiuzhao@Ubuntu 桌面$ sudo virsh net-edit default
11
Select an editor.  To change later, run 'select-editor'.
12
# 选择编辑器
13
  1. /bin/nano        <---- easiest
14
  2. /usr/bin/vim.basic ✅
15
  3. /usr/bin/vim.tiny
16
  4. /bin/ed
17

18
Choose 1-4 [1]: 2 ✅
19
Network default XML configuration edited.
20

21
<network>
22
  <name>default</name>
23
  <uuid>8a858bbb-913f-4ae7-b5ea-4bfb39563c3d</uuid>
24
  <forward mode='nat'/>
25
  <bridge name='virbr0' stp='on' delay='0'/>
26
  <mac address='52:54:00:50:7c:87'/>
27
  <!-- 修改这里 -->
28
  <ip address=📌'10.0.0.1'📌 netmask='255.255.255.0'>
29
    <dhcp>
30
     <!-- DHCP范围也要同步修改 -->
31
      <range start=📌'10.0.0.2'📌 end=📌'10.0.0.254'📌/>
32
    </dhcp>
33
  </ip>
34
</network>
35

36
2)重启默认网络使配置生效
37
jiuzhao@Ubuntu 桌面$ sudo virsh net-destroy default
38
Network default destroyed
39
jiuzhao@Ubuntu 桌面$ sudo virsh net-start default
40
Network default started
41

42
3)验证生效
43
jiuzhao@Ubuntu 桌面$ ip add sho virbr0
44
8: virbr0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN group default qlen 1000
45
    link/ether 52:54:00:50:7c:87 brd ff:ff:ff:ff:ff:ff
46
    inet 10.0.0.1/24 ✅brd 10.0.0.255 scope global virbr0
47
       valid_lft forever preferred_lft forever

展开收起

📝 完成指南#

练习要求：

使用 vsftpd 服务共享网络源

使用 virt-install 基于 vsftpd 共享的网络源安装最小化的 Rocky 10

使用 Cockpit 在浏览器中验证系统可用性，确认无误后关机删除（连硬盘一起删）

① 搭建 vsftpd 网络安装源#

Terminal window展开收起

1
1)安装 vsftpd
2
[root@R199 ~]# dnf -y install vsftpd
3
✅️ vsftpd 是 FTP 服务，用来共享 Rocky10 的 ISO 内容给虚拟机
4

5
2)关闭 SELinux 和 firewalld
6
[root@R199 ~]# getenforce
7
Disabled
8
[root@R199 ~]# systemctl is-active firewalld.service
9
inactive
10

11
3)上传 Rocky 10镜像
12
[root@R199 ~]# mkdir /images
13
[root@R199 ~]# ls /images/ | wc -l
14
0
15
'把镜像放在这里面'
16
[root@R199 ~]# ls -lh /images/
17
total 8.7G
18
-rw-r--r-- 1 root root 8.7G May 28 19:38 Rocky-10.1-x86_64-dvd1.iso
19

20
4)创建 FTP 共享目录并挂载 ISO
21
[root@R199 ~]# mkdir -p /var/ftp/rocky10
22
[root@R199 ~]# ls /var/ftp/rocky10/ | wc -l
23
0
24
[root@R199 ~]# mount /images/Rocky-10.1-x86_64-dvd1.iso /var/ftp/rocky10/
25
✅️ /var/ftp 就是 vsftpd 服务的默认根目录'（FTP 站点的根）'
26
mount: /var/ftp/rocky10: WARNING: source write-protected, mounted read-only.
27
'ISO 是只读的，正常现象'
28
[root@R199 ~]# ls /var/ftp/rocky10/
29
AppStream  boot  BaseOS  images  media.repo
30

31
5)启动 vsftpd
32
# 开机自启
33
[root@R199 ~]# systemctl enable --now vsftpd
34
# 如果防火墙是开启状态 --> 放行防火墙
35
[root@R199 ~]# firewall-cmd --add-service=ftp
36
success
37
[root@R199 ~]# firewall-cmd --add-service=ftp --permanent
38
success
39
'👆 默认区域放行 & 永久生效'
40

41
6)在 libvirt 区域也放行 FTP（虚拟机通过 virbr0 访问）
42
[root@R199 ~]# firewall-cmd --add-service=ftp --zone=libvirt
43
success
44
[root@R199 ~]# firewall-cmd --add-service=ftp --zone=libvirt --permanent
45
success
46

47
7)验证 FTP 源可访问（在宿主机上自测）
48
[root@R199 ~]# ip add show virbr0 | grep net
49
    inet 192.168.122.1/24 brd 192.168.122.255 scope global virbr0
50
[root@R199 ~]#  curl ftp://192.168.122.1/rocky10/
51
curl: (67) Access denied: 530
52
⚠️  这个 530 Access denied 是 vsftpd 默认禁止匿名登录导致的
53
[root@R199 ~]# grep '^anonymous_enable' /etc/vsftpd/vsftpd.conf
54
anonymous_enable=NO ❌️ 默认禁止匿名登录
55
[root@R199 ~]# sed -n '/^anonymous_enable/s#NO#YES#gp' /etc/vsftpd/vsftpd.conf
56
anonymous_enable=YES ✅️ 把选项打开
57
[root@R199 ~]# sed -i '/^anonymous_enable/s#NO#YES#g' /etc/vsftpd/vsftpd.conf
58
'这个 -i 才是真正修改选项'
59
[root@R199 ~]# systemctl restart vsftpd
60
[root@R199 ~]# curl ftp://192.168.122.1/rocky10/
61
'FTP 站点的根目录 --> /var/ftp'
62
drwxr-xr-x    1 0   0   2048 Nov 14  2025 AppStream
63
drwxr-xr-x    1 0   0   2048 Nov 14  2025 BaseOS
64
................
65
'能看到目录文件列表就说明 OK'

展开收起

💡 为什么选 192.168.122.1？

这是 virbr0 网桥的 IP，虚拟机在 NAT 网络里只能通过这个地址访问宿主机

② 使用 virt-install 安装最小化系统#

Terminal window展开收起

1
[root@R199 ~]# virt-install \
2
    --name rocky10-minimal \
3
    --memory 2048 \
4
    --vcpus 2 \
5
    --disk size=20 \
6
    --osinfo rocky10 \
7
    --location ftp://192.168.122.1/rocky10/ \
8
    --graphics none \
9
    --console pty,target_type=serial \
10
    --extra-args "console=ttyS0,115200n8"
11
==========================================
12
参数解读：
13
--name      # 虚拟机名称
14
--memory        # 内存大小 (MB)
15
--vcpus         # CPU 核数
16
--disk size     # 磁盘大小 (GB)
17
--osinfo        # 操作系统类型
18
--location      # FTP 安装源地址
19
==========================================
20
--graphics none # 不使用图形界面，纯文本安装
21
--console       # 串口控制台（这样就能在当前终端操作安装过程了）
22
--extra-args  # 传给 Linux 内核的启动参数

展开收起

Tip

💡 关于 kickstart：还有一种全自动装法

提前写一份 ks.cfg 配置文件，把语言/时区/分区/软件包全部预设好
然后通过 --extra-args "inst.ks=ftp://..." 传给 virt-install，安装过程就完全不用人盯着了

但需要额外学 kickstart 语法、准备 ks.cfg 文件

装一台的话反而更麻烦，==批量部署几十台的时候才是它的主场==

✅️ 生产环境：kickstart 是标配，写一次配置文件，后面装 100 台全自动跑完

删除虚拟机流程#

Terminal window展开收起

1
1)查看虚拟机状态
2
root@R199:~# virsh list --all
3
 Id   Name              State
4
---------------------------------
5
 1    rocky10-minimal   running ✅️
6

7
2)停止虚拟机
8
[root@R199 ~]# virsh shutdown rocky10-minimal
9
[root@R199 ~]# virsh list --all
10
 Id   Name              State
11
----------------------------------
12
 -    rocky10-minimal   shut off
13

14
3)等待停止后，删除虚拟机定义'（但保留磁盘文件）'
15
[root@R199 ~]# virsh undefine rocky10-minimal
16
Domain 'rocky10-minimal' has been undefined
17
# 如果也需要删除磁盘文件，则需要手动删除
18

19
4)找到磁盘文件位置
20
[root@R199 ~]# virsh domblklist rocky10-minimal
21
 Target   Source
22
-------------------------------------------------------
23
 vda      /var/lib/libvirt/images/rocky10-minimal.qcow2
24
# 然后手动删除相关文件
25
[root@R199 ~]# rm -f /var/lib/libvirt/images/rocky10-minimal.qcow2
26
[root@R199 ~]# ls /var/lib/libvirt/images/ | wc -l
27
0 ✅️ 完全删除干净了

展开收起

⚠️ 注意：--disk size=20 创建的磁盘文件在 /var/lib/libvirt/images/rocky10-minimal.qcow2

不指定路径默认就在这里

虚拟机状态管理命令#

Terminal window展开收起

1
1)查看虚拟机状态
2
virsh list                   # 只显示运行中的虚拟机
3
virsh list --all             # 显示所有虚拟机（包括关闭的）
4

5
2)控制虚拟机状态
6
virsh start <vm-name>        # 启动虚拟机
7
virsh shutdown <vm-name>     # 正常关机
8
virsh destroy <vm-name>      # 强制关机（相当于断电）
9
virsh reboot <vm-name>       # 重启虚拟机
10

11
3)如果虚拟机处于关闭状态，你可以使用以下命令来启动它
12
# 启动已关闭的虚拟机
13
virsh start rocky10-minimal
14

15
# 然后连接到控制台
16
virsh console rocky10-minimal

展开收起

完整安装流程#

Terminal window展开收起

1
Text mode provides a limited set of installation options.
2
# 文本安装会有一些限制,是否继续选择文本安装
3

4
'Anaconda 安装程序检测到了图形模式和文本模式的选择'
5
1) Use graphical mode via Remote Desktop Protocol
6
-----------# 这个是远程桌面的方式
7
# 需要创建一个专门用于 RDP 远程桌面的用户名和密码
8
📌 不如图形化安装向导
9
2) Use text mode
10

11
Please make a selection from the above
12
✅️ 按键盘输入 2 然后回车，继续使用文本模式安装
13

14
==============================================================
15
Installation
16
1) [x] Language settings             2) [x] Time settings
17
       (Simplified Chinese (China))         (Asia/Shanghai timezone)
18
3) [!] Installation source           4) [!] Software selection
19
       (Setting up installation             (Processing...)
20
       source...)
21
5) [!] Installation Destination      6) [x] Kdump
22
       (Processing...)                      (Kdump is enabled)
23
7) [x] Network configuration         8) [!] Root password
24
       (Connected: enp1s0)                  (Root account is disabled)
25
9) [!] User creation
26
       (No user will be created)
27
==============================================================
28
Software selection
29
Base environment
30

31
1) [ ] Server with GUI                  4) [ ] Workstation
32
2) [ ] Server                           5) [ ] Custom Operating System
33
3) [x] Minimal Install                  6) [ ] Virtualization Host
34
✅️ 选择 "Minimal Install"（最小化安装）
35
==============================================================
36
Root password
37
Please select new root password. You will have to type it twice.
38
✅️ 设置 root 密码
39
Password:
40
Password (confirm):
41
==============================================================
42
Please make a selection from the above ['b' to begin installation
43
✅️ '按 b 键开始安装'
44
==============================================================
45
Installation complete. Press ENTER to quit:

展开收起

重启进入系统#

Terminal window展开收起

1
Rocky Linux 10.1 (Red Quartz)
2
Kernel 6.12.0-124.8.1.el10_1.x86_64 on x86_64
3

4
jiuzhao login: root
5
密码：
6
[root@jiuzhao ~]# hostname -I
7
192.168.122.191
8
[root@jiuzhao ~]# ping -W2 -c2 www.baidu.com
9
PING www.a.shifen.com (39.156.70.46) 56(84) 字节的数据。
10
64 字节，来自 39.156.70.46: icmp_seq=1 ttl=127 时间=18.8 毫秒
11
64 字节，来自 39.156.70.46: icmp_seq=2 ttl=127 时间=11.7 毫秒
12

13
--- www.a.shifen.com ping 统计 ---
14
已发送 2 个包， 已接收 2 个包, 0% packet loss, time 1002ms
15
rtt min/avg/max/mdev = 11.681/15.247/18.814/3.566 ms

展开收起

③ 使用 Cockpit 验证 & 清理#

Terminal window展开收起

1
1)确认 cockpit 已安装并运行
2
[root@R199 ~]# dnf -y install cockpit cockpit-machines
3
[root@R199 ~]# systemctl enable --now cockpit.socket
4

5
2)检查监听端口
6
[root@R199 ~]# ss -anptul | grep 9090
7
tcp  LISTEN 0  4096  *:9090  *:*  users:(("cockpit-tls",...))
8
✅️ '9090 端口在监听'
9

10
3)允许root登录
11
[root@R199 ~]# cat /etc/cockpit/disallowed-users
12
# List of users which are not allowed to login to Cockpit
13
root
14
[root@R199 ~]# sed -i 's@root@#root@g' /etc/cockpit/disallowed-users
15
[root@R199 ~]# systemctl restart cockpit
16

17
4)浏览器访问
18
https://10.0.0.199:9090/
19
# 用 root 账号登录

展开收起

image-20260528213624889

在 Cockpit 中验证以下内容：

验证项	操作路径
✅️ 虚拟机运行状态	左侧 “虚拟机” → 查看 rocky10-minimal 是否为 “Running”
✅️ CPU/内存使用	点击虚拟机 → “概览” 查看资源占用
✅️ 网络连通性	”虚拟机” → 点击进入 → “控制台” → 登录后 `ping -c2 www.baidu.com`
✅️ 磁盘 I/O	”概览” → 查看磁盘读写曲线

image-20260528213734377

image-20260528214420788

image-20260528214052029

Terminal window展开收起

1
5)验证无误后，关机
2
[root@R199 ~]# virsh shutdown rocky10-minimal
3
'或者直接在 Cockpit 网页里点关机按钮'
4

5
6)确认已关机
6
[root@R199 ~]# virsh list --all | grep rocky10-minimal
7
 -    rocky10-minimal   shut off
8
'shut off 状态才对'
9

10
7)删除虚拟机及磁盘
11
[root@R199 ~]# virsh undefine rocky10-minimal --remove-all-storage
12
Domain 'rocky10-minimal' has been undefined
13
Volume 'vda'(/var/lib/libvirt/images/rocky10-minimal.qcow2) removed.
14
--remove-all-storage    # 删除虚拟机的同时删除磁盘文件
15
# 不加这个参数只删定义，磁盘还留在 /var/lib/libvirt/images/ 里
16

17
7)二次确认磁盘已删除
18
[root@R199 ~]# ls /var/lib/libvirt/images/rocky10-minimal.qcow2
19
ls: cannot access '...': No such file or directory
20
'文件没了，干净利落'

展开收起

📌 virsh undefine 参数对比：

命令	效果
`virsh undefine vm名`	只删定义，不删磁盘
`virsh undefine vm名 --remove-all-storage`	删定义 + 删所有磁盘 ✅️
`virsh destroy vm名 && virsh undefine ...`	先强制关机再删（关机失败时用）

图形化安装向导#

上面演示的是纯文本安装, 其实挺难用的!!!

我么可以让 virt-install 启动图形安装界面并使用 virt-viewer 连接

移除 --graphics none 和 --console pty,target_type=serial（这两个是强制纯文本模式的）
移除 --extra-args "console=ttyS0,115200n8"（这会把内核输出重定向到串口，导致图形界面无法显示）

Terminal window展开收起

1
1)软件包准备
2
[root@Vir-01 ~]# rpm -qa virt-viewer
3
virt-viewer-11.0-10.el10.x86_64
4
✅️ 仅安装 --> 这个轻量级的图形控制台查看器
5
# 配合 virt-install 管理工具使用即可
6

7
2)命令安装
8
[root@Vir-01 ~]# virt-install \
9
    --name rocky10-test \
10
    --memory 2048 \
11
    --vcpus 2 \
12
    --disk size=20 \
13
    --osinfo rocky10 \
14
    --location ftp://192.168.122.1/rocky10/ \
15
    --graphics vnc,listen=0.0.0.0 \
16
    --wait -1
17
==============================
18
添加 `--graphics vnc` 来启用图形控制台
19
添加 `--wait -1` 让 `virt-install` 保持前台运行并自动弹出 `virt-viewer`

展开收起

image-20260530124436036

image-20260530124631327

image-20260530130503408

⚠️ 常见坑点#

问题	原因	解决
`curl ftp://192.168.122.1/` 不通	firewall 没在 libvirt 区域放行 ftp 服务	`firewall-cmd --add-service=ftp --zone=libvirt`
virt-install 报 “Could not find an installable distribution”	FTP 路径指错了，没找到 repodata	确认 URL 指向 repodata 所在的目录
SELinux 拦截 FTP 访问	SELinux 默认禁止 FTP 读取用户目录外的内容	`setenforce 0` 或配置 `ftpd_full_access` 布尔值
Cockpit 登录后看不到虚拟机	没装 `cockpit-machines` 包	`dnf -y install cockpit-machines && systemctl restart cockpit`
ISO 挂载后重启丢失	mount 是临时的，重启就没了	写入 `/etc/fstab` 或每次手动 mount

存储池&&PG及配置管理

Wed, 08 Apr 2026 00:00:00 GMT

存储池 && PG及配置管理#

[TOC]

命令拆解#

Ceph 命令是”层级式”命名的,拆开看每个词就不需要死记：

Terminal window

1
ceph osd pool rm  xixi  xixi  --yes-i-really-really-mean-it
2
 │   │    │   │     │     │
3
 │   │    │   │     │     └── "我真要这么干"池删除的最高级双重确认'两次 really'
4
 │   │    │   │     └── 池名（要输两遍,防止手滑）
5
 │   │    │   └── Remove 删除
6
 │   │    └── 存储池（逻辑分区）
7
 │   └── OSD 守护进程层
8
 └── Ceph CLI 总入口

词	含义	记忆方法
`ceph`	Ceph 集群 CLI 总入口	所有命令都从这个开始
`osd`	Object Storage Daemon	存储相关操作（池、PG、CRUSH 都归这层管）
`pool`	存储池,逻辑分区	数据的”命名空间”,不同业务用不同池
`pg`	Placement Group 归置组	数据分布的最小单位,一个 PG 里可放成千上万个对象
`rm`	Remove 删除
`create`	创建
`get`	查单个属性	精确==查询==某个参数值
`set`	修改属性	==修改==某个参数值
`dump`	导出全部	导出所有配置/规则,==常配合 `grep` 过滤==
`show`	查看最终生效配置	合并 Config DB + ceph.conf + 默认值给出进程==实际==跑的配置
`ls`	List 列出	列出所有池 / 规则
`config`	集中化配置数据库	替代传统 `ceph.conf`,Monitor 集中存储
`crush`	CRUSH 算法 / 拓扑表	集群的”地图”——数据该往哪放
`application`	池用途声明	告诉集群这池是给 RBD / CephFS / RGW 用的
`replicated`	副本池类型	数据完整复制多份——==“一式三份”==
`erasure`	纠删码池类型	切块 + 校验块——“拼图 + 备用块”
`pg_num`	PG 总数	池里有多少个”调度组”
`pgp_num`	参与数据放置的 PG 数	多少个调度组实际在干活,≤ pg_num
`size`	==副本数==	数据一共存几份
`min_size`	==最小副本数==	I/O 服务需要的最少可用副本数
`nodelete`	池级删除锁	给某个池打上 `true` → 该池不可删除
`mon_allow_pool_delete`	集群级删除开关	Monitor 总闸,控制整个集群是否允许删池
`pg_autoscale_mode`	PG 自动伸缩	Ceph 根据 OSD 数量和用量自动调整 PG 数
`global`	==全局配置层==	影响所有守护进程（mon/osd/mgr/mds/client）
`mon` / `osd` / `mgr`	类型级配置 target	只影响某一类守护进程
`osd.0` / `mon.Ceph-201`	==实例级==配置 target	精确到某一个具体进程
`--yes-i-really-really-mean-it`	”我真要这么干”（双重确认）	删池的最高级确认,两个 really
`--force`	跳过普通确认	常规操作的安全确认

命令层级——越靠左越宏观,越靠右越具体：

Terminal window

1
ceph              -->  集群层（管一切）
2
ceph osd          -->  OSD 层（管池、管 PG、管 CRUSH）
3
ceph osd pool     -->  池层（管大小、管副本、管类型）
4
ceph config       -->  配置层（管参数、管开关）

层面	命令入口	管的	视角
OSD 数据层	`ceph osd ...`	CRUSH 地图、OSD 状态、池属性、PG 状态	CRUSH 全局视角——“数据该往哪放”
配置管理层	`ceph config ...`	集中化配置数据库、参数读写	Monitor 视角——“集群怎么跑”
Dashboard 层	`ceph dashboard ...`	Web 管理界面、用户权限	图形化视角——“不想敲命令时用它”

存储池概述#

池（Pool）是个啥？#

🧱 池是 Ceph 里存储数据的逻辑分区,你可以把它理解成一个”命名空间”

不同的业务（RBD 块存储、CephFS 文件系统、RGW 对象存储）各自用各自的池,井水不犯河水

池的核心作用	大白话解释
逻辑分区	给不同应用划地盘,互不干扰
数据保护	指定==副本数==或==纠删码==,决定数据能坏几块盘还不丢
CRUSH 规则	绑一条 CRUSH 规则控制数据分布比如限定故障域或 OSD 的 class 标签（ssd/hdd/nvme）
访问控制	权限按==池==粒度划分 Monitor 发证,OSD 验票,限定谁能读写这个池
快照管理	对整个池做快照,出事了能回滚

数据存储流程对比#

我们最熟悉的是副本池的流程（参考之前的笔记📚）,先用它过一遍,再对照看纠删码池

🔹 副本池流程（复习）—— 以 3 副本为例：

Terminal window展开收起

1
┌──────────────────────────────────────────┐
2
│  Step 1：文件 → 切成固定 4MB 对象           │
3
│                                          │
4
│  100MB 照片                               │
5
│    │                                     │
6
│    ▼                                     │
7
│  ┌──────┐┌──────┐┌──────┐       ┌──────┐ │
8
│  │ 4MB  ││ 4MB  ││ 4MB  │ ...   │ 4MB  │ │
9
│  │ obj1 ││ obj2 ││ obj3 │  ×25  │ obj25│ │
10
│  └──────┘└──────┘└──────┘       └──────┘ │
11
│  '每个对象固定 4MB,不够就补齐'               │
12
└──────────────────────────────────────────┘
13
                       │
14
                       ▼
15
┌──────────────────────────────────────────┐
16
│  Step 2：对象→Pool→命中某个 PG              │
17
│                                          │
18
│  "对象名" + CRUSH Map ──→ PG.7            │
19
│  'CRUSH①：决定对象归哪个 PG'                │
20
└──────────────────────────────────────────┘
21
                       │
22
                       ▼
23
┌──────────────────────────────────────────┐
24
│  Step 3：PG → CRUSH 再算 → 副本落盘         │
25
│                                           │
26
│  PG.7（size=3,要放 3 份）                  │
27
│    │                                      │
28
│    ▼  'CRUSH②：决定副本落哪几块盘'            │
29
│    │                                      │
30
│    ├─→ 副本① → osd.1（host A）              │
31
│    ├─→ 副本② → osd.4（host B）              │
32
│    └─→ 副本③ → osd.7（host C）              │
33
│         ⚠️ （故障域 = host）                │
34
│  obj1 的 3 个副本,落在 3 台不同主机上         │
35
│  '读的时候随便找一个副本就能拿到完整数据'        │
36
└───────────────────────────────────────────┘

展开收起

📌 副本池的本质：一份数据原样 copy 好几份,写的时候多写几遍,读的时候读最近的那份就行

🔹 纠删码池流程 —— 以 6+3 为例：

Terminal window展开收起

1
      '前面两步一模一样,差异在第三步'
2
                         │
3
                         ▼
4
┌──────────────────────────────────────────────┐
5
│  Step 3：PG → 编码切块 → 分散落盘               │
6
│                                              │
7
│  PG.7 收到 obj1（4MB 对象）                    │
8
│    │                                         │
9
│    ▼  '不是直接 copy,而是先编码'                │
10
│    │                                         │
11
│  把 4MB 对象切成 6 个数据块                     │
12
│    │                                         │
13
│    ├─→ 数据块①                                │
14
│    ├─→ 数据块②                                │
15
│    ├─→ 数据块③   k = 6 个数据块                │
16
│    ├─→ 数据块④                                │
17
│    ├─→ 数据块⑤                                │
18
│    └─→ 数据块⑥                                │
19
│    │                                         │
20
│    ▼  '根据 6 个数据块算出 3 个校验块'           │
21
│    │                                        │
22
│    ├─→ 校验块⑦                               │
23
│    ├─→ 校验块⑧    m = 3 个校验块               │
24
│    └─→ 校验块⑨                               │
25
│    │                                        │
26
│    ▼  'CRUSH②：9 个块分散到 9 块盘上'          │
27
│    │                                        │
28
│    ├─→ 块① → osd.1       ├─→ 块⑥ → osd.6     │
29
│    ├─→ 块② → osd.2       ├─→ 块⑦ → osd.7     │
30
│    ├─→ 块③ → osd.3       ├─→ 块⑧ → osd.8     │
31
│    ├─→ 块④ → osd.4       ├─→ 块⑨ → osd.9     │
32
│    └─→ 块⑤ → osd.5                           │
33
│  总共 k+m = 9 个块,散落在 9 块不同的盘上         │
34
│        ⚠️ 如果故障域是 host → 需要 9 台主机！    │
35
│   如果故障域是 osd  → 9 块盘可以都在同一台主机上   │
36
│  '只要任意 6 块还在,数据就能算回来'              │
37
└──────────────────────────────────────────────┘

展开收起

📌 纠删码池的本质：数据不存整份,而是切成块 + 算出校验块,散开到更多盘上

用 CPU + I/O 换空间

具体差多少？往下看对比表格

🔹 读写路径对比 —— 关键差异一目了然：

Terminal window展开收起

1
🌰写路径：
2
副本池（3副本）                纠删码池（6+3）
3
obj1 ──→ copy 3 份           obj1 ──→ 切成6块+算3块
4
      │                            │
5
      ▼                            ▼
6
  直接写 3 块盘                编码后写 9 块盘
7
 '写 3 次,简单粗暴'         'CPU 编码开销 + 写 9 次 I/O'
8
      │                            │
9
   写放大：3x                   写放大：1.5x
10
'4MB 对象占 12MB 磁盘'      '4MB 对象只占 6MB 磁盘'
11
=====================================================
12
🌰读路径：
13
副本池（3副本）                纠删码池（6+3）
14
需要数据 ──→ 读最近的 1 个副本  需要数据 ──→ 读任意 6 块
15
          │                          │
16
          ▼                          ▼
17
      拿到完整数据              CPU 解码拼回数据
18
    '读 1 次,秒返回'        '读 6 次 I/O + CPU 解码'
19
          │                          │
20
      延迟：低                     延迟：高

展开收起

存储池的两种类型#

类型	英文名称	原理	类比
==副本池==	replicated	数据==完整复制==多份,每个副本放在不同 OSD 上	RAID1（多副本）
==纠删码池==	erasure	数据切成 k 个==数据块== + 算出 m 个==校验块== 共 k+m 个块,散落在不同盘上	RAID5（校验码）

通俗解释：

副本池就是”一式三份”——同一份数据 copy 到三块盘上,简单粗暴,坏两块盘都不怕

缺点是废空间,3 副本 = 实际可用只有 1/3 的容量

纠删码池像*“拼图+备用块”*——把数据切成 6 个数据块,再算 3 个校验块,总共 9 个块散落在 9 块盘上

只要任意 6 块还在就能恢复完整数据,比副本省空间多了

对比维度	副本池	纠删码池
存储利用率	低（3 副本 = 1/3）	高（6+3 = 2/3）
CPU 开销	低	高（需要编码&解码运算）
I/O 延迟	低	较高（要读多个块才能拼回数据）
典型场景	RBD 块设备、高性能场景	RGW 对象存储、冷数据归档
最多能坏几块盘	size-1 块（3副本最多坏2块）	任意 m 块（6+3 最多坏 3 块） 6是数据块(k), 3是校验块(m)

📌 生产环境推荐用副本池,除非你对容量极度敏感且能接受性能损耗

PG 概述#

什么是PG#

Ceph 存数据的过程：对象 → Pool → PG → OSD

💡 OSD 是什么？ OSD 本质上是一个进程 + 一块盘
说 osd.0 就是指 /dev/sda 上的那个守护进程,说”数据写到 osd.3”就是写到 osd.3 背后的那块物理盘上
后面讲的 peering、backfill、磁盘 I/O,都是在说 OSD 进程在操作它背后的那块盘

Terminal window

1
Object（对象） --CRUSH①--> Pool 下的某个 PG --CRUSH②--> OSD 集合

📌 CRUSH 在数据落地过程中用了两次：

第一次负责逻辑分组（对象归哪个 PG）

第二次负责数据落盘（PG 的副本落哪几块盘）

🧱 Pool 和 PG 的关系？

Pool 是 PG 的容器——一个 Pool 下挂着若干个 PG,PG 是 Pool 内部数据分布的最小单位

对象先命中某个 Pool,再由 CRUSH 哈希到该 Pool 下的某个 PG,最终落盘到 OSD

📌 PG 的数量远小于对象的数量——这才是 PG 存在的意义：

一个 PG 里可以存放成千上万个对象

Terminal window展开收起

1
PG.7（一个 PG）
2
  ├── obj1（4MB）
3
  ├── obj8（4MB）
4
  ├── obj15（4MB）
5
  ├── ...（成千上万个对象）
6
  └── objN（4MB）
7
====================================
8
一个 Pool 里的数量对比：
9

10
  对象：几百万个（甚至上亿）      ← 海量
11
          │  'CRUSH 哈希收敛'
12
          ▼
13
   PG：几百个（通常 32 ~ 1024） ← 少量
14
          │  'CRUSH 再计算'
15
          ▼
16
   OSD：几十块盘               ← 更少

展开收起

PG 做的就是聚合收敛——把海量对象哈希到少量 PG 中,规模从百万级降到千级
迁移时以 PG 为单位搬——一次搬”一筐对象”,而不是一个一个搬
- 加减 OSD 时也只迁移受影响的 PG

PG 数量#

📌 ==官方公式==：

Terminal window

1
         OSD 数量 × X
2
  PG = ---------------
3
         pool 的 size（副本数）
4

5
  X = 每块 OSD 期望承载的 PG 数量,官方推荐 100 左右

🧱 这个公式到底在算什么？

核心逻辑：先定每块 OSD 背多少个 PG 合理,再反推池里该建多少个 PG

Terminal window

1
# PG 均匀散落在 OSD 上：
2
                     PG 总数 × size
3
每块 OSD 背的 PG 数 = ---------------
4
                        OSD 数量
5

6
# 反过来,已知每 OSD 期望背 X 个 PG,求 PG 总数：
7
         OSD 数量 × X
8
PG 总数 = ---------------
9
              size

PG 总数太多还是太少？

PG 总数	后果
太少	数据分布不均,个别 OSD 成为”热点”,忙的忙死闲的闲死
太多	PG 元数据膨胀,peering（互相同步状态） / scrub （校验数据一致性）开销暴增,CPU 和内存吃紧

公式里塞 X=100 就是为了让 PG 总数落在适中区间
Ceph 的 mon_max_pg_per_osd 默认上限是 250
算是一种硬保护,防止 PG 总数失控

回到公式——代入算一下：

Terminal window展开收起

1
  示例①：9 块 OSD,3 副本
2
        9 × 100
3
  PG = --------- = 300 → 取最近的 2 次方 → 256
4
           3
5
  '验证：256 × 3 / 9 = 每 OSD 约 85 个 PG'
6

7
  示例②：200 块 OSD,3 副本
8
        200 × 100
9
  PG = ----------- ≈ 6666 → 取最近的 2 次方
10
            3
11

12
    2^12 = 4096  ← 差 2570
13
    2^13 = 8192  ← 差 1526（更近）
14

15
  ∴ 集群 PG 总量取 2^13 = 8192 比较合理
16
  '验证：8192 × 3 / 200 = 每 OSD 约 123 个 PG,仍在合理范围'

展开收起

💡 结果取最近的 2 的幂（方便数据均匀分布）
算完后顺手验一下：PG总数 × size ÷ OSD数 是否在 100~250 之间

size VS min_size#

这两个参数是副本池容错的核心

参数	含义	生产推荐值
`size` ==副本数==	数据一共存几份（包含原始那份）	≥ 3
`min_size` ==与最小副本数==	I/O 服务需要的最少可用副本数	size - 1（如 3 副本时设为 2）

工作机制：

集群正常时,所有 size 个 OSD 上的数据一致
坏一块盘,剩余副本 ≥ min_size → I/O 照常跑
剩余副本 < min_size → 池暂停 I/O 或只读,优先保数据一致性,宁可停服也不丢数据

💡 这就是 Ceph 的”宁死不屈”机制——数据安全比服务可用性更重要

Terminal window展开收起

1
🌰实战：把 3 副本改成 5 副本,同时提高 min_size
2
1)查看PG状态
3
root@Ceph-201 ~# ceph pg stat
4
1 pgs: 1 active+clean; 449 KiB data, 284 MiB used, 5.3 TiB / 5.3 TiB avail
5
root@Ceph-201 ~# ceph pg dump
6
'所有 PG 详细状态'
7
version 1287
8
stamp 2026-05-26T03:38:21.766113+0000
9
last_pg_scan 0
10
................
11

12
2)查看默认池现有规则
13
root@Ceph-201 ~# ceph osd pool ls detail
14
pool 1 '.mgr' replicated size 3 min_size 2
15
'可以查看指定的参数'  # get  池子  key
16
root@Ceph-201 ~# ceph osd pool get .mgr size
17
size: 3
18
root@Ceph-201 ~# ceph osd pool get .mgr min_size
19
min_size: 2
20

21
3)修改规则
22
root@Ceph-201 ~# ceph osd pool get .mgr pg_autoscale_mode
23
pg_autoscale_mode: on
24
'如果开着 autoscale_mode,系统可能在你手动改完 pg_num 后立刻又给调回去'
25
# 我们在后面存储池管理中详细介绍这个选项
26
root@Ceph-201 ~# ceph osd pool set .mgr size 5
27
set pool 1 size to 5
28
root@Ceph-201 ~# ceph osd pool set .mgr min_size 3
29
set pool 1 min_size to 3
30
root@Ceph-201 ~# ceph osd pool ls detail
31
pool 1 '.mgr' replicated size 5 min_size 3 crush_rule 0
32
# 改成 5 副本后可以容忍任意 2 块盘故障（5-3=2）,但代价是容量利用率更低

展开收起

Peering 与 Backfill 详解#

Peering —— PG 状态协商#

🧱 前置概念：acting set 与 up set

在理解 peering 之前,先搞清楚 PG 里的 OSD 是怎么组织的

CRUSH 算法为每个 PG 算出一个 OSD 列表,指明该 PG 的副本应该落在哪几块盘上——这个列表就是 acting set

🌰 比如 PG.7 的 acting set = [OSD.0, OSD.1, OSD.2],意思是这个 PG 的 3 个副本（size=3）应分别存放在 OSD.0、OSD.1、OSD.2 三块盘上

🧱 主 OSD（Primary）

acting set 中的第一个 OSD 被指定为 主 OSD（Primary）,其余为副本 OSD

角色	谁	干什么
主 OSD	acting set 的第一个	接收客户端读写请求、将写操作同步到副本、驱动 peering / recovery / backfill
副本 OSD	acting set 的其余位置	被动响应主 OSD 指令,同步数据、响应 log 查询

🌰 PG.7 的 acting set = [OSD.0, OSD.1, OSD.2] → OSD.0 是主,OSD.1 / OSD.2 是副本

正常情况下,还有一个 up set（当前实际在干活的 OSD 列表）,两者保持一致：up set = acting set

如果某个 OSD 挂了,Monitor 会临时指派替代者,此时 up set 和 acting set 就不一致了（即后文的”临时 PG”机制）

概念	含义	一句话
`acting set`	CRUSH 算出的目标 OSD 集合	”应该在哪”
`up set`	当前实际在干活的 OSD 集合	”实际在哪”

🧱 Peering 是什么？

PG 的 acting set 里的 OSD 之间互相沟通、协商状态,达成共识——谁有最新数据、谁落后了、日志进度对齐到哪了

Tip

⚠️ 注意：PG 本身是逻辑实体,不干活

peering 的实际执行者是 acting set 里的 OSD 进程,==由主 OSD 牵头==、副本 OSD 响应——本质上就是这几个 OSD 在替这个 PG “对账”

📌 通俗理解：peering 就像三个副本”开会”

“你到哪了？我写到 log 第 100 条了""我才到 95,等我补一下”

先把状态对齐,再决定下一步动作

什么时候会触发 peering？

触发场景	说明
OSD 挂了又恢复	它上面的 PG 落后了,需要和同伴对账
PG 数量变化	pg_num / pgp_num 变了,PG 哈希边界重划,全部 PG 重新 peering
OSD 增删	CRUSH 重新分配 PG 到不同 OSD
集群重启	所有 PG 从零开始协商状态

Peering 的过程（简化版）

💡 一句话：说”PG.7 在 peering”和”主 OSD 在替 PG.7 peering”是同一件事
PG 是逻辑实体不干活,peering 由 acting set 里的 OSD 进程实际执行

Terminal window展开收起

1
     PG.7 的 acting set = [OSD.0, OSD.1, OSD.2]
2
     OSD.0 = 主 OSD（Primary）
3
     其余 OSD 为副本 OSD,只被动响应主 OSD 的指令
4

5
     ═══════════════════════════════════════
6
     Step 1: '主 OSD' 发起 peering 请求
7
     ┌─────────────────────────────────────┐
8
     │  OSD.0 (Primary)                    │
9
     │    │                                │
10
     │    │  PG.7 peering 报一下你们的       │
11
     │    │   PG Log 最后一条序号            │
12
     │    │                                │
13
     │    ├──────→ OSD.1 ──→ 回复: log #100 │
14
     │    └──────→ OSD.2 ──→ 回复: log #98  │
15
     └─────────────────────────────────────┘
16

17
     Step 2: 确定权威日志（Authoritative Log）
18
     ┌─────────────────────────────────────┐
19
     │  Primary 对比三份 log：               │
20
     │    OSD.0: #100 (自己就是最新的)        │
21
     │    OSD.1: #100 ✅ 一致               │
22
     │    OSD.2: #98  ❌ 落后 2 条          │
23
     │                                     │
24
     │  权威日志 = OSD.0 的 log              │
25
     │  原则：挑最完整的一份                   │
26
     │                                     │
27
     │  ⚠️ 前提：被选中的 log 必须连续、       │
28
     │  且属于当前 PG epoch——防止网络分区后    │
29
     │  旧主带着"过期最长 log"回来造成脑裂      │
30
     └─────────────────────────────────────┘
31

32
     Step 3: 状态判定——该走哪条恢复路径？
33
     ┌─────────────────────────────────────┐
34
     │  OSD.2 只差 2 条 log                 │
35
     │    → 走 recovery（增量恢复）          │
36
     │    → OSD.2 回放缺失的 log 条目即可     │
37
     │                                     │
38
     │  如果 OSD.2 整个 PG 目录都丢了         │
39
     │    → 走 backfill（全量回填）          │
40
     └─────────────────────────────────────┘

展开收起

📌 peering 本身不搬数据,只是协商状态 + 决定恢复策略
数据搬运是 recovery 或 backfill 的事

🧱 PG Log vs 实际数据

peering 过程中反复提到的”PG Log”到底是什么？跟用户存的数据是一回事吗？

Terminal window

1
PG Log（操作日志）                        实际数据（对象内容）
2
─────────────────────────               ─────────────────────
3
记录"发生过什么修改操作"（写/删/改/克隆等）    用户存的东西本身
4
比如：                                    比如：
5
  #98  write obj15                        obj15 = 4MB（照片的第 3 个分片）
6
  #99  delete obj8                        obj1  = 4MB（文档的第 1 个分片）
7
  #100 modify obj3                        obj3  = 4MB（视频的第 5 个分片）
8

9
像一个"记账本"                            像一个"仓库"
10
peering 对账本 → 轻量,秒级完成            scrubbing 翻仓库逐件盘点 → 重,费 I/O

📌 这就是为什么 peering 能几百个 PG 同时做（只对日志条目,几乎不碰磁盘）
而 backfill / recovery 要限流（搬实际数据）,scrubbing 也要限速（逐字节读副本比对,同样是重 I/O）

为什么 peering 多了会”风暴”？

每个 PG peering 时,acting set 里的 OSD 要来回发消息

关键前提：一块 OSD 上托管着很多 PG（按官方推荐 ~100 个）,每个 PG 的 acting set 都可能包含这块 OSD

Terminal window

1
1 个 PG peering：
2
  只有这 1 个 PG 的 acting set 里那几块 OSD 在通信 → 轻量,秒级完成
3

4
100 个 PG 同时 peering：
5
  每块 OSD 上托管着 ~100 个 PG,这 100 个 PG 的 peering 砸过来,
6
  一块 OSD 可能同时卷入几十个 PG 的协商：
7
    → OSD 进程的消息队列堆成山
8
    → Monitor 心跳超时
9
    → PG 被标记为 down / stale（误伤！）

这就是前面说的 peering 风暴——不是 peering 本身开销大,而是几百个 PG 同时 peering 时,OSD 的消息处理能力被打穿

Backfill —— 全量数据回填#

🧱 Backfill 是什么？

当某个 OSD 上整个 PG 的数据需要从头同步时,Ceph 不走逐条 log 回放（recovery）,而是直接扫描并全量拷贝 PG 的所有对象——这就是 backfill

recovery = 差几条 log,逐条追

backfill = 整个 PG 都要搬,全量拷

什么时候走 backfill 而不是 recovery？

场景	走哪条路	原因
OSD 短暂挂了又回来,只差几条 log	recovery	增量补就行
新 OSD 加入集群,上面啥数据都没有	backfill	全量搬
PG 扩容,PG 被分配到之前未托管过它的 OSD	backfill	该 OSD 上没有这个 PG 的存量数据,只能全量搬
OSD 永久替换（盘坏了换了块新的）	backfill	从零开始

Backfill 的过程

和 peering 一样,backfill 也是由主 OSD 驱动的——主 OSD 扫描 ==该PG== 落在自己盘上的所有对象,全量推送给目标 OSD

Terminal window展开收起

1
    场景：OSD.3 是新加入的盘,PG.7 被 CRUSH 分配到了它上面
2
    PG.7 acting set = [0, 1, 2] → OSD.3 加入后 → [0, 1, 3]
3

4
    ┌──────────────────────────────────────────────┐
5
    │              主 OSD (OSD.0)                   │
6
    │   PG.7 目录：                                  │
7
    │   ├── obj1  (4MB)                             │
8
    │   ├── obj8  (4MB)                             │
9
    │   ├── obj15 (4MB)                             │
10
    │   └── ...  (共 10000 个对象,约 40GB)           │
11
    └──────────┬───────────────────────────────────┘
12
               │
13
               │  Backfill：全量顺序扫描 & 推送
14
               │
15
               ▼
16
    ┌──────────────────────────────────────────────┐
17
    │              OSD.3 (新盘,PG 目录为空)         │
18
    │                                              │
19
    │  backfill 进度：                               │
20
    │  ████████████░░░░░░░░  67% (6.7K / 10K obj)  │
21
    │                                              │
22
    │  磁盘写 I/O 持续拉满                           │
23
    └──────────────────────────────────────────────┘
24

25
    同时,OSD.2 上的旧副本被标记为"待清理"（PG 成员变了）

展开收起

为什么 backfill 不能太多并发？

先理解一个前提：backfill 的每一步——从源 OSD 读对象、写到目标 OSD——本质上都是磁盘顺序 I/O

这里的磁盘,就是指 OSD 背后的那块物理盘

Terminal window

1
🌰 单个 PG backfill 时（比如 PG.7）：
2
   源 OSD 上 PG.7 的对象在磁盘上是连续存放的
3
     → 磁头从 A 位置一路扫到 B 位置,一口气读完
4
     → 这是"顺序读"——磁头几乎不用跳,速度极快

一块盘上托管着几十上百个 PG,它们的对象各自占据不同的物理区域

当多个 PG 同时 backfill 时：

Terminal window

1
❌ 50 个 PG 同时 backfill 在同一块盘上：
2
   磁盘被要求同时服务 PG.1、PG.7、PG.3... 的数据
3

4
   原本每个 PG 都是"一口气读完"的顺序 I/O,
5
   现在被搅在一起,磁头在不同 PG 的区域之间反复横跳
6
     → 顺序 I/O 退化成随机 I/O
7
     → 大量时间浪费在"寻道"上,实际读数据的时间占比暴跌
8
     → 吞吐量断崖式下跌,业务读写也被挤占

📌 核心：一块盘同一时间只做一件事（读或写某个 PG 的数据）效率最高,让它同时干好几件,磁头来回跳,总产出反而骤降

Peering → Recovery → Backfill 关系图#

Terminal window展开收起

1
OSD 挂掉 / PG 变化 / 集群事件
2
         │
3
         ▼
4
    ┌─────────┐
5
    │ Peering │  ← 先协商,搞清楚"谁有、谁缺、缺多少"
6
    └────┬────┘
7
         │
8
         ▼
9
    PG Log 差得少？──── 是 ──→ Recovery（增量回放 log）
10
         │                         │
11
         否                        ▼
12
         │                    恢复完成 → active+clean
13
         ▼
14
    Backfill（全量扫描 & 拷贝对象）
15
         │    '扫描 = 主 OSD 读自己的盘'
16
         │    '拷贝 = 写到目标 OSD 的盘'
17
         ▼
18
    恢复完成 → active+clean

展开收起

📌 一句话：peering 是”对账”,recovery 是”打补丁”,backfill 是”重装系统”。

PGP 是什么#

PGP = Placement Group for Placement,即”用于数据放置的 PG 数量”

🧱 pg_num 和 pgp_num 的区别：

参数	干什么的	通俗理解
`pg_num`	池里创建多少个 PG	池里有多少个”调度组”
`pgp_num`	多少个 PG 参与数据分布	有多少个调度组实际在干活

📌 pgp_num ≤ pg_num,通常两者保持相等

🧱 为什么需要 pgp_num？——安全扩容的”调速阀门”

如果把 pg_num 和 pgp_num 同时拉满,集群瞬间要对所有已有数据重新分布
- 全部 PG 同时 peering,==新PG== 集中 backfill,I/O 直接被打穿

pgp_num 就是调速阀门：pg_num 决定有多少个 PG 存在,pgp_num 决定其中多少个真正在干活

安全扩容三步走：

Terminal window

1
1) 扩大 pg_num  → 只创建新 PG 的数据结构,不实际迁移数据
2
2) 逐步调大 pgp_num → 每次只搬迁一部分 PG,集群平稳过渡
3
3) pgp_num 对齐 pg_num → 全部 PG 正常参与数据分布

📌 pgp_num 分步的本质是”限流”——让 PG 分批 peering + backfill,而非全部 PG 同时搅动
最终搬的数据总量差不多,但每批只扰动一部分 PG,集群始终保持可服务状态

🧱 为什么分步调能奏效？——回头看 peering 和 backfill

维度	peering 风暴	backfill 并发
瓶颈在哪	OSD 消息队列 / CPU	磁盘 I/O 带宽
什么感觉	PG 假死（被误标 down/stale）	业务 I/O 卡顿、延迟飙升
怎么控	pgp_num 分步,减少同时 peering 的 PG 数	pgp_num 分步 + `osd_max_backfills` 限速

💡 Ceph 默认 osd_max_backfills = 1（一次只回填 1 个 PG）,就是怕 backfill 把磁盘打穿

⚠️ 生产环境：pg_num 和 pgp_num 最终必须等齐,否则新 PG 不参与数据放置

但不要一次同步拉满——先调 pg_num,再逐步放大 pgp_num,每步确认集群 active+clean 后再继续

Terminal window

1
root@Ceph-201 ~# ceph osd pool get .mgr pg_num
2
pg_num: 1
3
root@Ceph-201 ~# ceph osd pool get .mgr pgp_num
4
pgp_num: 1
5
'两者通常保持相等'
6
✅️ 使用 set 进行调整

临时PG#

主 OSD 挂了怎么办❓️

CRUSH 会重新算 acting set,但 ==新主OSD== 上还没数据——此时需要一个==过渡机制==,这就是临时 PG

概念	谁定的	什么时候变	一句话
`acting set`	CRUSH 计算	PG 数变化、OSD 增删	”应该在哪”
`up set`	Monitor 根据 OSD 存活状态实时调整	OSD 挂掉/恢复	”实际在哪”

📌 正常情况 acting set = up set
当主 OSD 挂了,acting set 里换了新人但新人还没数据,up set 就让有数据的老人先顶班
acting set 和 up set 暂时不一致,这就是临时 PG

Terminal window展开收起

1
正常状态：
2
  PG.7 的 acting set = [0, 1, 2]
3
  up set = [0, 1, 2]        ← 与 acting set 一致
4
  OSD.0 = 主 OSD
5

6
────────────────────────────────────────
7
Step 1：OSD.0 故障
8
────────────────────────────────────────
9
  CRUSH 重新计算 → acting set = [3, 1, 2]
10
  OSD.3 被推举为新主 OSD,但盘上空空,还不能接读请求
11

12
────────────────────────────────────────
13
Step 2：申请临时 PG
14
────────────────────────────────────────
15
  PG 向 Monitor 申请过渡方案
16
  OSD.1（原副本,有最新数据）升任"临时主 OSD"
17
  → up set = [1, 3, 2]      ← '临时干活阵容'
18
  → acting set = [3, 1, 2]  ← CRUSH 的目标阵容（不变）
19
  ⚠️ acting set ≠ up set（过渡期不一致）
20

21
────────────────────────────────────────
22
Step 3：backfill 回填数据
23
────────────────────────────────────────
24
  临时主 OSD.1 将 PG.7 数据全量推给 OSD.3
25

26
────────────────────────────────────────
27
Step 4：恢复正常
28
────────────────────────────────────────
29
  OSD.3 数据同步完毕 → 临时 PG 取消
30
  up set 恢复 = acting set = [3, 1, 2]
31
  OSD.3 正式就任新主 OSD

展开收起

PG 状态#

PG 状态是判断集群数据分布是否健康的关键指标

日常只需重点关注 active + clean,其余都是过渡状态。

状态	含义	归类
`active`	能正常处理读写	✅ 理想
`clean`	所有副本齐全且内容一致 —> 没有缺失和待修复的副本	✅ 理想

Tip

上面两个同时出现（active+clean）= 一切正常

状态	含义	归类
`peering`	OSD 之间对 PG Log,协商谁最新谁落后 → 决定恢复策略 —> 对的是操作日志,不是数据本身	==对账==
`recovering`	逐条回放 PG Log,差多少补多少 → “打补丁”	==增量恢复==
`backfill`	全量扫描该 PG 对象,从头拷贝到新 OSD → “重装系统”	==全量恢复==
`wait-backfill`	排队等 backfill（受 `osd_max_backfills` 限制） —> 默认一次只回填 1 个 PG	限流
`backfill-toofull`	目标 OSD 使用率超阈值,backfill 挂起	⚠️ 阻塞

peering → 决定走 recovering 还是 backfill → ✅️ 完成 → active+clean

状态	含义	归类
`remapped`	`acting set ❌️≠❌️ up set`,PG 正由临时阵容代管 → ==临时 PG==	🔄过渡
`creating`	PG 正在创建	一次性
`splitting`	PG 数量扩容,正在分裂	一次性
`replay`	OSD 崩溃后,PG 在等待客户端重放未确认操作	🔄过渡

状态	含义	归类
`scrubbing`	逐字节比对副本的==实际数据==,发现静默损坏（bit rot） —> peering 是对 PG Log,scrub 是对数据本身	后台巡检
`repair`	scrubbing 发现不一致 → 用正确副本覆盖损坏副本	后台修复

异常 / 降级状态：

状态	含义
`degraded`	部分副本挂掉或落后,但剩余副本 ≥ `min_size`,还能接 I/O
`undersized`	当前可用副本数少于 `size`,但 ≥ `min_size`
`down`	该 PG 必要的数据副本全部不可达,PG 下线
`incomplete`	PG 缺少关键信息（如日志断层）,无法判断数据是否安全
`inconsistent`	scrubbing 检测到副本间实际数据不一致 → 触发 `repair`
`stale`	PG 所在 OSD 长时间没向 Monitor 报心跳,Monitor 不知道它什么状态
`inactive`	PG 不能处理读写,等待持有最新数据的 OSD 回来
`unclean`	有对象副本数不达标（与 `clean` 相反）,通常正在恢复中
`peered`	peering 已完成（状态协商好了）,但副本还没补够,暂不接客

Important

遇到 PG 异常的常规思路：

重启相关 OSD 服务
调整属性参数
重置 PG

存储池管理#

Terminal window展开收起

1
1)创建副本存储池（默认类型）
2
root@Ceph-201 ~# ceph osd pool create xixi replicated
3
pool 'xixi' created
4
⚠️ '默认不指定池子类型 --> 就是副本池' --> replicated
5

6
2)创建纠删码存储池
7
root@Ceph-201 ~# ceph osd pool create haha erasure
8
pool 'haha' created
9

10
3)查看存储池列表
11
root@Ceph-201 ~# ceph osd pool ls
12
.mgr
13
xixi <-- ✅️ 副本池
14
haha <-- ✅️ 纠删池
15
👆 '这两个是我们刚创建的'
16
# 我们再加一个选项 detail
17
root@Ceph-201 ~# ceph osd pool ls detail
18
'查看存储池详细信息🔍'
19
pool 1 '.mgr' replicated size 3 min_size 2 crush_rule 0 📌 'crush规则0'
20
pool 2 'xixi' replicated size 3 min_size 2 crush_rule 0 📌 'crush规则0'
21
pool 3 'haha' erasure profile default size 4 min_size 3 crush_rule 1 📌 '规则1'
22
==========================================================
23
root@Ceph-201 ~# ceph osd crush rule ls
24
"有哪些规则" --> 📌 只列出名字
25
replicated_rule
26
erasure-code
27
'很明显一个是副本池默认的crush规则, 另一个是纠删码池的默认crush规则'
28
# 创建crush规则参考之前的笔记📚
29
🌰 副本规则 `create-replicated`
30
🌰 纠删码规则 `create-erasure`
31
  ✅️ ceph osd crush rule dump <规则名>
32
  "这条规则内部长什么样" --> 📌 完整 JSON
33
  # 查看故障域详细的规则规则
34
  ✅️ ceph osd pool set <存储池名称> <参数名> <参数值>
35
  # 关联存储池到新规则
36

37
4)查看创建池子的pg和pgp数
38
✅️ '查看单个池的指定属性'
39
'默认相同' --> 32 = 2的5次方
40
# Ceph 会根据集群 OSD 数量和池的用量,自动计算并动态调整 PG 数量
41
📌 我们创建池子的时候,并没有指定pg数 ❌️ --> 生产环境一定要指定
42
root@Ceph-201 ~# ceph osd pool get xixi pg_num
43
pg_num: 32
44
root@Ceph-201 ~# ceph osd pool get xixi pgp_num
45
pgp_num: 32
46
root@Ceph-201 ~# ceph osd pool get haha pg_num
47
pg_num: 32
48
root@Ceph-201 ~# ceph osd pool get haha pgp_num
49
pgp_num: 32

展开收起

命令	查看维度	一句话
`rados df`	池	”每个池用了多少、剩多少,按池算账”
`ceph osd df`	OSD 设备	”每块盘用了多少、剩多少,按盘摸底”

Terminal window展开收起

1
5)查看存储池利用率
2
root@Ceph-201 ~# rados df
3
POOL_NAME     USED  OBJECTS  CLONES  COPIES  ....
4
.mgr       1.3 MiB        2       0       6  ....
5
haha           0 B        0       0       0  ....
6
kpyun          0 B        0       0       0  ....
7
xixi           0 B        0       0       0  ....
8
'📌 重点在下面的统计'
9
total_objects    2
10
total_used       285 MiB
11
total_avail      5.3 TiB
12
total_space      5.3 TiB
13

14
root@Ceph-201 ~# ceph osd df
15
ID  CLASS WEIGHT REWEIGHT SIZE    AVAIL    %USE   PGS  STATUS
16
0   hdd  0.293   1.000   300 GiB  300 GiB  0.01   44    up
17
1   hdd  0.488   1.000   500 GiB  500 GiB  0.01   58    up
18
...........
19

20
6)重命名存储池
21
root@Ceph-201 ~# ceph osd pool rename haha hehe
22
pool 'haha' renamed to 'hehe'
23
root@Ceph-201 ~# ceph osd pool ls | grep hehe | wc -l
24
1

展开收起

Terminal window

1
7)创建时指定 PG 数量和关闭自动伸缩
2
root@Ceph-201 ~# ceph osd pool get .mgr pg_autoscale_mode
3
pg_autoscale_mode: on
4
'系统池这个选项是开着的 --> 系统可能在你手动改完 pg_num 后立刻又给调回去'
5
root@Ceph-201 ~# ceph osd pool create kpyun 128 128 --autoscale_mode off
6

7
✅️ 128 128 = pg_num 128, pgp_num 128

📌 自动伸缩（pg_autoscale_mode）是什么？
Ceph 会根据集群 OSD 数量和池的用量,自动计算并动态调整 PG 数量
如果开着 autoscale,系统可能在你手动改完 pg_num 后立刻又给调回去
为什么创建时关掉它？ 既然你手动指定了 128 个 PG,就说明你算好了PG数量了

--autoscale_mode off 告诉 Ceph “PG 数量我来定,你别插手”

同理,后续用 set 修改 pg_num 前也需要先关 autoscale

Terminal window

1
'我在创建这个池子的时候,默认不指定池的类型 --> 副本池'
2
root@Ceph-201 ~# ceph osd pool ls  detail | grep kpyun
3
pool 4 'kpyun' replicated size 3 min_size 2 crush_rule 0
4
root@Ceph-201 ~# ceph osd pool get kpyun pg_num
5
pg_num: 128
6
root@Ceph-201 ~# ceph osd pool get kpyun pgp_num
7
pgp_num: 128
8
'这次都是128 --> 而不是32'

📌 Ceph 的逻辑：⚠️ 创建一个池之后务必声明它的用途
否则 Monitor 不知道这个池是存 RBD 镜像还是当 CephFS 元数据池,持续报 HEALTH_WARN ❌️

类型	业务	一句话
`rbd`	==块存储==	“这池子给虚拟机/云盘用的”
`cephfs`	==文件系统==	“这池子给共享文件存储用的”
`rgw`	==对象存储==	“这池子给 S3 / Swift 对象网关用的”

Terminal window展开收起

1
root@Ceph-201 ~# ceph -s | grep -A2 health
2
    health: HEALTH_WARN ❌️
3
            Degraded data redundancy: 6 pgs undersized
4
            3 pool(s) do not have an application enabled
5
📌 集群里有 3 个池子还没声明"我是干啥用的"
6
1)声明用途
7
✅️ ceph osd pool application enable <池名> <类型>
8
root@Ceph-201 ~# ceph osd pool application enable kpyun rbd
9

10
2)查看已声明的用途
11
✅️ ceph osd pool application get <池名>
12
root@Ceph-201 ~# ceph osd pool application get kpyun
13
{
14
    "rbd": {}
15
}

展开收起

删除存储池的两道锁#

Ceph 为了保护数据不被人手滑删掉,设计了两道锁：

Terminal window

1
机制一：nodelete 标记（池级锁）
2
  给'某个存储池'打上 nodelete=true → 该池不可删除 ❌️
3
  '默认值'：false（可删除）✅️
4

5
机制二：mon_allow_pool_delete 全局开关（集群级锁）
6
  Monitor 级别的总闸,📌'控制整个集群是否允许删池'
7
  '默认值'：false（不允许删除）❌️
8

9
⚠️ 两道锁都有一票否决权 --> 任一不通过都不能删池

锁	允许删除的条件	默认值	默认能删吗
`nodelete`（池级）	`false`	`false`	✅ 能
`mon_allow_pool_delete`（集群级）	`true`	`false`	❌ 不能

📌 实际删池时,nodelete 默认就是 false（没上锁）,真正卡住你的是全局开关 mon_allow_pool_delete

所以实验里只需要翻这一道开关就够了

不是只开了一个就能删,而是另一个本来就没关

📌 生产环境建议：nodelete=true + mon_allow_pool_delete=false

双重保险,防止手滑

ceph config 方式删除（推荐）#

Terminal window展开收起

1
'删除池的完整流程 —— ceph config 版'
2

3
1)强制删除试试
4
# 由于这是一个高风险操作,Ceph要求您提供更强的确认
5
  1.需要输入两次存储池名称（xixi xixi）
6
  2.使用 --yes-i-really-really-mean-it 参数
7
  # 两次really强确认
8
root@Ceph-201 ~# ceph osd pool rm xixi xixi --yes-i-really-really-mean-it
9
Error EPERM: pool deletion is disabled; --> '删除失败' ❌️
10
"在删除存储池之前,您必须先将mon_allow_pool_delete配置选项设置为true"
11

12
2)检查 nodelete 标记
13
root@Ceph-201 ~# ceph osd pool get xixi nodelete
14
nodelete: false
15
'池级锁默认false --> 可以删除'
16

17
3)在 monitor 和 global 级别都开启允许删除
18
'global = 所有守护进程（mon/osd/mgr/mds/client）,mon = 仅 Monitor'
19
# 实际上：设了 global,就完全不需要再设 mon
20
✅️ 老运维只认 mon, 后来 global 出现了,有些人就"两条都写上,求个心安"
21
root@Ceph-201 ~# ceph config set mon mon_allow_pool_delete true
22
root@Ceph-201 ~# ceph config set global mon_allow_pool_delete true
23

24
4)确认开关已生效
25
root@Ceph-201 ~# ceph config get mon mon_allow_pool_delete
26
true
27
root@Ceph-201 ~# ceph config get global mon_allow_pool_delete
28
Error EINVAL: unrecognized entity 'global'
29
'这是为什么??'
30
# global 不能用 get 查（不是具体守护进程类型）,用 dump 来看
31
root@Ceph-201 ~# ceph config dump | grep mon_allow_pool_delete
32
ceph config dump  # 导出所有配置项
33
global          mon_allow_pool_delete  true
34
mon             mon_allow_pool_delete  true
35
'global 和 mon 都 true,确认生效'
36

37
5)执行删除
38
root@Ceph-201 ~# ceph osd pool rm xixi xixi --yes-i-really-really-mean-it
39
pool 'xixi' removed
40
root@Ceph-201 ~# ceph osd pool ls | grep xixi | wc -l
41
0
42

43
6)安全收尾——关掉开关
44
root@Ceph-201 ~# ceph config set mon mon_allow_pool_delete false
45
root@Ceph-201 ~# ceph config set global mon_allow_pool_delete false

展开收起

ceph config 配置管理#

Ceph 从 Squid 版本开始,引入了集中化配置数据库（Configuration Database）,ceph config 命令是统一入口

传统 ceph.conf vs 配置数据库#

Terminal window

1
传统方式：'分散管理,一致性难保证'
2
  1.N 个节点各存一份 `ceph.conf`
3
  2.改配置 = 挨个 SSH 改文件,漏一台就不一致
4
---------------------------------------------
5
现代方式（Config DB）：📌'Monitor 集中存储'
6
    1.Monitor 内存着一份"配置总账"（存在 RocksDB 里）
7
    2.你敲一条 `ceph config set` 写入总账,所有节点的守护进程自动拉取
8
  3.一份数据,全集群读

💡 RocksDB 又是什么？
它是 Facebook 开源的一款嵌入式键值(Key-Value)数据库
非常轻量 —> 不需要单独部署服务,直接嵌在 Monitor 进程里跑,负责把==配置数据==持久化到磁盘上
Monitor 用它存两类东西：

① 配置数据库（Config DB）

② 集群 Map（OSD Map / PG Map / CRUSH Map 等）

说白了就是 Ceph 自己的”小账本”

优先级（由高到低）：

① Config DB（ceph config set）→ ② ceph.conf 文件 → ③ 代码内置默认值

📌 最佳实践：日常运维优先用 ceph config 在线改,ceph.conf 仅作为静态补充或离线批量配置

常用命令#

命令	说明
`ceph config dump`	导出所有配置项常配合grep过滤
`ceph config get <target> <option>`	查配置——`<target>` 可以是类型级或实例级
`ceph config set <target> <option> <val>`	设配置——`<target>` 可以是类型级或实例级
`ceph config rm <target> <option>`	删除配置（同上）
`ceph config show <target> <option>`	查看某个进程实际生效的配置合并全部来源,给出最终生效值
`ceph config assimilate-conf -i ceph.conf`	把老 ceph.conf 导入配置数据库

粒度	例子
类型级 —> 影响==一类守护进程==	`mon` / `osd` / `mgr`
实例级 —> 精确到一个具体进程	`osd.0` / `mon.Ceph-201`

Tip

💡 get / set / rm 的 <target> 可以是类型级（mon）也可以是实例级（mon.Ceph-201）

show 通常跟实例级,看某个==具体进程==实际跑的是什么配置

Terminal window

1
💡 守护进程命名规则：`type.id`
2
osd.0 → type.id
3
         │   └── OSD 编号（Ceph 内部'守护进程编号',不是 Linux PID（重启会变））
4
         └── 守护进程类型（mon / osd / mgr / mds / client）
5
`osd.0` = `osd` 类型的 `0` 号实例
6
📌 Monitor 用主机名当 ID（`mon.Ceph-201`）,MDS 和 Manager 同理

Important

📌 global 是==虚拟赋值层==

可以往里写（set）,但往里读（get）就报 unrecognized entity❌️
验证 global 是否生效用 ceph config dump | grep

取值	层级	影响范围	`set`	`get`
`global`	==全局==	==所有守护进程==	✅	❌,用 `dump` 查
`mon`	类型	所有 Monitor	✅	✅
`osd`	类型	所有 OSD	✅	✅
`mgr`	类型	所有 Manager	✅	✅
`mds`	类型	所有 MDS	✅	✅
`client`	类型	所有客户端	✅	✅
`osd.0`	==实例==	仅 osd.0 这一个进程	✅	✅
`mon.Ceph-201`	==实例==	仅 Ceph-201 上的 Monitor	✅	✅

Terminal window展开收起

1
'实操示例'
2
1)查看 monitor 级别是否允许删池
3
root@Ceph-201 ~# ceph config get mon mon_allow_pool_delete
4
false
5

6
2)设置 monitor 级别配置
7
root@Ceph-201 ~# ceph config set mon mon_allow_pool_delete true
8

9
3)查看mon.Ceph-201的所有配置
10
'这里已经具体到某台主机了'
11
root@Ceph-201 ~# ceph config show mon.Ceph-201
12
NAME           ALUE
13
debug_mon     20/20
14
keyring       $mon_data/keyring
15
log_to_file    false
16
public_network 10.0.0.0/24
17
................
18
✅️ '后面也可以跟某个具体配置'
19
root@Ceph-201 ~# ceph config show mon.Ceph-201 public_network
20
10.0.0.0/24
21

22
4)global全局配置
23
root@Ceph-201 ~# ceph config get gobal public_network
24
Error EINVAL: unrecognized entity 'gobal' ❌️
25
'需要配置 👇'
26
root@Ceph-201 ~# ceph config dump | grep public_network
27
global    advanced  public_network     10.0.0.0/24

展开收起

Dashboard 速览#

Dashboard 是 Ceph 自带的 Web 图形化管理界面（端口 8443）,不想敲命令的时候用它

Tentacle（v20）换了新 UI —— 首页改叫 Overview,界面更现代

🔹 Tentacle 新版主要功能：

功能	一句话
多集群管理	一个页面管好几个 Ceph 集群,不用来回切统一看健康状态、容量、告警
NVMe 高速存储	网页上配 NVMe 盘、分命名空间
对象存储（RGW）	多活同步、冷热分层、过期删除、权限策略,全在页面上点
文件共享（SMB）	Linux 上的 CephFS 当作 Windows 共享文件夹用
性能监控	看磁盘读写速度、延迟、带宽趋势
统一登录（OAuth2）	对接公司已有的账号系统,不用单独记密码
配置管理	改副本数、改 PG 数、换 CRUSH 规则,不用敲命令
角色权限（RBAC）	管理员、只读、块存储管理员、对象存储管理员…各看各的

Tip

📌 Tentacle 附带的监控组件：Prometheus 3.6 + Grafana 12 + Alertmanager 0.28

💡 生产环境别忘了把 Dashboard 的自签名证书换成正规 CA 签发的证书

内置角色：

角色	能干啥	一句话
`administrator`	==全部权限==	“超级管理员,什么都能动”
`read-only`	只能看	”参观者,点不坏任何东西”
`block-manager`	RBD 块设备	”管虚拟机云盘的”
`rgw-manager`	对象网关	”管 S3 存储桶的”
`cephfs-manager`	文件系统	”管共享目录的”

ceph dashboard 命令	干什么
`ac-user-create <用户名> -i <密码文件> <角色>`	创建用户
`ac-user-show <用户名>`	查看用户信息
`ac-user-set-password <用户名> -i <密码文件>`	修改密码
`ac-user-set-roles <用户名> <角色>`	修改角色
`ac-user-delete <用户名>`	删除用户

Terminal window

1
📌 复杂的操作上 Web 界面点,命令行记住👆上面 5 条够用了
2
'实例'
3

4
1)创建管理员用户 jiu,密码从文件读入
5
root@Ceph-201 ~# echo 'Redhat123.com' > /root/passwd.txt
6
⚠️ 防止 Password is too weak❌️ --> ✅️ '密码设置复杂一点'
7
root@Ceph-201 ~# ceph dashboard ac-user-create jiu -i /root/passwd.txt administrator
8
✅️ 刚创建的同时,把用户信息也打印出来了
9
{"username": "jiu", "password": "$2b$12$xn ...xxx", "roles": ["administrator"]

image-20260526094948461

image-20260526095557741

Terminal window展开收起

1
2)查看 admin 用户信息
2
root@Ceph-201 ~# ceph dashboard ac-user-show admin
3
✅️ 是admin用户呀!
4
{"username": "admin", "password": "$2b$12$Vq..xxx"
5

6
3)修改 jiu 的密码
7
root@Ceph-201 ~# echo 'Oldboy123.com' > /root/passwd.txt
8
root@Ceph-201 ~# ceph dashboard ac-user-set-password jiu -i /root/passwd.txt
9
✅️ 选项 --> ac-user-set-password
10
✅️ 后面没有角色, 只有一个密码文件📃
11

12
4)把 jiu 降级为只读
13
root@Ceph-201 ~# ceph dashboard ac-user-set-roles jiu read-only
14
✅️ 选项 & 更换的角色
15
{"username": "jiu", ...xxx "roles": ["read-only"],

展开收起

image-20260526100311770

Terminal window

1
5)删除 jiu
2
root@Ceph-201 ~# ceph dashboard ac-user-delete jiu
3
User 'jiu' deleted

image-20260526100420948

Manager 的 Active / Standby 机制#

Dashboard 本质上是 Manager 进程提供的 HTTP 服务

Terminal window展开收起

1
URL: https://Ceph-201:8443/
2

3
root@Ceph-201 ~# curl -k https://Ceph-201:8443/
4
# -k 跳过证书
5
This resource can be found at <a href="https://10.0.0.202:8443/">
6
✅️ -L 可以实现自动跳转
7
🔹 为什么访问 Ceph-201 却跳到 Ceph-202❓️
8

9
1)显示集群中 active / standby
10
root@Ceph-201 ~# ceph -s | grep mgr
11
    mgr: Ceph-202.xdeumk(active, since 88m), standbys: Ceph-201.cxdvrq
12
'Ceph 集群通常有多台 Manager（冗余）,但同一时刻只有一个是 active'
13
✅️ 此时 active --> Ceph-202
14
✅️ 谁当 active mgr,Dashboard 就跑在谁上面
15

16
2)试试Ceph-202
17
root@Ceph-201 ~# curl -kI https://Ceph-202:8443/
18
HTTP/1.1 200 OK
19
'这个是可以通的'
20
https://Ceph-201:8443/
21
     │
22
     └→ standby mgr（Ceph-201）: "我不当家,去Ceph-202找active"
23
              │
24
              └→ 重定向 → https://10.0.0.202:8443/
25
✅️ 访问 standby mgr 的 Dashboard 端口,会被重定向到 active mgr

展开收起

🔹 选举规则

Manager 选举是先到先得——两边的 mgr 容器同时启动,谁先向 Monitor 注册成功谁就是 active,晚了半拍就成 standby

这不是故障,是正常的 HA 设计：active 挂了,standby 秒级接替

Terminal window展开收起

1
3)查看mgr的状态
2
root@Ceph-201 ~# ceph mgr stat
3
✅️ JSON 格式更详细
4
{
5
    "epoch": 72,
6
    "available": true,
7
    "active_name": "Ceph-202.xdeumk",
8
    "num_standby": 1
9
}
10

11
4)看 Dashboard 实际跑在哪个 IP
12
root@Ceph-201 ~# ceph mgr services
13
✅️ 这个命令是真的实用
14
{
15
    "dashboard": "https://10.0.0.202:8443/"
16
}
17

18
5)手动踢掉 active mgr,触发 standby 接替
19
✅️ 被踢的原 active 重启
20
# 用于主动切换（维护前可能会用）
21
root@Ceph-201 ~# ceph mgr fail
22
root@Ceph-201 ~# ceph mgr services
23
{
24
    "dashboard": "https://10.0.0.201:8443/"
25
}
26
root@Ceph-201 ~# curl -kI https://Ceph-201:8443/
27
HTTP/1.1 200 OK ✅️

展开收起

🔹 把 Dashboard 固定在某台机器上

如果不想让它跟着 active mgr 跑,可以显式指定 IP：

Terminal window

1
root@Ceph-201 ~# ceph config set mgr mgr/dashboard/server_addr 10.0.0.201
2
root@Ceph-201 ~# ceph config get mgr mgr/dashboard/server_addr
3
10.0.0.201
4
'终于用上 rm 选项了'
5
root@Ceph-201 ~# ceph config rm mgr mgr/dashboard/server_addr
6
root@Ceph-201 ~# ceph mgr fail
7
✅️ ceph mgr fail 一踢,mgr 重启 --> 重新加载配置,内存里的旧值清了
8
# mgr 不会热加载,得重启才生效

常用操作速查#

Terminal window展开收起

1
# ===================================
2
# 集群状态
3
# ===================================
4
ceph -s                                    # 集群整体健康状态
5
ceph -w                                    # 实时监控集群变化
6
ceph osd tree                              # OSD 树（含 class / 权重 / 状态）
7
ceph osd df                                # OSD 磁盘使用率
8
rados df                                   # 存储池使用率（按池算账）
9
ceph mgr stat                              # Manager active/standby 状态（JSON）
10
ceph mgr services                          # Dashboard 实际跑在哪个 IP
11

12
# ===================================
13
# 存储池管理
14
# ===================================
15
ceph osd pool ls                           # 列出所有存储池
16
ceph osd pool ls detail                    # 存储池详细信息（类型/副本数/规则）
17
ceph osd pool create <name> <pg> <pgp> replicated    # 创建副本池
18
ceph osd pool create <name> <pg> <pgp> erasure       # 创建纠删码池
19
ceph osd pool create <name> <pg> <pgp> --autoscale_mode off  # 创建时关闭自动伸缩
20
ceph osd pool rename <old> <new>           # 重命名存储池
21
ceph osd pool rm <name> <name> --yes-i-really-really-mean-it  # 删除存储池（双重确认）
22
ceph osd pool application enable <name> <rbd|cephfs|rgw>  # 声明池用途
23

24
# ===================================
25
# 池属性管理
26
# ===================================
27
ceph osd pool get <name> <param>           # 查单个属性（size / min_size / pg_num ...）
28
ceph osd pool set <name> <param> <val>     # 修改属性
29
ceph osd pool get <name> pg_autoscale_mode # 查看自动伸缩是否开启
30
ceph osd pool get <name> nodelete          # 查看池级删除锁状态
31

32
# ===================================
33
# CRUSH 规则
34
# ===================================
35
ceph osd crush rule ls                     # 列出所有 CRUSH 规则（只列名字）
36
ceph osd crush rule dump <rule>            # 查看规则完整 JSON（故障域/副本数/设备类型）
37

38
# ===================================
39
# PG 管理
40
# ===================================
41
ceph pg stat                               # PG 状态概览
42
ceph pg dump                               # 所有 PG 详细状态（常配合 grep）
43

44
# ===================================
45
# 配置管理 (ceph config)
46
# ===================================
47
ceph config dump                           # 导出所有配置项（常配合 grep 过滤）
48
ceph config dump | grep <keyword>          # 按关键字查配置
49
ceph config get <target> <option>          # 查配置（类型级/实例级）
50
ceph config set <target> <option> <val>    # 设配置（global/mon/osd/mgr 等）
51
ceph config rm <target> <option>           # 删除配置
52
ceph config show <target>                  # 查看进程实际生效的全部配置
53

54
# ===================================
55
# Dashboard 用户管理
56
# ===================================
57
ceph dashboard ac-user-create <user> -i <passwd_file> <role>   # 创建用户
58
ceph dashboard ac-user-show <user>                              # 查看用户信息
59
ceph dashboard ac-user-set-password <user> -i <passwd_file>     # 修改密码
60
ceph dashboard ac-user-set-roles <user> <role>                  # 修改角色
61
ceph dashboard ac-user-delete <user>                            # 删除用户

展开收起

OSD运维管理&&非并置部署

Thu, 02 Apr 2026 00:00:00 GMT

OSD运维管理 && 非并置部署#

[TOC]

OSD设备管理#

命令拆解#

Ceph 命令是”层级式”命名的,拆开看每个词就不需要死记：

Terminal window

1
ceph orch device zap  <host>  /dev/<disk>  --force
2
│    │    │      │     │        │            │
3
│    │    │      │     │        │            └── 跳过确认提示
4
│    │    │      │     │        └── 磁盘路径
5
│    │    │      │     └── 主机名
6
│    │    │      └── 清零 / 擦除 LVM 数据
7
│    │    └── 磁盘设备
8
│    └── Orchestrator 编排器（cephadm 的控制层）
9
└── Ceph CLI 总入口

词	含义	记忆方法
`ceph`	Ceph 集群 CLI 总入口	所有命令都从这个开始
`orch`	Orchestrator 编排器	==管服务的==：加/删/启/停守护进程
`osd`	Object Storage Daemon	存数据的进程,一块盘一个 OSD
`device`	磁盘设备	物理层面的：查看磁盘、清磁盘
`host`	集群中的主机节点	主机层面的：增删节点、驱逐服务
`daemon`	==守护进程（容器）==	进程层面的：启停单个进程
`apply`	应用 spec 规则	用 yaml 描述目标,部署为==托管形式==
`rm`	Remove 删除
`zap`	==清零 / 擦除==	干掉 Ceph 在磁盘上建的 LVM 分区
`drain`	==排干 / 驱逐==	把一台主机上的所有服务迁到其他节点
`replace`	替换	删旧盘 + 标记”这里要补一块新盘”
`purge`	==彻底清除==	从 CRUSH 表里把 OSD 记录踢出去
`out` / `in`	暂停/恢复使用	out 触发数据迁走；in 恢复使用进程始终在跑
`crush`	CRUSH 算法 / 拓扑表	集群的”地图”——哪个 OSD 在哪台机器上
`--force`	跳过普通确认	常规操作的安全确认
`--yes-i-really-mean-it`	”我真要这么干”	危险操作的二次确认（删池、purge等）
`--dry-run`	==预演不执行==	只算匹配结果给你看,不实际创建 OSD

命令层级——越靠左越宏观,越靠右越具体：

Terminal window

1
ceph       -->  集群层（管一切）
2
ceph osd   -->  OSD 层（管 CRUSH、管状态）
3
ceph orch  -->  编排层（管服务、管磁盘）

层面	命令入口	管的	视角
CRUSH 拓扑层	`ceph osd ...`	CRUSH 地图、OSD 状态、数据放置规则	CRUSH 全局视角——“数据该往哪放”
编排器层	`ceph orch ...`	容器/进程、磁盘设备、主机节点	cephadm 视角——“服务跑在哪”

托管 vs 非托管#

它决定了”删 OSD 后会不会自动补盘”

替换、整机缩容的行为都跟它有关

对比项	托管 OSD	非托管 OSD
创建方式	`ceph orch apply osd --all-available-devices` 或 `-i spec.yaml`	`ceph orch daemon add osd`
删盘后	✅ 自动重建新 OSD	❌ 需手动添加
`ceph orch ls` 区别在最右列	显示部署位置	显示 `<unmanaged>`
适用场景	生产环境标准化	临时测试、手动干预

	`ceph orch ls`	`ceph orch ps`
关注层面	服务级别（service）	进程/容器级别（daemon）
粒度	一个服务类型一行最右列 PLACEMENT 区分托管/非托管	每个守护进程实例一行
关键信息	是否托管、部署位置、`RUNNING` 比值	每个 daemon 的详细运行状态

📌 一句话：orch ls 看==服务整体==的编排情况
orch ps 看每个 daemon 进程的实际运行状态

手动 daemon add —> ==非托管==

怎么判断当前是哪种：

Terminal window

1
root@Ceph-201 ~# ceph orch ls | grep osd
2
NAME        'RUNNING' REFRESHED  AGE 'PLACEMENT'
3
mgr              2/2  5m ago     25h  count:2
4
mon              1/5  5m ago     25h  count:5
5
osd.default        3  5m ago     5m  'Ceph-201' <-- '限定节点'
6
osd.all-available-devices   1    55s   '*'
7
# 👆托管——最右列显示部署位置  '没有限定节点👆所有主机都匹配'
8
# 👇非托管——最右列显示 <unmanaged>：
9
osd                3  8m ago     -   '<unmanaged>'

RUNNING 列怎么读——实际在跑 / 预期目标：

Terminal window

1
3        -->  3/3  实际 = 预期 ✅️健康
2
1/3      -->  1个在跑,预期3个（其余没起来或挂了）
3
0/3      -->  全挂了

	RUNNING 的数字来源
托管	预期数由 spec 决定——匹配到多少块符合条件的盘
非托管	没有 spec,没有”预期”,就显示实际跑着的数量

PLACEMENT 列的==三种值==：

PLACEMENT	含义
`Ceph-201`	spec 里 `placement: hosts: [Ceph-201]` 限定只在这台节点部署
`*`	没有限定节点,所有主机都匹配——`--all-available-devices` 就是这种
`<unmanaged>`	非托管,没有 spec 规则在管它

托管 —> 非托管（只交管理权,不删数据）：

Terminal window

1
root@Ceph-201 ~# ceph orch rm osd.default --force
2
'spec 规则被删除,OSD 进程和数据不受影响'
3
# 只是变成 <unmanaged>,不再自动补盘
4
root@Ceph-201 ~# ceph orch ls
5
osd.default   3  9m ago     -   '<unmanaged>' ✅️ 非托管

📌 创建托管 OSD 的两种写法

	`--all-available-devices`	`-i spec.yaml`
选盘方式	自动——所有 `AVAILABLE: Yes` 的盘全上	手动——你挑：路径 / 属性 / 主机
范围	所有节点	按 placement 限定
服务名	`osd.default`	`osd.<service_id>`
适用场景	快速部署、测试环境	生产环境精确控制

⚠️ 两种方式的大前提：磁盘必须 AVAILABLE: Yes
已跑着非托管 OSD 的盘正被占用,AVAILABLE 为 No,spec 不会去碰它

Terminal window

1
# 方式一：全自动——接管所有空闲盘
2
ceph orch apply osd --all-available-devices
3

4
# 方式二：精细化——按 spec 文件指定
5
ceph orch apply -i spec.yaml

“非托管 OSD 变成托管”的实际流程——不是魔法,是删旧补新：

Terminal window

1
非托管 OSD 在跑  -->  磁盘被占用  -->  AVAILABLE: No  -->  spec 不理它
2
      ↓ 删除
3
ceph orch osd rm <id> --zap  -->  磁盘空闲  -->  AVAILABLE: Yes
4
      ↓  👆完成停进程 + 清 CRUSH + 清磁盘
5
spec 自动检测到空闲盘  -->  自动部署新 OSD  -->  变成托管了

Terminal window展开收起

1
root@Ceph-201 ~# ceph orch ls
2
osd.default   3  76s ago    -    <unmanaged>
3
'现在是非托管' --> 数量3个
4
root@Ceph-201 ~# ceph osd tree
5
 0    hdd  0.48830   osd.0     up   1.00000  1.00000
6
 1    hdd  0.29300   osd.1     up   1.00000  1.00000
7
 2    hdd  1.00000   osd.2     up   1.00000  1.00000
8
root@Ceph-201 ~# ceph orch osd rm osd.1 --zap
9
Unable to find OSDs: ['osd.1'] ❌️
10
✅️ 直接删除的是 1
11
root@Ceph-201 ~# ceph orch osd rm 1 --zap
12
Scheduled OSD(s) for removal.
13
root@Ceph-201 ~# ceph osd tree
14
 0    hdd  0.48830   osd.0     up   1.00000  1.00000
15
 2    hdd  1.00000   osd.2     up   1.00000  1.00000
16
'没有 1 了'
17
root@Ceph-201 ~# ceph orch device ls
18
Ceph-201  /dev/sdb  hdd 300G  Yes ✅️
19
'可以加入OSD设备'
20
root@Ceph-201 ~# ceph orch apply osd --all-available-devices
21
Scheduled 'osd.all-available-devices' update...
22
📌 留意这个名称
23
root@Ceph-201 ~# ceph orch device ls
24
Ceph-201  /dev/sdb  hdd 300G  No ✅️ 过一会才会显示
25
root@Ceph-201 ~# ceph osd tree
26
'都加入进来了'
27
root@Ceph-201 ~# ceph orch ls
28
osd.all-available-devices   1  55s ago    71s  *
29
osd.default                 2  55s ago    -    <unmanaged>
30
'数量由原来 3 --> 2+1 '

展开收起

📌 apply spec 不会把已有的非托管 OSD “转换”成托管,它只管在空闲盘上部署新 OSD

想让某个非托管 OSD 变成托管

流程是：删了它 —> zap —> spec 自动补一个新的

⚠️ 删除 spec ≠ 删除 OSD 删的是”自动管理规则”,盘照样跑

设备类型管理#

Terminal window展开收起

1
1)查看当前 OSD 树（关注 CLASS 列）
2
root@Ceph-201 ~# ceph osd tree
3
ID  CLASS  WEIGHT   TYPE NAME          STATUS  REWEIGHT  PRI-AFF
4
-1         0.78130  root default
5
-3         0.78130      host Ceph-201
6
 0    hdd  0.48830          osd.0          up   1.00000  1.00000
7
 1    hdd  0.29300          osd.1          up   1.00000  1.00000
8
# hdd --> 机械硬盘   ssd --> 固态硬盘
9

10
2)移除原有 class
11
root@Ceph-201 ~# ceph osd crush rm-device-class osd.1
12
done removing class of osd(s): 1
13
'这个是osd.1'
14
ceph orch osd rm 1 --zap
15
# 直接写ID即可
16

17
3)设置新 class
18
root@Ceph-201 ~# ceph osd crush set-device-class ssd osd.1
19
set osd(s) 1 to class 'ssd'
20
root@Ceph-201 ~# ceph osd tree | grep osd.1
21
 1    ssd  0.29300   osd.1   up   1.00000  1.00000
22
# 由hdd --> ssd

展开收起

💡 rm-device-class + set-device-class 仅用于实验环境

生产环境中设备类型由硬件自动识别

out 与 in（暂停/恢复 OSD）#

out 和 in 是一对可逆操作,跟 rm（真删除）是两回事：

Terminal window

1
ceph osd out   -->  告诉 CRUSH："现存的数据搬走,别往这块盘放数据了"
2
ceph osd in    -->  "行了,可以继续用了"
3
ceph osd rm    -->  真删了,OSD 没了

⚠️ 注意区分两个层面的”可逆”：

层面	`out` —> `in` 之后
OSD 本身	✅ 可恢复——==盘还在==、==进程没停==、`in` 后继续用
盘上的数据	❌ 不可逆——`out` 时数据已经被搬到其他 OSD 了,`in` 后是空盘

所以==“可逆”==说的是 OSD 这个盘没被销毁,还能继续服役

Terminal window展开收起

1
1)暂停使用 osd.1
2
root@Ceph-201 ~# ceph osd tree
3
ID  CLASS  WEIGHT    NAME 'STATUS' 'REWEIGHT'  PRI-AFF
4
 0    hdd  0.48830   osd.0     up   1.00000  1.00000
5
 1    hdd  0.29300   osd.1     up   1.00000  1.00000
6
 2    hdd  1.00000   osd.2     up   1.00000  1.00000
7
'📌 重点注意状态 & 权重'     👆    👆
8
root@Ceph-201 ~# ceph osd out osd.1
9
marked out osd.1.
10
root@Ceph-201 ~# ceph osd tree
11
ID  CLASS  WEIGHT    NAME 'STATUS' 'REWEIGHT'  PRI-AFF
12
 0    hdd  0.48830   osd.0     up   1.00000  1.00000
13
 1    hdd  0.29300   osd.1     up       '0'  1.00000
14
 2    hdd  1.00000   osd.2     up   1.00000  1.00000
15
✅️ OSD 状态：osd.1  up  <-- 进程还在跑
16
osd: 3 osds: 3 up (since 2h), 2 in (since 23s)
17
📌 3 up = 3个进程都在跑  2 in = 但只有2个在干活（osd.1 out了不参与）
18
  进程在跑（up）≠ 参与干活（in）
19
✅️ CRUSH 权重 --> 0,不再接收新数据
20
✅️ PG 恢复：osd.1 不干活了 --> 从剩余副本盘拷贝数据到新盘,恢复副本数
21
📌 原来3副本 --> out一个 --> 只剩2副本 --> 触发恢复补回到3副本
22
root@Ceph-201 ~# ceph -s | grep 'pgs:'
23
    pgs:     1 'active+clean'
24
⚠️ 等 PG 恢复完成 --> ceph -s 确认 'active+clean'
25
✅️ 恢复完成,osd.1 上只剩废数据（不再被使用）
26
⚠️ 旧数据物理还在盘上,但已是孤儿,不会被访问——会被后续回收/覆盖
27

28
2)恢复使用
29
═══════════════════════════════════════
30
 out / in 全流程副本变化示意
31
═══════════════════════════════════════
32
 out前：[osd.0 ✅] [osd.1 ✅] [osd.2 ✅]  = 3/3 健康
33
 out后：[osd.0 ✅] [osd.1 🈳] [osd.2 ✅]  = osd.1 不干活了,PG 少一个副本
34
    ↓    从 osd.0/osd.2(剩余副本) 拷贝数据到新盘
35
  恢复后：[osd.0 ✅]             [osd.2 ✅]  = 2/2 osd.1 空盘,旧数据变孤儿
36

37
  in后： [osd.0 ✅] [osd.1 🈳] [osd.2 ✅]  = osd.1 回组但空的! PG 又缺副本
38
    ↓    从 osd.0/osd.2(剩余副本) 拷贝数据到 osd.1
39
  恢复后：[osd.0 ✅] [osd.1 ✅] [osd.2 ✅]  = 3/3 osd.1 又是正常副本了
40
═══════════════════════════════════════
41
root@Ceph-201 ~# ceph osd in osd.1
42
marked in osd.1.
43
# 权重恢复 --> CRUSH 重新把 PG 分配到这块盘
44
📌 osd.1 回组但盘是空的,实际只剩2个有效副本,所以"缺一个"
45
root@Ceph-201 ~# ceph -s | grep 'pgs:'
46
    pgs:     100.000% pgs not active
47
⚠️ PG 缺副本：osd.1 回组但空盘 --> '由空盘补成一个真正的副本'
48
root@Ceph-201 ~# ceph -s | grep 'pgs:'
49
    pgs:     1 active+clean
50
✅️ 数据从其他盘拷贝完成,osd.1 又是正常副本了

展开收起

📌 生产环境删 OSD 前先 out,等数据迁完再 rm,保证不丢数据

添加 OSD#

Terminal window

1
🌰 语法
2
ceph orch daemon add osd <host>:<device_path>
3
            📌中间👆有 '冒号:'
4
⚠️ 通过 `daemon add` 添加的 OSD 默认处于 '非托管 (unmanaged)' 状态
5
# 示例
6
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdb

删除 OSD#

推荐 ceph orch osd rm —> 一条命令完成停进程 + 清 CRUSH +（可选）清磁盘

📌 删除后是否自动重建 OSD —> 看托管状态,不是看命令选项

ceph orch osd rm status —> 查看删除进度

Terminal window

1
⚠️ 防止单节点删除卡住：`.mgr` 池默认副本数 ≥ 2,单节点删 OSD 优先降副本
2

3
root@Ceph-201 ~# ceph osd pool ls detail
4
pool 1 '.mgr' replicated size 2 min_size 1 crush_rule 0
5
✅️ size=2 想要2副本  min_size=1 最少1副本就能IO
6
root@Ceph-201 ~# ceph osd pool set .mgr size 1 --yes-i-really-mean-it
7
Error EPERM: configuring pool size as 1 is disabled by default
8
❌️ 新版 Ceph 默认禁止设 size=1 --> 先开权限
9
root@Ceph-201 ~# ceph config set mon mon_allow_pool_size_one true
10
root@Ceph-201 ~# ceph osd pool set .mgr size 1 --yes-i-really-mean-it
11
set pool 1 size to 1
12
root@Ceph-201 ~# ceph osd pool ls detail
13
pool 1 '.mgr' replicated size 1 min_size 1 crush_rule 0
14
✅️ 副本数设置为 1

Terminal window展开收起

1
root@Ceph-201 ~# ceph orch daemon rm osd.0 --force
2
# 从集群中删除 OSD 守护进程
3
root@Ceph-201 ~# ceph osd purge osd.0 --yes-i-really-mean-it
4
# 从 CRUSH 表彻底删除 → 集群名单踢出
5
'后面的那个选项 --> 危险操作的二次确认'
6
root@Ceph-201 ~# ceph orch device zap Ceph-201 /dev/sdb --force
7
# 擦除磁盘上的 Ceph 数据（恢复为空盘）     主机名  👆 路径
8
'中间可没有 --> 冒号:'
9
=============以上三步的详细操作 --> 参考上一篇笔记📚
10
🌰 语法
11
ceph orch osd rm <OSD_ID> [--replace] [--force] --zap
12
        ⚠️ 直接删除的是 1 而不是 osd.1
13

14
1)保留磁盘数据 --> 不加 --zap选项
15
root@Ceph-201 ~# ceph osd rm 1
16
Error EBUSY: osd.1 is still up; must be down before removal.
17
❌️ ceph osd rm 删不了还在 up 的 OSD --> 必须先停进程
18
root@Ceph-201 ~# ceph osd rm 1 --force
19
Error EINVAL: osd.1 is still up; must be down before removal.
20
❌️ --force 也不行,up 状态就是不让删
21
'少加 orch（编排器）'
22
root@Ceph-201 ~# ceph orch osd rm 1
23
✅️ orch（编排器）自动停进程 + 清 CRUSH,不用管 up/down
24
Scheduled OSD(s) for removal.
25
VG/LV for the OSDs won't be zapped
26
⚠️ 只是没加 --zap,VG/LV 没被摧毁,磁盘 LVM 还在,AVAILABLE 仍为 No
27

28
2)同时清除磁盘数据
29
root@Ceph-201 ~# ceph orch osd rm 1 --zap
30
Scheduled OSD(s) for removal.
31
✅️ 删除 + 清除磁盘数据（磁盘恢复为 AVAILABLE: Yes）
32
root@Ceph-201 ~# ceph orch osd rm status
33
'查看删除进度'
34
OSD  HOST      STATE     PGS  REPLACE  FORCE  ZAP   DRAIN STARTED AT
35
1    Ceph-201  draining    0  False    False  True  2026-05-21 12:29:05

展开收起

⚠️ 不要用 ceph orch daemon rm——只删容器进程,不清理 CRUSH,也不清理磁盘,会产生 stray daemon,还得手动 purge + zap

🧱 为什么 daemon rm 会产生 stray daemon？——两个层面不一致：

Terminal window

1
ceph orch daemon rm osd.0        → 只清了编排器层 ✅   CRUSH 拓扑层纹丝不动 ❌
2
       ↓
3
cephadm："osd.0 不归我管了"        CRUSH："osd.0 应该在线啊,去哪了？"
4
       ↓
5
                         两层不一致 → stray daemon 告警！

✅ 正确做法：用 ceph orch osd rm 一条命令同时清两层（停进程 + 清 CRUSH + 可选 zap）

生产 vs 实验：

	生产环境	实验环境
步骤	`ceph osd out` —> 等 PG 恢复 —> `orch osd rm --zap`	直接 `orch osd rm --zap`
原因	`out` 先把数据迁走,保证安全	无数据,out 反而空跑恢复

替换 OSD#

Terminal window

1
# 语法
2
ceph orch osd rm <OSD_ID> --replace --zap

--replace 的核心作用就一句话：同一个 ID,同一个主机,原位补回

📌 决定”会不会重建”的是托管状态,--replace 决定的是重建时保不保留原 ID 和原位置

	不加 `--replace`	加 `--replace`
托管 OSD	自动重建 ✅️	自动重建 ✅️
非托管 OSD	❌️不自动重建,需手动 `daemon add`	❌️不自动重建,需手动 `daemon add`
ID	递增出新号	保留原 ID
主机	无约束,哪台都行	同一台主机

实例对比（托管场景）：

Terminal window

1
# 不加 --replace：osd.2 永远消失 → spec 在空闲盘上建全新 osd.4
2
ceph orch osd rm 2 --zap
3
--> osd tree: osd.0, osd.1, osd.3, osd.4  <-- '换了张新面孔,换了台主机'
4

5
# 加 --replace：osd.2 被标记"等着补回来" → 新盘顶上还是 osd.2
6
ceph orch osd rm 2 --replace --zap
7
--> osd tree: osd.0, osd.1, osd.2, osd.3  <-- '同一个 ID,同一台主机'

为什么必须是同一台主机？

CRUSH 里 OSD ID 和主机是绑定的：

Terminal window

1
host Ceph-201
2
  osd.2    # ← 位置写死了,osd.2 永远是 Ceph-201 的

保留 osd.2 这个 ID → 新盘只能在 Ceph-201 上补

ID 不变 = 主机不变,两个是捆绑的

📌 生产换盘一定加 --replace：同一个 ID、同一台主机,监控不告警,CRUSH 不乱

整机缩容（下架节点）#

移除一整台主机及其上所有 OSD：

Terminal window展开收起

1
root@Ceph-201 ~# ceph orch host ls
2
HOST      ADDR        LABELS  STATUS
3
Ceph-201  10.0.0.201  _admin
4
Ceph-202  10.0.0.202
5
Ceph-203  10.0.0.203
6
3 hosts in cluster
7
root@Ceph-201 ~# ceph orch ps Ceph-203
8
'PS查看各个进程的' --> 单独看 Ceph-203 主机的
9
⚠️ 不是ls ⚠️
10
NAME          HOST      PORTS  STATUS
11
mon.Ceph-203  Ceph-203         running (51m)
12
osd.6         Ceph-203         running (51m)
13
osd.7         Ceph-203         running (51m)
14
osd.8         Ceph-203         running (51m)
15
=============================================
16

17
1)驱逐节点上所有服务（移除本机 daemon,OSD 数据靠剩余副本恢复）
18
root@Ceph-201 ~# ceph orch host drain Ceph-203
19
Scheduled to remove the following daemons from host 'Ceph-203'
20
type                 id
21
-------------------- ---------------
22
osd                  8
23
osd                  6
24
osd                  7
25
mon                  Ceph-203
26
'多次执行直到输出为空,确认所有 daemon 移除任务已下发完毕'
27
📌 drain 输出为空 = 任务调度完成 ≠ 数据已搬完——这只是第一步
28
root@Ceph-201 ~# ceph orch host drain Ceph-203
29
Scheduled to remove the following daemons from host 'Ceph-203'
30
type                 id
31
-------------------- ---------------
32
'现在什么都没有了'
33
root@Ceph-201 ~# ceph orch host ls
34
HOST      ADDR        LABELS                         STATUS
35
Ceph-201  10.0.0.201  _admin
36
Ceph-202  10.0.0.202
37
Ceph-203  10.0.0.203  _no_schedule,_no_conf_keyring
38
👆 '变为不可调度'
39

40
2)等待数据恢复完成
41
📌 这才是真正等数据搬完：PG 从剩余副本拷贝数据到新位置需要时间
42
root@Ceph-201 ~# ceph -s | grep health
43
    health: HEALTH_OK
44
✅️ 确认 HEALTH_OK 再继续
45

46
3)清理磁盘上的 LVM 残留
47
'drain 不自动 zap,只清磁盘用 device zap 即可'
48
📌 编排器命令,在集群任意节点执行,<hostname> 指定目标即可,不用 SSH 到被驱逐节点
49
root@Ceph-201 ~# ceph orch device zap <hostname> /dev/<disk> --force
50
root@Ceph-201 ~# ceph orch device zap Ceph-203 /dev/sdb --force
51
root@Ceph-201 ~# ceph orch device zap Ceph-203 /dev/sdc --force
52
root@Ceph-201 ~# ceph orch device zap Ceph-203 /dev/sdd --force
53

54
4)从 CRUSH 删除主机条目
55
root@Ceph-201 ~# ceph osd tree
56
-7     0      host Ceph-203
57
'现在还有它'
58
📌 CRUSH 拓扑层：删掉 CRUSH 地图里该主机的空 bucket（此时 OSD 已无,bucket 已空）
59
root@Ceph-201 ~# ceph osd crush remove <hostname>
60
root@Ceph-201 ~# ceph osd crush remove Ceph-203
61
removed item id -7 name 'Ceph-203' from crush map
62

63
5)从集群删除主机
64
root@Ceph-201 ~# ceph orch host ls | grep Ceph-203
65
Ceph-203  10.0.0.203  _no_schedule,_no_conf_keyring
66
📌 编排器层：把主机从 cephadm 管理名单中踢出去,集群不再知道这台机器
67
root@Ceph-201 ~# ceph orch host rm Ceph-203
68
Removed  host 'Ceph-203'
69
root@Ceph-201 ~# ceph orch host ls | grep Ceph-203 | wc -l
70
0
71
root@Ceph-201 ~# ceph orch host ls
72
HOST      ADDR        LABELS  STATUS
73
Ceph-201  10.0.0.201  _admin
74
Ceph-202  10.0.0.202
75
2 hosts in cluster
76
'现在在Ceph-201已经查看不到Ceph-203了'

展开收起

📌 drain 后 OSD 已被移除,磁盘上仍有 LVM 残留,需手动 zap
⚠️ 不要在 drain 前手动 stop OSD——stop 后 OSD 处于暂停状态,drain 无法处理

误操作后的情况	如何补救
只是 `stop` 了 OSD	`ceph orch daemon start osd.<id>` 恢复 → 正常 `drain`
已经 `daemon rm` 了	`ceph osd purge osd.<id>` + `ceph orch device zap` 收场

清扫收尾（集群侧已清理完毕,以下是节点本地操作）：

Terminal window

1
# 被驱逐节点：解除残留的 device mapper 映射（可能会）
2
'zap 后 LVM 已清,但内核的 dm 映射 可能 还在 ——> lsblk 看到的"幽灵"设备'
3
root@Ceph-203 ~# lsblk
4
# 无残留 dm 设备则跳过,有则继续
5
root@Ceph-203 ~# dmsetup remove <dm-name>
6
# 手动移除 dm 映射

Terminal window

1
OSD 创建时：  /dev/sdb  ──LVM──▶  dm-0 (OSD block)
2
                                ↓ 写入内核 /proc/device-mapper
3
zap 之后：   磁盘上 LVM 已清除 ✅   内核 dm 映射'可能'残留 ⚠️
4
                                ↓
5
            lsblk 若还能看到 dm-0 → dmsetup remove dm-0 清掉

Terminal window

1
# 被驱逐节点：删除 cephadm 数据目录（删的是配置文件,不是块设备数据）
2
'是被删除节点的数据' ⚠️ Ceph-203上执行
3
root@Ceph-203 ~# ls /var/lib/ceph/
4
fdc2219c-5344-11f1-8042-000c2990a57e
5
root@Ceph-203 ~# rm -rf  /var/lib/ceph/

💡 rm -rf /var/lib/ceph/ 清的是 cephadm 的==文件系统层配置==（FSID 目录）,==不能替代== device zap
前者删文件,后者擦块设备上的 LVM 元数据

非并置 OSD 部署 (WAL && DB && DATA 分离)#

BlueStore 存储架构#

🧱 BlueStore 是 Ceph 默认的存储后端,直接管理裸设备,消除了传统 FileStore 的双写惩罚

Terminal window

1
🧱 非并置：'一个 OSD 进程'横跨'三块不同类型'的物理盘
2
                 ┌─ osd.3 ─────────────────────────────────────────┐
3
                 │                                                 │
4
┌─────────┐      │  WAL (预写日志)  ──▶ Block.wal ──▶ nvme0n3  SSD  │'低延迟'
5
│ 客户端IO │──▶   │  DB  (元数据)    ──▶ Block.db  ──▶ nvme0n2 SSD  │'加速'
6
└─────────┘      │  DATA (对象数据) ──▶ Block.data ─▶ sdb      HDD  │'容量层'
7
                 │                                                 │
8
                 └─────────────────────────────────────────────────┘
9
                 📌 配对规则：一个 OSD 进程最多三块盘（data + db + wal）

组件	说明	放置	性能要求
`data`	OSD 所有对象数据	HDD	大容量、低成本
`db`	BlueStore 内部元数据 (RocksDB)	SSD/NVMe	高 IOPS、低延迟
`wal`	预写日志,保证数据一致性	SSD/NVMe	最低延迟

💡 将 WAL 和 DB 放在高速 SSD 上,data 放在廉价 HDD 上,是性能和成本的最佳平衡

Terminal window展开收起

1
'手动添加磁盘'
2
root@Ceph-201 ~# lsblk
3
NAME        SIZE RO TYPE
4
sdb            300G  0 disk
5
└─ceph-xxx
6
sdc            500G  0 disk
7
└─ceph-xxx
8
sdd              1T  0 disk
9
└─ceph-xxx
10
'上面三个已经在集群种了'
11
sde             20G  0 disk
12
sdf             20G  0 disk
13
nvme0n1         20G  0 disk
14
nvme0n2         20G  0 disk
15
root@Ceph-201 ~# ceph orch device ls --refresh
16
--refresh      # 绕开缓存直接触发一次新扫描
17
HOST      PATH         TYPE  SIZE  AVAILABLE
18
Ceph-201  /dev/nvme0n1  ssd  20.0G  No
19
Ceph-201  /dev/nvme0n2  ssd  20.0G  No
20
Ceph-201  /dev/sdb    hdd   300G  No
21
Ceph-201  /dev/sdc      hdd   500G  No
22
Ceph-201  /dev/sdd      hdd  1024G  No
23
Ceph-201  /dev/sde    hdd  20.0G  No
24
Ceph-201  /dev/sdf      hdd  20.0G  No
25
'触发强扫后,自动添加上去了'
26
root@Ceph-201 ~# ceph orch ls
27
NAME                  RUNNING  REFRESHED  AGE  PLACEMENT
28
osd.all-available-devices   6  7m ago     10h  *
29
osd.default                 1  7m ago     10m  Ceph-201
30
'这些都是托管的所以他就会自动添加OSD了'
31

32
1)删 spec 规则 → 变非托管
33
root@Ceph-201 ~# ceph orch rm osd.all-available-devices --force
34
root@Ceph-201 ~# ceph orch rm osd.default --force
35
root@Ceph-201 ~# ceph orch ls
36
NAME                  RUNNING  REFRESHED  AGE  PLACEMENT
37
osd.all-available-devices   6  4m ago     -    '<unmanaged>'
38
osd.default                 1  4m ago     -    '<unmanaged>'
39

40
2)删 OSD + zap → 磁盘变 AVAILABLE: Yes
41
root@Ceph-201 ~# ceph orch osd rm 3 --zap
42
root@Ceph-201 ~# ceph orch osd rm 4 --zap
43
root@Ceph-201 ~# ceph orch osd rm 5 --zap
44
root@Ceph-201 ~# ceph orch osd rm 6 --zap
45
'需要点时间⌚️'
46
root@Ceph-201 ~# ceph orch osd rm status
47
# 查看删除进度
48
root@Ceph-201 ~# ceph osd tree
49
'还剩三个'
50
root@Ceph-201 ~# ceph -s | egrep 'health:|osd:|pgs:'
51
    health: HEALTH_OK
52
    osd: 3 osds: 3 up (since 3m), 3 in (since 25m)
53
    pgs:     1 active+clean
54
root@Ceph-201 ~# ceph orch device ls | grep Yes | wc -l
55
4
56
'这四个已经变为Yes状态'
57

58
3)写 spec 文件（data on HDD, db/wal on NVMe）
59
root@Ceph-201 ~# vim osd_spec.yaml

展开收起

Spec 文件结构拆解#

1
service_type: osd          # 固定值,声明这是 OSD 服务
2
service_id: <随便起>        # 名字后缀,最终服务名 osd.<service_id>
3
placement:                 # 限定在哪些主机上生效
4
  hosts:
5
    - Ceph-201             # 只在这台节点选盘
6
spec:
7
  data_devices:            # 对象数据盘 —— 存你的业务数据
8
    all: true   # 使用所有可用设备
9
  db_devices:              # RocksDB 元数据盘 —— 存 OSD 内部索引
10
  wal_devices:             # 预写日志盘 —— 写入缓冲
11
  # ↑如果没有配置 --> 则复用 db

key	含义	类比
`service_type`	固定 `osd`,声明管的是 OSD 服务	”我是 OSD 部署规则”
`service_id`	随便起名,服务名后缀	给这条规则起外号
`placement`	限定在哪些主机上生效（通配符`*`匹配所有主机）	圈定战场——只在这些机器选盘
`data_devices`	对象数据盘,存业务数据 `all: true`表示使用所有可用设备	仓库——存货物
`db_devices`	RocksDB 元数据盘,存 OSD 内部索引	仓库地图——货在哪
`wal_devices`	预写日志盘,写入缓冲 `不配` → WAL 自动塞到 db 盘 `连 db 也没配` → 全落到 data 盘	记账本——先记后入库没单独给记账本就记在地图背面

Terminal window

1
📌 配对规则：一个 OSD 进程最多三块盘（data + db + wal）
2
  paths 列表 → cephadm 一一配对,不是把所有盘合给一个 OSD
3

4
  写两条 data + 两条 db：         写一条 data + 一条 db：
5
  sde ──┐  nvme0n1 ──┐            sde ── nvme0n1 --> 一个 OSD
6
  sdf ──┤  nvme0n2 ──┤
7
        ↓            ↓
8
   osd.3: sde + nvme0n1           = '拆成两个独立 OSD,各配一对盘'
9
   osd.4: sdf + nvme0n2

Spec 设备筛选 —> ==常用属性==

属性	说明	示例值
`rotational`	0=SSD/NVMe, 1=HDD	`0`
`size`	设备容量范围	`'10G:'` (≥10G)
`paths`	指定具体设备路径	`/dev/sda`

方式一：指定具体路径 (path)#

1
service_type: osd
2
service_id: osd_using_paths
3
placement:
4
  hosts:
5
    - Ceph-201
6
spec:
7
  data_devices:
8
    paths:
9
      - /dev/sde
10
      # 数据盘：SATA HDD
11
  db_devices:
12
    paths:
13
      - /dev/nvme0n1
14
      # 元数据盘：NVMe SSD
15
  wal_devices:
16
    paths:
17
      - /dev/nvme0n2
18
      # WAL盘：NVMe SSD

展开收起

Terminal window展开收起

1
4)预演不执行
2
root@Ceph-201 ~# ceph orch apply -i osd_spec.yaml --dry-run
3
--dry-run    # 干运行(预览)
4
'把 spec 匹配结果算出来给你看,但不会真的创建 OSD'
5
# 确认结果对了再拿掉 --dry-run 正式 apply
6
....xxx
7
Preview data is being generated.. Please re-run this command in a bit.
8
'关键是最后一句' --> 等几秒重新跑一次
9
root@Ceph-201 ~# ceph orch apply -i osd_spec.yaml --dry-run
10
################
11
OSDSPEC PREVIEWS
12
################
13
+---------+-----------------+----------+----------+--------------+--------------+
14
|SERVICE  |NAME             |HOST      |DATA      |DB            |WAL           |
15
+---------+-----------------+----------+----------+--------------+--------------+
16
|osd      |osd_using_paths  |Ceph-201  |/dev/sde  |/dev/nvme0n1  |/dev/nvme0n2  |
17
+---------+-----------------+----------+----------+--------------+--------------+
18

19
5)应用 spec
20
# 确认无误后正式 apply
21
root@Ceph-201 ~# ceph orch ls
22
NAME                  RUNNING  REFRESHED  AGE  PLACEMENT
23
osd.all-available-devices   3  9m ago     -    '<unmanaged>'
24
'剩三个osd进程在跑' --> 非托管
25
root@Ceph-201 ~# ceph -s | egrep 'health:|osd:|pgs:'
26
    health: HEALTH_OK
27
    osd: 3 osds: 3 up (since 73m), 3 in (since 95m)
28
    pgs:     1 active+clean
29
root@Ceph-201 ~# ceph orch apply -i osd_spec.yaml
30
Scheduled osd.osd_using_paths update...
31
root@Ceph-201 ~# ceph orch ls
32
NAME                  RUNNING  REFRESHED  AGE  PLACEMENT
33
osd.all-available-devices   3  3s ago     -    '<unmanaged>'
34
osd.osd_using_paths      1  3s ago    23s  'Ceph-201'
35
'三块盘合成一个进程'
36
root@Ceph-201 ~# ceph -s | egrep 'health:|osd:|pgs:'
37
    health: HEALTH_OK
38
    osd: 4 osds: 4 up (since 111s), 4 in (since 98m)
39
    pgs:     1 active+clean
40
root@Ceph-201 ~# ceph osd tree
41
'多了一个osd的进程' --> osd.3
42
⚠️ 标签class列为 hdd --> ✅️ 以 data 设备为准

展开收起

📌 非并置 OSD 的 CLASS 由 data 设备 的类型决定

💡 如果无法直接在宿主机使用 ceph 命令,可挂载 spec 文件到容器中：

Terminal window

1
cephadm shell --mount osd_spec.yaml:/var/lib/ceph/osd/osd_spec.yaml

删除被 spec 托管的 OSD 后自动恢复#

Terminal window展开收起

1
# 删除 osd.3
2
root@Ceph-201 ~# ceph orch osd rm 3 --zap
3
Scheduled OSD(s) for removal.
4

5
1)初次查看 OSD 树
6
root@Ceph-201 ~# ceph osd tree
7
 0    hdd  0.29300    osd.0    up
8
 1    hdd  0.48830    osd.1    up
9
 2    hdd  1.00000    osd.2    up
10
'没反应过来'
11

12
2)再次查看
13
root@Ceph-201 ~# ceph osd tree
14
 0    hdd  0.29300    osd.0    up
15
 1    hdd  0.48830    osd.1    up
16
 2    hdd  1.00000    osd.2    up
17
 3    hdd  0.03909    osd.3    up
18
'又回来了'
19
root@Ceph-201 ~# ceph -s | egrep 'health:|osd:|pgs:'
20
    health: HEALTH_OK
21
    osd: 4 osds: 4 up (since 14s), 4 in (since 2h)
22
    pgs:     1 active+clean
23
'依旧是 4 个osd进程'
24
===================================
25
⚠️ 被 spec 规则托管的 OSD：
26
删除后磁盘被 zap,spec 规则发现可用磁盘满足条件,'自动重建了 OSD'

展开收起

正确删除 spec 托管的 OSD#

Terminal window展开收起

1
1)先删除 spec 服务规则
2
root@Ceph-201 ~# ceph orch rm osd.osd_using_paths --force
3
'只交管理权,不删数据'
4
Removed service osd.osd_using_paths
5
root@Ceph-201 ~# ceph orch ls | grep osd
6
NAME                  RUNNING  REFRESHED  AGE  PLACEMENT
7
osd.all-available-devices   3  8m ago     -    '<unmanaged>'
8
osd.osd_using_paths      1  8m ago    -    '<unmanaged>'
9
'此时服务变为 <unmanaged>,OSD 进程还在'
10

11
2)再删除具体的 OSD
12
root@Ceph-201 ~# ceph orch osd rm 3 --zap
13
Scheduled OSD(s) for removal.
14
root@Ceph-201 ~# ceph orch osd rm status
15
# 查看一下删除进度
16
No OSD remove/replace operations reported
17
root@Ceph-201 ~# ceph orch ls | grep osd
18
NAME                  RUNNING  REFRESHED  AGE  PLACEMENT
19
osd.all-available-devices   3  3s ago     -    '<unmanaged>'
20
'确认服务规则已完全清理'
21
root@Ceph-201 ~# ceph osd tree
22
root@Ceph-201 ~# ceph osd tree
23
 0    hdd  0.29300    osd.0    up
24
 1    hdd  0.48830    osd.1    up
25
 2    hdd  1.00000    osd.2    up
26
 root@Ceph-201 ~# ceph -s | egrep 'health:|osd:|pgs:'
27
    health: HEALTH_OK
28
    osd: 3 osds: 3 up (since 2m), 3 in (since 2h)
29
    pgs:     1 active+clean
30
'这次是彻底删除干净了'
31
root@Ceph-201 ~# ceph orch device ls | grep Yes | wc -l
32
4

展开收起

方式二：按属性筛选 (rotational / size)#

Terminal window

1
1)编写新的spec文件
2
root@Ceph-201 ~# vim osd_spec2.yaml

1
service_type: osd
2
service_id: ssd_and_hdd
3
placement:
4
  hosts:
5
    - Ceph-201
6
spec:
7
  data_devices:
8
    rotational: 1
9
    # HDD：rotational=1
10
    size: '10G:'
11
    # 容量 ≥ 10G
12
  db_devices:
13
    rotational: 0
14
    # SSD：rotational=0
15
    size: '10G:'
16
  wal_devices:
17
    rotational: 0
18
    # SSD：rotational=0
19
    size: '10G:'

展开收起

Terminal window展开收起

1
root@Ceph-201 ~# ceph orch device ls --refresh
2
HOST      PATH         TYPE  SIZE  AVAILABLE
3
Ceph-201  /dev/nvme0n1  ssd  20.0G  Yes
4
Ceph-201  /dev/nvme0n2  ssd  20.0G  Yes
5
Ceph-201  /dev/sdb    hdd   300G  No
6
Ceph-201  /dev/sdc      hdd   500G  No
7
Ceph-201  /dev/sdd      hdd  1024G  No
8
Ceph-201  /dev/sde    hdd  20.0G  Yes
9
Ceph-201  /dev/sdf      hdd  20.0G  Yes
10

11
2)预览
12
Preview data is being generated.. Please re-run this command in a bit.
13
'执行完,稍微等一会... --> 再执行一遍'
14
root@Ceph-201 ~# ceph orch apply -i osd_spec2.yaml --dry-run
15
################
16
OSDSPEC PREVIEWS
17
################
18
+---------+-------------+----------+----------+----+-----+
19
|SERVICE  |NAME         |HOST      |DATA      |DB  |WAL  |
20
+---------+-------------+----------+----------+----+-----+
21
|osd      |ssd_and_hdd  |Ceph-201  |/dev/sde  |-   |-    |
22
|osd      |ssd_and_hdd  |Ceph-201  |/dev/sdf  |-   |-    |
23
+---------+-------------+----------+----------+----+-----+
24
'❌️ DB 和 WAL 全是 -,非并置失败——退化成纯 data OSD'

展开收起

Terminal window

1
🧱 为什么会退化成纯 data❓️
2

3
  spec 要的：                 实际有的：
4
  data_devices  2 块 HDD ✅    2 块 HDD (sde, sdf)
5
  db_devices    2 块 SSD ✅    2 块 SSD (nvme0n1, nvme0n2)
6
  wal_devices   2 块 SSD ❌    0 块 —— 没多余的 SSD 了！
7
  ─────────────────────────────────────
8
  共需 6 块,实有 4 块 → cephadm 凑不齐,全部降级成纯 data OSD

Terminal window展开收起

1
📌 解法一：
2
  删掉 `wal_devices`,WAL 自动复用 db 盘——2 HDD + 2 SSD 刚好配 2 个非并置 OSD
3
# 我来手动删除
4
root@Ceph-201 ~# tail -4 osd_spec2.yaml
5
db_devices:
6
  rotational: 0
7
  # SSD：rotational=0
8
  size: '10G:'
9
'已经把wal相关配置删除'
10
root@Ceph-201 ~# ceph orch apply -i osd_spec2.yaml --dry-run
11
'执行两遍' --> 再次预览结果
12
################
13
OSDSPEC PREVIEWS
14
################
15
+---------+-------------+----------+----------+--------------+-----+
16
|SERVICE  |NAME         |HOST      |DATA      |DB            |WAL  |
17
+---------+-------------+----------+----------+--------------+-----+
18
|osd      |ssd_and_hdd  |Ceph-201  |/dev/sde  |/dev/nvme0n2  |-    |
19
|osd      |ssd_and_hdd  |Ceph-201  |/dev/sdf  |/dev/nvme0n1  |-    |
20
+---------+-------------+----------+----------+--------------+-----+
21
✅️ 删除后 4 块盘都用上了

展开收起

Terminal window

1
📌 解法二：
2
    💡 如果再加 2 块 NVMe 盘（共 4 块 SSD）：
3
    data_devices  2 块 HDD ✅
4
    db_devices    2 块 SSD ✅  nvme0n1, nvme0n2
5
    wal_devices   2 块 SSD ✅  nvme0n3, nvme0n4（新加的）
6
    ─────────────────────────────────────
7
    共需 6 块,实有 6 块 → 刚好配出 2 个完整非并置 OSD：
8

9
    osd.X: sde (data HDD) + nvme0n1 (db SSD) + nvme0n3 (wal SSD)
10
    osd.Y: sdf (data HDD) + nvme0n2 (db SSD) + nvme0n4 (wal SSD)
11

12
    每个 OSD 独占三块盘,WAL/DB/DATA 全分离 ✅️

Terminal window展开收起

1
root@Ceph-201 ~# ceph orch device ls --refresh
2
'得强制刷新 2 次'
3
HOST      PATH         TYPE  SIZE  AVAILABLE
4
Ceph-201  /dev/nvme0n1  ssd  20.0G  Yes
5
Ceph-201  /dev/nvme0n2  ssd  20.0G  Yes
6
Ceph-201  /dev/nvme0n3  ssd  20.0G  Yes ✅️
7
Ceph-201  /dev/nvme0n4  ssd  20.0G  Yes ✅️
8
Ceph-201  /dev/sdb    hdd   300G  No
9
Ceph-201  /dev/sdc      hdd   500G  No
10
Ceph-201  /dev/sdd      hdd  1024G  No
11
Ceph-201  /dev/sde    hdd  20.0G  Yes
12
Ceph-201  /dev/sdf      hdd  20.0G  Yes
13
⚠️ 别忘记把spec 配置文件改回来
14
root@Ceph-201 ~# tail -4 osd_spec2.yaml
15
wal_devices:
16
  rotational: 0
17
  # SSD：rotational=0
18
  size: '10G:'
19
'把wal相关配置加回来'
20
root@Ceph-201 ~# ceph orch apply -i osd_spec2.yaml --dry-run
21
'执行两遍' --> 再次预览结果
22
################
23
OSDSPEC PREVIEWS
24
################
25
+---------+-------------+----------+----------+----+-----+
26
|SERVICE  |NAME         |HOST      |DATA      |DB  |WAL  |
27
+---------+-------------+----------+----------+----+-----+
28
|osd      |ssd_and_hdd  |Ceph-201  |/dev/sde  |-   |-    |
29
|osd      |ssd_and_hdd  |Ceph-201  |/dev/sdf  |-   |-    |
30
+---------+-------------+----------+----------+----+-----+
31
📌 加了 2 块 NVMe（共 4 块 SSD）预览还是纯 data❓️
32
🧱 根因：db 和 wal 筛选条件一模一样（rotational: 0, size: '10G:'）
33
     cephadm 看到 4 块 SSD 全匹配 → 分不清哪块归 db、哪块归 wal
34
     → 同一个池子分不清 → 放弃,全降纯 data
35
✅ 解法：wal 和 db 用 paths 明确指盘
36
root@Ceph-201 ~# vim osd_spec2.yaml

展开收起

1
service_type: osd
2
service_id: ssd_and_hdd
3
placement:
4
  hosts:
5
    - Ceph-201
6
spec:
7
  data_devices:
8
    rotational: 1
9
    # HDD：rotational=1
10
    size: '10G:'
11
    # 容量 ≥ 10G
12
  db_devices:
13
    paths:
14
      - /dev/nvme0n1
15
      - /dev/nvme0n2
16
  wal_devices:
17
    paths:
18
      - /dev/nvme0n3
19
      - /dev/nvme0n4

展开收起

Terminal window

1
root@Ceph-201 ~# ceph orch apply -i osd_spec2.yaml --dry-run
2
################
3
OSDSPEC PREVIEWS
4
################
5
+---------+-------------+----------+----------+--------------+--------------+
6
|SERVICE  |NAME         |HOST      |DATA      |DB            |WAL           |
7
+---------+-------------+----------+----------+--------------+--------------+
8
|osd      |ssd_and_hdd  |Ceph-201  |/dev/sde  |/dev/nvme0n2  |-             |
9
|osd      |ssd_and_hdd  |Ceph-201  |/dev/sdf  |/dev/nvme0n1  |/dev/nvme0n4  |
10
+---------+-------------+----------+----------+--------------+--------------+

🐛 实测发现：cephadm paths 模式下多 OSD WAL 配对 bug
环境：Ceph 20.2.1 (tentacle),cephadm + docker
现象：无论 db_devices 和 wal_devices 用 paths 指 2 块盘还是用属性筛选,cephadm 始终只给一个 OSD 分配独立 WAL,另一个 OSD 的 WAL 恒为 -（退化到 DB 盘）
即使 data + db + wal 全部用 paths 显式指定,结果依旧
排查过程：

所有 NVMe 盘均 AVAILABLE: Yes,无拒绝原因

blkid / hexdump 确认盘上无残留签名,全零

换不同 NVMe 盘组合（nvme0n3/nvme0n4 → nvme0n5/nvme0n3）,被跳过的盘跟着变

结论：不是盘的问题,是 cephadm 的配对算法 bug

💡 ==WAL 不可共用==
- 表示 WAL 数据合并写入 DB 盘,≠❌️ 两个 OSD 共用 WAL

OSD metadata 档案 / 详细信息#

ceph osd metadata <id> 拉取的是这个 OSD 的 “档案信息”,与业务数据无关：

层面	存的什么	类比
业务数据	客户端写入的对象数据	仓库里的货物
OSD metadata	OSD 自身的配置、硬件、部署信息	仓库门牌——“这台设备是什么、装在哪、用什么盘”

grep device 常见字段：

Terminal window

1
root@Ceph-201 ~# ceph osd metadata 0 | grep device
2
    "bluefs_single_shared_device": "1",          # 1 = DB/WAL 和 data 在同一块盘（并置）
3
    "bluestore_bdev_devices": "sdb", <--✅️盘的名称 # 数据盘（data）
4
    "default_device_class": "hdd",               # 设备类型
5
    "device_ids": "",                            # 设备 ID 串
6
    "device_paths": "sdb=/dev/disk/by-path/...", # 设备 by-path 路径映射
7
    "devices": "sdb", <--✅️盘的名称               # 设备短名
8
    "osdspec_affinity": "all-available-devices", # 由哪个 spec 规则创建

如果是非并置 OSD（DB 独立盘）,还会多出：

Terminal window

1
    "bluefs_dedicated_db": "1",                  # 1 = DB 在独立盘上
2
    "bluefs_db_devices": "nvme0n3",              # DB 盘（只有非并置才出现）

📌 并置 → bluefs_single_shared_device": "1"
非并置 → bluefs_db_devices": "具体哪块盘"——这两个字段是判断 OSD 部署方式的关键

常用操作速查#

Terminal window展开收起

1
# ===================================
2
# 集群状态
3
# ===================================
4
ceph -s                                    # 集群整体健康状态
5
ceph -w                                    # 实时监控集群变化
6
ceph osd tree                              # OSD 树（含 class / 权重 / 状态）
7
ceph osd df                                # OSD 磁盘使用率
8
ceph orch host ls                          # 集群节点列表
9
ceph orch device ls                        # 可用磁盘设备
10
ceph orch ps                               # 所有服务运行状态
11
ceph orch ls                               # 服务编排状态（含 managed/unmanaged）
12

13
# ===================================
14
# OSD 管理
15
# ===================================
16
ceph orch daemon add osd <host>:/dev/<disk>  # 手动添加 OSD（非托管）
17
ceph orch osd rm <id>                        # 删除 OSD
18
ceph orch osd rm <id> --zap                  # 删除 OSD + 清除数据
19
ceph orch osd rm <id> --replace --zap        # 替换 OSD
20
ceph orch osd rm status                      # 查看删除/替换进度
21
ceph orch device zap <host> /dev/<disk> --force  # 清理磁盘
22
ceph orch host drain <hostname>              # 驱逐节点所有服务
23
ceph osd crush remove <hostname>             # 从 CRUSH 删除主机
24
ceph orch host rm <hostname>                 # 从集群删除主机
25

26
# ===================================
27
# 设备类型 (Class) 管理
28
# ===================================
29
ceph osd crush rm-device-class <osd-id>     # 移除设备 class
30
ceph osd crush set-device-class <class> <osd-id>  # 设置设备 class
31

32
# ===================================
33
# Spec 规则管理
34
# ===================================
35
ceph orch apply -i spec.yaml                # 应用 spec 规则
36
ceph orch apply -i spec.yaml --dry-run      # 干运行（预览不执行）
37
ceph orch rm <service_name> --force         # 删除 spec 服务规则
38

39
# ===================================
40
# OSD 元数据
41
# ===================================
42
ceph osd metadata <id> | grep device        # 查看 OSD 对应物理设备

展开收起

Ceph集群开篇

Sat, 28 Mar 2026 00:00:00 GMT

Ceph 集群开篇#

[TOC]

image-20260520181221114

Ceph Documentation
- 官方文档📄

一、Ceph 概述#

Ceph 是什么#

==Ceph== 是一个开源的分布式存储系统,它把每一块待管理的数据切分为固定大小的对象（==object==）,并以对象为原子单元完成数据存取

底层存储服务由多个主机（host）组成的存储集群提供,该集群被称为 ==RADOS==（Reliable Automatic Distributed Object Store）——==可靠==、==自动化==、==分布式==、==对象存储==系统

RADOS 通俗理解：把四个字母拆开就是它的全部秘密：

字母	含义	通俗解释
Reliable	可靠	每份数据自动存 3 份,坏一台机器不丢数据
Automatic	自动化	你不用管数据放哪块盘,系统自己决定
Distributed	分布式	多台机器绑在一起干活,不是单机
Object Store	对象存储	数据被切成固定大小的”对象”来存取,像一个个标准快递箱

RADOS Cluster = 分布式集群 = 服务端
RADOS Cluster 本身就是由多台物理主机组成的
不是一台机器叫 RADOS,是这几台绑在一起才叫 RADOS Cluster

Terminal window

1
生产环境（≥3 台主机）：                 单节点实验（--single-host-defaults）：
2

3
    Ceph-201    Ceph-202    Ceph-203         Ceph-201（只有一台）
4
   ┌────────┐ ┌────────┐ ┌────────┐      ┌───────────────────┐
5
   │ MON ✅️ │ │ MON ✅️ │ │ MON ✅️ │     │ MON ✅️            │
6
   │ MGR ✅️ │ │ MGR    │ │ MGR    │      │ MGR ✅️ × 2       │
7
   │ OSD.0  │ │ OSD.3  │ │ OSD.6  │      │ OSD.0 OSD.1 OSD.2 │
8
   │ OSD.1  │ │ OSD.4  │ │ OSD.7  │      └───────────────────┘
9
   │ OSD.2  │ │ OSD.5  │ │ OSD.8  │      ⚠️ 一台挂 = 全集群挂 ❌️
10
   └────────┘ └────────┘ └────────┘      # 不适合生产环境
11
   一台挂 → 另两台顶上 ✅️

📌 一句话：RADOS 是 Ceph 的唯一地基——无论上层是 RBD、CephFS 还是 RadosGW
数据最终都变成”对象”沉到 RADOS 里,再由它分发到各台机器的磁盘上

Ceph 架构全景：工具 → 接口 → 集群#

Ceph 整个体系就三层——从你敲的命令,到程序调用的接口,到底层真正存数据的集群：

Terminal window展开收起

1
                    ┌── 工具层：你在终端敲的命令 ──┐
2
                    │                          │
3
               rbd           ceph fs        radosgw-admin       ceph
4
           (块设备命令)    (文件系统命令)       (对象网关命令)    (集群管理命令)
5
                │               │                │
6
                ▼               ▼                ▼
7
                    ┌── 接口层：三种存储入口 ──┐
8
                    │                      │
9
               RBD           CephFS        RadosGW
10
           (块设备接口)   (文件系统接口)  (对象网关接口)
11
                │               │               │
12
                └───────────────┴───────────────┘
13
                                │
14
            ════════════════════╪════════════════
15
                                ▼
16
                        RADOS Cluster = 分布式集群 = 服务端
17

18
                ┌───────┐  ┌───────┐  ┌───────┐
19
                │  MON  │  │  MON  │  │  MON  │  ← 大脑：管地图
20
                └───────┘  └───────┘  └───────┘
21
                ┌───────┐
22
                │  MGR  │                         ← 副手：管监控
23
                └───────┘
24
                ┌───────┐  ┌───────┐  ┌───────┐
25
                │ OSD.0 │  │ OSD.1 │  │ OSD.2 │  ← 仓库：真存数据
26
                │ /sdb  │  │ /sdc  │  │ /sdd  │
27
                └───────┘  └───────┘  └───────┘

展开收起

📌 三层角色：

层	是什么	谁在用	举例
工具层	命令行可执行文件	运维/开发人员手工敲	`rbd create`、`ceph fs ls`、`radosgw-admin user create`
接口层	三种存储入口	应用程序通过代码调用	RBD（块）、CephFS（文件）、RadosGW（对象）
集群层	服务端进程的集合	接口层把数据交给它	MON + MGR + OSD + MDS（可选）

💡 类比：

工具层 = ATM 机的触摸屏——你用手指点它
接口层 = ATM 机内部的银行系统——屏上的操作转成后台调用
集群层 = 银行金库——钱真正存放的地方

📌 librados 为什么不在接口层：它不是独立的存储类型（你不能说”我用 librados 存储”）

而是 RBD 和 RadosGW 底层共用的 C 语言原生库

三种存储类型#

存储类型	接口（接口层）	工具（工具层）	依赖关系	通俗理解	典型用途
块存储	==RBD==	`rbd`	依赖 librados	虚拟硬盘,能格式化、分区、挂载	虚拟机磁盘、数据库
文件存储	==CephFS==	`ceph fs`	不依赖 librados	共享文件夹,多台机器同时挂载	文件共享、日志存储
对象存储	==RadosGW==	`radosgw-admin`	依赖 librados	HTTP/HTTPS API,适合非结构化数据	图片/视频云存储

💡 关键区别：

RadosGW：基于 RESTful 风格提供跨互联网的==云存储服务==
- 里面的对象和 Ceph 内部的对象（固定大小存储块,基于 RPC 协议）不是一回事
RBD：将 Ceph 集群的存储空间模拟成独立块设备,依赖 Linux 内核的 librbd 模块
CephFS：和 librados 是同级组件,但使用热度比 RadosGW 和 RBD 低

📌 librados 的特殊地位：

RBD 和 RadosGW 底层都调用 librados,但 CephFS 不走这条路：

Terminal window

1
RBD ──────→ librados ──→ RADOS Cluster
2
RadosGW ──→ librados ──→ RADOS Cluster
3
CephFS ─────────────────→ RADOS Cluster （直接和 MDS / OSD 通信）

RADOS Cluster = 分布式集群 = 服务端

librados 是 Ceph 的”母语”——其他接口要么基于它,要么绕过它直接说方言

Ceph-架构

📌 核心要点：

无论你用哪种工具、哪种接口,最终数据都会被写入 RADOS Cluster(分布式集群)
每种客户端类型都有自己的存储池（Pool）资源
- 这句话的核心意思是：不同存储类型的”数据地盘”是分开的

Terminal window展开收起

1
"类比理解"
2
  一个 RADOS Cluster 就像一栋商场大楼：
3
  RADOS Cluster（商场）
4
  ├── Pool A（RBD 专区）   → 只放虚拟硬盘的"扇区数据"
5
  ├── Pool B（CephFS 专区） → 只放共享文件夹的"文件+目录信息"
6
  ├── Pool C（RadosGW 专区）→ 只放云存储的"图片/视频对象"
7
  └── Pool D（.mgr 系统池） → 只放集群自己的"内部账本"
8
      # 初始化集群后只有一个 .mgr 系统池
9
✅️ 每个 Pool 有自己独立的配置——副本数、PG 数量、CRUSH 规则——互不干扰
10
===========================
11
为什么不能混用❓️
12
  1.RBD 存的是扇区块（像硬盘的 0/1 二进制块）
13
  2.CephFS 存的是文件 + 目录树（像文件夹结构）
14
  3.RadosGW 存的是S3 对象 + 元数据（像云存储的 Key-Value）
15
✅️ 数据格式完全不同,所以每种类型必须有自己的 Pool
16
💡 就像商场里服装店和餐厅不能共用同一个铺位

展开收起

📌 一句话总结

每种客户端类型都有自己的存储池

你用 RBD 就建 RBD 的池,用 CephFS 就建 CephFS 的池,各有各的地盘,互不串门

CRUSH 算法详解#

CRUSH = Controlled Replication Under Scalable Hashing

可控的、可扩展的、基于哈希的副本分布算法
==CRUSH 算法== 是 Ceph 内部数据对象存储路由的算法,它没有中心节点（无元数据服务器）

🧱 通俗理解：

传统存储（比如 HDFS）的做法：

搞一个 NameNode（元数据服务器）,里面记着”文件A → 块1在机器3、块2在机器5”
客户端每次读写都要先问它

Ceph 的做法：不搞中心索引 —> ==客户端自己算位置==（去中心化）

Terminal window

1
传统 HDFS：                          Ceph CRUSH：
2
  客户端                               客户端
3
    │  "文件A存哪？"                      │  "我自己算！"
4
    ▼                                   │
5
 NameNode ──→ "机器3和机器5"              │  对象名 + CRUSH Map
6
    │                                   │        ↓ 哈希计算
7
    ▼                                   │  OSD.3 + OSD.7 + OSD.12
8
  机器3、机器5                            ▼
9
                                     直接找 OSD.3 写数据

💡 核心思想：CRUSH 就是一个伪随机哈希函数——给定”对象名字”和”集群地图”,算出”应该存到哪几块盘”

对比维度	传统元数据服务器（HDFS NameNode）	Ceph CRUSH
数据寻址	查表——问中心节点	计算——客户端自己算
中心节点	有（单点瓶颈、单点故障）	无（去中心化）
扩展性	受限于 NameNode 内存	理论上无限
节点增减	需要大规模重新平衡	只迁移受影响的 PG,其余不动
故障影响	NameNode 一挂 → 所有 I/O 立刻停	Monitor 不在数据路径上(门口保安) 短期：已连接客户端仍可读写长期：无法认证新连接,集群最终不可用

🧱 为什么 Monitor 挂了”短期能读、长期不行”：

Terminal window

1
HDFS NameNode 是"必经之路"：          Ceph Monitor 是"门口保安"：
2
  客户端                                  客户端（缓存了地图）
3
    │ 每次读写都得问                          │ "我知道 OSD.3 在哪"
4
    ▼                                       ▼
5
 NameNode ──→ 一挂全停 ❌️              OSD.3 ←── 直接通信,不经过 Monitor
6
                                         ✅️ Monitor 不在数据路径上

场景	还能不能？	原因
部分 Monitor 挂（还有 quorum）	✅ 完全正常	活着的 Monitor 继续服务,3个挂1个 —> 无所谓
全部 Monitor 挂 → 已连接客户端读写	✅ 短期能	客户端缓存了 OSD Map 和 CRUSH Map,知道数据在哪个 OSD,直接和 OSD 通信
全部 Monitor 挂 → 新建连接/打开新文件	❌ 不能	新客户端需要向 Monitor 认证身份、获取集群地图
全部 Monitor 挂 → 长时间运行	❌ 不能	OSD Map 有过期时间,OSD 之间心跳也会断,集群最终停摆

📌 CRUSH 三个关键优势：

去中心化：客户端拿着 CRUSH Map（集群拓扑图）,自己就能算出数据该存哪个 OSD,不需要每次问 Monitor
- 这就是”没有元数据服务器”的含义
故障域可控：你可以指定”同一份数据的 3 个副本必须分布在 3 台不同主机上”
- 这就是 type=host 的作用
弹性伸缩：加减 OSD 时,CRUSH 只重新分配受影响的 PG（安置组）,不是全量数据搬迁

📌 CRUSH Map 是什么❓️

CRUSH Map 就是”集群的地图”——它描述了：

有多少台主机
每台主机上有多少块 OSD
OSD 的权重*（容量越大的盘权重越高）*
故障域层级（root → host → osd）

客户端下载了这份地图,就不需要问别人了——所有位置计算都在本地完成

核心组件#

🚢 ① ==OSD==（Object Storage Device,对象存储守护进程,ceph-osd）

通俗解释：真正负责存数据的”仓库管理员”,一块磁盘对应一个 OSD 守护进程,类似于 HDFS 的 DataNode

存储数据、处理数据复制、恢复、重新平衡

通过检查其他 OSD 的心跳向 Monitor 和 Manager 提供监视信息

负责守护程序和管理客户端之间的身份验证（基于 ==Cephx 协议==）

❗️ 为了实现冗余和高可用,通常至少需要 3 个 OSD（默认数据副本是 3 个）

🧱 OSD 心跳互检——“不是 Monitor 挨个 ping,而是 OSD 互相盯着”：

Terminal window

1
        Monitor（大脑）
2
             ▲
3
      "OSD.3 挂了！"
4
             │
5
  ┌──────────┼──────────┐
6
  │          │          │
7
OSD.0 ←──→ OSD.1 ←──→ OSD.2
8
  │  心跳     │   心跳    │
9
  └───────────┴──────────┘

每个 OSD 定期给其他 OSD 发心跳包
如果 OSD.0 发现 OSD.3 半天没回应,就主动上报 Monitor
Monitor 不需要自己扫描所有 OSD

**类比：**老师（Monitor）不需要挨个点名——同学们（OSD）互相看着,谁没来立刻有人举手报告

🧱 OSD 负责 Cephx 身份验证——“Monitor 发证,OSD 验票”：

Terminal window展开收起

1
              ① 先去 Monitor 领"通行证"
2
客户端 ──────────────────────────> Monitor
3
  │    "我是 client.admin,这是我的 key"
4
  │                                  │
5
  │    <────── 通行证（ticket）────────┘
6
  │           Monitor 用密钥签名
7
  │
8
  │    ② 拿着通行证直接找 OSD
9
  └────────────────────────────────> OSD.3
10
       "我要写数据,这是我的通行证"
11
                                         │
12
                                         OSD 自己验票：
13
                                         "签名是 Monitor 的❓️"
14
                                         '没过期❓️权限够❓️'
15
                                         │
16
                                         ▼
17
                                      ✅ 放行 / ❌ 拒绝

展开收起

关键：Monitor 只负责签发通行证,不参与每一次数据读写——否则 Monitor 又变成瓶颈了

OSD 是验票的——每一次客户端读写,OSD 都要查通行证是否有效,防止未授权的客户端偷数据

通行证是 Monitor 用密钥签名的,OSD 认得这个签名——不需要每次回头问 Monitor

📦 ② ==Monitor==（监视器,ceph-mon）

通俗解释：集群的”大脑”和”元数据中心”,维护整个集群的运行状态地图

维护 5 张映射表：Monitor Map、Manager Map、OSD Map、CRUSH Map、PG Map

负责集群成员管理和客户端认证

❗️ 至少需要 3 个 Monitor（高可用 + 负载均衡）

⚙️ ③ ==Manager==（管理器,ceph-mgr）

通俗解释：Monitor 的”数据缓存副手”——它把查询类操作缓存下来,监控请求时能及时响应

Ceph 早期版本没有 mgr 组件,mon 每次查询都实时读取,代价高昂

L 版本引入 mgr,还托管基于 Python 的插件和 Rest API

❗️ 高可用通常至少需要 2 个 Manager

🧱 Manager 缓存了什么——和 Dashboard 的关系：

Terminal window展开收起

1
浏览器打开 Dashboard（https://Ceph-201:8443）
2
        │
3
        ▼
4
     Manager ←── 提前从集群各处收集并缓存：
5
        │
6
        ├── 集群健康状态（HEALTH_OK / WARN / ERR）
7
        ├── OSD 列表、状态、容量、延迟
8
        ├── MON 列表、quorum 情况
9
        ├── PG 状态（active+clean / degraded / ...）
10
        ├── 性能图表数据（IOPS、吞吐量、延迟曲线）
11
        ├── Dashboard 配置（你改过的密码、告警阈值...）
12
        └── 设备健康信息（SMART 数据、磁盘温度...）
13
简单概括: '存设备健康+数据、性能指标、Dashboard 配置等"内部账本"'
14

15
这些数据存在哪❓️
16
  → Manager 把上述数据持久化到 .mgr 存储池（系统池,bootstrap 时自动创建）
17
  → 这样 Manager 重启后配置不丢,Dashboard 刷新时秒出数据
18

19
❌️ Manager 不存用户数据（你的 RBD 块、CephFS 文件、RadosGW 对象）
20
✅️ 它只管"集群自己的内部账本和监控数据"

展开收起

📌 通俗类比：

Monitor 是”公司档案室”（存地图和花名册）

Manager 是”运营大屏”（Dashboard）的后台

它提前把各项指标算好缓存起来,你打开网页时不用现场去每个部门问一遍

🗂️ ④ ==MDS==（MetaData Server,元数据服务器,ceph-mds,可选组件）

通俗解释：对应 CephFS 文件系统的”目录索引”,类似于 HDFS 的 NameNode——找文件时不用扫描所有 OSD

存储 CephFS 的元数据（文件名、目录结构、权限）

仅在使用 CephFS 时需要,RBD 和 RadosGW 不需要

从严格意义上来讲,MDS 只能算作构建于 RADOS 之上的文件存取接口,而非基础组件

❗️ 如果使用 CephFS,建议部署多个 MDS 以防单点故障

🔹 ⑤ ==RGW==（对象存储网关,可选组件）

用于对象存储系统,需要启用相关组件模块

📋 ⑥ ==Pool & PG==（存储池 & 安置组,抽象概念）

通俗解释：

Pool：数据的逻辑分区

一个 Ceph 集群可以有多个 Pool,每个 Pool 还可以划分多个 namespace

PG（Placement Group）：Pool 内部的逻辑分组

数据通过 CRUSH 算法映射到具体 OSD 时,以 ==PG== 为单位

Tip

Pool 就是 PG 的容器,PG 是数据分布的”最小单位”

数据存储流程#

用一个具体例子走一遍：把一张 100MB 的照片存进 Ceph

Terminal window展开收起

1
┌───────────────────────────────────────────────┐
2
│  Step 1：切块                                  │
3
│                                               │
4
│  100MB 照片                                    │
5
│    │                                          │
6
│    ▼                                          │
7
│  ┌──────┐┌──────┐┌──────┐       ┌──────┐      │
8
│  │ 4MB  ││ 4MB  ││ 4MB  │ ...   │ 4MB  │      │
9
│  │ obj1 ││ obj2 ││ obj3 │  ×25  │ obj25│      │
10
│  └──────┘└──────┘└──────┘       └──────┘      │
11
│                                               │
12
│  Ceph 的对象固定 4MB,100MB → 切成 25 个对象     │
13
│                                               │
14
│  如果只有 10MB：                                │
15
│  ┌──────┐ ┌──────┐ ┌──────┐                   │
16
│  │ 4MB  │ │ 4MB  │ │ 4MB  │                   │
17
│  │ obj1 │ │ obj2 │ │ obj3 │                   │
18
│  └──────┘ └──────┘ └──────┘                   │
19
│    不足 4MB 也按 4MB 分配（2MB 数据 + 2MB 空白）  │
20
│  '对象大小固定 4MB,不够就补齐'                   │
21
│                                               │
22
└───────────────────────────────────────────────┘
23
                         │
24
                         ▼
25
┌──────────────────────────────────────────────┐
26
│  Step 2：对象→Pool→PG（CRUSH 计算）            │
27
│                                              │
28
│  以 obj1 为例 --> 每个对象在 RADOS 中有唯一的名字 │
29
│                                              │
30
│    "对象名"（如 rbd_data.1032.0001）           │
31
│         +                                    │
32
│    CRUSH Map                                 │
33
│         │ （集群地图：几台主机、几块盘、权重多少） │
34
│         ▼   'CRUSH 伪随机哈希'                │
35
│    命中 Pool 下的某个 PG → 例如 PG.7           │
36
│                                              │
37
│  25 个对象被均匀哈希到 Pool 下的各 PG 中         │
38
│      '一个 PG 里可以存放多个对象'                │
39
│  Pool 是 PG 的容器,PG 是数据分布的"最小单位"     │
40
└──────────────────────────────────────────────┘
41
                         │
42
                         ▼
43
┌─────────────────────────────────────────────┐
44
│  Step 3：PG→OSD（副本落地）                   │
45
│                                             │
46
│  PG.7 要做 3 个副本（Pool 的 size=3）：        │
47
│                                             │
48
│     PG.7                                    │
49
│       │                                     │
50
│       ▼  'CRUSH 再次计算'（故障域 = host）     │
51
│       │                                     │
52
│       ├─→ 副本① → Ceph-201 的 osd.1          │
53
│       ├─→ 副本② → Ceph-202 的 osd.4          │
54
│       └─→ 副本③ → Ceph-203 的 osd.7          │
55
│                  '三台不同主机'               │
56
│  obj1 最终变成 3 份,落在 3 台不同机器的磁盘上   │
57
└─────────────────────────────────────────────┘

展开收起

📌 三个关键角色：

角色	是什么	为什么需要它
Object	4MB 固定大小的数据块	统一大小,方便管理和分布
PG	Pool 内的逻辑分组	海量对象 → 少量 PG → 几块 OSD PG 做聚合收敛：百万对象只需几百个 PG 加减 OSD 时只搬 PG,不搬海量对象
CRUSH	==决定”去哪”的算法==	在数据落地过程中用了两次：① 对象名→PG；② PG→OSD

🧱 CRUSH 发挥了两次作用：

Terminal window

1
  对象名 ──CRUSH①──→ PG.7 ──CRUSH②──→ osd.1 / osd.4 / osd.7
2
          "去哪个 PG？"         "这个 PG 的 3 个副本放哪 3 块盘？"

第一次负责逻辑分组（对象归哪个 PG）

第二次负责数据落盘（PG 的副本落哪几块盘）

两段分工不同,但用的都是同一套 CRUSH 算法

🧱 PG 的数量远小于对象的数量——这才是 PG 存在的意义：

Terminal window

1
一个 Pool 里的数量对比：
2

3
  对象：几百万个（甚至上亿）         ← 海量
4
          │  'CRUSH 哈希收敛'
5
          ▼
6
   PG：几百个（通常 32 ~ 1024）      ← 少量
7
          │  'CRUSH 再计算'
8
          ▼
9
   OSD：几十块盘                     ← 更少

PG 做的是聚合收敛——不是一对一映射

如果每个对象对应一个 PG,那 PG 就没有存在的必要了

✅️ 一个 PG 里可以存放多个对象：

Terminal window

1
PG.7（一个 PG）
2
  ├── obj1（4MB）
3
  ├── obj8（4MB）
4
  ├── obj15（4MB）
5
  ├── obj22（4MB）
6
  ├── ...（成千上万个对象）
7
  └── objN（4MB）
8

9
CRUSH 把对象均匀哈希到各 PG → 每个 PG 里装了大量对象
10
迁移时以 PG 为单位搬 → 一次搬"一筐对象",而不是一个一个搬

📌 一句话总结：文件 → 切成对象 → CRUSH 算 PG → PG 分发到 OSD → 存 3 份到不同主机

BlueStore 存储引擎#

BlueStore 是 OSD 内部的存储引擎——决定数据最终以什么方式写到磁盘上

🧱 通俗理解：

OSD 收到一个对象后,怎么把它存到磁盘❓️ —> 这就靠存储引擎

Ceph 经历过一次大换血：

Terminal window展开收起

1
旧方案：FileStore                    新方案：BlueStore（v12.2.z 起默认）
2

3
  对象                                 对象
4
   │                                    │
5
   ▼                                    ├──> 数据 ──> 直接写裸块设备（/dev/sdb）
6
  Journal（日志盘）                       │
7
   │  ← 先写一份到这里（第 1 次写）         │
8
   ▼                                    ├──> 元数据 ──> Key-Value 数据库
9
  XFS 文件系统                           │    "对象名叫啥、存在磁盘哪个位置..."
10
   │  ← 再从 Journal 搬到这（第 2 次写）   │
11
   ▼                                    │
12
  裸块设备                               └──> 都在同一块盘上,没有中间商
13

14
问题：
15
  1.每笔数据写两遍 → 慢！
16
  2.XFS 这层本身也有开销 → 又慢一点！
17
  # 依赖 XFS 文件系统

展开收起

对比	FileStore（旧）	BlueStore（新）
写数据	先写 Journal → 再搬 XFS → 再落盘（写两次）	直接写裸块设备（写一次）
元数据	靠 XFS 文件系统管理	内建 RocksDB（Key-Value 数据库）,自己管
依赖	依赖 XFS 文件系统层	不依赖任何文件系统,直接在裸盘上存储
快满时	性能陡降	几乎不降
小随机写	慢	快（RocksDB 优化）
额外机制	无	支持 COW（写时复制）,RBD 快照/克隆更高效

FileStore 是”先写草稿再誊写”,BlueStore 是”一笔写成”
- 少了一道工序,性能自然更好

📌 RocksDB 是什么：一个轻量级的嵌入式键值(Key-Value)数据库（Facebook 开源）

BlueStore 用它来存元数据——“对象 A 存在磁盘偏移量 0x1234 处,长度 4MB”
- 读写数据前先查 RocksDB,找到位置后直接操作裸盘

二、Ceph 高可用集群部署#

部署工具概览#

部署工具	特点	推荐度
==cephadm==	类似 kubeadm,部署服务非常方便,容器化部署	⭐⭐⭐⭐⭐
ceph-deploy	原生工具,仅依赖 SSH + sudo + Python	⭐⭐(已丢弃)
ceph-ansible	基于 Ansible playbook	⭐⭐⭐⭐

💡 推荐使用 cephadm：与 k8s 的 kubeadm 一样好用,基于容器化部署,官方主推

Ceph 版本说明#

Terminal window

1
x.0.z → 0 --> 开发版本（内部测试）
2
x.1.z → 1 --> 测试版本（开发人员测试）
3
x.2.z → 2 --> 稳定版本（✅️ 生产环境推荐）
4
'x --> 大版本'
5
'z --> 小版本'
6

7
示例: 20.2.1 (Tentacle) 为稳定版本

image-20260520181823824

Ceph Releases (index)
- 时刻关注版本变换

三、cephadm 快速部署实战#

环境准备#

官方前提条件

Terminal window

1
- Python 3
2
- Systemd
3
- Podman or Docker for running containers
4
- Time synchronization (such as Chrony or NTP)
5
- LVM2 for provisioning storage devices

集群节点规划（3 节点）

主机	IP	CPU	内存	磁盘设备
Ceph-201	10.0.0.201	2C	4G	/dev/sdb (300G), /dev/sdc (500G), /dev/sdd (1024G==1T)
Ceph-202	10.0.0.202	2C	4G	/dev/sdb (300G), /dev/sdc (500G), /dev/sdd (1024G==1T)
Ceph-203	10.0.0.203	2C	4G	/dev/sdb (300G), /dev/sdc (500G), /dev/sdd (1024G==1T)

image-20260519084030991

Terminal window

1
✅️ 我是开机添加的, "重启生效"
2
'查看磁盘设备是否就绪'
3
root@Ceph-201 ~# lsblk
4
NAME                      MAJ:MIN RM  SIZE RO TYPE MOUNTPOINTS
5
sda                         8:0    0   40G  0 disk
6
|-sda1                      8:1    0    1M  0 part
7
|-sda2                      8:2    0    2G  0 part /boot
8
|-sda3                      8:3    0   38G  0 part
9
  └─-ubuntu--vg-ubuntu--lv 252:0    0   30G  0 lvm  /
10
sdb                         8:16   0  300G  0 disk     # ← 待加入 Ceph 的数据盘
11
sdc                         8:32   0  500G  0 disk     # ← 待加入 Ceph 的数据盘
12
sdd                         8:48   0    1T  0 disk     # ← 待加入 Ceph 的数据盘
13
sr0                        11:0    1  2.6G  0 rom
14
"sdb/sdc/sdd 三块裸盘无分区无挂载,满足加入 Ceph 的条件"

基础环境配置

Terminal window展开收起

1
1)设置时区（所有节点）
2
root@Ceph-201 ~# timedatectl status | grep zone
3
                Time zone: Asia/Shanghai (CST, +0800)
4
root@Ceph-201 ~# timedatectl set-timezone Asia/Shanghai
5
root@Ceph-201 ~# ll /etc/localtime
6
lrwxrwxrwx 1 root root 33 May 16 09:38 /etc/localtime -> /usr/share/zoneinfo/Asia/Shanghai
7

8
2)安装 Docker 环境（所有节点）
9
root@Ceph-201 ~# ls
10
autoinstall-docker.zip
11
root@Ceph-201 ~# unzip autoinstall-docker.zip
12
root@Ceph-201 ~# chmod +x install-docker.sh
13
root@Ceph-201 ~# ./install-docker.sh i
14
root@Ceph-201 ~# scp -O autoinstall-docker.zip root@10.0.0.202:/root/
15
autoinstall-docker.zip         100%   96MB 108.2MB/s
16
# -O 参数会告诉 scp 使用旧版的 SCP 协议进行文件传输,而不是默认的 SFTP 协议
17
root@Ceph-201 ~# scp -O autoinstall-docker.zip root@10.0.0.203:/root/
18
'把tar包拷贝过去'
19
# 另外两台也要进行安装
20

21
3)添加 hosts 解析（所有节点）
22
root@Ceph-201 ~# cat >> /etc/hosts <<EOF
23
10.0.0.201 Ceph-201
24
10.0.0.202 Ceph-202
25
10.0.0.203 Ceph-203
26
EOF
27

28
4)集群时间同步（Ubuntu 系统可跳过）
29

30
5)关机拍快照【强烈推荐】
31
root@Ceph-201 ~# init 0
32
# 快照可以让你在部署失败时快速回滚

展开收起

初始化 Ceph 集群#

下载并安装 cephadm

Terminal window展开收起

1
1)下载 cephadm（选择与目标版本一致）
2
root@Ceph-201 ~# CEPH_RELEASE=20.2.1
3
root@Ceph-201 ~# curl --silent --remote-name --location https://download.ceph.com/rpm-${CEPH_RELEASE}/el9/noarch/cephadm
4
'建议用浏览器去提前下载安装'
5
root@Ceph-201 ~# ls
6
cephadm
7

8
2)添加到 PATH
9
root@Ceph-201 ~# chmod +x cephadm
10
'下载下来的是二进制执行文件644'(不保留x权限)
11
root@Ceph-201 ~# mv cephadm /usr/local/bin/
12
root@Ceph-201 ~# ls /usr/local/bin/cephadm
13
/usr/local/bin/cephadm
14
root@Ceph-201 ~# cephadm version
15
# 验证版本
16
cephadm version 20.2.1 (6a49aff47758778a5f5951e731d437c317f72fb2) tentacle (stable)
17
'版本号确认无误 ✅️'

展开收起

必要镜像拉取

Terminal window展开收起

1
'提前拉取 Ceph 所需镜像（避免初始化时从外网拉取失败）'
2
root@Ceph-201 ~# docker pull quay.io/ceph/ceph:v20
3
root@Ceph-201 ~# docker pull quay.io/ceph/grafana:12.2.0
4
root@Ceph-201 ~# docker pull quay.io/prometheus/prometheus:v3.6.0
5
root@Ceph-201 ~# docker pull quay.io/prometheus/node-exporter:v1.9.1
6
root@Ceph-201 ~# docker pull quay.io/prometheus/alertmanager:v0.28.1
7
'因为这些镜像没在Docker Hub上, 所以拉取镜像还是很轻松的'
8

9
root@Ceph-201 ~# docker images
10
quay.io/ceph/ceph:v20                     0bae386bc859    2.15GB
11
quay.io/ceph/grafana:12.2.0               74144189b384     974MB
12
quay.io/prometheus/alertmanager:v0.28.1   27c475db5fb1     110MB
13
quay.io/prometheus/node-exporter:v1.9.1   d00a542e409e    40.8MB
14
quay.io/prometheus/prometheus:v3.6.0      76947e7ef22f     440MB
15
# 5 个核心镜像：ceph + grafana + prometheus + node-exporter + alertmanager
16

17
'save导出 & load导入别的节点'
18
root@Ceph-201 ~# docker save quay.io/ceph/ceph:v20 > ceph-v20.tar.gz
19
root@Ceph-201 ~# docker save quay.io/ceph/grafana:12.2.0 > grafana-12.2.0.tar.gz
20
root@Ceph-201 ~# docker save quay.io/prometheus/alertmanager:v0.28.1 > alertmanager-v0.28.1.tar.gz
21
root@Ceph-201 ~# docker save quay.io/prometheus/node-exporter:v1.9.1 > node-exporter-v1.9.1.tar.gz
22
root@Ceph-201 ~# docker save quay.io/prometheus/prometheus:v3.6.0 > prometheus-v3.6.0.tar.gz
23
root@Ceph-201 ~# ls *.tar.gz | xargs -n 1
24
alertmanager-v0.28.1.tar.gz
25
ceph-v20.tar.gz
26
grafana-12.2.0.tar.gz
27
node-exporter-v1.9.1.tar.gz
28
prometheus-v3.6.0.tar.gz
29
root@Ceph-201 ~# ls *.tar.gz | xargs -i scp -O {} root@10.0.0.202:/home/test
30
root@Ceph-201 ~# ls *.tar.gz | xargs -i scp -O {} root@10.0.0.203:/home/test
31

32
# 别的节点
33
root@Ceph-202 ~# ls /home/test/
34
alertmanager-v0.28.1.tar.gz
35
root@Ceph-202 ~# cd /home/test/
36
root@Ceph-202 test# for i in `ls`; do docker load -i $i;done
37
'另一台也一样'
38
root@Ceph-203 test# docker images
39
quay.io/ceph/ceph:v20
40
quay.io/ceph/grafana:12.2.0
41
...........xxxxxxxx

展开收起

初始化集群#

Terminal window

1
root@Ceph-201 ~# cephadm bootstrap \
2
  --mon-ip 10.0.0.201 \
3
  --cluster-network 10.0.0.0/24 \
4
  --allow-fqdn-hostname \
5
  --skip-pull
6
'cephadm bootstrap 是 Ceph 集群初始化的核心命令'

📌 参数说明：

参数	作用
`--mon-ip 10.0.0.201`	指定 Monitor 监听 IP
`--cluster-network 10.0.0.0/24`	集群内部通信网络（OSD 间数据复制走此网）
`--allow-fqdn-hostname`	允许使用主机名而非仅 IP
`--skip-pull`	跳过镜像拉取（已提前导入）

🔹 bootstrap 常用可选参数补充

参数	作用
`--registry-url=xxxx`	指定私有镜像仓库地址
`--registry-username=xxxx`	私有仓库用户名
`--registry-password=xxx`	私有仓库密码
`--initial-dashboard-password=xxx` ✅️	预设 Dashboard 密码
`--dashboard-password-noupdate` ✅️	禁止首次登录强制修改密码
`--single-host-defaults`	单节点部署优化（见下方实验）

Terminal window

1
Verifying podman|docker is present...
2
...........
3
Waiting for mgr to start...
4
Waiting for mgr...
5
mgr not available, waiting (1/15)...
6
mgr not available, waiting (2/15)...
7
mgr not available, waiting (3/15)...
8
mgr is available
9
Ceph Dashboard is now available at:
10

11
       URL: https://Ceph-201:8443/    <--'域名访问'(导入Windows中hosts表)
12
      User: admin            <--"用户名"
13
  Password: twt8hvj9t0         <--"密码"(随机生成)

💡 Bootstrap 做了什么？

① 生成了集群 FSID（唯一标识）
② 在本地主机上为新集群创建一个 Monitor（监听 10.0.0.201:6789）和一个 Manager 守护程序
③ 为 Ceph 集群生成一个新的 SSH 密钥,私钥自己拿着(存在 Ceph 内部)

👆 并将公钥添加到 root 用户的 /root/.ssh/authorized_keys 文件中(方便连自身)

④ 将公钥副本写入 /etc/ceph/ceph.pub(用于分发)
⑤ 将最小配置文件写入 /etc/ceph/ceph.conf（与 Ceph 守护程序通信所必需的）
⑥ 将 client.admin 管理（特权）密钥副本写入 /etc/ceph/ceph.client.admin.keyring
⑦ 将 _admin 标签添加到引导主机

👆 默认情况下,任何具有此标签的主机都会获得 ceph.conf 和 keyring(管理员密钥环)的副本

Terminal window展开收起

1
1)SSH 密钥与 authorized_keys（为什么内容一模一样？）
2
root@Ceph-201 ~# cat /root/.ssh/authorized_keys
3
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIMK+kon/b+d4oV1PQNY4AKhq5R9M17zm18uLv//0/4N8 ceph-fdc2219c-5344-11f1-8042-000c2990a57e
4
=======================不同的文件
5
root@Ceph-201 ~# cat /etc/ceph/ceph.pub
6
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIMK+kon/b+d4oV1PQNY4AKhq5R9M17zm18uLv//0/4N8 ceph-fdc2219c-5344-11f1-8042-000c2990a57e
7
=======================
8
 ─── 通俗解释 ───
9
SSH 密钥对 = 私钥 + 公钥
10
  - 私钥（自己留着,不公开） → Bootstrap 生成了,存在 Ceph 内部
11
  - 公钥（可以到处分发）     → 写入 /etc/ceph/ceph.pub
12
/root/.ssh/authorized_keys 是什么❓️
13
  → 这是 SSH 的"访客白名单"：谁的公钥在里面,谁就能"免密登录"这台机器
14
=======================
15
为什么两个文件内容一样？
16
  Bootstrap 拿同一把公钥做了两件事：
17
     ① 把公钥"贴到"自己的 authorized_keys 文件里
18
        → 让 Ceph-201 自己能 SSH 免密连自己（后续编排时 master 需要连自身）
19
     ② 把公钥保存到 /etc/ceph/ceph.pub
20
        → 以后用 ssh-copy-id -i /etc/ceph/ceph.pub 分发给其他节点
21
        → 其他节点收到这把公钥,也会把它写入自己的 authorized_keys
22
        → 这样 Ceph-201 就能免密 SSH 到所有节点,完成集群的编排调度
23
📌 一句话：ceph.pub 是钥匙的"公钥副本",authorized_keys 是"允许用这把钥匙的人进来"
24
  ✅️ 两者内容相同,因为本质上是同一把公钥
25

26

27
2)最小配置文件
28
root@Ceph-201 ~# cat /etc/ceph/ceph.conf
29
# minimal ceph.conf for fdc2219c-5344-11f1-8042-000c2990a57e
30
[global]
31
  fsid = fdc2219c-5344-11f1-8042-000c2990a57e    # ← 集群唯一身份证号（UUID）
32
  mon_host = [v2:10.0.0.201:3300/0,v1:10.0.0.201:6789/0]
33
=======================
34
 ─── 通俗解释 ───
35
fsid（集群 ID）：
36
  1.就像每个人的身份证号,全球唯一,用来区分不同的 Ceph 集群
37
  2.当你管理多个集群时,就是靠 fsid 来区分"你在操作哪一个集群"
38
=======================
39
mon_host（Monitor 地址列表）：
40
  告诉客户端：集群的大脑（Monitor）在哪里？
41
  格式：[v2:IP:3300/0, v1:IP:6789/0]
42
      - v2（msgr2 协议）：端口 3300,新版高性能通信协议,支持加密
43
      - v1（msgr1 协议）：端口 6789,老版协议,向后兼容
44
    "两个协议地址都写上,新旧客户端都能连"
45
=======================
46
为什么叫"最小配置"❓️
47
      ① fsid    → 知道你是谁（不能连错集群）
48
        就像你去公司报到,只需要知道"公司名称"和"公司地址"
49
      ② mon_host → 知道大脑在哪里（去哪报到）
50
        其他所有信息（OSD 在哪、数据怎么分布…）都由 Monitor 动态告诉你
51

52

53
3) 管理员密钥环（keyring）
54
root@Ceph-201 ~# cat /etc/ceph/ceph.client.admin.keyring
55
[client.admin]                                # ← 用户名：client.admin（管理员账号）
56
  key = AQBh9wtq2sSYJRAAweHsVl4OjRia0jObKVHapA==    # ← 管理员的"密码"
57
  caps mds = "allow *"       # 对 MDS 的权限： * = 所有操作
58
  caps mgr = "allow *"       # 对 Manager 的权限： * = 所有操作
59
  caps mon = "allow *"       # 对 Monitor 的权限： * = 所有操作
60
  caps osd = "allow *"       # 对 OSD 的权限： * = 所有操作
61
=======================
62
 ─── 通俗解释 ───
63
keyring（密钥环）是什么❓️
64
  就是 Ceph 的"用户名+密码+权限"文件
65
  类似 MySQL 的 user@host 认证,或 Linux 的 /etc/shadow
66
MySQL 客户端连接 ` mysql -u root -p `
67
# 你向 MySQL 服务端证明"我是 root"
68
Ceph 客户端连接 `  ceph -s ` ---> 背后读取 client.admin keyring
69
# ceph 命令行工具向 Monitor（mon_host 指定的地址）证明"我是 admin"
70
=======================
71
[client.admin] → 用户名
72
  这是 Ceph 的"root 账号",拥有集群的绝对控制权
73
  类比：Linux 的 root、MySQL 的 root@localhost
74
key = AQBh... → 密码（经过 base64 编码的密钥）
75
  这是 client.admin 的认证密钥,不是人类可读的密码,而是加密密钥
76
  客户端出示 key → Monitor 验证 → 通过后发放 session ticket
77
"普通客户端（只想挂个 RBD 硬盘） --> 创建一个权限受限的普通账号"
78
=======================
79
caps（capabilities,权限）→ 能做什么
80
  每个组件都有独立的权限控制：
81
      mds  = CephFS 元数据服务器 → allow * = 可以读写所有文件系统操作
82
      mgr  = Manager           → allow * = 可以访问监控和编排功能
83
      mon  = Monitor           → allow * = 可以查看和修改集群状态
84
      osd  = OSD 数据守护进程  → allow * = 可以直接读写所有磁盘数据
85

86

87
4) 浏览器访问 Dashboard
88
URL: https://Ceph-201:8443/
89
# 用上面输出的 admin 用户名和初始密码登录即可

展开收起

如果用主机名访问 Dashboard,需要修改 Windows 的hosts 解析记录

⚠️ 注意：首次登录 Dashboard 需要修改密码

image-20260519171553551

配置 Ceph 集群管理命令#

方式一：宿主机直接安装（推荐）#

Terminal window展开收起

1
1)安装 ceph 通用工具包
2
root@Ceph-201 ~# apt update
3
root@Ceph-201 ~# apt -y install ceph-common
4
# 所有主机节点都装一下
5

6
2)测试使用
7
root@Ceph-201 ~# ceph version
8
ceph version 20.2.1 (6a49aff47758778a5f5951e731d437c317f72fb2) tentacle (stable)
9

10
root@Ceph-201 ~# ceph -s
11
  cluster:
12
    id:     fdc2219c-5344-11f1-8042-000c2990a57e
13
    health: HEALTH_WARN
14
    # 还没加 OSD,所以健康状态为 WARN
15
            OSD count 0 < osd_pool_default_size 3
16

17
  services:
18
    mon: 1 daemons, quorum Ceph-201 (age 7m) [leader: Ceph-201]
19
    mgr: Ceph-201.cxdvrq(active, since 7m)
20
    osd: 0 osds: 0 up, 0 in
21
    # 还没有 OSD
22

23
  data:
24
    pools:   0 pools, 0 pgs
25
    objects: 0 objects, 0 B
26
    usage:   0 B used, 0 B / 0 B avail
27
    pgs:

展开收起

方式二：基于容器管理#

Terminal window展开收起

1
1)启动 cephadm shell（本质是启动了一个临时容器）
2
root@Ceph-201 ~# cephadm shell
3
Inferring fsid fdc...xxx
4
root@Ceph-201:/# ceph -s
5
  cluster:
6
    id:     fdc2219c-5344-11f1-8042-000c2990a57e
7
    health: HEALTH_WARN
8
            OSD count 0 < osd_pool_default_size 3
9
  ...
10
============================
11
# 新开一个终端
12
root@Ceph-201 ~# docker ps -l
13
IMAGE          COMMAND   CREATED              STATUS
14
0bae386bc859   "bash"    About a minute ago   Up About a minute
15
============================
16
root@Ceph-201:/# exit
17
exit
18
'exit退出shell后,容器随即自动删除'
19

20

21
2)非交互式执行命令（执行完自动退出容器）
22
'用 -- 分隔,后面跟要执行的命令,适合脚本和快速查看'
23
root@Ceph-201 ~# cephadm shell -- ceph -s
24
Inferring fsid ...
25
  cluster:
26
    id:     fdc2219c-5344-11f1-8042-000c2990a57e
27
    health: HEALTH_WARN
28
            OSD count 0 < osd_pool_default_size 3
29
  ...
30

31
3)多集群环境指定参数
32
'单集群环境 --> 参数可自动添加,多集群需显式指定'
33
root@Ceph-201 ~# cephadm shell --fsid <fsid> -c /etc/ceph/ceph.conf -k /etc/ceph/ceph.client.admin.keyring
34
✅️ 明确指定集群 fsid、最小配置文件、keyring(管理员密钥环)路径

展开收起

📌 关键点：cephadm shell 本质是启动一个临时容器,退出即删除

添加主机到集群#

Terminal window展开收起

1
'在 Ceph-201 节点上操作'
2

3
1)查看现有集群主机
4
root@Ceph-201 ~# ceph orch host ls
5
HOST      ADDR        LABELS  STATUS
6
Ceph-201  10.0.0.201  _admin
7
1 hosts in cluster
8

9
2)把 SSH 公钥分发到其他节点
10
root@Ceph-201 ~# ssh-copy-id -f -i /etc/ceph/ceph.pub Ceph-202
11
-f   # 参数用于强制复制
12
-i  # 指定密钥
13
Number of key(s) added: 1
14
root@Ceph-201 ~# ssh-copy-id -f -i /etc/ceph/ceph.pub Ceph-203
15

16
3)添加主机到集群
17
root@Ceph-201 ~# ceph orch host add Ceph-202 10.0.0.202
18
Added host 'Ceph-202' with addr '10.0.0.202'
19
root@Ceph-201 ~# ceph orch host add Ceph-203 10.0.0.203
20
Added host 'Ceph-203' with addr '10.0.0.203'
21

22
4)验证集群节点列表
23
root@Ceph-201 ~# ceph orch host ls
24
HOST      ADDR        LABELS  STATUS
25
Ceph-201  10.0.0.201  _admin
26
Ceph-202  10.0.0.202
27
Ceph-203  10.0.0.203
28
3 hosts in cluster
29
✅️ 3 个节点全部加入集群

展开收起

image-20260523161350093

四、添加 OSD 设备#

OSD 加入条件#

Terminal window

1
⚠️ 一个设备想要加入 Ceph 集群,必须满足 3 个条件：
2
  （1）设备未被使用（无分区、无文件系统、没有被 LVM 占用、当前未挂载）
3
  （2）设备的存储大小必须大于 5GB
4
  （3）需要等待 30s~3min 才能在 ceph orch device ls 中看到设备
5
'ceph orch device ls --refresh'
6
✅️ --refresh 强扫,比干等 agent 周期扫描快
7
'绕开缓存直接触发一次新扫描'

查看可用设备#

Terminal window展开收起

1
1)查看集群可用的设备
2
root@Ceph-201 ~# ceph orch device ls
3
✅️ 优先加 --refresh 强扫选项
4
HOST      PATH      TYPE SIZE  AVAILABLE
5
Ceph-201  /dev/sdb  hdd   300G  Yes        15m ago
6
Ceph-201  /dev/sdc  hdd   500G  Yes        15m ago
7
Ceph-201  /dev/sdd  hdd  1024G  Yes        15m ago
8
Ceph-201  /dev/sr0  hdd   VMware..xxx  space (<5GB)  # ← 光驱,<5GB,不可用
9
Ceph-202  /dev/sdb  hdd   300G  Yes        13m ago
10
Ceph-202  /dev/sdc  hdd   500G  Yes        13m ago
11
Ceph-202  /dev/sdd  hdd  1024G  Yes        13m ago
12
Ceph-202  /dev/sr0  hdd   VMware..xxx  space (<5GB)
13
Ceph-203  /dev/sdb  hdd   300G  Yes        10s ago
14
Ceph-203  /dev/sdc  hdd   500G  Yes        10s ago
15
Ceph-203  /dev/sdd  hdd  1024G  Yes        10s ago
16
Ceph-203  /dev/sr0  hdd   VMware..xxx  space (<5GB)
17
# 每个节点 3 块数据盘 × 3 个节点 = 9 个候选 OSD
18
============================
19
AVAILABLE 列的评判标准：就是"这块盘还能不能拿来当 OSD"
20
一旦加入OSD成功,Ceph 在上面建了 LVM、写了文件系统
21
再次查看时,AVAILABLE 从 Yes 变No --> ✅️ 不是盘坏了,是盘已经有主了
22

23

24
2)查看当前 OSD 列表（加盘前）
25
root@Ceph-201 ~# ceph osd tree
26
ID  CLASS  WEIGHT  TYPE NAME     STATUS  REWEIGHT  PRI-AFF
27
-1              0  root default
28
# 空 ——> 还没加 OSD

展开收起

字段	说明
ID	OSD 或节点的==唯一标识符==,负数通常表示分组节点 `-1`：默认根节点
CLASS	存储设备的类型分类如 hdd（机械硬盘）、ssd（固态硬盘）、nvme（NVMe SSD）
WEIGHT	CRUSH 算法中使用的权重值,决定数据分布比例容量越大权重==通常==越大
TYPE	==节点类型== 如 root（根节点）、host（主机）、osd（存储守护进程）
NAME	节点名称可能是主机名或 OSD 编号
STATUS	==状态== up 表示在线可用,down 表示离线
REWEIGHT	临时权重调整值,用于控制数据迁移 1.0 为正常,0.0 为禁止数据
PRI-AFF	Placement Group 亲和性设置

📌 CLASS 类型速查：

CLASS	接口/协议	判断依据	性能定位	VMware 模拟
`hdd`（机械硬盘）	SATA/SCSI	`rotational=1`,`/dev/sd*`	慢,便宜,容量大	SCSI/SATA 虚拟盘（默认）
`ssd`（固态硬盘）	SATA/SCSI	`rotational=0`,`/dev/sd*`	快,适合热数据	SCSI/NVMe 虚拟盘
`nvme`（NVMe SSD）	PCIe 直连	`/dev/nvme*`（自动识别）	最快,延迟最低	NVMe 虚拟盘

hdd < ssd < nvme — CRUSH 用 CLASS 区分快慢,实现数据分层
元数据放 nvme、热数据放 ssd、冷数据放 hdd

⭐批量添加 OSD#

Terminal window

1
'一次一条命令,将 9 块盘全部添加为 OSD'
2

3
# --- Ceph-201 节点 ---
4
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdb
5
✅️ 太慢了,等等吧...
6
Created osd(s) 0 on host 'Ceph-201'
7
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdc
8
Created osd(s) 1 on host 'Ceph-201'
9
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdd
10
Created osd(s) 2 on host 'Ceph-201'
11

12
root@Ceph-202 ~# ceph orch daemon add osd Ceph-202:/dev/sdb
13
Error initializing cluster client: ObjectNotFound('RADOS object not found (error calling conf_read_file)')
14
# ↑ Ceph-202 本地找不到 /etc/ceph/ceph.conf,无法知道 Monitor 在哪,认证凭据也没有

🧱 通俗解释：

ceph orch host add(添加主机到集群) 只是把主机名和 IP 登记到集群的”花名册”上（Monitor 知道有这台机器了）,但并没有把”身份证”发给这台机器
执行 ceph orch daemon add osd 时,命令要和 Monitor 通信——需要两样东西：

ceph.conf → “公司在哪”（Monitor 地址）

ceph.client.admin.keyring → “你是谁”（管理员身份证明）

Ceph-202 本地没有这两个文件 → 报 ObjectNotFound
解决：从 Ceph-201（引导节点）拷贝过去就行

📌 延伸 — 多集群管理：既然 ceph.conf + keyring 决定了”连哪个集群、以什么身份连”
那么一个客户端拿着多套配置文件,就能同时管理多个 Ceph 集群：

Terminal window

1
# 切换到集群 A
2
ceph --fsid <fsid-A> -c /etc/ceph/ceph-A.conf -k /etc/ceph/ceph-A.client.admin.keyring -s
3

4
# 切换到集群 B
5
ceph --fsid <fsid-B> -c /etc/ceph/ceph-B.conf -k /etc/ceph/ceph-B.client.admin.keyring -s

Note

无需登录到不同节点,在本地切换配置文件即可——类似于 kubectl 的 context 切换

Terminal window展开收起

1
'👇在 Ceph-201 上执行,把"身份证"分发到其他节点'
2
root@Ceph-201 ~# scp /etc/ceph/ceph.conf root@Ceph-202:/etc/ceph/
3
root@Ceph-201 ~# scp /etc/ceph/ceph.client.admin.keyring root@Ceph-202:/etc/ceph/
4
'👇设置正确权限'
5
root@Ceph-201 ~# ssh root@Ceph-202 "chmod 644 /etc/ceph/ceph.conf && chmod 600 /etc/ceph/ceph.client.admin.keyring"
6

7
# --- Ceph-202 节点 ---
8
root@Ceph-201 ~# ceph orch daemon add osd Ceph-202:/dev/sdb
9
Created osd(s) 3 on host 'Ceph-202'
10
root@Ceph-201 ~# ceph orch daemon add osd Ceph-202:/dev/sdc
11
Created osd(s) 4 on host 'Ceph-202'
12
root@Ceph-201 ~# ceph orch daemon add osd Ceph-202:/dev/sdd
13
Created osd(s) 5 on host 'Ceph-202'
14

15
# --- Ceph-203 节点 ---
16
'同上'
17
root@Ceph-201 ~# ceph orch daemon add osd Ceph-203:/dev/sdb
18
Created osd(s) 6 on host 'Ceph-203'
19
root@Ceph-201 ~# ceph orch daemon add osd Ceph-203:/dev/sdc
20
Created osd(s) 7 on host 'Ceph-203'
21
root@Ceph-201 ~# ceph orch daemon add osd Ceph-203:/dev/sdd
22
Created osd(s) 8 on host 'Ceph-203'

展开收起

❤️LVM 技术栈#

💡 底层原理：ceph 底层使用 ==LVM 技术栈== 管理磁盘,每块盘会被初始化为 LVM PV → VG → LV

LVM技术栈

🧱 LVM 技术栈详解：PV → VG → LV

LVM（==逻辑卷管理器==）是 Linux 下对磁盘进行灵活分区管理的技术

它的核心思路是：在物理磁盘和文件系统之间加一层抽象

让你可以随时调整”分区”大小,而不需要像传统分区那样推倒重来

① 物理卷 — PV（Physical Volume）

PV 是最底层的存储单元

PV 可以是一整块物理磁盘（如 /dev/sdb）,也可以是磁盘上的一个分区（如 /dev/sda3）
一块盘/分区被 pvcreate 标记后,LVM 就能识别并使用它
PV 内部被切分为==固定大小==的 PE（Physical Extent,默认 4MB）
- PE 是 LVM 分配空间的最小单位

📌 类比：PV 就像一块空地——不管原来是整座山（整块盘）还是山的一角（分区）,圈进来之后就都是可用的地皮

② 卷组 — VG（Volume Group）

VG 是 LVM 的==“资源池”==——把多块 PV 整合成一个统一的大池子

多个 PV 可以加入同一个 VG,VG 的容量 = 所有 PV 容量之和
VG 就像一个弹性仓库——你只负责从池子里取空间,底层是哪块盘不用操心
后期可以随时往 VG 里加新盘（新 PV）,也可以移除旧盘（数据迁移后）

📌 类比：VG 就像把多块空地合并成一个大工地

③ 逻辑卷 — LV（Logical Volume）

LV 是从 VG 中切分出来的、==最终可用==的存储空间

从 VG 中==按需划分==,大小可以动态调整（扩容/缩容）
LV 可以像普通分区一样格式化（ext4/XFS）并挂载使用
LV 支持快照（snapshot）——给某个 LV 拍一个”当时的状态”,用于备份或回滚

📌 类比：LV 就像从大工地里隔出来的房间——想要多大隔多大,房间不够用了还能在线扩容

📋 三层结构速查表：

层次	英文	是什么	关键操作
物理卷	PV	底层存储”砖块”	`pvcreate /dev/sdb`
卷组	VG	多块 PV 的”资源池”	`vgcreate vg_name /dev/sdb /dev/sdc`
逻辑卷	LV	最终使用的”存储空间”	`lvcreate -L 100G -n lv_name vg_name`

🔁 数据流向：物理磁盘 → PV → VG → LV → 格式化文件系统 → 挂载使用

⚖️ LVM 的优缺点：

	优点	缺点
1	在线扩容：LV 不够用了,在线扩,不影响正在跑的业务	多一层开销：比直接操作裸盘多一层抽象,有微弱性能损耗
2	灵活聚合：多块小盘合成一个大 VG,打破单盘容量限制加新盘 → 扩 VG → 扩 LV → 文件系统变大	故障面扩大：VG 中某块 PV 坏了,用到它的 LV 会受影响
3	快照功能：给 LV 拍快照,备份/回滚/测试都很方便	学习成本：多了一套概念（PV→VG→LV）,排错链路变长
4	动态伸缩：不光能扩容,还能缩容（ext4 支持,XFS 不支持缩容）	固件限制：固件不认识 LVM,只认普通分区所以 `/boot` 通常要单独分出来放在 LVM 外面

💻 Ubuntu 与 LVM：

Ubuntu 系统安装时如果勾选”使用 LVM”,底层就是这样运作的——安装程序自动创建：

Terminal window

1
# Ubuntu 默认 LVM 结构（以 40G 系统盘为例）
2
/dev/sda3 → PV ──→ ubuntu-vg（VG）──→ ubuntu-lv（LV,挂载到 /）
3
                                       │
4
                                       └── LV 不会占满整个 VG,留一部分空闲
5
                                           '不是空间浪费,是刻意的'
6
                                           '留着以后给 / 根分区在线扩容用'

Terminal window展开收起

1
# 验证一下（Ubuntu环境里就有）
2
root@Ceph-201 ~# lsblk
3
sda     8:0    0   40G  0 disk
4
├─sda1  8:1    0    1M  0 part
5
├─sda2  8:2    0    2G  0 part /boot ✅️'/boot只认普通分区'
6
└─sda3  8:3    0  '38G' 0 part
7
  └─ubuntu--vg-ubuntu--lv   252:0    0  '30G'  0 'lvm'  /
8
   👆 '这一整行是逻辑卷（LV）'          'LVM技术栈'👆
9
📌 细节 --> 从sda3开始分
10
✅️ 38G 的 PV,LV 只用了 30G → 8G 空闲留在 VG 里
11

12
root@Ceph-201 ~# vgs
13
  VG        #PV #LV #SN Attr   VSize  VFree
14
  ubuntu-vg   1   1   0 wz--n- 38.00g 8.00g
15
    👆 '这才是卷组'
16
✅️ VFree = 8G ← 空闲空间,随时可以扩给 /

展开收起

📌 Ubuntu 不会一开始就把所有空间分给根分区,只会分一半左右——剩下的留在 VG 里

方便后续 lvextend 在线扩容,不用重装系统

🔗 回到 Ceph：

Ceph 添加 OSD 时,ceph orch daemon add osd 在背后做的事本质上就是这套 LVM 流程：

Terminal window

1
# 当你执行 ceph orch daemon add osd Ceph-201:/dev/sdb 时,Ceph 自动：
2
/dev/sdb → pvcreate → 创建 PV
3
         → vgcreate → 创建 VG（名：ceph-<VG_UUID>）
4
         → lvcreate → 创建 LV（不进行文件系统格式化, BlueStore 直接写裸 LV）
5
             ✅️ BlueStore:  '不依赖任何文件系统,直接在裸盘上存储'

Terminal window

1
root@Ceph-201 ~# vgs
2
  VG                 #PV #LV #SN Attr   VSize     VFree
3
  ceph-023d...f772   1   1   0 wz--n-  <500.00g     0
4
  ceph-6f9f...7035   1   1   0 wz--n- <1024.00g     0
5
  ceph-fadf...ac73   1   1   0 wz--n-  <300.00g     0
6
  ubuntu-vg          1   1   0 wz--n-   <38.00g <8.00g
7
# 👆 卷组名 = ceph-<VG_UUID>（VG_UUID 是 LVM 随机生成的）

Terminal window展开收起

1
'在 Ceph-202 上验证 LVM 结构'
2
root@Ceph-202 ~# lsblk
3
sda                  8:0    0   40G  0 disk
4
├─sda1               8:1    0    1M  0 part
5
├─sda2               8:2    0    2G  0 part /boot
6
└─sda3               8:3    0   38G  0 part
7
  └─ubuntu--vg-ubuntu--lv   252:0    0   30G  0 lvm  /
8
'上面是系统盘'
9
sdb ✅️物理磁盘 'PV'   8:16   0  300G  0 disk
10
└─ceph--fadf...ac73-osd--block--2078...bd8bd   252:1    0  300G  0 lvm
11
sdc ✅️物理磁盘 'PV'   8:32   0  500G  0 disk
12
└─ceph--023d...f772-osd--block--8bb5...f359   252:2    0  500G  0 lvm
13
sdd ✅️物理磁盘 'PV'   8:48   0    1T  0 disk
14
└─ceph--6f9f...7035-osd--block--da9a...7195   252:0    0 1024G  0 lvm
15
# 👆 lsblk 看到的是基于物理磁盘创建的 LV（逻辑卷）
16
'这些逻辑卷被用作 Ceph OSD 的数据存储'

展开收起

📋 命名规律速查：

层级	命名格式	示例（以 sdb 300G 为例）
VG	`ceph-<VG_UUID>` 随机生成的	`ceph-fadf...ac73`
LV 短名	`osd-block-<OSD_FSID>`	`osd-block-2078...bd8bd`
LV 完整名（lsblk）	`ceph--<VG_UUID>-osd--block--<OSD_FSID>`	`ceph--fadf...ac73-osd--block--2078...bd8bd`

📌 规律：ceph- 开头 → ==VG（卷组）==,osd-block- 开头 → ==LV 短名==

LV 完整名 = VG名 + LV短名,lsblk 里看到的就是这个完整名

LV 短名中的 osd-block-<OSD_FSID> = OSD 的 fsid（/var/lib/ceph/<集群>/osd.<N>/fsid）

Terminal window

1
/var/lib/ceph/
2
└── fdc2219c-5344-11f1-8042-000c2990a57e/  <-- '这是集群的 FSID'
3
    ├── cephadm.adad9831..xxx
4
    ├── osd.3 ✅️ OSD 目录
5
    ├── osd.4 ✅️ OSD 目录
6
    ├── osd.5 ✅️ OSD 目录
7
    ├── ...xxx
8
    └── crash
9
root@Ceph-201 osd.0# pwd
10
/var/lib/ceph/<集群>/osd.0
11
'每个 OSD 有一个唯一的 fsid'
12
root@Ceph-201 osd.0# cat fsid
13
2078...bd8bd

对比	Ubuntu 系统盘 LVM	Ceph OSD 数据盘 LVM
PV	`/dev/sda3`（分区）	`/dev/sdb`（整块裸盘）
VG	`ubuntu-vg`	`ceph-<VG_UUID>`
LV 短名	`ubuntu-lv`	`osd-block-<OSD_FSID>`
LV 完整名（lsblk）	`ubuntu--vg-ubuntu--lv`	`ceph--<VG_UUID>-osd--block--<OSD_FSID>`
文件系统	ext4（建在 LV 上）	无（BlueStore 绕过文件系统直接操作裸 LV）
扩容方式	`lvextend` + `resize2fs`	不需要——Ceph 已占满整块盘

📌 一句话：Ceph 底层使用 LVM 技术栈管理每块 OSD 数据盘

PV→VG→LV 三步把裸盘变成 Ceph 可管理的存储单元

BlueStore 直接在 LV 上读写,省掉了文件系统这层中间商

验证 OSD 状态#

image-20260523181615360

Terminal window展开收起

1
1)查看 OSD 树
2
root@Ceph-201 ~# ceph osd tree
3
'每个字段的含义,参考上面的表格'
4
ID  CLASS  WEIGHT   TYPE NAME       STATUS  REWEIGHT  PRI-AFF
5
-1         5.34389  root default
6
-3         1.78130      host Ceph-201
7
 0    hdd  0.29300          osd.0       up   1.00000  1.00000
8
 1    hdd  0.48830          osd.1       up   1.00000  1.00000
9
 2    hdd  1.00000          osd.2       up   1.00000  1.00000
10
-5         1.78130      host Ceph-202
11
 3    hdd  0.29300          osd.3       up   1.00000  1.00000
12
 4    hdd  0.48830          osd.4       up   1.00000  1.00000
13
 5    hdd  1.00000          osd.5       up   1.00000  1.00000
14
-7         1.78130      host Ceph-203
15
 6    hdd  0.29300          osd.6       up   1.00000  1.00000
16
 7    hdd  0.48830          osd.7       up   1.00000  1.00000
17
 8    hdd  1.00000          osd.8       up   1.00000  1.00000
18
'hdd -->机械硬盘'
19
# 9 个 OSD 全部 up ✅️
20

21
2)查看集群健康状态
22
root@Ceph-201 ~# ceph -s
23
  cluster:
24
    id:     fdc2219c-5344-11f1-8042-000c2990a57e
25
    health: HEALTH_OK  ✅️ 健康！
26

27
  services:
28
    mon: 3 daemons, quorum Ceph-201,Ceph-202,Ceph-203 (age 113m) [leader: Ceph-201]
29
    mgr: Ceph-201.cxdvrq(active, since 5h), standbys: Ceph-202.xdeumk
30
    osd: 9 osds: 9 up (since 37m), 9 in (since 39m)    ✅️ 9 个全 up
31

32
  data:
33
    pools:   1 pools, 1 pgs
34
    objects: 2 objects, 449 KiB
35
    usage:   249 MiB used, 5.3 TiB / 5.3 TiB avail    ✅️ 总空间 5.3T
36
    pgs:     1 active+clean

展开收起

📌 集群关键数据：3 节点 × 3 盘 = 9 OSD,总容量 ~5.3 TiB,9/9 在线,状态 HEALTH_OK

OSD 的移除与磁盘清理#

加盘的反向操作——当你需要撤掉某个 OSD 或重新部署时：

Terminal window展开收起

1
1)从集群中删除 OSD 守护进程
2
root@Ceph-201 ~# ceph orch daemon rm osd.0 --force
3
Removed osd.0 from host 'Ceph-201'
4
rm      # 移除 OSD 守护进程（容器停止并被删除）
5
osd.0    # 表示OSD的ID编号
6
--force    # 跳过确认提示,直接执行
7

8
2)擦除磁盘上的 Ceph 数据（恢复为空盘）
9
ceph orch device zap <主机名> <路径> [--force]
10
root@Ceph-201 ~# ceph orch device zap Ceph-201 /dev/sdb --force
11
zap successful for /dev/sdb on Ceph-201
12
zap      # "清零"——销毁 Ceph 建的 LVM 卷、分区、文件系统
13
--force    # 跳过确认提示
14
root@Ceph-201 ~# ceph osd tree
15
ID  CLASS  WEIGHT   TYPE NAME          STATUS  REWEIGHT  PRI-AFF
16
-1         1.78130  root default
17
-3         1.78130      host Ceph-201
18
 0    hdd  0.29300          osd.0      'down'   1.00000  1.00000
19
'已经down掉了'
20
root@Ceph-201 ~# ceph orch device ls
21
Ceph-201  /dev/sdb  hdd  300G  'Yes' ✅️ AVAILABLE为Yes --> 可以重新添加为OSD
22
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdb
23
Created osd(s) 3 on host 'Ceph-201'
24
root@Ceph-201 ~# ceph osd tree
25
ID  CLASS  WEIGHT   TYPE NAME          STATUS  REWEIGHT  PRI-AFF
26
-1         2.07430  root default
27
-3         2.07430      host Ceph-201
28
 0    hdd  0.29300          'osd.0'        down        0  1.00000
29
 1    hdd  0.48830          'osd.1'         up   1.00000  1.00000
30
 2    hdd  1.00000          'osd.2'         up   1.00000  1.00000
31
 3    hdd  0.29300          'osd.3'         up   1.00000  1.00000
32
root@Ceph-201 ~# ceph -s
33
  cluster:
34
    id:     3ca027a7-5400-11f1-a4e3-000c2990a57e
35
    health: HEALTH_WARN ❌️
36
    ⚠️ 此时 `ceph -s` 出现 `1 stray daemon(s)` 告警
37
            1 stray daemon(s) not managed by cephadm
38
            # 一个流浪进程,不被cephadm管理了
39
   services: xxx
40
    osd: 4 osds: 3 up (since 61s), 3 in (since 42s)
41
    '4 个 OSD 记录,但只有 3 个在线'
42
    osd.0 → down（旧号,没人管了）
43
  osd.3 → up  （新盘,新 ID）

展开收起

Terminal window

1
🧱 为什么会有 stray daemon❓️
2

3
ceph orch daemon rm osd.0         → 只删了编排器层（cephadm 视角）的容器进程
4
ceph orch device zap Ceph-201 /dev/sdb  → 磁盘清空
5

6
但是！CRUSH 拓扑层（CRUSH 全局视角）还记着 osd.0：
7
  → CRUSH 说："osd.0 应该在线啊,去哪了？"
8
  → cephadm 说："osd.0 不归我管了"
9
  → 这个没人认领的 OSD 就是 stray daemon（流浪进程）

层面	命令入口	管的	视角
CRUSH 拓扑层	`ceph osd ...`	CRUSH 地图、OSD 状态、数据放置规则	CRUSH 全局视角——“数据该往哪放”
编排器层	`ceph orch ...`	容器/进程、磁盘设备、主机节点	cephadm 视角——“服务跑在哪”

📌 stray daemon 的根因：ceph orch daemon rm 只清了编排器层,CRUSH 拓扑层还记着这个 OSD → 两层不一致 → 集群告警
✅ 正确做法：用 ceph orch osd rm 一条命令同时清两层（停进程 + 清 CRUSH + 可选 zap）,详见 day03 笔记

🔧 如果已经出现 stray daemon,此时 OSD 已经是 down 状态,直接 purge 就行：

Terminal window

1
'从 CRUSH 表彻底删除 → 集群名单踢出'
2
ceph osd purge osd.<旧ID> --yes-i-really-mean-it
3
# stray daemon 的 OSD 已经 down 了（容器早就被 rm 了）,所以直接 purge 不会报错
4
root@Ceph-201 ~# ceph -s
5
  cluster:
6
    id:     3ca027a7-5400-11f1-a4e3-000c2990a57e
7
    health: HEALTH_OK
8
  services:...xxx
9
    osd: 3 osds: 3 up (since 3m), 3 in (since 6m)
10
  '三个osd,三个都在运行'

🔹 osd out 是什么？

Terminal window

1
`osd out` 的作用是 标记 OSD 为"即将退役"
2
触发 PG 恢复——集群自动把该 OSD 上的数据副本搬到其他 OSD,等数据全部搬完后再删盘就不会丢数据
3
============================
4
osd out 之后发生的事：
5
osd.3 上的副本 → 搬到 osd.1 / osd.2 / osd.4 ...
6
PG 状态：recovering → active+clean
7
数据搬完了 → 删 osd.3 就安全了

⚠️ 但实验环境几乎没数据,osd out 反而触发无意义的恢复

集群拼命搬空气,搬完你又加回来,纯属折腾

✅ 删除 OSD — 生产环境 vs 实验环境：

Terminal window展开收起

1
'============================='
2
'  生产环境（有真实数据）— 四步  '
3
'============================='
4
1)标记退役 → 触发 PG 恢复,数据安全搬到其他 OSD
5
root@Ceph-201 ~# ceph osd out osd.3
6
'等待 recovery 完成'
7
# ceph -s 确认 PG 全部 active+clean
8

9
'============================='
10
'  实验环境（没数据）— 三步即可  '
11
'============================='
12
📌 下篇笔记📚有更简单的方法
13
`ceph orch osd rm` ——> 一条命令完成停进程 + 清 CRUSH + 清磁盘
14
2)停进程
15
root@Ceph-201 ~# ceph orch daemon rm osd.3 --force
16

17
3)销户口
18
root@Ceph-201 ~# ceph osd purge osd.3 --yes-i-really-mean-it
19

20
4)清磁盘
21
root@Ceph-201 ~# ceph orch device zap Ceph-201 /dev/sdb --force

展开收起

Terminal window

1
对比：
2
  生产环境：out → daemon rm → purge → zap   （多一步 out,保证数据安全）
3
  实验环境：       daemon rm → purge → zap   （跳过 out,避免无意义恢复）
4
==============================
5
  关键依赖：无论哪种,purge 都必须在 daemon rm 之后（要求 down 状态）

⚠️ zap 不可逆,生产环境慎用；实验环境无所谓

拍快照, 尝试单机部署

五、CRUSH 规则与故障域#

🧱 故障域概念：Ceph 的 CRUSH 算法决定了数据副本如何分布在不同的 OSD 上,而”故障域”定义了故障的隔离边界

*默认情况下,Ceph 按**主机（host）*划分故障域

这意味着 CRUSH 会尽量将同一数据的多个副本放置在不同的主机上

默认规则长什么样❓️

Terminal window

1
root@Ceph-201 ~# ceph osd crush rule dump
2
'查看Ceph集群中的所有CRUSH规则'
3
[
4
    {
5
        "rule_id": 0, <-- 默认规则 ✅️
6
        "rule_name": "replicated_rule",
7
        "type": 1,
8
        "steps": [
9
            { "op": "take", "item": -1, "item_name": "default" },
10
            { "op": "chooseleaf_firstn", "num": 0, "type": "host" },
11
            { "op": "emit" }
12
        ]
13
    }
14
]

📌 chooseleaf_firstn + type: "host" 的执行步骤（假设副本数 = 3）：

Terminal window

1
  ① take default      → 从 CRUSH 树的根节点开始
2
  ② chooseleaf_firstn  → 选 N 台不同的 host,每台 host 下再挑 1 块最佳 OSD
3
     num = 0           → 这里的 0 不是"选 0 个",是"不硬编码"的占位符
4
                       → 实际 N 从存储池的 size 参数动态读取
5
                       → 池 size=3 → 0 等价于 3（如果池 size=2,0 就等价于 2）
6
  Step 1: 选第 1 台 host → 挑该 host 下的一块 OSD → 放副本①
7
  Step 2: 选第 2 台 host（必须和 Step1 不同）→ 挑 OSD → 放副本②
8
  Step 3: 选第 3 台 host（必须和 Step1/2 不同）→ 挑 OSD → 放副本③
9

10
  核心约束：同一台 host 只能被选中一次！

💡 num = 0 的设计意图：让一条 CRUSH 规则能被多个不同副本数的池复用——规则本身不写死数量,而是从池的 size 参数动态读取

num 如果写死成 3,那这条规则就只能给 size=3 的池用,其他池得另建规则

单节点 + 默认规则 = 矛盾

你的单节点 CRUSH 树：

Terminal window

1
  root default
2
   └─ host Ceph-201        ← 只有 1 台主机！
3
       ├─ osd.0 (sdb)
4
       ├─ osd.1 (sdc)
5
       └─ osd.2 (sdd)

CRUSH 尝试放置 3 个副本的过程：

Terminal window

1
  选第 1 台 host → Ceph-201 → 挑 osd.0 → 放副本① ✅
2
  选第 2 台 host → 树里只有 Ceph-201,但它已被选过 → 不能再选 → 失败 ❌
3
  选第 3 台 host → 同上 → 失败 ❌
4

5
  最终结果：3 个副本只放下了 1 个

“只能选 1 块盘”这句话的真正含义：
你有 3 块盘（sdb、sdc、sdd）,盘是够的
但 CRUSH 规则的第一关不是”找盘”,而是”找不同的主机”
每台主机只能被选一次,1 台主机 → 只能过第一关一次 → 只能选到 1 块盘

3 块盘 ≠❌️ 3 个副本存放位置

3 台主机 =✅️ 3 个副本存放位置 ← CRUSH 要的是这个

单节点 HEALTH_WARN 复现#

Terminal window展开收起

1
'主要是在单节点下进行添加OSD设备'
2
# 我这里是进行了恢复快照
3

4
root@Ceph-201 ~# ceph orch host ls
5
HOST      ADDR        LABELS  STATUS
6
Ceph-201  10.0.0.201  _admin
7
1 hosts in cluster
8
'不把其他两台主机添加到集群' <-- 它俩关机状态
9
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdb
10
Created osd(s) 0 on host 'Ceph-201'
11
# 然后直接添加OSD设备
12
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdc
13
Created osd(s) 1 on host 'Ceph-201'
14
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdd
15
Created osd(s) 2 on host 'Ceph-201'
16
root@Ceph-201 ~# ceph -s
17
  cluster:
18
    id:     fdc2219c-5344-11f1-8042-000c2990a57e
19
    health: HEALTH_OK
20
'在我添加完, 立马查看状态 ✅️ OK'
21
可是并没有看到 HEALTH_WARN ❌️

展开收起

⚠️ 加完 3 块 OSD 立刻 ceph -s 看到 HEALTH_OK,是因为 PG 还没完成创建/peering

实测等一会儿再查,状态就变换了❌️,不是版本差异,纯粹是时序问题

Terminal window

1
root@Ceph-201 ~# ceph -s
2
  cluster:
3
    id:     fdc2219c-5344-11f1-8042-000c2990a57e
4
    health: HEALTH_WARN ❌️ "告警暴露出来了"
5
            Reduced data availability: 1 pg inactive   --> 'PG 不活跃'
6
            Degraded data redundancy: 1 pg undersized  --> '副本数不足'
7
                                # 要 3 个只放了 1 个
8
root@Ceph-201 ~# ceph osd pool ls detail
9
'显示集群中所有存储池的详细配置信息'
10
pool 1 '.mgr' replicated size 3 min_size 2 crush_rule 0...
11
replicated size 3  # 副本数=3 → 要放 3 份
12
min_size 2      # 最少 2 个副本才允许读写I/O
13
crush_rule 0    # crush_rule 0 = 默认规则 (type = host)
14
📌 只有 1 台主机 → CRUSH 只能选出 1 块盘 → PG undersized '副本数不足'

创建以 OSD 为故障域的规则#

命令	作用	一句话
`ceph osd crush rule ls`	列出所有规则 ==只列名字==	“有哪些规则”
`ceph osd crush rule dump <规则名>`	查看规则内部细节 ==完整 JSON==	“这条规则内部长什么样”
`ceph osd crush rule create-replicated <规则名> <根节点> <故障域>`	创建副本规则	”起名 + 定根 + 定故障域,三步搞定”
`ceph osd crush rule create-erasure <规则名> <profile名>`	创建纠删码规则	”引用 profile,让规则知道 k/m 和编码算法”

对比维度	副本规则 `create-replicated`	纠删码规则 `create-erasure`
参数	规则名 + 根节点 + 故障域	规则名 + 纠删码 profile
故障域在哪指定	命令里直接写（host / osd / rack）	不在命令里——profile 已声明 k+m,CRUSH 据此选盘
为什么不同	副本 = 简单 copy,不需要额外配置	纠删码要提前定义 k+m 比例、编码算法（jerasure / lrc 等）,这些全在 profile 里

Terminal window展开收起

1
root@Ceph-201 ~# ceph osd crush rule ls
2
replicated_rule    ← 默认,type = host
3

4
1)创建新规则（故障域从 host 降为 osd）
5
'语法：ceph osd crush rule create-replicated <规则名> <根节点> <故障域级别>'
6
root@ceph:~# ceph osd crush rule create-replicated rule_osd default osd
7
root@ceph:~# ceph osd crush rule ls
8
replicated_rule       ← 默认,type = host
9
rule_osd              ← 新建,type = osd
10

11
2)对比两条规则
12
root@ceph:~# ceph osd crush rule dump rule_osd
13
'指定查看我们刚创建的规则 rule_osd'
14
# dump后面紧跟规则名
15
{
16
    "rule_id": 1, <-- 新建规则 ✅️
17
    "rule_name": "rule_osd",
18
    "type": 1,
19
    "steps": [
20
        { "op": "take", "item": -1, "item_name": "default" },
21
        { "op": "choose_firstn", "num": 0, "type": "osd" },
22
        { "op": "emit" }
23
    ]
24
}

展开收起

📌 chooseleaf_firstn + host vs choose_firstn + osd：

Terminal window

1
  type = host (chooseleaf_firstn)        type = osd (choose_firstn)
2

3
  ① 先选 host,再在 host 下选 OSD        ① 直接在 OSD 层选,不管 OSD 属于谁
4
  ② 同一 host 只能被选一次               ② 任何 OSD 都可以被独立选中
5

6
  ┌─────────────────────┐                ┌────────────────────┐
7
  │ root                │                │ root               │
8
  │  └─ host Ceph-201   │                │  ├─ osd.0 → 副本①   │
9
  │      ├─ osd.0 → 副本①|                │  ├─ osd.1 → 副本②   │
10
  │      ├─ osd.1  ✗    |                │  └─ osd.2 → 副本③   │
11
  │      └─ osd.2  ✗    |                │                    │
12
  │                     │                 │ 3 块盘都在同一台     │
13
  │ 只能放 1 个副本       │                 │ 主机上也没关系       │
14
  └─────────────────────┘                 └───────────────────┘

关联存储池到新规则#

Terminal window展开收起

1
ceph osd pool set <存储池名称> <参数名> <参数值>
2
# 将存储池关联到新规则
3
root@Ceph-201 ~# ceph osd pool set .mgr crush_rule rule_osd
4
# rule_osd 我们新建的规则
5
set pool 1 crush_rule to rule_osd
6
===================================
7
`.mgr` 是什么❓️
8
  1.Manager 守护进程的内部存储池,bootstrap(初始化集群) 时自动创建
9
  2.Manager 用它来存设备健康+数据、性能指标、Dashboard 配置等"内部账本",不存用户数据
10
  3.点号开头是命名惯例,表示"系统池"
11
  4.集群启动后第一个池就是它——所以 单节点 HEALTH_WARN 也是它先暴露出来的
12
`Dashboard` 是什么❓️
13
  1.就是 Ceph 自带的 Web 管理界面（端口 8443）
14
  2.你浏览器打开后能看集群健康状态、OSD列表、性能图表、存储池信息等等
15
✅️ Dashboard 配置存在 .mgr 池里指的是
16
  1.你通过 Web 界面做的设置（比如改了登录密码、调了监控告警阈值）
17
  2.Manager进程把这些配置数据写到 .mgr 池里持久化保存
18
  3.这样即使 Manager 重启,配置也不会丢
19

20

21
root@Ceph-201 ~# ceph osd pool ls detail
22
'显示集群中所有存储池的详细配置信息'
23
pool 1 '.mgr' ... crush_rule 1 ...
24
✅️ rule_id 从 0 变成 1
25
# 由默认规则 --> 到新建规则
26
root@Ceph-201 ~# ceph -s
27
  cluster:
28
    health: HEALTH_OK ✅️
29
  ...
30
    pgs:     1 active+clean 🏷️

展开收起

场景速查表#

场景	故障域	副本数	CRUSH 规则	结果
多节点（≥3 台）	host	3	`chooseleaf_firstn` + host	✅ HEALTH_OK
单节点 + 默认规则	host	3	`chooseleaf_firstn` + host	❌ PG undersized 副本数不足
单节点 + 手动改规则	osd	3	`choose_firstn` + osd	✅ HEALTH_OK
单节点 + `--single-host-defaults`	osd	2	`choose_firstn` + osd	✅ HEALTH_OK

🧱 一句话总结：默认 CRUSH 规则 type=host 的本质是**“同一个数据的多个副本必须放在不同主机上”**

宁可少放,也不能全堆在同一台主机（主机一挂所有副本全丢）
单节点实验要么用 --single-host-defaults,要么手动创建 type=osd 的规则

要在单个主机上部署 Ceph 集群,请在引导时使用 --single-host-defaults 标志
此类集群通常不适合生产环境
该标志会自动设置以下配置选项：

global/osd_crush_chooseleaf_type = 0 — 故障域从 host 降为 OSD 级别

默认规则直接就是 osd 故障域,无需手动改

global/osd_pool_default_size = 2 — 默认副本数从 3 降为 2

mgr/mgr_standby_modules = False — 禁用备用 Manager 模块

💡 参考文档：不同部署场景的推荐配置

集群删除（完整流程）#

Terminal window展开收起

1
root@Ceph-201 ~# ceph orch device ls
2
'查看集群可用设备' --> 它们已经添加为OSD(已经被 Ceph 占用,不能再加第二次)
3
  --> NO(不可用,不能再次添加了) Has a FileSystem(有了文件系统)
4
Ceph-201  /dev/sdb  hdd  300G  No❌️
5
Ceph-201  /dev/sdc  hdd  500G  No❌️
6
Ceph-201  /dev/sdd  hdd 1024G  No❌️
7
====================================
8
AVAILABLE = No 不是"坏了",是"已上岗" --> 表示磁盘上有 Ceph 数据
9

10
1)禁用 cephadm 模块（停止所有编排操作）
11
root@Ceph-201 ~# ceph mgr module disable cephadm
12

13
2)获取集群 FSID
14
root@Ceph-201 ~# ceph fsid
15
fdc2219c-5344-11f1-8042-000c2990a57e
16

17
3)在所有主机上清除 Ceph 守护程序和数据
18
'⚠️ 所有节点都要执行！'
19
root@Ceph-201 ~# cephadm rm-cluster --force --zap-osds --fsid fdc2219c-5344-11f1-8042-000c2990a57e
20
--force        # 强制删除 --> "别问我确认,直接干"
21
--zap-osds      # 清除磁盘上的 OSD 数据
22
--fsid fdcxxx    # 指定FSID
23
Deleting cluster with fsid: fdc2219c-...xxx
24
Zapping /dev/sdb...
25
Zapping /dev/sdc...
26
Zapping /dev/sdd...
27
'初始化集群自动创建的文件也都删除了'
28
# No such file or directory
29
root@Ceph-201 ~# ls /etc/ceph/ceph.pub
30
# 到处分发的公钥
31
'都删除了'
32
root@Ceph-201 ~# ls /etc/ceph/ceph.conf
33
# 最小配置文件
34
root@Ceph-201 ~# ls /etc/ceph/ceph.client.admin.keyring
35
# 管理员密钥环
36

37
4)清理残留
38
root@Ceph-201 ~# ceph -s
39
Error initializing cluster client: ObjectNotFound(...) --> ✅️ 集群已不存在
40
root@Ceph-201 ~# rm -rf /etc/ceph/rbdmap
41
root@Ceph-201 ~# > /root/.ssh/authorized_keys
42
'清空 authorized_keys 文件,移除 cephadm bootstrap 写入的 SSH 公钥'

展开收起

⚠️ 注意：

cephadm rm-cluster 需要在所有集群节点上执行

--zap-osds 会彻底清除磁盘上的所有 Ceph 数据

☠️ 清空 OSD 盘上的所有数据

✅️ 不加 —zap-osds 还有救（盘上数据还在,重建 Monitor 就行）

参照下面👇重建集群

你要是想保留数据只重建 Monitor 不加 —zap-osds

手动指定集群 FSID#

它只有一个场景：集群坏了要重建,但你不想丢数据
- 机器还在、盘还在、Ceph数据还在

Terminal window

1
正常装集群：cephadm bootstrap
2
   └── 自动生成一个随机 FSID,OSD 盘上标记的就是这个 ID
3
'FSID 就是集群的"身份证号"'
4

5
root@Ceph-201 ~# ceph fsid
6
fdc2219c-5344-11f1-8042-000c2990a57e
7
# 获取当前FSID号
8
root@Ceph-201 ~# cephadm bootstrap --fsid fdc221...xxx
9
--fsid 用旧 ID  →  磁盘上的 OSD 还认得这个 FSID,数据能恢复

单节点部署#

Terminal window展开收起

1
'单节点 + --single-host-defaults'
2

3
1)设置主机名
4
root@Ceph-201 ~# tail -3 /etc/hosts
5
10.0.0.201 Ceph-201
6
10.0.0.202 Ceph-202
7
10.0.0.203 Ceph-203
8

9
2)使用 --single-host-defaults 重新引导
10
root@Ceph-201 ~# cephadm bootstrap \
11
  --mon-ip 10.0.0.201 \
12
  --single-host-defaults \
13
  --initial-dashboard-password=Oldboy123.com \
14
  --dashboard-password-noupdate \
15
  --allow-fqdn-hostname \
16
  --skip-pull
17

18
Ceph Dashboard is now available at:
19
       URL: https://Ceph-201:8443/
20
      User: admin
21
  Password: Oldboy123.com
22
'单节点优化模式已生效'
23

24
3)查看默认 CRUSH 规则（故障域已是 osd 级别）
25
root@Ceph-201 ~# ceph osd crush rule dump replicated_rule
26
# dump后紧跟的是默认的规则名
27
{
28
    "rule_id": 0, ✅️ 这个0也能说明它是默认的规则
29
    "rule_name": "replicated_rule",
30
    "type": 1,
31
    "steps": [
32
        { "op": "take", "item": -1, "item_name": "default" },
33
        { "op": "choose_firstn", "num": 0, "type": "osd" }, <-- ✅️已经是 osd 级别
34
        { "op": "emit" }
35
    ]
36
}
37

38
4)逐个添加 OSD（也可逐个指定磁盘）
39
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdb
40
Created osd(s) 0 on host 'Ceph-201'
41
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdc
42
Created osd(s) 1 on host 'Ceph-201'
43
root@Ceph-201 ~# ceph orch daemon add osd Ceph-201:/dev/sdd
44
Created osd(s) 2 on host 'Ceph-201'
45
root@Ceph-201 ~# ceph -s
46
  cluster:
47
    id:     3ca027a7-5400-11f1-a4e3-000c2990a57e
48
    health: HEALTH_OK ✅️
49

50
  services:
51
    mon: 1 daemons, quorum Ceph-201 (age 49m) [leader: Ceph-201]
52
    mgr: Ceph-201.ylifrh(active, since 47m), standbys: Ceph-201.eukksl
53
    # 部署了两个 mgr
54
    '一台机器上跑了两个 MGR 守护进程 ——> 一个 active,一个 standby'
55
    osd: 3 osds: 3 up (since 39m), 3 in (since 39m)
56

57
5)验证最终状态
58
root@Ceph-201 ~# ceph osd tree
59
ID  CLASS  WEIGHT   TYPE NAME          STATUS  REWEIGHT  PRI-AFF
60
-1         1.78130  root default
61
-3         1.78130      host Ceph-201
62
 0    hdd  0.29300          osd.0          up   1.00000  1.00000
63
 1    hdd  0.48830          osd.1          up   1.00000  1.00000
64
 2    hdd  1.00000          osd.2          up   1.00000  1.00000
65
root@Ceph-201 ~# ceph osd pool ls detail
66
pool 1 '.mgr' replicated size 2 min_size 1 crush_rule 0 ...
67
'副本数size 2, min_size 1'   # --single-host-defaults 的效果

展开收起

💡 推荐：实验/学习环境用 --single-host-defaults,生产环境严格多节点部署

LinuxOps

函数与数组

函数 && 数组#

函数#

基本概念#

1) 函数定义的三种方式#

2) 函数的传参#

方法1：在函数后传参（位置参数）#

方法2：通过赋值传参#

方法3：通过read读入传参#

3) 函数的变量——local#

4) 函数的返回值#

exit 方式#

return 方式#

错误示范——$? 只能取一次#

5) 主函数#

数组#

基本概念#

数组分类#

定义数组的4种方法#

查看数组#

案例1：数组 + for 探测不连续IP#

案例2：通过索引遍历#

关联数组#

案例3：统计性别出现次数#

案例4：统计系统中每种shell的使用人数#

小结#

循环与case多分支

循环 && case多分支#

初识while#

break跳出循环#

猜数字游戏#

ping脚本#

case语句#

语法结构#

案例1：系统信息查看脚本#

案例2：Nginx启动脚本#

案例3：case或判断表达式#

案例4：跳板机脚本#

完善版跳板机——角色+密码+验证码#

for循环#

语法结构#

案例1：循环数字#

案例2：循环字符串#

案例3：支持序列#

案例4：支持命令#

案例5：支持拼接#

案例6：批量创建用户#

案例7：批量探测IP是否在线#

案例8：从文件读取创建用户#

案例9：给每个用户设置随机密码#

命令行一行for#

案例10：100内能被3整除的数的和#

案例11：for循环从1加到100#

while循环#

语法结构#

案例1：死循环的两种写法#

案例2：循环序列（while版）#

案例3：从1加到100（while版）#

案例4：for vs while 读取文件的关键区别#

案例5：基于文件批量创建用户和密码#

流程控制：break continue exit#

项目练习#

小结#

数值运算与if条件判断

数值运算&&if条件判断#

📦 变量子串#

长度统计#

统计字符串的长度（笔试题）#

统计长度小于 3 的字符串#

子串删除#

从前往后删除#

从后往前删除#

子串替换#

⚙️ 数值运算#

expr — 支持整数、不支持小数#

$(()) — 支持整数、效率最高#

$[] — 不支持小数（老式语法）#

let — 常用于自增/自减#

bc — 支持整数和小数#

`$(())` — 支持整数、效率最高#

`$[]` — 不支持小数（老式语法）#

多整数比较 — `-o` 和 `-a`#

第一种：`sh` / `bash`#

第二种：路径方式（需要 `+x` 执行权限）#

第三种：`source` / `.`（紧跟空格）#

① 交互式 Login Shell — SSH 登录 / tty / `su -`#

② 交互式 Non-login Shell — 终端里敲 `bash` / `su`#

④ 非交互式 Login Shell — `bash -l script.sh`#

📦 `/etc/profile.d/` 机制#

`$n` — 脚本传参#

`$#` — 传参数量#

`$?` — 上一条命令返回结果#

`$$` — 脚本的 PID 号#

`$*` vs `$@` — 所有传参#

`$_` — 最后一个参数#