每位玩家独立存档是怎么做到的?PartyDeck中fuse-overlayfs挂载实战解析
每位玩家独立存档是怎么做到的?PartyDeck中fuse-overlayfs挂载实战解析
PartyDeck 是一款面向 Linux 和 SteamOS 的分屏游戏启动器(split-screen game launcher),最多支持 4 名玩家同屏共玩。它最核心的亮点之一就是:每位玩家拥有独立的存档、设置和角色进度。这背后靠的关键技术是 fuse-overlayfs 挂载——启动时给每个玩家建一个"存档层",游戏的所有写入都落进各自的分层里,原始游戏文件纹丝不动。本文带你从零理解这套机制,并对照源码走一遍完整流程。
先想清楚问题:4 个实例写同一份存档会怎样?
大多数单机游戏的存档写在固定路径里(比如 Documents/ 或游戏目录内的 saves/)。如果 4 个游戏实例直接共享游戏目录:
- 玩家 1 存了档,玩家 2 的进度直接被覆盖;
- 多人同时写同一个文件,轻则互相覆盖,重则存档损坏;
- 想给某个玩家装 MOD 或单独改配置,根本无处下手。
所以 PartyDeck 的思路是:让每个实例"看到"一份只属于自己的游戏目录视图——读的时候共用原文件,写的时候各写各的。这正是 overlay(叠加层)挂载的用武之地。
fuse-overlayfs 是什么?用"图层叠加"理解挂载
fuse-overlayfs 是 overlayfs 的 FUSE 用户态实现,可以把多个目录叠加成一个视图,只需要三个参数:
| 参数 | 角色 | 在 PartyDeck 里对应 |
|---|---|---|
lowerdir |
只读的"底图" | 游戏安装目录(handler 的 overlay/ 优先) |
upperdir |
可写的"上层" | 该玩家的存档目录 gamesaves/{游戏名} |
workdir |
内核要求的临时工作区 | tmp/work-{i} |
行为规则非常直观:
- 读文件:先看 upperdir,没有再按顺序查 lowerdir——所以玩家自己的改动会"盖住"原游戏文件;
- 写文件:触发 copy-up,把文件复制到 upperdir 再修改——底层的原始游戏文件永远不会被碰到。
一句话概括:游戏目录是共享底图,每位玩家的存档槽是各自的上层图层 🧩。
实战解析:PartyDeck 挂载的三步流程
整个启动流程在 src/app/app.rs 中串联:准备 profile → 挂载游戏目录 → 启动实例,三步缺一不可。
第一步:为每个玩家建好存档位
调用链是 setup_profiles,它做两件事:
- 建 profile:create_profile 在
profiles/{玩家名}/下创建标准目录结构——windata/(Windows 游戏的用户目录)、home/(Linux 原生游戏的 HOME)、steam/(Steam 配置)。如果是 Guest 玩家,set_instance_names 会随机分配.Blinky、.Pinky这类名字,对局结束后自动清理。 - 建存档槽:create_profile_gamesave 创建
profiles/{玩家名}/gamesaves/{游戏名}/——这就是稍后 fuse-overlayfs 要用的 upperdir。
所有数据都落在 ~/.local/share/partydeck/ 下(路径定义见 src/paths.rs)。
第二步:给每个实例拼一条 fuse-overlayfs 命令
核心代码在 fuse_overlayfs_mount_gamedirs。它先通过 get_game_rootpath 定位游戏根目录(Steam 游戏会自动按 AppID 找到安装位置),再对每个实例拼出挂载命令。以 2 人游玩 L4D2 为例,实际等价于:
fuse-overlayfs \
-o lowerdir=.../partydeck/handlers/l4d2/overlay:.../steamapps/common/Left_4_Dead_2/left4dead2 \
-o upperdir=.../partydeck/profiles/Blinky/gamesaves/l4d2 \
-o workdir=.../partydeck/tmp/work-0 \
.../partydeck/tmp/game-0
这里有两个精妙细节:
- lowerdir 可以是多层:如果 handler 目录里带了
overlay/子目录,PartyDeck 会把它放在最前面,优先级高于游戏原文件——这就是 handler 能给游戏"无侵入式"打 MOD、替换 HUD 或注入配置的原理(下图启动器界面右下角的提示正是这个约定):
- 每位玩家的挂载点独立:
tmp/game-{i}是挂载点、tmp/work-{i}是工作区、profiles/{玩家名}/gamesaves/{游戏名}是各自的 upperdir——同一份游戏目录,N 个玩家 N 套完全隔离的视图。
最终在磁盘上呈现的目录结构大致如下:
~/.local/share/partydeck/
├── handlers/l4d2/
│ └── overlay/ # handler 级共享覆盖层(MOD/配置)
├── profiles/
│ ├── Blinky/gamesaves/l4d2/ # 玩家1的独立存档(upperdir)
│ └── Poochy/gamesaves/l4d2/ # 玩家2的独立存档(upperdir)
└── tmp/
├── game-0/ work-0/ # 玩家1的挂载点与工作区
└── game-1/ work-1/ # 玩家2的挂载点与工作区
第三步:让游戏从挂载点启动
挂载完成后,launch_cmds 会把每个实例的当前工作目录指向对应的挂载点 tmp/game-{i} 而不是原始游戏目录,并以此为起点拉起 gamescope → bwrap → 游戏本体。于是游戏读到的文件来自"overlay 层 + 游戏目录"的合并视图,而一切写入(存档、配置、缓存)都只落到该玩家的 upperdir 里。
bwrap 则负责另一维度的隔离——屏蔽不属于本实例的输入设备、隔离 HOME 目录——与 fuse-overlayfs 各司其职。
读写流向速查表
| 操作 | 流向 | 结果 |
|---|---|---|
| 读取(引擎加载资源) | upperdir 有则用,否则查 handler overlay → 游戏目录 | MOD 无感替换原文件 |
| 写入(保存进度、改设置) | 仅写入本玩家的 gamesaves/{游戏名}/ |
4 人互不干扰,游戏目录零改动 |
| 删除 | 在上层打删除标记 | 底层原文件依然安全 |
两个影响行为的关键开关
| 配置项 | 默认值 | 作用 |
|---|---|---|
profile_unique_dirs |
开启 | 为每个 profile 提供独立数据目录(Windows 游戏的 C:\Users\steamuser / Linux 的 HOME)。关闭后实例会直接写真实游戏目录(见 config.rs) |
disable_mount_gamedirs |
关闭 | 调试用:强制从原始游戏目录启动、跳过 fuse-overlayfs 挂载,此时 handler 内置 MOD 不再生效(说明文字见 app_pages.rs) |
遇到"MOD 没生效""怀疑挂载有问题"时,可以打开调试开关对照排查。
快速上手:在自己机器上启用独立存档
- 安装依赖:SteamOS 已预装
fuse-overlayfs;桌面 Linux 用发行版包管理器安装(如sudo apt install fuse-overlayfs)。缺失时启动会明确报Fuse-overlayfs executable not found; - 创建 Profile:在 Profiles 菜单为玩家建 profile,首次游玩会自动生成
gamesaves/存档槽; - 正常启动游戏:启动后到
~/.local/share/partydeck/tmp/下能看到game-0/、work-0/等挂载目录; - 验证隔离:退出游戏后检查
profiles/{玩家名}/gamesaves/{游戏名}/,里面就是该玩家本次产生的全部存档与配置。
小结
PartyDeck 用一套朴素但强大的组合拳解决了分屏同机的存档冲突问题:
- fuse-overlayfs 把"游戏目录 + 玩家存档层"叠成独立视图,写入天然隔离、底层零污染;
- handler overlay 借多层 lowerdir 实现无侵入 MOD 注入;
- bwrap 补齐输入与 HOME 隔离,让 4 个实例真正"各玩各的"。
理解这套机制后,你甚至能参考 src/launch.rs 的写法,为自己的多开/联机工具实现同样的独立存档方案。

