文件系统 | 技术站点

文件系统与目录结构

Sun, 04 Jan 2026 00:00:00 +0000

Linux文件系统概述

什么是文件系统？

文件系统是操作系统用于组织、存储和管理数据的方法。它定义了文件在存储设备上的存储格式和访问方式。

┌─────────────────────────────────────────────────────────────┐
│                    文件系统架构                              │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   用户程序 ──→ 文件系统API ──→ VFS（虚拟文件系统）           │
│                         │                                   │
│              ┌──────────┼──────────┐                       │
│              ▼          ▼          ▼                        │
│           ext4        XFS        Btrfs                      │
│              │          │          │                        │
│              └──────────┴──────────┘                        │
│                         │                                   │
│              ┌──────────┴──────────┐                        │
│              ▼                     ▼                        │
│         磁盘分区                 内存                        │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Linux文件系统特点

核心特性

一切皆文件：设备、进程、套接字都作为文件处理
大小写敏感：File.txt 和 file.txt 是不同文件
无文件扩展名强制：扩展名仅用于提示，Linux不依赖扩展名
长文件名支持：支持最多255个字符的文件名

常见Linux文件系统类型

文件系统	特点	适用场景
ext4	稳定可靠，日志功能	通用场景
XFS	大文件高性能	大型企业存储
Btrfs	快照、压缩、校验	现代桌面/服务器
ZFS	企业级特性，完整数据保护	存储服务器
swap	交换空间	内存扩展
vfat	Windows兼容	U盘、移动存储

FHS文件系统层次结构

Linux遵循**Filesystem Hierarchy Standard (FHS)**标准，定义了目录结构和内容。

┌─────────────────────────────────────────────────────────────┐
│                  Linux 根目录结构                            │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   /                                                         │
│   ├── bin/        ──  Essential command binaries           │
│   ├── boot/       ──  Boot loader files                     │
│   ├── dev/        ──  Device files                          │
│   ├── etc/        ──  Configuration files                    │
│   ├── home/       ──  User home directories                  │
│   ├── lib/        ──  Essential shared libraries            │
│   ├── media/      ──  Removable media mount points          │
│   ├── mnt/        ──  Temporary mount points                │
│   ├── opt/        ──  Optional add-on packages              │
│   ├── proc/       ──  Virtual filesystem (process info)     │
│   ├── root/       ──  Root user's home directory            │
│   ├── run/        ──  Runtime data                          │
│   ├── sbin/       ──  System binaries                       │
│   ├── srv/        ──  Service data                          │
│   ├── sys/        ──  Virtual filesystem (kernel info)      │
│   ├── tmp/        ──  Temporary files                       │
│   ├── usr/        ──  User utilities and applications       │
│   └── var/        ──  Variable data (logs, caches)          │
│                                                             │
└─────────────────────────────────────────────────────────────┘

核心目录详解

/bin - 基本命令

存放所有用户都可以执行的二进制命令文件。

# 常用命令
/bin/ls           # 列出目录
/bin/cp           # 复制
/bin/mv           # 移动
/bin/rm           # 删除
/bin/cat          # 查看文件
/bin/mkdir        # 创建目录
/bin/rmdir        # 删除目录
/bin/chmod        # 改变权限
/bin/chown        # 改变所有者
/bin/ping         # 网络测试

/sbin - 系统管理命令

存放只有系统管理员（root）才能执行的系统管理命令。

# 常用命令
/sbin/ifconfig    # 网络配置
/sbin/fsck        # 文件系统检查
/sbin/mkfs        # 创建文件系统
/sbin/iptables     # 防火墙
/sbin/reboot       # 重启
/sbin/shutdown     # 关机
/sbin/partition    # 分区工具

/etc - 系统配置

存放系统和应用程序的配置文件。

# 重要配置目录
/etc/passwd       # 用户账户信息
/etc/shadow       # 用户密码（加密）
/etc/group        # 用户组信息
/etc/fstab        # 文件系统挂载表
/etc/hosts        # 主机名解析
/etc/resolv.conf  # DNS配置
/etc/network/     # 网络配置
/etc/nginx/       # Nginx配置
/etc/apache2/     # Apache配置
/etc/ssh/         # SSH配置

谨慎操作

/etc目录下的配置文件直接控制系统行为。修改前务必备份！

/home - 用户主目录

存放普通用户的主目录，每个用户有一个以用户名命名的子目录。

/home/
├── user1/
│   ├── Desktop/
│   ├── Documents/
│   ├── Downloads/
│   ├── Music/
│   ├── Pictures/
│   ├── Videos/
│   └── .config/        # 用户配置
├── user2/
└── ...

/root - root主目录

root用户（系统管理员）的主目录，与普通用户分离。

/var - 变量数据

存放经常变化的文件，如日志、缓存、数据库等。

/var/
├── log/           # 系统日志
│   ├── syslog     # 系统日志
│   ├── auth.log   # 认证日志
│   ├── dmesg      # 启动信息
│   └── apache2/   # Apache日志
├── cache/         # 应用缓存
├── lib/           # 状态信息
├── spool/         # 打印队列
└── www/html/      # Web根目录

/tmp - 临时文件

存放临时文件，系统重启后可能清空。

tmpfs

很多系统将 /tmp 挂载为 tmpfs（内存文件系统），提供极速读写性能。

/usr - 用户程序

存放用户安装的应用程序和库文件。

/usr/
├── bin/           # 用户命令
├── sbin/          # 用户系统管理命令
├── lib/           # 库文件
├── include/       # 头文件（C/C++）
├── share/         # 架构无关数据
│   ├── man/       # 手册页
│   └── doc/       # 文档
├── local/         # 本地安装程序
└── src/           # 源代码

/proc - 虚拟文件系统

提供内核和进程信息的虚拟文件系统。

# 内核参数
/proc/sys/net/ipv4/ip_forward    # IP转发
/proc/cpuinfo                     # CPU信息
/proc/meminfo                     # 内存信息
/proc/diskstats                   # 磁盘统计
/proc/loadavg                     # 系统负载

# 进程信息
/proc/1234/                       # PID 1234的进程信息
/proc/1234/cmdline                # 启动命令
/proc/1234/environ                # 环境变量
/proc/1234/fd/                    # 打开的文件描述符

/dev - 设备文件

存放设备文件，Linux将硬件设备映射为文件。

# 设备类型
/dev/sda           # 第一块SATA硬盘
/dev/sda1          # 第一块硬盘的第一个分区
/dev/nvme0n1       # NVMe SSD
/dev/null          # 空设备（丢弃所有数据）
/dev/zero          # 零字节生成器
/dev/random        # 随机数生成器
/dev/tty           # 当前终端
/dev/pts/0         # 伪终端

# 设备类型标识
brw-rw----  1 root disk     # 块设备（b）
crw-rw----  1 root video     # 字符设备（c）
lrwxrwxrwx  1 root root     # 符号链接（l）

/boot - 启动文件

存放内核和启动加载器文件。

/boot/
├── vmlinuz-5.15.0-generic    # Linux内核
├── initrd.img-5.15.0-generic # 初始化RAM磁盘
├── config-5.15.0-generic     # 内核配置
├── grub/                     # GRUB启动引导器
│   └── grub.cfg              # 启动菜单配置
└── System.map-5.15.0-generic # 内核符号表

/media 和 /mnt - 挂载点

# /media - 自动挂载的可移动设备
/media/cdrom/        # 光盘
/media/usb/          # U盘

# /mnt - 手动挂载的临时挂载点
/mnt/backup/         # 备份盘挂载点
/mnt/win/            # Windows分区挂载点

文件类型

Linux中有七种文件类型：

┌─────────────────────────────────────────┐
│            文件类型标识                  │
├─────────────────────────────────────────┤
│                                         │
│   -          普通文件 (regular file)    │
│   d          目录文件 (directory)        │
│   l          符号链接 (symbolic link)   │
│   c          字符设备 (character device)│
│   b          块设备 (block device)       │
│   p          管道文件 (pipe)             │
│   s          套接字 (socket)             │
│                                         │
└─────────────────────────────────────────┘

文件类型示例

$ ls -la /dev/
total 0
crw-rw---- 1 root video    226,   0 Jan 15 09:00 card0      # c: 字符设备
crw-rw---- 1 root video    226,   1 Jan 15 09:00 card1      # c: 字符设备
brw-rw---- 1 root disk      8,   0 Jan 15 09:00 sda         # b: 块设备
brw-rw---- 1 root disk      8,   1 Jan 15 09:00 sda1       # b: 块设备
crw-rw-rw- 1 root root       1,   7 Jan 15 09:00 full       # c: 字符设备
prw-r--r-- 1 root root             0 Jan 15 09:00 initctl   # p: 管道
srw-rw-rw- 1 root root             0 Jan 15 09:00 rw-rw-rw-  # s: 套接字
lrwxrwxrwx 1 root root            12 Jan 15 09:00 fd -> /proc/self/fd   # l: 符号链接

文件路径

绝对路径与相对路径

# 绝对路径 - 从根目录开始的完整路径
/etc/nginx/nginx.conf
/home/user/Documents/report.pdf

# 相对路径 - 从当前目录开始的路径
./scripts/backup.sh          # 当前目录下的scripts目录
../config/settings.ini       # 上级目录的config目录
../../var/log/syslog         # 上级目录的上级目录

路径快捷方式

符号	说明	示例
`~`	用户主目录	`~/Documents` = `/home/user/Documents`
`.`	当前目录	`./script.sh`
`..`	上级目录	`cd ..`
`-`	上次目录	`cd -`

文件操作命令

ls - 列出目录内容

# 基本用法
ls                  # 列出当前目录
ls /etc             # 列出指定目录
ls -l               # 详细信息
ls -a               # 包含隐藏文件
ls -lh              # 人类可读大小
ls -lt              # 按修改时间排序
ls -lS              # 按文件大小排序
ls -R               # 递归列出子目录

# 高级用法
ls -la --sort=size  # 按大小排序
ls -la --time=atime # 按访问时间排序
ls -d */            # 只列目录
ls -i               # 显示inode号

# 颜色标识（自动）
# 蓝色: 目录    绿色: 可执行文件    白色: 普通文件
# 青色: 符号链接  红色: 压缩文件    黄色: 设备文件

cd - 切换目录

cd                  # 返回主目录
cd /etc/nginx       # 切换到绝对路径
cd ./projects       # 切换到相对路径
cd ..               # 返回上级目录
cd -                # 返回上次目录
cd ~user            # 切换到指定用户主目录

# pushd/popd - 带记忆的目录切换
pushd /var/log      # 切换并记住当前位置
popd                # 返回上一个位置
dirs                # 显示记住的目录栈

pwd - 显示当前目录

pwd                 # 显示当前绝对路径
pwd -P              # 显示物理路径（解析符号链接）

mkdir - 创建目录

# 基本用法
mkdir newdir                    # 创建单个目录
mkdir dir1 dir2 dir3            # 创建多个目录
mkdir -p project/src/lib        # 递归创建（父目录不存在时自动创建）

# 设置权限
mkdir -m 755 mydir              # 指定权限
mkdir -p ~/backup/$(date +%Y%m%d)  # 使用命令替换

rm - 删除文件/目录

# 删除文件
rm file.txt                     # 删除单个文件
rm -f file.txt                  # 强制删除（不提示）
rm -i file.txt                  # 删除前确认

# 删除目录
rm -r mydir                     # 递归删除目录
rm -rf mydir                    # 强制递归删除（危险！）
rm -r directory1 directory2     # 删除多个目录

# 示例
rm -rf /tmp/*                   # 清空临时目录（常用）

危险操作

rm -rf 删除操作不可恢复！务必确认路径后再执行！

cp - 复制文件/目录

# 基本语法
cp source destination

# 复制文件
cp file.txt /backup/            # 复制到目录
cp file1.txt file2.txt          # 复制并重命名
cp -i file.txt /backup/          # 覆盖前确认

# 复制目录
cp -r mydir /backup/            # 递归复制目录
cp -ra /home /backup/home      # 归档复制（保留属性）

# 高级选项
cp -u source destination        # 只复制更新的文件
cp -v source destination       # 显示详细信息
cp -p source destination       # 保留文件属性

mv - 移动/重命名文件

# 移动文件
mv file.txt /new/location/      # 移动到目录
mv file1.txt file2.txt          # 重命名

# 移动目录
mv olddir newdir                # 重命名目录
mv mydir /other/location/       # 移动目录

# 选项
mv -i file.txt /backup/         # 覆盖前确认
mv -n file.txt /backup/        # 不覆盖已存在的文件
mv -v file.txt /backup/        # 显示详细信息
mv -f file.txt /backup/        # 强制覆盖

ln - 创建链接

# 符号链接（软链接）
ln -s target link_name         # 创建软链接
ln -s /etc/nginx nginx.conf    # 常用写法
ln -sf /new/target link        # 强制覆盖

# 硬链接
ln target hardlink              # 创建硬链接

# 查看链接
ls -la link_name               # 查看链接属性
readlink link_name             # 查看链接目标

软链接 vs 硬链接

特性	软链接	硬链接
本质	指向原文件的路径	指向同一个inode
跨分区	支持	不支持
目录	可以链接目录	不可以链接目录
原文件删除	链接断开	仍可访问

touch - 创建空文件

# 创建空文件
touch newfile.txt              # 创建单个文件
touch file1.txt file2.txt      # 创建多个文件

# 更新时间戳
touch -a file.txt              # 只更新访问时间
touch -m file.txt              # 只更新修改时间
touch -t 202601011200 file.txt # 指定时间戳
touch -r reference.txt file.txt # 使用参考文件的时间戳

file - 判断文件类型

file document.txt              # 查看文件类型
file -z archive.tar.gz         # 查看压缩包内容
file -i filename               # MIME类型输出

stat - 显示文件详细信息

stat filename
# 输出：
#   File: filename
#   Size: 4096        Blocks: 8          IO Block: 4096   regular file
# Device: 801h/2049d  Inode: 131081      Links: 1
# Access: (0644/-rw-r--r--)  Uid: ( 1000/    user)   Gid: ( 1000/    user)
# Access: 2026-01-04 10:00:00.000000000 +0800
# Modify: 2026-01-04 10:00:00.000000000 +0800
# Change: 2026-01-04 10:00:00.000000000 +0800

查找文件

find - 强大的文件搜索工具

# 基本语法
find [路径] [选项] [表达式]

# 按名称查找
find /home -name "*.txt"           # 查找所有txt文件
find /home -iname "*.TXT"          # 忽略大小写
find . -name "file*"               # 通配符搜索

# 按类型查找
find /home -type f                 # 普通文件
find /home -type d                 # 目录
find /home -type l                 # 符号链接
find /home -type b                 # 块设备
find /home -type c                 # 字符设备

# 按大小查找
find /home -size +100M             # 大于100MB
find /home -size -1k               # 小于1KB
find /home -size 10M               # 正好10MB

# 按时间查找
find /home -mtime -7               # 7天内修改
find /home -atime +30              # 30天前访问
find /home -ctime -1               # 今天属性改变
find /home -mmin -30               # 30分钟内修改

# 按权限查找
find /home -perm 755               # 精确权限
find /home -perm -u+x              # 包含执行权限
find /home -perm /222              # 任何写权限

# 按所有者查找
find /home -user username          # 指定用户
find /home -group groupname        # 指定组
find /home -uid 1000               # 指定UID
find /home -nouser                 # 无效用户

# 执行动作
find /home -name "*.log" -delete   # 删除找到的文件
find /home -name "*.txt" -exec cat {} \;     # 执行命令
find /home -name "*.txt" -exec cat {} +      # 批量执行（高效）
find /home -name "*.txt" -print -o -name "*.doc" -print

# 组合条件
find /home -type f -name "*.txt" -size +1M -mtime -7

locate - 快速文件搜索

# 安装并更新数据库
sudo apt install mlocate
sudo updatedb

# 使用
locate filename
locate -i filename                 # 忽略大小写
locate -c filename                 # 显示数量
locate -l 10 filename              # 限制数量
locate -r "regex_pattern"          # 正则表达式

locate vs find

locate依赖数据库，搜索速度快但需定期更新数据库 find实时搜索，精确但较慢

which - 查找命令位置

which python              # 查找python命令
which -a python           # 查找所有同名命令
which -s python           # 只返回状态码

whereis - 查找命令及源码

whereis python
# 输出：python: /usr/bin/python /usr/bin/python3.10 /usr/lib/python3.10 /usr/include/python3.10 /usr/share/man/man1/python.1.gz

压缩与归档

tar - 归档工具

# 创建归档
tar -cvf archive.tar file1 file2 dir1/      # 创建.tar归档
tar -czvf archive.tar.gz dir1/             # 创建.tar.gz压缩
tar -cjvf archive.tar.bz2 dir1/            # 创建.tar.bz2压缩
tar -cJvf archive.tar.xz dir1/              # 创建.tar.xz压缩

# 查看归档内容
tar -tvf archive.tar                        # 列出文件
tar -tvf archive.tar.gz                     # 列出.tar.gz内容

# 解压归档
tar -xvf archive.tar                        # 解压.tar
tar -xzvf archive.tar.gz                    # 解压.tar.gz
tar -xjvf archive.tar.bz2                   # 解压.tar.bz2
tar -xJvf archive.tar.xz                    # 解压.tar.xz

# 解压到指定目录
tar -xzvf archive.tar.gz -C /target/dir/

# 追加文件
tar -rvf archive.tar newfile.txt

# 常用选项
-c, --create        # 创建归档
-x, --extract      # 解压归档
-t, --list         # 列出内容
-v, --verbose      # 详细输出
-f, --file=FILE    # 指定文件名
-z, --gzip         # gzip压缩
-j, --bzip2        # bzip2压缩
-J, --xz           # xz压缩
-C, --directory    # 切换目录
-p, --preserve-permissions  # 保留权限
--exclude=PATTERN  # 排除文件

zip - ZIP压缩

# 压缩
zip archive.zip file1 file2           # 压缩文件
zip -r archive.zip directory/         # 递归压缩
zip -q archive.zip *.txt              # 静默模式
zip -e archive.zip sensitive/         # 加密压缩

# 解压
unzip archive.zip                     # 解压到当前目录
unzip archive.zip -d /target/         # 解压到指定目录
unzip -l archive.zip                  # 列出内容
unzip -o archive.zip                  # 覆盖已存在的文件

# 常用选项
-r, --recursive        # 递归处理
-q, --quiet            # 静默模式
-d, --dest             # 指定目标目录
-e, --encrypt          # 加密
-p, --password         # 指定密码

其他压缩工具

# gzip - 最常用
gzip file.txt                    # 压缩
gunzip file.txt.gz               # 解压
gzip -k file.txt                 # 压缩并保留原文件
gzip -d file.txt.gz              # 解压
gzip -9 file.txt                 # 最大压缩率
gzip -1 file.txt                 # 最快速度

# bzip2 - 更高压缩率
bzip2 file.txt
bunzip2 file.txt.bz2

# xz - 最高压缩率
xz file.txt
unxz file.txt.xz

# 7z
7z a archive.7z files/           # 压缩
7z x archive.7z                   # 解压

磁盘管理

df - 磁盘空间使用

# 基本用法
df                         # 显示所有文件系统
df -h                      # 人类可读格式
df -T                      # 显示文件系统类型
df -i                      # 显示inode使用情况
df -a                      # 显示所有文件系统
df -h /home                # 显示指定挂载点

# 示例输出
$ df -h
Filesystem      Size  Used Avail Use% Mounted on
tmpfs           1.6G  1.3M  1.6G   1% /dev/shm
/dev/sda1       100G   50G   45G  53% /
tmpfs           1.6G   80K  1.6G   1% /dev
tmpfs           320M  1.5M  319M   1% /run

du - 目录空间使用

# 基本用法
du                      # 显示当前目录及子目录大小
du -h                   # 人类可读格式
du -sh                  # 只显示总大小
du -sh *                # 显示各子项大小
du -h --max-depth=1     # 限制深度
du -c                   # 显示总计
du -a                    # 显示所有文件
du -m                    # 以MB为单位

# 实用示例
du -sh /var/log         # 查看日志目录大小
du -h /home | sort -h   # 按大小排序
find /home -type f -exec du -h {} + | sort -h

mount/umount - 挂载管理

# 查看挂载
mount                    # 显示所有挂载
mount | grep /dev/sda    # 查看特定设备
findmnt                  # 树形显示挂载关系
findmnt /dev/sdb1        # 查看特定挂载

# 挂载设备
sudo mount /dev/sdb1 /mnt/usb
sudo mount -o ro /dev/sdb1 /mnt/usb    # 只读挂载
sudo mount -t ntfs /dev/sdb1 /mnt/win  # 指定文件系统
sudo mount -a            # 挂载fstab中的所有设备

# 卸载设备
sudo umount /mnt/usb
sudo umount -l /mnt/usb   # 懒卸载
sudo umount -f /mnt/usb    # 强制卸载

# 常用挂载选项
ro          # 只读
rw          # 读写
remount     # 重新挂载
bind        # 绑定挂载

课后练习

实践任务

练习使用 ls -la 查看各种文件类型
创建目录结构 ~/projects/{src,bin,lib,docs} 并在每个目录创建测试文件
使用 find 命令搜索 /var/log 中最近7天修改的 .log 文件
创建压缩包并练习各种解压选项
使用 df -h 和 du -sh 分析磁盘使用情况
创建一个符号链接指向 /var/log 并观察链接行为

下一篇预告：我们将学习Linux用户与权限管理，理解如何安全地管理系统用户和文件权限。

XFS 文件系统修复指南：诊断、恢复与最佳实践

Wed, 15 Apr 2026 00:00:00 +0000

XFS 文件系统修复指南：诊断、恢复与最佳实践

文档信息

适用系统： RHEL 7/8/9 · CentOS 7/8 · Rocky Linux · AlmaLinux · Ubuntu 20.04+
内核要求： Linux Kernel ≥ 3.10（XFS v5 需 ≥ 3.16）
阅读时间： 约 25 分钟

1. XFS 基础与损坏原因

1.1 XFS 核心架构

XFS 是 SGI 于 1993 年开发的高性能 64 位日志型文件系统，RHEL 7 起成为默认文件系统。其核心结构如下：

XFS 磁盘布局
┌─────────────────────────────────────────────────────────┐
│  Superblock (SB)  │  主超级块，记录文件系统元数据           │
├─────────────────────────────────────────────────────────┤
│  AG 0             │  Allocation Group 0（含独立 SB 副本） │
│    ├─ AGF          │  空闲空间 B+Tree 根                  │
│    ├─ AGI          │  inode B+Tree 根                    │
│    └─ AGFL         │  空闲列表                           │
├─────────────────────────────────────────────────────────┤
│  AG 1 ... AG N    │  每个 AG 独立管理，支持并行 I/O        │
├─────────────────────────────────────────────────────────┤
│  Internal Log     │  日志区（或外部日志设备）               │
└─────────────────────────────────────────────────────────┘

关键概念：

概念	说明
AG（Allocation Group）	分配组，XFS 的并发单元，大文件系统通常有数十至数百个 AG
Superblock	记录块大小、AG 数量、UUID、特性标志等关键元数据
B+Tree	XFS 广泛使用 B+Tree 管理空闲空间、inode、目录项
日志（Log）	保证元数据操作的原子性，损坏日志是 XFS 最常见故障
inode	文件元数据节点，默认 512 字节（XFS v5 可更大）

1.2 损坏的常见原因

磁盘损坏根因分类

硬件层面
  ├─ 存储设备突然断电（最常见）
  ├─ 坏块（Bad Sector）/ 硬件 ECC 错误
  ├─ RAID 控制器故障或缓存数据丢失
  └─ 磁盘固件 Bug / 写入中途掉电

系统层面
  ├─ 内核崩溃（Kernel Panic）时文件系统未 umount
  ├─ 强制 kill -9 正在写入的进程
  ├─ 虚拟机快照回滚导致文件系统不一致
  └─ 时间戳回退（NTP 跳变）

操作层面
  ├─ 误操作 dd / mkfs 覆盖分区
  ├─ 分区调整（resize）操作中断
  └─ 文件系统挂载参数不当（如关闭日志 nobarrier）

2. 损坏诊断与症状识别

2.1 系统日志快速排查

第一步：查看内核日志，识别 I/O 错误：

# 查看最近的文件系统错误
dmesg | grep -iE "xfs|error|corruption|ioerror" | tail -50

# 查看系统日志（systemd）
journalctl -k -p err --since "1 hour ago" | grep -i xfs

# 查看 /var/log/messages（RHEL/CentOS）
grep -i "xfs\|filesystem" /var/log/messages | tail -100

# 实时监控内核日志
dmesg -w | grep -i xfs

典型 XFS 错误消息解读：

# 日志损坏（最常见）
XFS (sdb1): log mount/recovery failed: error -5
XFS (sdb1): Log I/O Error Detected. Shutting down filesystem

# 元数据校验失败（XFS v5 CRC）
XFS (sdb1): Metadata CRC error detected at xfs_agf_read_verify
XFS (sdb1): Corruption detected. Unmounting filesystem

# inode 损坏
XFS (sdb1): corrupt dinode 12345678, ... Unmounting filesystem

# 超级块损坏
XFS (sdb1): bad magic number
XFS (sdb1): SB validate failed with error -22

2.2 文件系统状态检查

# 查看挂载状态
mount | grep xfs
df -hT | grep xfs

# 检查文件系统是否以只读模式重新挂载（损坏的典型表现）
dmesg | grep "remounting read-only"

# 查看块设备信息
lsblk -f
blkid /dev/sdXN

# 检查磁盘 SMART 状态
smartctl -a /dev/sdX
smartctl -t short /dev/sdX   # 触发快速自检

2.3 xfs_check 快速检测

注意

xfs_check 在大文件系统上极慢，已被废弃，推荐使用 xfs_repair -n。

# 只读模式检查（不修复），适合快速确认是否存在问题
xfs_repair -n /dev/sdXN

# 输出解读：
# "No modify flag set, skipping phase X" → 正常，表示只读模式
# "would have fixed ..." → 发现问题，需要实际修复
# "Metadata corruption detected" → 元数据损坏

2.4 故障严重程度评估

级别	症状	建议行动
轻微	文件系统只读重挂、日志需重放	`xfs_repair` 通常可自动修复
中等	部分 inode 损坏、目录项丢失	`xfs_repair` 修复 + 备份恢复丢失文件
严重	超级块损坏、AG 头部损坏	使用备份超级块恢复 + `xfs_repair`
极严重	多 AG 损坏、日志区物理损坏	需结合底层工具 + 数据恢复

3. 修复前必读：黄金原则

数据安全警告

这些原则关乎数据安全，请在操作前逐条确认。

原则一：先备份，再修复

# 对损坏分区做完整镜像（哪怕分区已损坏）
# dd 会跳过读取错误并继续，conv=noerror,sync 填充坏块为零
dd if=/dev/sdXN of=/backup/disk-image.img bs=4M conv=noerror,sync status=progress

# 使用 ddrescue（推荐，比 dd 更强的坏块处理）
ddrescue -d -r3 /dev/sdXN /backup/disk-image.img /backup/rescue.log

# 验证镜像可读
file /backup/disk-image.img
xfs_repair -n /backup/disk-image.img   # 在镜像上先测试

原则二：修复前必须卸载

# XFS 必须在卸载状态下修复（不能在线修复损坏）
umount /dev/sdXN

# 若设备忙，查找并终止占用进程
fuser -mv /mount/point
lsof | grep /mount/point
fuser -k /mount/point   # 强制终止（谨慎）

# 若无法卸载（根分区），进入单用户模式或救援模式
systemctl rescue
# 或通过 LiveCD/LiveUSB 启动

原则三：根分区修复必须离线

# 根分区（/）无法在运行时卸载
# 方法 1：进入救援模式（systemd）
systemctl rescue

# 方法 2：编辑 GRUB，追加 single 或 emergency 启动参数
# 在 GRUB 选项行末尾加：rd.break 或 init=/bin/bash

# 方法 3：使用同发行版 LiveCD 启动后操作

# 方法 4：设置 /etc/fstab 的 fsck 顺序（xfs 通常不自动 fsck）
# XFS 会在挂载时自动重放日志，无需 fsck

原则四：记录操作日志

# 所有修复操作务必记录，便于回溯
script /tmp/xfs-repair-$(date +%Y%m%d-%H%M%S).log
# ... 执行修复操作 ...
exit

4. 核心工具详解

4.1 工具速查

工具	用途	风险等级
`xfs_repair`	文件系统元数据检查与修复	中（会修改文件系统）
`xfs_db`	底层调试、结构查看与手动修改	高（直接操作底层结构）
`xfs_metadump`	导出元数据用于离线分析	低（只读导出）
`xfs_mdrestore`	从 metadump 恢复元数据	中
`xfs_logprint`	解析并打印 XFS 日志内容	低（只读）
`xfs_growfs`	在线扩展文件系统	中
`xfs_freeze`	冻结/解冻文件系统（用于一致性快照）	低
`xfs_info`	查看文件系统参数	低（只读）
`ddrescue`	坏块磁盘镜像恢复	低（源盘只读）

4.2 安装工具包

# RHEL/CentOS/Rocky
yum install -y xfsprogs xfsdump gddrescue

# Ubuntu/Debian
apt install -y xfsprogs xfsdump gddrescue

# 验证安装
xfs_repair -V
xfs_db -V

5. xfs_repair 完整修复流程

xfs_repair 是 XFS 的主要修复工具，采用多阶段检查机制。

5.1 修复阶段说明

xfs_repair 工作阶段

Phase 1: 找到并验证文件系统超级块
Phase 2: 检查 AG 头部结构（AGF / AGI / AGFL）
Phase 3: 扫描 AG 中的 inode，检查 inode 结构
Phase 4: 清理并重建 inode 链接计数
Phase 5: 检查并修复各 inode 的内容（目录/数据块）
Phase 6: 检查目录连接性（确保所有 inode 可达）
Phase 7: 重建 AG 空闲列表
Phase 8: 验证并清理磁盘配额信息（若有）

关键阶段：
- Phase 2 失败 → AG 头部损坏，可能需要备份超级块
- Phase 3 失败 → inode 严重损坏
- Phase 6 产生 lost+found → 有孤立文件

5.2 标准修复步骤

Step 1：只读预检（不修改磁盘）

# 强烈建议先执行只读检查，了解损坏程度
xfs_repair -n /dev/sdXN 2>&1 | tee /tmp/xfs-check.log

# 分析输出
grep -E "ERROR|CORRUPT|would|bad|lost" /tmp/xfs-check.log | head -50

Step 2：执行修复

# 标准修复（最常用）
xfs_repair /dev/sdXN 2>&1 | tee /tmp/xfs-repair.log

# 修复过程中的关键输出说明：
# "Phase X - ..." → 进度正常
# "ERROR: ..." → 发现错误（通常会自动修复）
# "fixed ..." → 已修复
# "disconnected inode XXXXXXXX, moving to lost+found" → 孤立 inode
# "would move inode ... to lost+found" → （-n 模式，实际会处理）

Step 3：强制重置日志（日志损坏时）

# 当 xfs_repair 提示日志损坏，无法正常修复时
# ⚠️ 此操作会丢失未提交的事务（通常可接受）
xfs_repair -L /dev/sdXN 2>&1 | tee /tmp/xfs-repair-L.log

-L 参数说明

强制清零日志，会丢失日志中尚未提交的元数据变更。对于已损坏的文件系统，这通常是必要的，代价是可能丢失最近几秒内的写操作。

Step 4：使用备份超级块修复

# 当主超级块损坏时，使用备份超级块
# 首先找到所有备份超级块的位置
xfs_db -c "sb 0" -c "print" /dev/sdXN   # 查看 agcount 和 agblocks

# 或使用 xfs_repair 自动探测备份超级块
xfs_repair -o ag_stride=<agblocks> /dev/sdXN

# 指定备份超级块位置（AG 编号，从 1 开始）
xfs_repair -b <blocksize> -f -o bhash=<size> /dev/sdXN

# 更简单的方式：让 xfs_repair 自动寻找
xfs_repair /dev/sdXN
# 若失败，尝试：
xfs_repair -v /dev/sdXN   # 详细模式，显示更多信息

Step 5：验证修复结果

# 修复完成后再次只读检查
xfs_repair -n /dev/sdXN

# 若无错误输出，尝试挂载
mount /dev/sdXN /mnt/recovery

# 验证文件系统完整性
ls -la /mnt/recovery/
ls -la /mnt/recovery/lost+found/   # 查看是否有孤立文件

# 查看文件系统信息
xfs_info /mnt/recovery
df -hT /mnt/recovery

5.3 xfs_repair 常用参数

# -n        只读检查，不修改文件系统（Dry Run）
xfs_repair -n /dev/sdXN

# -L        强制清零日志（日志损坏时使用）
xfs_repair -L /dev/sdXN

# -v        详细输出
xfs_repair -v /dev/sdXN

# -d        允许在挂载状态下运行（危险！仅用于根分区单用户模式）
xfs_repair -d /dev/sdXN

# -e        遇到错误立即退出（不尝试修复）
xfs_repair -e /dev/sdXN

# -f        将设备视为普通文件（用于镜像文件修复）
xfs_repair -f /path/to/image.img

# -m <mb>   限制内存使用量（MB），大文件系统修复时可能需要
xfs_repair -m 2048 /dev/sdXN

# -t <secs> 进度报告间隔（秒）
xfs_repair -t 30 /dev/sdXN

# -P        禁用预取（Prefetch），减少内存使用
xfs_repair -P /dev/sdXN

# 组合使用示例
xfs_repair -v -t 30 /dev/sdXN 2>&1 | tee /tmp/repair-$(date +%Y%m%d%H%M%S).log

6. xfs_db 底层调试

xfs_db 是 XFS 的底层调试工具，允许直接查看和修改文件系统结构。高风险，非必要不直接修改。

6.1 只读探查（安全操作）

# 以只读模式启动（推荐）
xfs_db -r /dev/sdXN

# 常用只读命令
xfs_db -r -c "sb" /dev/sdXN              # 查看超级块
xfs_db -r -c "sb 0" -c "print" /dev/sdXN # 打印主超级块内容
xfs_db -r -c "agf 0" -c "print" /dev/sdXN# 查看 AG 0 的空闲块头
xfs_db -r -c "agi 0" -c "print" /dev/sdXN# 查看 AG 0 的 inode 头

# 查看文件系统 UUID
xfs_db -r -c "uuid" /dev/sdXN

# 查看标志位
xfs_db -r -c "sb 0" -c "print features_incompat" /dev/sdXN

6.2 超级块关键字段解读

xfs_db -r -c "sb 0" -c "print" /dev/sdXN
# 重点字段：
# magicnum  = 0x58465342      → 必须为 "XFSB"，否则超级块损坏
# blocksize = 4096            → 块大小（通常 4096 字节）
# dblocks   = XXXXXX          → 数据块总数
# agcount   = XX              → AG 总数
# agblocks  = XXXXXX          → 每个 AG 的块数
# logstart  = XXXXXX          → 日志起始块（内部日志）
# uuid      = XXXXXXXX-...    → 文件系统 UUID
# inprogress = 0              → 必须为 0，为 1 表示修复未完成
# versionnum = ...            → 版本号（v5 特性需要 >= 5）

6.3 查找备份超级块

# 列出所有 AG 的超级块位置
xfs_db -r /dev/sdXN
  sb 0
  print agblocks    # 记下 agblocks 的值，例如 2621440

# 备份超级块位于每个 AG 的第一个块：
# AG 0: block 0 (主超级块)
# AG 1: block agblocks * 1
# AG 2: block agblocks * 2
# ...

# 快速列出所有备份超级块块号
xfs_db -r -c "sb 0" -c "print agblocks agcount" /dev/sdXN
# 假设 agblocks=2621440, agcount=8
# 备份 SB 位于块：2621440, 5242880, 7864320, ...

# 验证备份超级块
xfs_db -r -c "fsblock 2621440" -c "type sb" -c "print" /dev/sdXN

6.4 使用 metadump 导出元数据

# 导出元数据（不含用户数据，可安全传输给专家分析）
xfs_metadump /dev/sdXN /tmp/metadata-$(date +%Y%m%d).xfsdump

# 在另一系统恢复元数据进行分析
xfs_mdrestore /tmp/metadata.xfsdump /tmp/restored-image.img

# 在恢复镜像上进行无损调试
xfs_db -r /tmp/restored-image.img

7. 日志（Journal）恢复

XFS 日志损坏是最常见的故障类型，处理方式如下：

7.1 检查日志状态

# 打印日志内容（只读）
xfs_logprint /dev/sdXN

# 查看日志配置
xfs_info /dev/sdXN | grep -i log

# 检查日志是否干净
xfs_db -r -c "sb 0" -c "print" /dev/sdXN | grep -E "logstart|logblocks|logbsize"

7.2 日志损坏的典型表现

# 挂载时报错
mount: /dev/sdXN: can't read superblock
XFS: log mount/recovery failed: error -5

# xfs_repair 输出
ERROR: The filesystem has valuable metadata changes in a log which needs to
       be replayed.  Mount the filesystem to replay the log, and unmount it
       before re-running xfs_repair.

# 无法挂载也无法重放时
XFS: log mount/recovery failed

7.3 日志恢复步骤

# Step 1: 尝试正常挂载（自动重放日志）
mount /dev/sdXN /mnt/test

# Step 2: 若挂载失败，尝试忽略日志挂载（会丢失未完成事务）
mount -o norecovery,ro /dev/sdXN /mnt/test

# Step 3: 若仍失败，用 xfs_repair 重放日志
xfs_repair /dev/sdXN

# Step 4: 若 xfs_repair 提示日志不可恢复，强制清零
# ⚠️ 最后手段，确保已有备份
xfs_repair -L /dev/sdXN

# Step 5: 确认日志已清理
xfs_logprint /dev/sdXN | head -20
# 正常输出: "no log records"

7.4 外部日志设备

# 若使用外部日志设备（-l 参数挂载的文件系统）
mount -o logdev=/dev/sdYN /dev/sdXN /mnt/test

# xfs_repair 指定外部日志
xfs_repair -l /dev/sdYN /dev/sdXN

# 强制清零外部日志
xfs_repair -l /dev/sdYN -L /dev/sdXN

8. 数据恢复策略

8.1 lost+found 目录处理

xfs_repair 会将无法确定归属的 inode 放入 lost+found：

# 挂载后查看 lost+found
ls -la /mnt/recovery/lost+found/

# lost+found 中的文件命名规则：
# #INODE_NUMBER（例如 #12345678）

# 尝试识别文件类型
file /mnt/recovery/lost+found/*

# 对文本文件，查看内容推断用途
head -5 /mnt/recovery/lost+found/\#12345678

# 批量识别
for f in /mnt/recovery/lost+found/*; do
    echo "=== $f ==="
    file "$f"
    head -2 "$f" 2>/dev/null || echo "[binary file]"
done

8.2 使用 PhotoRec / TestDisk 恢复用户数据

当 XFS 元数据严重损坏，文件无法通过 xfs_repair 恢复时，使用数据雕刻工具：

# 安装
yum install -y testdisk   # RHEL/CentOS
apt install -y testdisk   # Ubuntu

# TestDisk：修复分区表、恢复分区
testdisk /dev/sdX

# PhotoRec：按文件头特征恢复文件（不依赖文件系统）
photorec /dev/sdXN
# → 选择分区 → 选择文件类型 → 选择输出目录 → 开始恢复
# ⚠️ PhotoRec 恢复的文件无原始文件名，需手动整理

8.3 挂载只读镜像进行恢复

# 将磁盘镜像以 loop 方式挂载（只读，安全）
losetup -r -f /backup/disk-image.img
losetup -a   # 查看 loop 设备编号，例如 /dev/loop0

# 修复镜像（不影响原始磁盘）
xfs_repair -f /backup/disk-image.img

# 挂载修复后的镜像
mount -o loop,ro /backup/disk-image.img /mnt/recovery

# 从镜像中拷贝数据
rsync -avH /mnt/recovery/ /data/restored/

9. 特殊场景处理

9.1 根分区（/）损坏修复

# 方案 1：进入 Emergency 模式
# 在 GRUB 启动参数末尾添加：
systemd.unit=emergency.target

# 进入 emergency shell 后
mount -o remount,ro /
xfs_repair /dev/sdaN   # 根分区设备

# 方案 2：使用 LiveCD
# 1. 从 LiveCD 启动
# 2. 识别根分区
lsblk -f
# 3. 修复
xfs_repair /dev/sdaN
# 4. 验证并重启
mount /dev/sdaN /mnt && ls /mnt

9.2 LVM 上的 XFS 修复

# 激活 LVM 卷组
vgscan
vgchange -ay

# 查看逻辑卷
lvdisplay
lvs

# 卸载并修复
umount /dev/vg0/lv_data
xfs_repair /dev/vg0/lv_data

# 若 LVM 元数据也损坏，先修复 LVM
vgcfgrestore -f /etc/lvm/backup/vg0 vg0

9.3 加密分区（LUKS）上的 XFS 修复

# 解锁 LUKS 容器
cryptsetup luksOpen /dev/sdXN xfs_crypt

# 修复内层 XFS
xfs_repair /dev/mapper/xfs_crypt

# 修复完成后关闭
cryptsetup luksClose xfs_crypt

9.4 NFS 导出的 XFS 修复

# 取消所有 NFS 导出
exportfs -ua

# 确认无客户端连接
netstat -an | grep :2049
showmount -a

# 卸载并修复
umount /export/data
xfs_repair /dev/sdXN

# 重新挂载并恢复导出
mount /dev/sdXN /export/data
exportfs -a

9.5 容器/虚拟机环境

# Docker 数据目录（通常为 /var/lib/docker）
# 先停止 Docker
systemctl stop docker

# 修复
xfs_repair /dev/sdXN   # Docker 所在分区

# 若 Docker 使用 overlay2，修复后可能需要重建层
systemctl start docker
docker system prune   # 清理损坏的 layer（会删除所有停止的容器和未使用镜像）

10. 预防性维护

10.1 挂载参数优化

# /etc/fstab 推荐配置
# 格式：设备  挂载点  类型  选项  dump  fsck优先级

# 数据盘（高性能）
/dev/sdXN  /data  xfs  defaults,noatime,nodiratime  0  0

# 重要数据盘（强一致性）
/dev/sdXN  /critical  xfs  defaults,noatime,barrier  0  0

# 参数说明：
# noatime      → 不更新访问时间，减少写 I/O
# nodiratime   → 不更新目录访问时间
# barrier      → 写屏障（默认开启，确保掉电安全）
# nobarrier    → ⚠️ 禁用写屏障（SSD/RAID 带 BBU 时可提升性能，但增加风险）
# logbufs=8    → 增大日志缓冲数（高并发写入场景）
# allocsize=   → 预分配大小（流式写入场景）

10.2 监控脚本

#!/bin/bash
# /usr/local/bin/xfs-health-check.sh
# 建议加入 crontab 每日执行

LOGFILE="/var/log/xfs-health-$(date +%Y%m%d).log"
ALERT_EMAIL="ops@example.com"

echo "=== XFS Health Check $(date) ===" >> "$LOGFILE"

# 检查所有 XFS 分区
while IFS= read -r line; do
    device=$(echo "$line" | awk '{print $1}')
    mountpoint=$(echo "$line" | awk '{print $3}')

    echo "Checking $device ($mountpoint)..." >> "$LOGFILE"

    # 检查 dmesg 中的 XFS 错误
    errors=$(dmesg | grep "XFS.*$device" | grep -i "error\|corrupt" | wc -l)
    if [ "$errors" -gt 0 ]; then
        msg="WARNING: $errors XFS errors found for $device"
        echo "$msg" >> "$LOGFILE"
        echo "$msg" | mail -s "XFS Alert on $(hostname)" "$ALERT_EMAIL"
    fi

    # 检查文件系统使用率
    usage=$(df -h "$mountpoint" | awk 'NR==2 {print $5}' | tr -d '%')
    if [ "$usage" -gt 90 ]; then
        msg="WARNING: $mountpoint is ${usage}% full"
        echo "$msg" >> "$LOGFILE"
        echo "$msg" | mail -s "XFS Disk Space Alert on $(hostname)" "$ALERT_EMAIL"
    fi

done < <(mount | grep "type xfs")

echo "=== Check Complete ===" >> "$LOGFILE"

# 添加到 crontab
echo "0 2 * * * root /usr/local/bin/xfs-health-check.sh" > /etc/cron.d/xfs-health
chmod 644 /etc/cron.d/xfs-health

10.3 定期备份策略

# 使用 xfsdump 进行增量备份（XFS 原生备份工具）
# Level 0 = 全量备份
xfsdump -l 0 -f /backup/data-full-$(date +%Y%m%d).dump /data

# Level 1 = 基于上次 Level 0 的增量
xfsdump -l 1 -f /backup/data-incr-$(date +%Y%m%d).dump /data

# 恢复
xfsrestore -f /backup/data-full-20260101.dump /mnt/restore

# 查看 dump 信息
xfsdump -I   # 列出所有历史 dump 记录

10.4 UPS 与写缓存配置

# 查看磁盘写缓存状态
hdparm -W /dev/sdX

# 对无 BBU 的 RAID 控制器，禁用磁盘写缓存
hdparm -W0 /dev/sdX

# 对有 BBU 的 RAID 控制器，可以启用（通过控制器管理界面）

# SSD 检查是否支持 FUA（强制单元访问）
cat /sys/block/sda/queue/fua

10.5 内核参数调优

# /etc/sysctl.d/99-xfs.conf

# 增大脏数据回写阈值（减少突发 I/O）
vm.dirty_ratio = 10
vm.dirty_background_ratio = 5

# 增大脏数据最大驻留时间（秒）
vm.dirty_expire_centisecs = 3000
vm.dirty_writeback_centisecs = 500

# 应用
sysctl -p /etc/sysctl.d/99-xfs.conf

11. 参考资料

资源	说明
	XFS 内核 Wiki，架构与设计文档
	`man 8 xfs_repair` 完整参数说明
	底层调试工具完整文档
	RHEL 官方文件系统管理指南
	常见问题解答
	GNU ddrescue 官方文档
	数据恢复工具官方文档

快速参考卡

XFS 修复速查

【诊断】
  dmesg | grep -i xfs                   # 查看内核错误
  xfs_repair -n /dev/sdXN               # 只读检查

【标准修复流程】
  1. umount /dev/sdXN                   # 卸载
  2. dd/ddrescue → 备份镜像             # 备份
  3. xfs_repair /dev/sdXN               # 修复
  4. xfs_repair -n /dev/sdXN            # 验证
  5. mount /dev/sdXN /mnt               # 挂载验证

【日志损坏】
  xfs_repair -L /dev/sdXN               # 强制清零日志（最后手段）

【超级块损坏】
  xfs_db -r -c "sb 0" -c "print" /dev/sdXN   # 查看超级块
  xfs_repair /dev/sdXN                        # 自动找备份超级块

【孤立文件】
  ls /mnt/lost+found/                   # 查看孤立 inode

【镜像修复】
  xfs_repair -f /path/to/image.img      # 在镜像上修复

总结

XFS 修复的核心原则是 “备份优先，只读验证，最后动手”。xfs_repair 能处理绝大多数场景，日志损坏时配合 -L 参数，超级块损坏时利用 AG 备份副本恢复。任何操作前务必用 ddrescue 备份原始磁盘镜像，这是数据安全的最后防线。