谁的童年没有几款念念不忘的经典游戏？FC红白机、SFC、GBA、街机、PS1……想重温怀旧游戏，却不想在电脑、手机安装各类模拟器客户端，占用设备存储空间、切换设备还无法同步存档？
今天给大家分享RetroArch Web完整部署教程，全程零基础可上手，提供Docker极速部署（新手首选）和源码编译部署（进阶定制）两种方案。部署完成后，只需任意设备打开浏览器，就能在线运行全平台复古游戏，支持云端存档、键鼠/手柄适配、多核心模拟器切换，在家局域网、外网随时随地都能玩。
一、什么是 RetroArch Web？
RetroArch 是目前最强大的开源多平台模拟器前端，支持几乎所有复古游戏主机平台。而 RetroArch Web 是基于 Emscripten 编译的网页版本，将模拟器核心打包为网页可运行资源，无需安装任何客户端程序。
✅ 核心优势：
- 跨设备通用：电脑、手机、平板、电视浏览器均可打开
- 全平台兼容：支持 FC、GBA、SFC、MD、街机、PS1 等数十种游戏核心
- 轻量化部署：占用资源极低，NAS、轻量云服务器、本地电脑均可部署
- 支持存档、手柄、滤镜、帧率调节，媲美客户端体验
- 开源免费、无广告、无内置付费，完全私有化部署
二、部署前置准备
两种部署方案通用基础环境，提前准备即可：
- 一台可运行 Docker 的设备：本地电脑、云服务器、NAS（绿联、极空间、群晖等）
- 设备已安装 Docker & Docker Compose（新手推荐一键安装，适配Windows/Linux/macOS）
- 设备网络通畅，可正常拉取镜像、访问外网
注：Docker 安装教程网上通用，本文不再赘述，优先保证 Docker 服务正常启动即可。
三、方案一：Docker 极速部署（新手首选，5分钟搞定）
该方案无需复杂编译，一键拉取现成镜像，零配置快速上线，适合绝大多数用户。
1、一键启动容器
打开终端/命令行，执行以下命令，直接部署 RetroArch Web 服务：
docker run -d \
--name retroarch-web \
-p 8080:80 \
--restart unless-stopped \
inglebard/retroarch-web:latest命令参数说明：
- -p 8080:80：将服务器8080端口映射到容器服务端口，可自行修改前置端口（如8888、9090）
- –restart unless-stopped：开机自启，意外重启设备后自动恢复游戏服务
- –name retroarch-web：自定义容器名称，方便后续管理
2、Docker Compose 部署（推荐，方便后续维护）
如果需要长期使用、后续挂载游戏目录，推荐使用 Compose 部署，配置更规范：
新建 docker-compose.yml 文件，写入以下内容：
services:
retroarch:
image: inglebard/retroarch-web:latest
container_name: retroarch-web
ports:
- "8080:80"
restart: unless-stopped
volumes:
# 挂载本地游戏目录（自行修改本地路径）
- ./roms:/usr/share/nginx/html/roms
# 挂载存档配置目录，持久化存档数据
- ./config:/usr/share/nginx/html/config文件目录下执行启动命令：
docker-compose up -d3、本地访问服务
部署完成后，直接打开浏览器访问：http://设备IP:8080
示例：本地电脑部署访问 http://localhost:8080，NAS部署访问 http://NAS局域网IP:8080
四、方案二：源码编译部署（进阶定制，最新版本）
适合有开发基础、想要体验最新功能、自定义编译核心的用户，基于官方 Emscripten 编译，纯净无修改。
1、安装编译环境
需要提前安装 Git、Emscripten 编译工具链，初始化 emsdk 环境：
# 克隆emsdk源码
git clone https://github.com/emscripten-core/emsdk.git
cd emsdk
# 安装并激活最新稳定版
./emsdk install latest
./emsdk activate latest
source ./emsdk_env.sh2、编译 RetroArch 网页版
# 克隆RetroArch源码
git clone https://github.com/libretro/RetroArch.git
cd RetroArch/pkg/emscripten
# 编译网页版静态资源
make -j$(nproc)编译完成后，会在目录生成网页运行所需的 html、js、wasm 资源，直接用 Nginx 或静态网页服务托管即可访问。
五、首次初始化 & 基础使用教程
首次打开网页会进入初始化界面，简单几步完成配置：
1、界面主题选择
推荐选择 Anarch 简洁主题，适配网页端操作，加载速度更快，点击确认进入主界面。
2、安装模拟器核心
核心是对应游戏平台的模拟器驱动，操作路径：主菜单 → 在线更新 → 下载核心，按需下载：
- FC红白机：fceumm
- GBA：mgba
- SFC：snes9x
- 街机：fbneo
- PS1：pcsx_rearmed
3、加载游戏ROM
- 将游戏ROM文件放入之前挂载的
./roms目录 - 网页端进入 加载内容 → roms目录
- 选择对应游戏，匹配核心即可启动游玩
4、按键与手柄配置
- 默认支持键盘操控，可在 设置 → 输入 自定义按键
- 支持外接蓝牙/有线游戏手柄，网页自动识别适配
- 开启自动存档、即时存档，随时保存游戏进度
六、公网访问配置（随时随地玩）
默认仅局域网访问，想要外网手机、异地电脑游玩，可通过内网穿透实现公网访问，推荐极简方案：
- 安装 Cpolar、Frp 等内网穿透工具
- 创建 HTTP 隧道，绑定本地端口8080
- 获取公网地址，任意设备打开即可访问游戏服务
搭配域名可实现长期稳定外网访问，适合搭建个人专属云端游戏厅。
七、常见问题排查
- 访问页面空白/无法打开：检查服务器防火墙、端口是否放行，确认Docker容器正常运行
docker ps - 下载核心失败：网络问题，可手动下载核心放入对应配置目录
- 游戏卡顿、掉帧：降低画面滤镜、关闭高清渲染，适配网页端性能
- 存档丢失：确认已挂载 config 持久化目录，避免容器重启数据清空
八、总结
RetroArch Web 是复古游戏玩家的神器，轻量化私有化部署，彻底摆脱客户端束缚。新手直接用 Docker一键部署，5分钟即可拥有全平台网页游戏厅；进阶用户可源码编译，自定义功能、精简资源、适配专属场景。
部署完成后，无论是居家局域网娱乐，还是外网远程怀旧，都能随时打开浏览器重温童年经典，存档数据永久留存，体验拉满！
收藏本文，快速搭建你的专属云端复古游戏厅！
