企业官网建设流程全解析

先说结论：Touhou Project 的 Windows 正作并没有官方 Linux 版。

但这不意味着 Linux 用户玩不了东方，也不意味着打不了 Mod。真正的问题是：游戏怎么跑起来、Mod 放在哪里、加载器怎么兼容、批量管理怎么落地。这篇文章不聊“装个 Windows 虚拟机”这种绕方案，就讲在 Linux 原生环境下，通过 Proton、Wine 和社区补丁工具把东方跑通、把 Mod 打上的完整路线。

如果你手里正好是 Linux 单系统，或者刚从 Windows 迁移过来，想继续玩东方、还想把之前那套 Mod 环境搬过来，这篇文章可以直接收藏。文章会覆盖路线选型、环境检查、Proton/Wine 部署、Mod 投放方式、路径转换、批量脚本和故障排查几个部分。没有“官方 Linux 版”这个定论，不等于“Linux 上不能玩”，关键看你选择哪条兼容路线。

1. Linux 玩东方Project：核心能力速览

先给一张快速判断表，看完你就知道这条路线值不值得折腾。

一个容易误导人的点要先说清楚：很多人在网上搜“Linux 东方”，看到的是弹幕同人引擎作品，比如一些用跨平台框架开发的类 Prayer 游戏。这些不是 ZUN 的官方正作，只是社区同人。正作该走兼容层还是要走兼容层。

2. 适用场景与使用边界

2.1 适用人群

第一种，日常主力系统是 Linux、游戏只占小部分时间的人。你不想为了一个弹幕游戏切到 Windows，也不想开虚拟机，Proton 路线基本能满足。

第二种，Steam Deck 用户。SteamOS 本身就是 Arch Linux 的定制版，东方很多作品能在 Steam 上买到，通过 Proton 运行后打 Mod 的逻辑和桌面 Linux 几乎一样。

第三种，做批量 Mod 管理的玩家。你手里可能有几十个补丁、上百 MB 的立绘替换包、BGM 替换包，在 Linux 下用 rsync 和 shell 脚本整理这类文件，比在 Windows 资源管理器里手动拖拽舒服得多。

2.2 不适合的场景

如果你想打的是“启动器注入型”Mod，比如一些重度依赖 Windows 专属 Hook 的补丁框架，兼容层下不一定稳定。这类工具如果只写了 Windows 进程注入逻辑，在 Wine/Proton 里没法保证行为一致。

如果你追求的是“最小折腾”，那还是 Windows 最省心。Linux 路线要接受一个现实：第一次配环境会花时间，后面稳定了才舒服。

2.3 版权与合规边界

东方Project 有明确的二次创作指南，Mod 和汉化补丁通常属于二次创作范畴，个人使用没问题，但公开分发时要确认是否符合现行规定。只给自己的正版游戏打补丁、只做本地备份，是最稳妥的使用方式。

不要用 Mod 去绕过游戏购买、不要传播未经授权整合包。别碰“免安装版替代原版”这类操作，这不是技术能力问题，是法律和社区规则问题。

3. 整体技术路线：四种方案怎么选

Linux 下玩东方、打 Mod，大致有四条路线。

从材料可见，当前 Linux 生态下讨论最多的是 Steam 工作坊 Mod、通用 Mod 管理器的兼容问题，以及系统本身的环境安装。这条路径和 Proton 路线的重合度很高，所以下面重点展开前面两种。

3.1 为什么首选 Proton

Proton 是 Valve 在 Wine 基础上集成的兼容层，包含了 DXVK、VKD3D-Proton、Wine 补丁等组件。它最大的优势是“开箱即用”：你在 Steam 客户端里打开兼容层选项，装好游戏，点开始，剩下的环境配置 Steam 替你做完了。

对东方的老作品来说，Proton 的表现通常比裸 Wine 更稳定，因为 DXVK 会帮你把 D3D9/D3D11 调用转成 Vulkan，在现代显卡上效率更高。

3.2 什么时候选 Wine/Lutris

你手里如果有 Steam 之外渠道获得的东方同人作品，或者非 Steam 版游戏，那就进 Lutris，用 Wine 前缀单独配置。Lutris 的好处是不同游戏用不同前缀，Mod 环境互不污染，改坏了一个不影响其它实例。

还有一个谨慎的理由：Proton 对 Steam 游戏好使，但有时你在 Steam 客户端里开的某些游戏需要手动注入某些 DLL 时，反而没 Lutris 方便。Lutris 的配置界面里可以直接选 Wine 版本、DXVK 版本、运行参数，更适合排查问题。

3.3 这些路线都能打 Mod 吗

能。Mod 本质是文件替换、插件注入、补丁加载三类，和运行方式不发生冲突。你通过 Proton 跑起来的游戏，目录结构依然在本地磁盘上，补丁工具只要能够访问到游戏可执行文件和资源目录就行。差异只在路径上，这一点后面会详细展开。

4. 环境准备与前置条件

4.1 系统与内核

首选 Debian/Ubuntu 系或者 Arch 系发行版，因为它们对 Steam 和 Wine 的依赖处理最成熟。操作系统版本不用太新，但内核尽量保持在 5.15 以上，对现代显卡驱动的兼容性更好。这里用通用检查模板，实际版本以你的发行版为准。

# 查看发行版信息 cat /etc/os-release # 查看内核版本 uname -a # 确认 CPU 架构 arch

如果你用的是 CentOS/RHEL 系，也能装，但依赖要手动补多一些。从实际体验来讲，Ubuntu 系和 Arch 系玩家社区资料最多，遇坑好搜。

4.2 显卡驱动与 Vulkan 支持

这一步很关键。弹幕游戏虽然是 2D 渲染，但通过 DXVK 转译后，底层是 Vulkan，所以“显卡驱动支持 Vulkan”是硬前提。

• NVIDIA 显卡：装闭源驱动，确认 470 或更新版本
• AMD 显卡：装 Mesa 的 RADV 驱动，一般随系统自带
• Intel 核显：装 Mesa 的 ANV 驱动，近几代核显都能用

验证方法：

# vulkaninfo 存在时直接查看 vulkaninfo --summary # glxinfo 查看 OpenGL 支持 glxinfo -B | grep -i vendor

如果vulkaninfo没有输出，说明缺驱动组件。Debian/Ubuntu 系可以安装mesa-vulkan-drivers、libvulkan1和vulkan-tools。具体包名按发行版仓库为准。没装 Vulkan 之前，启动 Proton 游戏大概率直接闪退或报 DXVK 错误。

4.3 工具链清单

需要安装的核心工具有这些：

• Steam 客户端：Proton 路线的启动入口
• Lutris：Wine 路线的图形化管理工具
• Wine：Lutris 依赖的 Windows 兼容层本体
• Winetricks：安装 DirectX、VC 运行库等组件
• rsync：批量同步和备份 Mod 文件

# Debian/Ubuntu 系示例，实际包名以仓库为准 sudo apt install steam-installer lutris winetricks rsync

注意：不要直接装系统自带的 Wine 版本就以为自己能搞定一切。Modern Wine 需要配合正确的 Windows 前缀、运行库和 DXVK。建议用 Lutris 自带的 Wine 构建版，而不是系统全局的 Wine。

4.4 磁盘空间预留

东方单作游戏体积并不大，几十到几百 MB 是常见区间。但 Wine/Proton 前缀会额外占用几 GB，Mod 文件再叠加，建议预留 20GB 以上空闲空间。

# 查看磁盘剩余空间 df -h ~

如果磁盘只剩 1~2GB，前缀创建都容易失败，更不用说后续 Mod 解压。这个环节别省。

4.5 确认 Steam 兼容层设置

Steam 客户端要根据游戏情况开启 Proton。Steam 默认只对部分游戏启用兼容层，对东方这类老游戏，最好在“设置 -> 兼容性”里打开“为所有其它产品启用 Steam Play”。

选项有两个：

• 为所有其它产品启用 Steam Play
• 启用 Steam Play 对所有其它产品

这两个选项的效果接近，都行。选择后，你的 Steam 库里会多一个“Proton Next”的运行时选项。部分游戏如果默认 Proton 跑不顺，可以切换具体版本，这个由官方兼容性测试结果和社区反馈决定。

5. 安装部署：Steam Proton 路线

5.1 在 Steam 中设置 Proton

打开 Steam，进入设置：

1. 选择“兼容性”
2. 勾选“为所有其它产品启用 Steam Play”
3. 在兼容层版本列表里选择一个 Proton 版本，一般优先选最新稳定版

这个操作等同于给所有 Steam 游戏叠加一个 Wine 兼容层。东方游戏在 Steam 上购买后，直接走这个逻辑。

5.2 安装游戏本体

在 Steam 库中搜索你要玩的东方作品，正常安装。安装完成后，游戏文件在 Steam 库的 common 目录下。

# 常见路径模板，实际以你的库设置为准 ls ~/.local/share/Steam/steamapps/common/

如果 Steam 库设置在其它磁盘分区，路径会不同。可以这样快速定位：

# 全局查找 steamapps 下的 common 目录 find ~ -type d -path "*steamapps/common" 2>/dev/null

5.3 启动与验证

点击“开始游戏”。首次启动时，Proton 会创建前缀、编译 shader 缓存，耗时比 Windows 下久一点，耐心等。成功启动的标志是游戏窗口出现、标题画面音乐正常、键盘方向键能控制自机移动。

如果第一次启动黑屏几秒然后退出，先清理 Proton 目录再试，不要反复点击启动。清缓存的方法是把对应游戏的 compatdata 底部相关目录删掉，让 Steam 重新初始化：

# 先关闭 Steam，再移除对应游戏前缀，注意游戏ID要按实际查 rm -rf ~/.local/share/Steam/steamapps/compatdata/<game_id>

这个命令会把该游戏的前缀缓存删掉，下次启动重建。注意备份存档，存档通常也在 compatdata 里。

5.4 分析 Steam Play 日志

如果启动失败，需要看日志。Steam 客户端对每个游戏都提供“查看游戏文件”的入口，但更直接的方式是在 Steam 启动选项里加一句参数：

PROTON_LOG=1 %command%

加了以后，日志会写在~/steam-<游戏ID>.log，里面能看到 DXVK 初始化、加载 DLL 列表、崩溃点。排查时重点看err:和fixme:两行，前者是错误，后者是未实现的 Win API，很多 fixme 不影响游戏。

6. 安装部署：Wine/Lutris 路线

Proton 适合 Steam 正版。如果你手里的东方游戏来自其它渠道，或者你想用独立 Wine 前缀跑，用 Lutris。

6.1 安装 Lutris 与 Wine

在 Debian/Ubuntu 系，安装方式为：

sudo apt install lutris wine winetricks

Lutris 会自带几个 Wine 版本选择，建议在“上游版本”里选 stable。不要用系统自带 wine 直接跑，很多老游戏需要特定 Wine 版本和组件，手动装很容易缺库。

6.2 为东方游戏单独建前缀

Lutris 的核心是“每游戏一个前缀”，好处是不会互相污染。进入 Lutris，点左上角“+”添加游戏，选择“安装一个 Windows 游戏”。手工模式配置 EXE 路径和 Wine 前缀。

配置要点：

• Wine 版本：选 Lutris 提供的稳定版
• 前缀架构：默认 win64 对多数游戏没问题，老游戏若报错可试试 win32
• DXVK 版本：开启 VKD3D 和 DXVK，能用 Vulkan 就走 Vulkan
• 窗口化：弹幕游戏全屏跑没问题，但调试阶段开窗口化看日志更方便

6.3 启动与日志

Lutris 启动游戏时，可以在界面里点“系统日志”，看到该前缀的 Wine 输出。日志位置通常在：

~/.local/share/lutris/runners/wine/

出现wine: Bad EXE format之类的错误，说明你的游戏 EXE 架构和前缀不匹配，要么换 win32 前缀，要么重新选 EXE。

Lutris 跑老游戏的常见问题主要有三类：缺运行库、缺 D3D 组件、分辨率适配错误。前两类用 Winetricks 装d3dx9vcrun2019这类组件解决；第三类在游戏配置里改分辨率或者强制窗口化。

7. 功能测试与效果验证：原版先跑通

不管是 Proton 还是 Wine，第一条原则相同：先跑通原版，再碰 Mod。原版跑通了，说明基础环境没问题，后面 Mod 出问题时才能确定是 Mod 本身的问题还是兼容层的问题。

7.1 启动检查清单

启动游戏后，按这个顺序确认：

如果第五项有问题，说明 Wine 前缀对“文档”文件夹的映射有问题。存档路径通常在C:\Users\用户名\AppData\Roaming\ShanghaiAlice\th_数字段\score.dat这种位置，但具体以游戏为准。在资源管理器中对应到 Linux 路径，用 find 命令搜.dat文件即可定位：

find ~/.local/share/Steam/steamapps/compatdata/ -name "*.dat" 2>/dev/null

7.2 输入设备：手柄与键盘

东方玩家多数用键盘，这个在 Linux 下没有额外问题。XInput 手柄在 Proton 下通常能被直接识别。如果手柄没反应，检查 Wine 前缀里xinput相关的 DLL 是否加载，或者在 Steam 控制器设置里给该游戏启用“通过 Steam 手动配置”。

7.3 回放与网络功能

本地 Replay 功能存的是文件，兼容层下没问题。东方的网络联机不像现代游戏那样依赖反作弊服务，多半不需要额外配置。如果遇到联机相关组件报错，优先排查 Wine 网络栈设置，但这个不是常见玩法，简单跑通本地即可。

8. MOD 加载与管理：Linux 路径下的核心操作

这个部分是整篇文章的重点。Windows 用户打 Mod 通常很随意，下载压缩包、解压到游戏目录、或者丢给 Mod 管理器。Linux 下要稍微改变思路，但逻辑完全可通。

8.1 MOD 的三种投放方式

第一类：直接资源替换。立绘、BGM、弹幕皮肤这类 Mod，本质是覆盖游戏目录下的原有文件。这种最好处理，复制文件就行。

第二类：补丁工具加载。比如社区常用的 thcrap 这类本地化与补丁框架，它不会覆盖原文件，而是在游戏启动时通过 DLL 注入和文件映射来加载 Mod。这种方式在 Windows 上流行，Linux 兼容层下也可以跑。

第三类：Steam Workshop 订阅。订阅后 Steam 会自动把 Mod 文件下载到你的本地工作坊目录，游戏通过特定机制读取。Proton 下这类目录同样存在，只是路径和 Windows 不同。

绝大部分东方 Mod 不会采取复杂的启动器注入，而是“资源替换 + 补丁读取”的组合，所以 Linux 下完全可控。

8.2 Windows 路径到 Linux 路径的转换

这是最容易踩坑的地方。Windows 下游戏目录可能是：

D:\SteamLibrary\steamapps\common\th_15\th15.exe

Linux 下对应：

/home/你的用户名/.local/share/Steam/steamapps/common/th_15/th15.exe

Steam Workshop 目录映射：

Windows: D:\SteamLibrary\steamapps\workshop\content\<游戏ID>\<ModID> Linux: ~/.local/share/Steam/steamapps/workshop/content/<游戏ID>/<ModID>

Wine 前缀里的“C 盘”映射：

Windows: C:\users\<用户名>\Documents\... Linux: ~/.local/share/Steam/steamapps/compatdata/<游戏ID>/pfx/drive_c/users/<用户名>/Documents/...

这个映射搞清楚，80% 的路径问题都能解决。直接用命令验证：

# 查看某个东方游戏的可执行文件位置 find ~/.local/share/Steam/steamapps/common -name "th*.exe" 2>/dev/null

8.3 thcrap 补丁工具的配置流程

thcrap 是东方社区广泛使用的补丁加载器，它的核心思路是“增量补丁层”。补丁文件不直接覆盖游戏原文件，而是构建一个补丁树，游戏启动时加载之。

在 Linux 下的通用流程：

1. 下载 thcrap 二进制包
2. 解压到独立目录，建议不要放在游戏目录内，单独放在~/mods/thcrap/
3. 配置补丁存储目录和补丁列表
4. 启动 thcrap 时选择目标游戏 EXE
5. 验证补丁生效

# 假设你放在这个目录，替换为实际的版本目录名 THCRAP_DIR="$HOME/mods/thcrap" GAME_EXE="$HOME/.local/share/Steam/steamapps/common/th_15/th15.exe" cd "$THCRAP_DIR" # 这一步启动 thcrap 的配置界面，具体入口以你下载的构建版为准 ./thcrap_configure.sh "$GAME_EXE"

注意：不同版本的 thcrap 构建方式不同，命令写法不完全一样。核心思路是先配置补丁树，再用它启动游戏。如果它报告 DLL 加载失败，检查补丁目录路径是否和配置里的相对路径一致。

8.4 通用 Mod 管理器在 Linux 下的兼容性

很多玩家习惯用图形化 Mod 管理器批处理 Mod 下载和启用。这类管理器多数是 Windows GUI 程序，在 Linux 下需要 Wine 运行。

基本原则：

• 能跑，但要看它依赖的框架。纯 .NET WinForms 程序在 Wine 下通常还能用，依赖 UWP 或者系统组件的会比较痛苦。
• Mod 管理器必须定位到你的游戏路径。如果你通过 Steam 运行游戏，管理器要填 Linux 下的实际路径，不要填 Windows 盘符。
• 有些管理器会把自己放到“我的文档”，对应的 Wine 前缀路径可能藏在 compatdata 下，注意区分。

建议：如果 Mod 数量不多，用脚本代替图形管理器，稳定性和可重复性强很多。

8.5 批量同步与备份脚本

Linux 下批量管理 Mod 文件的最优解是 shell 脚本加 rsync。下面给出一个通用模板，按实际目录替换路径即可。

#!/bin/bash # mod_sync.sh # 用法：把本地 Mod 包同步到指定游戏目录，覆盖同名文件并记录日志 MOD_SRC="$HOME/mods/package/active" GAME_DIR="$HOME/.local/share/Steam/steamapps/common/th_15" if [ ! -d "$MOD_SRC" ]; then echo "Mod source not found: $MOD_SRC" exit 1 fi rsync -av --delete "$MOD_SRC"/ "$GAME_DIR"/ | tee -a "$HOME/mods/sync.log"

使用--delete可以保持 Mod 目录和游戏目录的完全一致，适合“当前只启用一套 Mod”的场景。如果你要在多个 Mod 包之间切换，可以把不同 Mod 包放在不同目录，用同一套脚本换源。

备份脚本更简单：

#!/bin/bash # mod_backup.sh # 备份修改过的资源文件，按日期存放 GAME_DIR="$HOME/.local/share/Steam/steamapps/common/th_15" BACKUP_DIR="$HOME/mods/backup/$(date +%F)" mkdir -p "$BACKUP_DIR" rsync -av "$GAME_DIR"/ "$BACKUP_DIR"/ | tee -a "$HOME/mods/backup.log"

这套脚本的逻辑和 Windows 下用 Mod 管理器“一键还原”本质上一样，但 Linux 下更透明，出了问题能靠日志定位。

8.6 批量任务思路：一次验证多套 Mod

如果你有多个 Mod 包，需要反复测试哪套组合最稳定，可以用这样的流程：

1. 每套 Mod 放在独立目录：~/mods/package/ver1/、~/mods/package/ver2/
2. 写一个切换脚本，拷贝目标目录到游戏目录
3. 启动游戏，录制一局回放，检查回放文件大小和是否完整
4. 用脚本自动做前后校验和对比

# 校验文件是否一致 sha256sum "$GAME_DIR"/th*.dat

这个操作可以批量完成，搭配 cron 定时备份也行。核心价值是“可复现”，你随时能知道当前游戏文件来源于哪套 Mod。

9. 接口 API 与批量任务：没有 API，但有自动化空间

东方正作本身没有对外提供接口 API，不像现代 Web 服务那样能直接调 RESTful 接口。Mod 层面也不存在一个“官方远程服务”，所以这里要直接跳过“接口调用”的常规写法。

但这不意味着没有程序化操作空间。东方有回放文件、存档文件、资源文件，这三类都能用脚本批量处理。比如：

• 批量整理回放文件：按日期重命名、导出到外部目录
• 批量检查 Mod 文件是否完整：用 sha256sum 对全部文件做校验
• 批量改配置文件：用 sed 调整补丁顺序和参数

# 批量改名回放文件，把录制日期作为前缀 for f in ~/.local/share/Steam/steamapps/common/th_15/replay/*.rpy; do date_str=$(stat -c %y "$f" | cut -d' ' -f1) mv "$f" "${f%.rpy}_$date_str.rpy" done

这就是 Linux 环境下相对 Windows 的优势：文件系统操作和脚本自动化天然强大。

10. 资源占用与性能观察

10.1 显存与内存

东方正作是 2D 弹幕游戏，渲染压力集中在 CPU 和传统图形 API 调用。兼容层 DXVK 会把 D3D 转成 Vulkan，会有额外显存占用，但具体数字要看游戏版本、分辨率和 Mod 复杂度，不建议拍脑袋给一个定值。

观察命令：

# NVIDIA 显卡 nvidia-smi # AMD/Intel 可通过功耗与频率工具观察，或用 MangoHud

MangoHud 会叠加在游戏画面上，显示帧率、CPU 占用、显存占用。安装方式随发行版不同，开源工具，在 Proton 游戏里应用很普遍。启动 Steam 游戏时加上MANGOHUD=1 %command%即可看到叠加层。

10.2 CPU 与 Wine 开销

第一次启动游戏时，shader 缓存编译会占 CPU，出现短暂卡顿属正常。之后 DXVK 缓存生效，CPU 占用会明显下降。如果你在弹幕密集时观察到掉帧，先看是不是 shader 缓存未完成，而不是一上来怪 Wine。

10.3 降低资源占用的通用策略

• 关闭系统桌面特效和合成器开销
• 游戏内开启垂直同步
• 分辨率和刷新率按显示器原生值设置，不要为了“更高”强行拉到 4K
• 减少同时启用的 Mod 数量，尤其是大量替换立绘为高分辨率图片的 Mod
• 在 Wine 配置中关闭内置声音节流

这些优化没有特定数字，但方向符合弹幕游戏的特点：稳定 60 帧比高分辨率更重要。

11. 常见问题与排查方法

如果上述表格中的排错没有解决，常见策略是“重建前缀”或“清缓存重跑”。Proton 下删除对应 compatdata 目录即可，Lutris 下删除对应 wineprefix 目录。记住先备份存档。

12. 最佳实践与使用建议

到这里，部署和排查基本聊完。最后把经验浓缩成几条可执行的建议。

第一次上手，不要急着装一堆 Mod。先验证原版加兼容层能跑通，确认帧率和音频正常再加载第一个 Mod。原因很简单：兼容层本身就是变量，Mod 又是新变量，叠加起来出问题你不好定位。

Mod 文件分目录管理。把“下载的 Mod 包”“当前启用的 Mod 集”“备份的原版文件”三目录分开。下载文件不动，启用目录被脚本读取，备份目录保底。这个习惯在 Windows 下也适用，但 Linux 下很容易实现，一行 rsync 就搞定。

批量任务一定要加日志。同步 Mod、切换 Mod、备份文件，脚本里加上tee -a日志，故障排查的信息都在里面。别省这一步。

接口和自动化上，优先用文件级操作而不是进程级操作。东方 Mod 世界的主流是“补丁读取 + 资源注入”，不是“进程注入 + 内存修改”。你不需要写复杂的 API 对接，掌握目录映射和补丁配置就够了。

涉及图片、音频素材的替换，留意素材授权。东方Project 社区对二次创作比较开明，但也有明确规则。个人自用无所谓，一旦要打包分享、做成整合包发布，必须核对版权边界。

Steam Deck 这类 Linux 掌机玩家，可以直接沿用上述流程。SteamOS 下~/.local/share/Steam路径体系一致，Mod 管理脚本同样适用，只是环境变量略有差别，先确认 shell 环境再跑脚本。

最后，如果你是那种喜欢长期保有一套“稳定 Mod 环境”的人，建议写一个README.md放到 Mod 根目录，记录每个 Mod 的版本、来源、用途和游戏版本兼容关系。Windows 下很多人喜欢靠记忆，Linux 下既然有了脚本和文件系统，就把这套结构化习惯也用起来。环境配好后，一个 tab 开游戏、一个 tab 开脚本，工具链稳定，玩起来不会比 Windows 差太多。