每位玩家独立存档是怎么做到的?PartyDeck中fuse-overlayfs挂载实战解析

原创2026-10-26 13:33:421,701 阅读

每位玩家独立存档是怎么做到的?PartyDeck中fuse-overlayfs挂载实战解析

PartyDeck 是一款面向 Linux 和 SteamOS 的分屏游戏启动器(split-screen game launcher),最多支持 4 名玩家同屏共玩。它最核心的亮点之一就是:每位玩家拥有独立的存档、设置和角色进度。这背后靠的关键技术是 fuse-overlayfs 挂载——启动时给每个玩家建一个"存档层",游戏的所有写入都落进各自的分层里,原始游戏文件纹丝不动。本文带你从零理解这套机制,并对照源码走一遍完整流程。

PartyDeck分屏游戏实战画面:两名玩家各自操作独立角色、等级进度互不干扰

先想清楚问题: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,它做两件事:

  1. 建 profile:create_profile 在 profiles/{玩家名}/ 下创建标准目录结构——windata/(Windows 游戏的用户目录)、home/(Linux 原生游戏的 HOME)、steam/(Steam 配置)。如果是 Guest 玩家,set_instance_names 会随机分配 .Blinky、.Pinky 这类名字,对局结束后自动清理。
  2. 建存档槽: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 或注入配置的原理(下图启动器界面右下角的提示正是这个约定):

PartyDeck启动器界面:左侧为游戏handler列表,右侧显示L4D2的MOD说明与独立存档配置

  • 每位玩家的挂载点独立: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 没生效""怀疑挂载有问题"时,可以打开调试开关对照排查。

快速上手:在自己机器上启用独立存档

  1. 安装依赖:SteamOS 已预装 fuse-overlayfs;桌面 Linux 用发行版包管理器安装(如 sudo apt install fuse-overlayfs)。缺失时启动会明确报 Fuse-overlayfs executable not found;
  2. 创建 Profile:在 Profiles 菜单为玩家建 profile,首次游玩会自动生成 gamesaves/ 存档槽;
  3. 正常启动游戏:启动后到 ~/.local/share/partydeck/tmp/ 下能看到 game-0/、work-0/ 等挂载目录;
  4. 验证隔离:退出游戏后检查 profiles/{玩家名}/gamesaves/{游戏名}/,里面就是该玩家本次产生的全部存档与配置。

小结

PartyDeck 用一套朴素但强大的组合拳解决了分屏同机的存档冲突问题:

  • fuse-overlayfs 把"游戏目录 + 玩家存档层"叠成独立视图,写入天然隔离、底层零污染;
  • handler overlay 借多层 lowerdir 实现无侵入 MOD 注入;
  • bwrap 补齐输入与 HOME 隔离,让 4 个实例真正"各玩各的"。

理解这套机制后,你甚至能参考 src/launch.rs 的写法,为自己的多开/联机工具实现同样的独立存档方案。

登录后查看全文
partydeck