如何下载Unity WebGL格式游戏到本地离线使用并归档？

Unity WebGL格式的游戏完全可以下载到本地离线运行，你遇到的报错是资源抓取不全、MIME类型配置错误两类常见问题，具体原因和操作方法如下：

报错原因拆解 #

• 404资源缺失报错：默认参数的wget/HTTrack无法完整抓取Unity WebGL的全部依赖资源，除了入口HTML、UnityLoader.js之外，WebGL构建产物还包含.data、.wasm、.framework.js、.unityweb、构建配置JSON等动态加载的资源，常规静态爬虫很容易漏抓。
• JSON解析语法错误：你请求的游戏配置文件（通常是Build.json）没有被正确抓取，服务端返回了404的HTML页面（内容开头为<），游戏代码尝试将HTML内容作为JSON格式解析，就会触发Unexpected token < in JSON at position 0的报错。

具体操作步骤 #

1. 完整抓取所有游戏资源 #

调整爬虫参数保证覆盖所有WebGL资源类型，或者通过浏览器完成全量加载后再抓取：

• wget抓取命令：
  wget -p -k -np -U "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36" --accept html,js,css,wasm,data,unityweb,json,png,jpg,mp3,ogg 游戏页面URL
  各参数作用：
  • -p：下载页面加载所需的所有资源
  • -k：将页面内的链接转换为本地相对路径
  • -np：限制爬虫不爬取当前目录之外的内容
  • -U：模拟浏览器UA避免触发站点反爬策略
  • --accept：明确指定需要抓取的资源后缀，覆盖Unity WebGL所有常用资源类型
• 浏览器抓取方案：打开游戏页面等待游戏完全加载完成后，使用浏览器离线下载插件导出整页资源，能捕获到所有动态加载的资源文件。

2. 校验本地资源目录 #

抓取完成后确认本地目录包含以下必要文件，缺失的资源可以从浏览器开发者工具的「网络」面板找到对应地址单独下载：

• 游戏入口index.html
• Unity加载器UnityLoader.js
• Build目录下的.data游戏资源包、.wasmWebAssembly代码包、.framework.js框架代码、构建配置Build.json

3. 配置本地Web服务器的MIME类型 #

Unity WebGL对Web服务器的MIME类型有明确要求，未正确配置会导致资源加载失败：

• Nginx本地服务：在配置文件的types块中添加以下配置：

  types {
    application/wasm wasm;
    application/octet-stream data;
    application/json unityweb;
  }
  

• Python简易服务：可以直接运行以下脚本启动服务，自动配置所需MIME类型：

  import http.server
  import socketserver
  
  PORT = 8000
  
  Handler = http.server.SimpleHTTPRequestHandler
  Handler.extensions_map.update({
      '.wasm': 'application/wasm',
      '.data': 'application/octet-stream',
      '.unityweb': 'application/json',
  })
  
  with socketserver.TCPServer(("", PORT), Handler) as httpd:
      print(f"服务已启动，访问地址为 http://localhost:{PORT}")
      httpd.serve_forever()
  

• XAMPP/WAMP等集成环境：在Apache的mime.types配置文件中添加上述对应MIME类型即可。

4. 本地运行测试 #

启动本地Web服务器后，通过http协议访问对应地址即可运行游戏，不要直接双击打开index.html，浏览器的本地文件安全策略会阻止跨域请求，导致加载失败。

内容的提问来源于stack exchange，提问作者Vadim