Dad's MMO Lab MU Online传奇单机教程:OpenMU离线服务器从零搭建完整步骤
Dad's MMO Lab MU Online传奇单机教程:OpenMU离线服务器从零搭建完整步骤
本文是 Dad's MMO Lab 的 MU Online 离线服务器搭建教程:基于开源 OpenMU 服务器模拟器 + Docker + 一键安装脚本,在 Steam Deck 上把经典网游 MU Online(Season 6 Episode 3)完整搬到本地运行——无需订阅、无需外网服务器、永久畅玩。整个过程只需一条安装命令,客户端配置也仅需几步。
一、为什么选择 Dad's MMO Lab 搭建 MU Online 离线服?
Dad's MMO Lab 是一个专注经典 MMO 本地化的开源项目:全部使用开源服务器模拟器 + Docker 部署,脚本可一键安装、可干净卸载,专为 Steam Deck 调试验证过,也支持 Linux 和 Windows 10/11(WSL2)。
跑通本教程后,你的 Steam Deck 上将拥有:
- ✅ 完整离线的 MU Online Season 6 Episode 3 服务器(全部地图、怪物、Boss)
- ✅ 浏览器 Web 管理面板(管理账号、服务器、配置)
- ✅ Gaming Mode 一键启动器,客户端关闭后服务器自动停机
- ✅ 自动处理 Proton 网络连通问题(这是其他教程最容易卡住的部分)
💡 法律提示:服务器是自动的,但 客户端文件需要你自行提供(Webzen 游戏资产不属于本项目的分发范围)。本项目只做游戏保存(preservation),不传播任何版权内容。
二、安装前准备:硬件要求与客户端文件清单
2.1 硬件与环境要求
| 项目 | 要求 |
|---|---|
| 平台 | Steam Deck(安装时进入 Desktop Mode)/ 任意 Linux / Windows 10/11 (WSL2) |
| 磁盘 | 客户端约 3 GB + Docker 若干 GB |
| 网络 | 安装时需要联网;游玩时也必须连接局域网(Wi-Fi 或有线) |
⚠️ 为什么游玩时也要联网?因为 MU 客户端跑在 Proton 沙箱里,而 Proton 沙箱无法访问 127.0.0.1,只能通过 Deck 的局域网 IP 连接服务器(原理见第四节)。
2.2 客户端文件清单(需自行准备)
从 OpenMU 社区(其 GitHub Releases 与 Discord #downloads 频道)获取以下 4 个文件:
| 文件 | 作用 |
|---|---|
| MU Season 6 Episode 3 客户端 | 基础游戏文件 |
OpenMU 补丁版 main.exe |
已移除 GameGuard,可连接 OpenMU 服务器 |
补丁版 Data/Local/Eng/ItemTooltip_eng.bmd |
修复一个物品提示数据崩溃 |
| OpenMU ClientLauncher(可选) | 辅助启动器 |
将它们放入同一个文件夹,例如 ~/Games/MU Client 1.04d - Season 6E3/,并把补丁版 main.exe 和 ItemTooltip_eng.bmd 覆盖到基础文件中即可。
三、一键安装步骤:三条命令启动 OpenMU 服务器
第一步:获取安装脚本
clone 项目仓库,进入 MU Online 指南目录:
git clone https://gitcode.com/gh_mirrors/da/dads-mmo-lab
cd dads-mmo-lab/guides/Mu-online
第二步:运行安装器
chmod +x install-muonline.sh
./install-muonline.sh
安装器 install-muonline.sh(v2.0.0)会依次完成 3 个阶段,只需在提示时输入 sudo 密码:
- 启动 OpenMU 服务器 — 自动安装 Docker、拉取官方 OpenMU 镜像、创建数据库并拉起服务,且强制服务器以 Deck 的局域网 IP 对外注册;
- 配置网络重定向 — 写入
/etc/hosts重定向规则,并安装一个 root 属主的辅助脚本 + 精确的免密 sudo 规则,让启动器以后能自动"重新钉住" IP; - 安装 Gaming Mode 启动器 — 生成
~/muonline-launcher.sh启动器和参考手册~/muonline-server/MY_SERVER.txt,最后打印客户端配置指引。
首次运行需要拉取镜像并初始化数据库,耐心等待约几分钟。
四、连接原理:为什么必须走 LAN IP 而不是 localhost
这是 MU 安装与其他 MMO 最大的不同,理解一次就够:
- Proton 沙箱有隔离的回环地址——沙箱内的
127.x并不是 Deck 的 localhost,所以客户端连不上127.0.0.1上的服务器; - 但沙箱 可以访问 Deck 的局域网 IP(如
192.168.0.21); - 因此安装器做了两件事:让服务器以 LAN IP 对外广播 + 把客户端硬编码的连接域名(
connect.muonline.webzen.com)在/etc/hosts中重定向到该 LAN IP; - 启动器每次运行都会自动重新钉住两边,换了路由器 / DHCP 换 IP 也能自愈,你无需手动维护。
Steam Deck (LAN IP)
├── Docker: OpenMU 服务器 + 数据库 ← 以 LAN IP 对外广播
├── /etc/hosts: connect.muonline.webzen.com → LAN IP
└── Proton 客户端 ──(走 LAN IP)──▶ 连上本地服务器 ✅
五、客户端配置:添加 Mu Client 到 Steam(GE-Proton + gamescope)
- 在 Steam 中将
main.exe添加为 Non-Steam 游戏,命名建议为Mu Client 2; - 属性 → 兼容性:强制使用 GE-Proton(标准 Proton 无法运行,如有需要可用 ProtonUp-Qt 安装);
- 属性 → 常规 → 启动选项 填入:
gamescope -w 1024 -h 768 -W 1280 -H 800 -f -- %command%
这行参数把 MU 缩放铺满 Deck 屏幕,并让启动器能检测到你退出游戏(从而自动关服务器)。不要再添加 connect /u… /p… 等参数——此客户端会忽略它们。
六、Gaming Mode 一键游玩:服务器自动启停
安装器已生成启动脚本,把它挂进 Steam 即可全程游戏模式操作:
- 添加
/usr/bin/konsole为 Non-Steam 游戏,重命名为MU Online Server; - 启动选项:
--hold -e bash ~/muonline-launcher.sh; - ⚠️ 该快捷方式 不要启用 Proton(它是 bash 脚本)。
日常游玩流程(每次只需两步):
- 启动
MU Online Server→ 等待出现✅ MU ONLINE IS READY!; - 按 Steam 键 → 启动
Mu Client 2→ 进入游戏。
关闭客户端后,服务器自动关机,无需手动清理进程。
七、登录账号与 Web 管理面板
MU Online 不会自动注册账号,直接使用内置演示账号——密码与用户名相同:
| 用户名 | 密码 | 说明 |
|---|---|---|
test0 |
test0 |
普通账号 |
test1 … test9 |
与用户名相同 | 更多普通账号 |
testgm |
testgm |
GM 管理员权限 |
服务器列表中任选一个进入(它们都指向你的本地服务器)→ 登录 → 创建角色,开玩。
🖥️ Web 管理面板:浏览器打开 http://127.0.0.1(80 端口),本地使用无需登录,可直接管理账号、服务器与配置。
八、常见问题排查(Troubleshooting 速查表)
| 症状 | 原因与解决办法 |
|---|---|
| 提示 "Wrong username or password" | 密码就是用户名,用 test0 / test0 试试 |
| 连接服务器列表正常、点选服务器就断线,或出现未设置的 "Helheim" | 启动了错误的 exe,或重定向未钉住。确认启动的是补丁版 Mu Client 2,且先启动了 MU Online Server 启动器 |
| 之前能连、换路由器 / 换 Wi-Fi 后连不上 | Deck 的 LAN IP 变了,重新启动 MU Online Server 即可自动重钉 |
| SteamOS 系统更新后连不上 | 更新可能清空 /etc,重新运行 install-muonline.sh 恢复(或执行启动器打印的一行修复命令) |
| 提示 "No LAN IP found" / 完全无法连接 | Deck 必须处于网络中(Wi-Fi 或 Dock 有线),连接后重新启动 |
| 服务器一直无法就绪、不出现 "ready" | 执行 docker logs -f openmu-startup 查看日志;首次运行拉镜像 + 初始化数据库需几分钟 |
九、实用命令与参考文件
# 手动启停服务器
cd ~/muonline-server && docker compose up -d
cd ~/muonline-server && docker compose down
# 实时查看服务器日志
docker logs -f openmu-startup
# 查看游戏服务器当前广播的 IP
docker logs openmu-startup | grep "registered with endpoint"
更多资料,建议收藏这些文件:
- 完整图文指南:MU-Online-HOWTO.md
- 安装器脚本:install-muonline.sh
- 安装完成后生成的随身手册:
~/muonline-server/MY_SERVER.txt - Windows 10/11 (WSL2) 支持:DML-Windows-HOWTO.md
- SteamOS 更新后 Docker 修复:fix-after-update.sh
- 卸载指南:Uninstall-HOWTO.md(脚本:uninstall.sh)
🎮 当 ✅ MU ONLINE IS READY! 亮起的瞬间,传奇的玛雅大陆就正式在你的掌中复活了——没有月卡、没有外网延迟、没有关服的风险,只有你和你的冒险者,永久在线。