目录项、inode 与那条看不见的链

文件系统里最基础的一对分工是:目录项管名字,inode 管实体。目录本质是一张「名字到 inode 号」的映射表(ext4 把它组织成 HTree 索引),文件内容、权限、大小全部长在 inode 上,名字只是贴在映射表里的一张标签。这个分工立刻推出三个常被误解的事实:删除文件(unlink)删的是一条目录项,不是数据本身;同一份数据可以贴任意多张标签,标签数记在 inode 的 link count 里;拷贝与改名是两类完全不同的操作——拷贝生成新 inode,改名只是搬动标签。理解这对分工,硬链接与符号链接的差别、rename 的原子性承诺、以及「文件被删了空间为什么不还」这类问题就都有了统一的解释框架。
本文先拆软硬链接两种「共享名字」的结构差异,再讲 rename 凭什么在 POSIX 层面承诺原子替换、Linux 又如何用 renameat2 把承诺扩展到「两路径互换」,最后落到工程里最有价值的模式:原子发布,以及两个发生在生产上的翻车现场。
flowchart TD
A["目录项 app.conf"] -->|"rename 前"| B["inode 100:旧配置"]
A -->|"rename 后"| C["inode 200:新配置"]
D["发布方"] --> E["写 app.conf.tmp 并 fsync<br/>内容先完整落盘"]
E --> F["rename:目录项一次原子改指向<br/>没有中间态"]
F --> C
B --> G["nlink 归零<br/>最后一个 fd 关闭后数据释放"]
H["握着旧 fd 的读者"] -.->|"继续读到旧 inode<br/>不受替换影响"| B
X["RENAME_EXCHANGE"] -.->|"两条路径一步互换<br/>目录同样适用"| F
硬链接:同一个 inode 的多个名字
ln a b 只做一件事:在目录表里给 a 的 inode 添一条新目录项,同时把 inode 的 link count 加一。此后 a 与 b 地位完全平等——没有「原件与副本」之分,ls -i 看两者 inode 号相同,改任何一个的内容,另一个天然同步(本来就是同一份数据);rm b 只是摘掉一张标签,link count 减一,数据完好;直到最后一张标签被摘、link count 归零且没有进程握着打开的 fd,数据块才真正释放。第 80 篇讲过的「删了文件空间不还」十有八九就是这条规则在起作用:还有硬链接或打开句柄挂着,inode 就不算死。
两个硬性边界必须记住。其一,硬链接不能跨文件系统:inode 号只在单个文件系统内部有意义,跨了就没有统一的「实体」可指。其二,不能给目录建硬链接(. 与 .. 是内核特例):目录树的层级结构靠「每个目录只有一个父目录」维持,允许任意目录硬链接会造出环与多父树,fsck 的遍历语义直接崩塌。另有一条现代防线值得知道:/proc/sys/fs/protected_hardlinks(多数发行版默认开启)禁止对不属于自己的文件建硬链接,堵住了一个经典的 /tmp 攻击面——过去攻击者可以对别人的敏感文件建硬链接,借合法程序的写操作间接篡改,这条 sysctl 让链接作者必须拥有源文件或对它有读写权。
符号链接:独立 inode 里的一个字符串
ln -s target link 创建的是一个全新 inode,类型为符号链接,内容就是 target 这条路径字符串本身——它不指向 inode,只指向「另一条名字」。这决定了它与硬链接的本质差异:跨文件系统随便指(反正只是字符串);可以指向尚不存在的目标(悬空链接不报错,只有真正解析到它时才 ENOENT);有自己的 inode 与权限位(删除符号链接动的是链接自身,rm 到目录链接上会用 rmdir 语义删链接而保留目录)。ext4 的实现里还藏着第 79 篇提过的细节:目标路径不超过约 60 字节时直接存进 inode 的 i_block 区域,不占数据块(fast symlink),更长的路径才分配一个块。
使用符号链接有两笔容易忽略的账。一笔是解析成本:访问符号链接要额外解析一条路径,内核对单次解析的总跳转数有上限(约 40 层,超限报 ELOOP),长链接链或循环链接在这里被拦下。另一笔是语义陷阱:相对路径的符号链接按「链接所在目录」解析而不是按调用者解析——拷贝目录树时链接指向可能悄悄失效,这也是容器镜像里大量使用绝对路径链接或改用硬链接的原因。lstat 与 stat 的分工在此必须分清:stat 解析到目标,lstat 只看链接自身,写监控或备份工具时用错一个,遇到链接目录就会陷入递归深渊。
rename 的原子契约:没有中间态
rename(2) 的承诺值得用一段话郑重写下:在同一个文件系统内,把 old 改名为 new,如果 new 已存在则被原子替换——任何时刻观察 new 这个路径,要么看到完整的旧文件,要么看到完整的新文件,不存在「空的瞬间」「半个文件」或「先删后建」的窗口。多线程读这个路径的读者各拿各的结果:读到旧 inode 的读者继续持有旧数据(打开的 fd 绑定 inode 而非名字),读到新 inode 的读者拿到新数据,互不干扰。这就是原子发布的理论根基:所有发布类操作(配置更新、代码上线、缓存切换)都该建立在这条契约上,而不是建立在「先 rm 再 cp」的赌博上。
契约的边界同样重要:跨文件系统的 rename 返回 EXDEV,mv 此时退化为「拷贝加删除」,原子性荡然无存(下一节现场 B 就是这个坑);new 为已存在的目录时必须为空目录,否则 ENOTEMPTY;目录 rename 搬动的是整个子树,但子树里挂载点与跨文件系统的部分会被留下。还有一个隐蔽的细节:rename 之后旧的目录项消失,但 dcache(下一篇文章的主角)里可能还躺着旧路径的缓存项,读取方不会出错——缓存失效由内核维护——但「刚 rename 完立刻在另一个目录里 stat 旧路径」这类代码要记得失效是异步可见的,程序语义上应该只信任新路径。
RENAME_EXCHANGE:两路径互换的原子开关
Linux 在 renameat2(3.15 起可用)里给了 rename 一个扩展参数位,最有用的是 RENAME_EXCHANGE:把两条路径的目录项一步互换——a 变成 b 的内容,b 变成 a 的内容,目录也适用,全程原子。它解锁的正是「灰度切换」这类场景:两套完整版本各自就位,一条系统调用完成切换,回滚就是再调一次。另一个标志 RENAME_NOREPLACE 提供「原子地不存在才创建」,替代「先 access 再 rename」的竞态写法;RENAME_WHITEOUT 服务于 overlayfs 这类叠层文件系统,应用层较少直接碰。glibc 从 2.28 起提供 renameat2 封装,老系统可用 syscall 直呼。没有这个调用时,「交换」只能靠三次 rename 中转——中间态暴露在窗口里,两文件短暂互为副本,任何依赖「切换期间两版本完整」的逻辑都会踩坑。
原子发布的标准姿势(python 与 shell)
把契约变成代码,python 版本完整覆盖「写临时文件、刷盘、原子替换、刷目录」四步——前三步保证内容完整,最后一步保证目录项变更持久化:
import os, tempfile
def atomic_publish(path: str, data: bytes) -> None:
d = os.path.dirname(os.path.abspath(path))
fd, tmp = tempfile.mkstemp(dir=d, prefix=".publish-") # 与目标同目录:同文件系统
try:
with os.fdopen(fd, "wb") as f:
f.write(data)
f.flush()
os.fsync(f.fileno()) # 内容先落盘,防「rename 后页缓存还没写」
os.replace(tmp, path) # 原子替换:不存在中间态
dfd = os.open(d, os.O_RDONLY) # 再刷目录项本身
try:
os.fsync(dfd)
finally:
os.close(dfd)
except BaseException:
os.unlink(tmp)
raise
atomic_publish("/etc/myapp/config.yaml", b"key: new-value\n")
三个易漏点全部浓缩在这十几行里。临时文件必须与目标同目录——跨目录就可能跨文件系统,EXDEV 之外还有「临时文件在另一块盘、rename 变拷贝」的隐患;os.fsync 在 rename 之前作用于文件内容、之后作用于目录 fd,两个 fsync 缺一不可(缺前者,掉电后 rename 指向的是没写完的文件;缺后者,掉电后 rename 本身可能丢失);os.replace 是跨平台语义正确的选择——Windows 上 os.rename 目标存在时会抛错,replace 才等价 POSIX rename。shell 里的等价写法是 write-tmp-then-mv -T,配合 sync -f 或直接依赖 mv 前显式 sync;而 vim、rsync 等工具默认就走「临时文件加改名」路径(vim 的 backupcopy 设置、rsync 不带 --inplace 的默认行为),「编辑器改配置为什么总没出过半截文件」的答案就在这里。
两个工程现场
现场 A:被截断半秒的配置文件
某服务用 cp new.conf old.conf 做配置热更新,定时器每分钟 reload——线上偶发 reload 失败,日志里是「配置文件为空」与「yaml 解析在第 0 行」。根因是 cp 的默认行为按截断再写入:先把 old.conf 截成零、再流式写新内容,中间几百毫秒里 reload 精确地撞上空文件。低概率、难复现、看栈看不出——这类「偶发读到半截」问题几乎都该往原子性上想。修复就是上文 atomic_publish 的 shell 等价物:写到同目录临时文件、mv 覆盖。顺带审计出同类的两处隐患:nginx 证书更新脚本用了 openssl x509 > server.crt(重定向同样是截断写),改成了临时文件加 mv;监控 agent 读配置的路径加了「读失败立即重试一次」的兜底——兜底不能代替原子性,但能让漏网的写法不至于直接炸。事故的核心教训:凡是被并发读的文件,写入方必须走 rename 发布;凡是 mv 发布的文件,读取方可以永远信任「读到的必然完整」。
现场 B:mv 跨文件系统的两宗罪
一次日志归档迁移,运维用 mv /data/log /archive/log(两个不同文件系统)搬 2TB 数据,mv 内部展开为逐文件拷贝加删除:其一,非原子——拷到一半的文件在 /archive 里是残缺的,下游按目录清单消费的脚本读到半截直接出错;其二,瞬时双倍占用——/data 与 /archive 同时挂着未删完的部分,归档盘容量按单份数据预估,中途告急。复盘后立了两条规矩:跨文件系统搬数据用 rsync(可断点续传、可校验)加最后一步本地 rename 收口,或先归档成单文件再搬;需要「切换生效」语义的一律不跨文件系统——发布目录与版本目录必须同盘,灰度切换用 RENAME_EXCHANGE 或「版本目录加符号链接、链接本身用 rename 换指向」。符号链接换指向的方案在这里值得展开:ln -sfn 的链式写法并非原子(先删后建),正确的做法是先建临时链接 ln -s versions/v2 link.tmp 再 mv -T link.tmp link——链接本身也是目录项,rename 它一样享受原子契约。
小结:规则清单
- 目录项与 inode 分离是理解的支点:硬链接是多标签贴同一 inode,符号链接是独立 inode 里的路径字符串。
- 硬链接不跨文件系统、不给目录建;protected_hardlinks 默认防线别关。
- stat 与 lstat 分清,写遍历工具时先 lstat 防递归;链接解析上限约 40 层,ELOOP 是循环链接的标配错误。
- 同文件系统 rename 是原子替换,跨文件系统是拷贝加删除——发布语义永远留在同一文件系统内。
- 原子发布四步:同目录临时文件、fsync 内容、rename、fsync 目录;python 用 os.replace,shell 用 mv -T。
- A/B 切换用 RENAME_EXCHANGE(glibc 2.28 起有封装);换符号链接指向用「临时链接加 mv -T」,不要用 ln -sfn 链式替换。
下一篇把镜头对准路径解析背后的缓存体系:dcache 与 inode 缓存怎么让第二次 ls 快如闪电、negative dentry 为什么值得单独一节、drop_caches 到底伤了什么——「名字的账」的最后一层。
读者留言
COMMENTS 暂无还没有留言,来说第一句?