一、先分清网页端形态
网页复古传奇不是一种固定架构，常见三种：
H5纯网页版：浏览器直接开，资源走HTTP拉取，不装独立客户端
微端网页引导版：网页里点开始游戏，自动拉微端登录器，本质是客户端套网页壳
Web列表跳转版：网页只做列表展示，点区名唤起本地登录器进游戏
三种排障方向完全不同。H5先看浏览器和资源服；微端网页版先看本地登录器和微端网关；列表跳转版先看本地登录器和服务端网关。
二、H5纯网页版排障
打开页面白屏、转圈、进图黑屏，按下面顺序查。
1. 浏览器缓存
关页面，清缓存和本地存储。Chrome按F12，Application里清Local Storage、Session Storage、Cache Storage。H5资源带版本号，旧缓存会一直加载破损贴图。
用无痕窗口再开一次，能进就是缓存问题。无痕还白屏才是资源或服务端问题。
2. 资源服不通
H5前端一般请求这些路径：
/index.html
/static/res/version.manifest
/static/res/data/
/static/res/map/
/static/res/pak/
浏览器F12看Network，哪个文件404、断连、超时，直接定位。
version.manifest是资源清单，缺了或格式错，前端不知道拉什么，表现就是转圈不停。manifest里每一行对应一个资源哈希，改了资源必须重算MD5写回，不重算前端继续用旧缓存。
3. 跨域与MIME
Web服必须开CORS，否则pak、wasm、json拉不下来：
Access-Control-Allow-Origin: *
Nginx示例：
location /static/ {
add_header Access-Control-Allow-Origin *;
types {
.pak application/octet-stream;
.wil application/octet-stream;
.manifest application/json;
}
}
MIME不对，浏览器把pak当成文本，前端解析直接崩。
4. 运行环境
H5前端多基于WebGL渲染，老机器、集显、核显驱动异常会黑屏。Chrome地址栏开：
chrome://gpu
看WebGL状态。被禁用就更新显卡驱动，或在启动参数加：
--enable-webgl --ignore-gpu-blocklist
移动端微信内置浏览器对WebGL支持参差，优先用系统浏览器或Chrome。
三、微端网页引导版排障
网页点开始没反应、弹请先下载登录器、黑屏有声音，按客户端逻辑查。
1. 本地登录器没起
网页通过自定义协议唤起本地登录器，例如：
mirl2://start?zone=1
没装登录器或协议没注册，点击无反应。重装配套登录器，注册表确认有URL协议项。
2. 杀软拦截
登录器、mir32.dll、插件dll被Defender、360、火绒静默隔离。安全中心保护历史记录还原文件，整个客户端目录加白名单。
3. 补丁结构
客户端根目录：
D:\MirClient\Data
D:\MirClient\Map
D:\MirClient\Resources
Resources文件夹名必须和登录器配置器、微端服务端三方一致。补丁平铺，不套“补丁\Data”嵌套。
NewopUI.pak放Data根目录，缺了黑屏小砖块。
4. PAK密码
Pak.txt路径改成当前真实路径，密码逐行核对，登录器配置器全绿再生成。红叉代表密码错或文件找不到，不弹窗但资源静默丢失。
四、服务端网关与微端
网页端背后还是那套网关，端口不通网页再干净也进不去。
1. 启动顺序
DBServer
LoginSrv
LoginGate 7000
SelGate 7100
RunGate 7200
M2Server
UpdateGate 8000
UpdateServer
M2没加载完网页点开始必黑屏断线。
2. 端口监听
netstat -ano | findstr "7000 7100 7200 8000 80 8080"
80是网页，8000是微端，7200是游戏网关。少一个都不完整。
3. 微端资源扫盘
UpdateServer基本设置：
客户端路径 D:\MirClient
资源目录名三方一致
更新密码两端一致
微端端口8000
UpdateGate目录放qqwry.dat，缺了网关起不来。
H5资源服和微端是两回事：H5走Web目录/static，微端走UpdateServer扫客户端目录。两套资源要分别校验完整。
4. 列表文件
网页后端读区服列表，list.txt用ANSI编码：
测试区公网IP 7000 8000
176
浏览器直接开列表地址能出内容再测。UTF-8带BOM老引擎不认。
五、Web服部署
H5前端一般放Nginx或IIS：
Nginx示例：
server {
listen 80;
server_name game.example.com;
root D:/WebClient;
index index.html;
location /static/ {
add_header Access-Control-Allow-Origin *;
expires 1h;
}
}
静态资源目录结构：
D:\WebClient\index.html
D:\WebClient\static\res\version.manifest
D:\WebClient\static\res\data\
D:\WebClient\static\res\map\
D:\WebClient\static\res\pak\
改了任何前端资源，version.manifest必须重新生成，否则客户端不拉新包。
六、玩家侧进服排障
网页点开始没反应：
清浏览器缓存，无痕模式再试
确认本地登录器已安装，协议可唤起
关浏览器扩展，广告拦截会拦资源请求
关杀软实时防护，登录器目录加白
白屏转圈：
F12看Network，哪个资源红就修哪个
查Web服是否起了，80端口通不通
查version.manifest是否完整
查CORS头是否带上
进图黑屏：
微端8000没通
Map资源没同步
PAK密码错
NewopUI.pak缺失
手机端排障：
清APP/浏览器缓存和数据
开存储、悬浮窗、显示在其他应用上层权限
关省电模式、关手机管家
WiFi切4G测一次，关梯子
七、复古内容校准
网页复古服别为了好看堆特效：
经验倍数默认1，爆率按原版表
无会员、无切割、无赞助称号、无商城直售属性
装备上限按版本原设，1.76看裁决骨玉，1.80看火龙，1.85看战神
地图逻辑走原路，尸王殿矿区挖墙，石墓阵按原路
H5前端不塞自动挂机、自动回收变态功能
M2里清掉@刷装备@调等级隐藏GM命令，PlugList只留配套插件。
八、外网发布
云服务器安全组放行：
TCP 80 7000 7100 7200 8000 8080
系统防火墙入站同样加，各网关exe加允许应用。
家用宽带做端口映射，内外端口一致。大内网用frp穿透。动态IP绑DDNS，网页和列表都写域名不写死IP。
netsh复位（装过加速器/VPN后常用）：
netsh winsock reset
netsh int ip reset
ipconfig /flushdns
重启。
九、标准自测顺序
1. 本机127起服务端，网关全活
2. netstat确认7000/7100/7200/8000监听
3. 客户端D:\MirClient放完整底包
4. 补丁平铺，Resources名三方一致
5. Pak.txt路径密码全绿
6. 同包登录器生成放客户端根
7. H5前端资源传Web目录，version.manifest重算
8. Nginx开CORS，MIME配pak/json
9. 浏览器无痕开网页，F12看资源全200
10. 本机进游戏看UI/地图/NPC/装备全显示
11. 外网放端口、绑公网IP、开微端
12. 手机端清缓存再测一次
十、现象速查
网页白屏：前端资源404、manifest坏、CORS没开
转圈不停：version.manifest缺失、资源服不通
点开始没反应：本地登录器没装、协议未注册
黑屏小砖块：NewopUI缺、PAK密码错
黑屏有声音：Map缺文件、微端没起
装备透明：Looks值错、物品pak密码错
地图黑地：Map资源没同步、微端路径错
进图秒回角色页：RunGate没起、7200没监听、对外IP错
外网能登进不去图：8000没映射、安全组没放
列表空白：编码不是ANSI、Web没起
微端重复下载：manifest版本号没递增
手机端秒退：权限没开、缓存坏、WebGL不支持
花屏：分辨率太高、DPI没关、客户端版本不对
排障核心就一句：H5端保前端资源通、manifest对、CORS开；微端网页版保本地登录器干净、补丁完整、网关全活。网页复古服稳不稳，看F12资源请求全不全、看进图三分钟会不会黑屏、看爆率是不是原版味。每次动WebClient、Mir200、Pak.txt前全量备份，改崩秒回滚。
