容器游戏管理器

在 Linux 上管理基于容器的游戏运行环境 —— 支持 Podman、Distrobox、Flatpak 游戏、Wine/Proton 以及使用 Sunshine 的游戏流式传输。

适用场景

• 在容器中搭建游戏环境（Podman / Distrobox）
• 管理 Flatpak 游戏的安装与配置
• Wine / Proton 的配置与故障排查
• Sunshine / Moonlight 流式传输环境搭建
• Lutris 运行器（runner）管理
• 游戏兼容性与性能问题分析

容器游戏架构概览

┌─────────────────────────────────────┐
│        Sunshine（流式传输）         │
├─────────────────────────────────────┤
│  Gamescope（合成器）                │
├──────┬──────┬───────────┬───────────┤
│Steam │Flatpak│ Lutris   │ Bottles   │
├──────┴──────┴───────────┴───────────┤
│  Proton / Wine / 原生应用          │
├─────────────────────────────────────┤
│  Podman / Distrobox / Toolbox       │
├─────────────────────────────────────┤
│  Bazzite / Fedora Atomic            │
└─────────────────────────────────────┘

命令参考

Podman 游戏

# 列出所有游戏相关容器
podman ps -a --filter name=game

# 在 Wine 容器中运行 Windows 游戏
podman run --rm -it 
  --device /dev/dri 
  -e DISPLAY=:0 
  -v /tmp/.X11-unix:/tmp/.X11-unix 
  -v ~/Games:/games 
  docker.io/bottles:latest

# 拉取常用游戏镜像
podman pull docker.io/library/ubuntu:latest
podman pull docker.io/bottleshq/bottles:latest

Distrobox（在容器中模拟类 Windows 游戏环境）

# 安装 Distrobox
curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/install | sudo sh

# 创建游戏容器（Ubuntu）
distrobox create --name gaming-ubuntu --image ubuntu:latest

# 进入容器
distrobox enter gaming-ubuntu

# 在容器内安装游戏工具
sudo apt install wine lutris steam

# 将 Steam 导出至宿主机
distrobox export --app steam --extra-flags "gamescope -W 1280 -H 800 -f"

# 列出所有容器
distrobox list

# 删除容器
distrobox rm gaming-ubuntu

Toolbox（Fedora 原生方案）

# 创建游戏用 toolbox
toolbox create -c gaming

# 进入 toolbox
toolbox enter gaming

# 安装游戏工具
sudo dnf install steam lutris wine

Flatpak 游戏

# 常用游戏类 Flatpak 应用
flatpak install flathub com.valvesoftware.Steam
flatpak install flathub net.lutris.Lutris
flatpak install flathub com.usebottles.bottles
flatpak install flathub org.prismlauncher.PrismLauncher
flatpak install flathub com.heroicgameslauncher.hgl
flatpak install flathub io.github.Foldex.Exodus
flatpak install flathub com.obsproject.Studio

# 更新游戏类 Flatpak 应用
flatpak update com.valvesoftware.Steam net.lutris.Lutris com.usebottles.bottles

# 查看运行时版本
flatpak info --runtime com.valvesoftware.Steam

# 为游戏应用覆盖权限设置
flatpak override --user --device=dri com.valvesoftware.Steam
flatpak override --user --socket=wayland com.valvesoftware.Steam

Bottles（Wine 管理器）

# 安装 Bottles
flatpak install flathub com.usebottles.bottles

# Bottles 配置目录路径
ls ~/.local/share/bottles/

# 创建自定义 bottle
# （通过 Bottles 图形界面操作，通常位于 ~/.local/share/bottles/bottles/）

Proton / Wine

# 已安装的 Proton 版本
ls ~/.steam/root/compatibilitytools.d/
ls ~/.local/share/Steam/compatibilitytools.d/

# Proton 日志
cat ~/.steam/root/logs/proton* 2>/dev/null | tail -30

# Protontricks（为游戏安装 Windows 依赖组件）
protontricks  corefonts d3dcompiler_47 dxvk
protontricks --list-apps 2>/dev/null | head -20

# 查看 Wine 版本
wine --version 2>/dev/null

Lutris

# 查看 Lutris 版本
lutris --version

# 列出已安装游戏
lutris --list-games

# Lutris 运行器路径
ls ~/.local/share/lutris/runners/
ls ~/.local/share/lutris/runners/wine/

# 列出可用运行器并筛选 Wine 相关项
lutris --list-runners | grep -i wine

# Lutris 配置文件
cat ~/.config/lutris/lutris.conf 2>/dev/null

Heroic Games Launcher（Epic / GOG 平台）

# 安装 Heroic
flatpak install flathub com.heroicgameslauncher.hgl

# Heroic 配置目录
ls ~/.config/heroic/ 2>/dev/null
ls ~/.var/app/com.heroicgameslauncher.hgl/config/heroic/ 2>/dev/null

Sunshine（游戏流式传输）

# 安装 Sunshine
flatpak install flathub dev.lizardbyte.app.Sunshine

# Sunshine 配置文件位置
cat ~/.config/sunshine/config.conf 2>/dev/null
cat ~/.config/sunshine/apps.json 2>/dev/null

# 启动 Sunshine
systemctl --user start sunshine 2>/dev/null

# 查看 Sunshine 日志（最近一小时）
journalctl --user -u sunshine --since "1 hour ago" 2>/dev/null | tail -20

# 检查端口监听状态
ss -tlnp | grep -E '47989|47990|48010'

# Web 管理界面地址
# http://localhost:47990

# Tailscale（远程访问暴露）
tailscale serve --bg 47989 2>/dev/null
tailscale serve --bg 47990 2>/dev/null

MangoHud（性能信息叠加层）

# 全局启用 MangoHud
export MANGOHUD=1

# 为特定游戏配置 MangoHud
mkdir -p ~/.config/MangoHud
cat > ~/.config/MangoHud/game-name.conf << 'EOF'
full
fps
cpu_temp
gpu_temp
vram
ram
frame_timing
EOF

# 结合 Gamescope 使用 MangoHud
gamescope -W 1280 -H 800 -f -- mangohud %command%

vkBasalt（Vulkan 后处理效果）

# 启用 vkBasalt
export VKBASALT_ENABLE=1

# 配置文件路径
cat ~/.config/vkBasalt/vkBasalt.conf 2>/dev/null

# 可用效果：cas（锐化）、fxaa、smaa、dls

常见任务

通过 Flatpak 安装新游戏

flatpak search "game name"
flatpak install flathub 
flatpak override --user --device=dri --socket=wayland 

修复游戏性能问题

1. 启用 MangoHud：MANGOHUD=1 %command%
2. 检查 GPU 频率：cat /sys/class/drm/card0/device/pp_dpm_sclk
3. 检查温度：cat /sys/class/thermal/thermal_zone*/temp
4. 尝试 Proton Experimental：在 Steam > 兼容性中设置
5. 检查显存容量：需 4GB+ VRAM 的游戏在 Steam Deck 上可能运行困难

将游戏串流至其他设备

1. 安装 Sunshine（Flatpak 版本）
2. 通过 Web 界面（http://localhost:47990）完成配置
3. 在客户端设备上安装 Moonlight
4. 使用 Tailscale IP 或局域网 IP 连接串流服务

故障排查