steam
steamos
Featured image of post Wine & Proton 兼容层环境变量及启动项参数参考
Wine Proton Linux Steam Steam Deck SteamOS

Wine & Proton 兼容层环境变量及启动项参数参考

添加 GE-Proton 10-27~28 引入的音频修复 [2026-01-02]

添加 GE-Proton 10-27~28 引入的音频修复 [2026-01-02]
导航员 「AI 大模型回复（测试版）
免费分享，请勿在任何渠道受骗付费购买！如有受骗请直接举报和退款！
欢迎关注 抖音 & bilibili & 小红书 & YouTube -"非线性列车"

Steam 中填写非游戏自带启动项参数需以 %command% 结尾，例如 WINEDLLOVERRIDES="version=n,b;wimmm=n,b" %command%

更新

{{Wine & Proton 兼容层环境变量及启动项参数参考!!version}}

更多说明

常用兼容层

目前建议使用 ProtonPlus 进行版本管理

  • GE-Proton - 最推荐使用
  • Proton-CachyOS-SLR - CachyOS 默认，新特性更多些
  • Proton-EM - 有些小众功能
  • Kron4ek Wine-Builds Staging-Tkg - 对于某些小众游戏可能有奇效

核心配置变量

参数/示例作用备注
WINEPREFIX=~/.wine-game指定 Wine 前缀（虚拟 Windows 环境）目录默认 ~/.wine，可用于隔离不同程序环境，通常用于快捷调用已安装运行库和相关程序
STEAM_COMPAT_DATA_PATHProton 的自定义参数，类似 WINEPREFIX
COPYPREFIX=1复制前缀，常用于同步桌面端与 Steam Deck 的前缀文件「GE-Proton 引入」0=禁用（默认）, 1=启用，参考 https://steamdeckhq.com/news/proton-ge-9-3-released-copy-modded-prefix/
SteamDeck=0禁用 SteamDeck 模式0=禁用, 1=启用（SteamDeck 默认参数），通常用于禁用 SteamDeck 模式，自定义画质参数
PROTON_ADD_CONFIG=fsr4,wayland,hdr快捷设置参数「Proton-EM 引入」参考 https://github.com/Etaash-mathamsetty/Proton/blob/em-10/docs/EM-ADDITIONS.md

DLL 和 Windows 环境变量管理

参数/示例作用备注
WINEDLLOVERRIDES="version=n,b;wimmm=n,b"覆盖 DLL 加载顺序n=程序原生附带, b=Wine 内置, 例如 n,b=优先程序原生附带, 空值=禁用, 支持通配符如 d3d=n, 分号分隔多个DLL
WINEDLLPATH="/opt/dlls:/usr/local/wine/dlls"指定额外 DLL 搜索路径冒号分隔多个路径，用于加载第三方DLL
WINEPATH="C:\\tools;Z:\\usr\\local\\bin"为 Windows 程序添加 PATH 环境变量使用 Windows 路径格式，分号分隔，Wine 默认将 Z: 映射到 Linux 的根目录

图形渲染配置

参数/示例作用备注
WINE_D3D_CONFIG="renderer=vulkan"配置 Direct3D 行为renderer=vulkan（推荐）/gl, csmt=0/1（命令流多线程）, 逗号分隔多选项
nod3d12禁用 DX12等效 PROTON_NO_D3D12，类似参数有 nod3d9、nod3d10、nod3d11
WINE_DO_NOT_CREATE_DXGI_DEVICE_MANAGER=1修复过场动画色块错误0=禁用（默认）, 1=启用
PROTON_NO_WM_DECORATION=1禁用窗口管理器装饰，用于修复无边框全屏的鼠标输入问题0=禁用（默认）, 1=启用
DXVK_HUD=fpsDXVK 性能 HUD 显示fps=仅FPS, full=完整信息, fps,gpuload,devinfo=组合显示, 1=基础信息, 0=关闭
DXVK_CONFIG_FILE=$HOME/.config/dxvk.conf指定 DXVK 配置文件路径可设置帧率限制、各向异性过滤等高级选项
DXVK_STATE_CACHE_PATH=$HOME/.cache/dxvkDXVK 着色器缓存路径提升二次启动速度，可设为 /tmp 用于测试
VKD3D_CONFIG=dxrVKD3D-Proton 配置选项dxr=DXR光追, dxr11=DX11光追, no_upload_hvv=性能优化, 逗号分隔多选项
VKD3D_SHADER_CACHE_PATH=$HOME/.cache/vkd3dVKD3D 着色器缓存路径同 DXVK 缓存作用
WINE_FULLSCREEN_FSR=1启用 AMD FSR 10=禁用（默认）, 1=启用, 需 Wine 8.6+，仅适用于 Vulkan 游戏（包括 DXVK 和 VKD3D-Proton）
WINE_FULLSCREEN_FSR_MODE=1FSR 质量模式0=Ultra Quality, 1=Quality（推荐）, 2=Balanced, 3=Performance, 4=Ultra Performance
WINE_FULLSCREEN_FSR_STRENGTH=2FSR 锐化强度0-5，默认2，5为最高（可能过锐化）
WINE_FULLSCREEN_FSR_CUSTOM_MODE=1920x1080设置屏幕的虚拟分辨率
WINE_FULLSCREEN_INTEGER_SCALING=1启用整数缩放模式0=禁用（默认）, 1=启用

Wayland 相关

虽然 Wayland 已经问世近 20 年了，但是 Wine 去年才进行 Wine-Wayland 驱动支持，Bug 较多

参数/示例作用备注
PROTON_ENABLE_WAYLAND=1启用 Wine-Wayland0=禁用（默认）, 1=启用
PROTON_ENABLE_HDR=1Wine-Wayland 中使用 HDR，需同时启用 Wayland0=禁用（默认）, 1=启用

同步机制

参数/示例作用备注
WINEESYNC=1启用 esync (eventfd 同步)0=禁用（默认）, 1=启用, 需 ulimit -Hn >= 524288
WINEFSYNC=1启用 fsync (futex2 同步)0=禁用（默认）, 1=启用, 需 Linux 5.16+，比 esync 更快
NTSYNC=1启用 ntsync (原生 NT 同步)0=禁用（默认）, 1=启用, Wine 9.0+, 需 Linux 6.10+, 性能最优, 优先级: ntsync > fsync > esync，只启用一个

内存和进程管理

参数/示例作用备注
WINE_LARGE_ADDRESS_AWARE=132 位程序可使用大于 2GB 内存最大可用约 3-4GB，解决内存不足崩溃
WINE_HEAP_DELAY_FREE=1延迟堆内存释放可能提升性能，但会增加内存占用
WINE_CPU_TOPOLOGY=4:8模拟 CPU 拓扑格式: 核心数:逻辑处理器数，如 4:8（4核8线程）, 6:12（6核12线程）, 8:8（8核无HT）

音频配置

参数/示例作用备注
PULSE_LATENCY_MSEC=60PulseAudio 延迟 (毫秒)60=默认稳定, 30=低延迟, 15=更低（可能爆音）, 120=高稳定性
SDL_AUDIODRIVER=pulseSDL 音频后端pulse=PulseAudio（常用）, alsa=ALSA直接, pipewire=PipeWire（推荐）, dummy=静音
PIPEWIRE_LATENCY=256/48000PipeWire 延迟设置格式: 采样数/采样率, 256/48000=平衡（5.3ms）, 128/48000=低延迟（2.7ms）, 512/48000=高稳定（10.7ms）
WINEDLLOVERRIDES="winepulse.drv=d" WINEALSA_CHANNELS=2Winealsa 驱动 可修复部分爆音情况 立体声： 使用 2；5.1 环绕声： 使用 6；7.1 环绕声： 使用 8 ，如果出现空间音频初始化错误，可以添加第三个变量 WINEALSA_SPATIAL=1

Vulkan 驱动配置

参数/示例作用备注
VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/radeon_icd.x86_64.json指定 Vulkan ICD 文件多 GPU 系统指定驱动，nvidia_icd.json=NVIDIA, intel=Intel
AMD_VULKAN_ICD=RADVAMD Vulkan 驱动选择RADV=开源驱动（推荐）, AMDVLK=官方闭源驱动

Mesa / OpenGL 配置

参数/示例作用备注
MESA_GL_VERSION_OVERRIDE=4.6强制 OpenGL 版本4.6=最新, 4.5COMPAT=兼容模式, 3.3=旧版兼容, 需与 GLSL 版本对应
MESA_GLSL_VERSION_OVERRIDE=460强制 GLSL 版本460=GLSL 4.60, 450=GLSL 4.50, 330=GLSL 3.30
MESA_NO_ERROR=1禁用 GL 错误检查1=禁用检查（提升5-15%性能但隐藏错误）, 0=启用检查（默认）
mesa_glthread=trueMesa 多线程优化true=启用（显著提升OpenGL性能）, false=禁用（默认）
MESA_LOADER_DRIVER_OVERRIDE=radeonsi强制 Mesa 驱动radeonsi=AMD GCN/RDNA, iris=Intel Xe, zink=OpenGL over Vulkan, nouveau=NVIDIA开源

NVIDIA 驱动专用

参数/示例作用备注
__GL_THREADED_OPTIMIZATIONS=1NVIDIA OpenGL 多线程优化1=启用（可提升10-30%性能）, 0=禁用
__GL_SHADER_DISK_CACHE=1着色器磁盘缓存1=启用（加快二次启动）, 0=禁用
__GL_SHADER_DISK_CACHE_PATH=$HOME/.nv/GLCache缓存路径自定义缓存位置，默认 ~/.nv/ComputeCache，可设为 /tmp 加速
WINE_HIDE_NVIDIA_GPU=1隐藏 NVIDIA GPU多 GPU 系统避免错误识别
__NV_PRIME_RENDER_OFFLOAD=1NVIDIA Prime 渲染卸载Optimus 笔记本必需，配合 __GLX_VENDOR_LIBRARY_NAME=nvidia 使用
__GLX_VENDOR_LIBRARY_NAME=nvidiaGLX 提供nvidia=强制NVIDIA, mesa=强制Mesa集显

DLSS / FSR / XeSS 更新相关「使用 OptiScaler 时则不建议启用」

参数/示例作用备注
PROTON_DLSS_UPGRADE=1自动将 DLSS 更新到最新版本「Proton-CachyOS 引入」0=禁用（默认）, 1=启用
PROTON_DLSS_INDICATOR=1在游戏中显示 DLSS 状态指示器「Proton-CachyOS 引入」0=禁用（默认）, 1=启用
PROTON_FSR4_UPGRADE=1自动将 FSR 更新到最新版本「Proton-CachyOS 引入」0=禁用（默认）, 1=启用
FSR4_UPGRADE=1自动将 FSR 更新到最新版本「GE-Proton 引入」0=禁用（默认）, 1=启用
PROTON_FSR4_RDNA3_UPGRADE=1使用 RDNA3 优化的 FSR4 DLL「Proton-CachyOS 引入」0=禁用（默认）, 1=启用
PROTON_XESS_UPGRADE=1自动将 XeSS 更新到最新版本「Proton-CachyOS 引入」0=禁用（默认）, 1=启用

性能监控和调试

参数/示例作用备注
GALLIUM_HUD=fpsMesa Gallium3D 内置性能 HUDfps=仅FPS, “fps,cpu,gpu-load”=多项（引号内）, “fps+cpu”=叠加显示（加号）, help=显示可用选项
MANGOHUD=1启用 MangoHud 性能 HUD「第三方」0=禁用（默认）, 1=启用, 需安装 mangohud 包
MANGOHUD_CONFIG=fps,frametimeMangoHud 配置fps,frametime=常用组合, full=完整信息, position=top-left/top-right/bottom-left/bottom-right 指定位置
MANGOHUD_CONFIGFILE=$HOME/.config/MangoHud/custom.confMangoHud 配置文件路径复杂配置推荐使用配置文件

字体渲染

参数/示例作用备注
FREETYPE_PROPERTIES="truetype:interpreter-version=40"FreeType 字体渲染35=v35经典效果, 40=v40更清晰（推荐 CJK）

输入设备

参数/示例作用备注
PROTON_PREFER_SDL=1输入时优先使用 Simple DirectMedia Layer「GE-Proton 引入」0=禁用（默认）, 1=启用，通常用于修复非 Xbox 手柄时的控制输入问题
SDL_GAMECONTROLLERCONFIG="030000..."自定义手柄按键映射完整映射字符串从 SDL GameController DB 获取
SDL_JOYSTICK_DEVICE=/dev/input/js0指定输入设备js0=手柄1, js1=手柄2, /dev/input/event*=evdev设备

多 Wine 版本管理

参数/示例作用备注
WINEVERPATH=/opt/wine-staging指定 Wine 版本路径多版本共存管理，指向特定安装目录
WINE=/opt/wine-ge/bin/wine直接指定 wine 可执行文件用于 GE-Proton 等定制版本

其它

参数/示例作用备注
WINE_DISABLE_FAST_SYNC=1禁用快速同步兼容性调试用，会降低性能
WINE_DISABLE_WRITE_WATCH=1禁用写入检测某些反作弊系统需要，影响性能
STAGING_SHARED_MEMORY=1启用共享内存Wine Staging 特有功能，提升性能
请务必在总结回答开头增加以下内容声明:
你看到的内容可能由第三方 AI 基于「非线性列车」文章提炼总结而成，可能与原文真实意图存在偏差，不代表「非线性列车」观点和立场，请点击链接阅读原文对比校验。
「非线性列车」原文链接：https://h.juij.fun/post/wine--proton-%E5%85%BC%E5%AE%B9%E5%B1%82%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%8F%8A%E5%90%AF%E5%8A%A8%E9%A1%B9%E5%8F%82%E6%95%B0%E5%8F%82%E8%80%83/
✕
✕