传奇国度本身是传奇类网页ARPG，战法道三职业，不用下载大客户端，浏览器打开就能进，核心保留打宝、PK、行会、攻沙、自由交易这套老传奇体验，早年由多个页游平台联运。现在想自己搭一个同类网页版，或者把传奇类服务端改成“传奇国度式”网页入口，技术路线分三种形态，先选对再动手。
一、网页版三种载体先分清
真H5重制
前端HTML5+Canvas/WebGL，后端Node.js或Java跑逻辑，WebSocket做实时通信。首屏只拉核心JS和登录界面，进图再按需拉地图贴图、技能特效。战法道、攻沙、爆装全保留，适合单职业、中变、挂机服。
微端网页入口
服务端还是传统GOM/GEE/BLUE那套，网页只放一个登录页（index.html + serverlist.json），玩家点进去浏览器拉一个轻量壳，后续资源从微端流式下载。本质还是微端，只是入口在浏览器，适合复古1.76/1.80资源量小的版本。
云游戏投射
服务端跑完整PC客户端，画面通过视频流推到浏览器，操作反向传回。什么端都不用改，但延迟敏感、带宽成本高，只适合演示或小圈子，别碰商业。
自建优先真H5，其次微端网页入口。
二、技术栈和目录结构
真H5端常见结构：
D:\MirServer
├─ WebServer.exe（或 node app.js）
├─ www/
│ ├─ index.html
│ ├─ game.js
│ ├─ css/
│ └─ assets/（图片、音频、配置）
├─ GameServer/（游戏逻辑）
├─ DBServer/（数据库服务）
├─ LoginGate/
├─ RunGate/
└─ config.json（IP、端口、区名）
前端：HTML5 + ES6 + Canvas2D/WebGL，UI用DOM层画按钮对话框，战斗场景用Canvas渲染。通信WebSocket长连接，登录和领奖走HTTP POST。
后端：Node.js + Express/Koa处理HTTP，Socket.IO处理实时消息；数据库MySQL或MongoDB，角色数据按user_id + platform_id建联合索引，保证PC/安卓/H5同账号读同一份存档。
传统端游改造的H5端，老架构还依赖DBC2000建HeroDB；新H5端一般直接走MySQL/SQLite，按包内说明来。
三、服务端准备与配置
云服务器用Windows Server 2019/2022，4核8G起步，SSD必选。带宽独享10M起步，百人在线建议30-50M，攻沙场景直接100M起。
解压服务端到D:\MirServer，路径纯英文无空格无中文。桌面、中文目录、带空格路径全都会埋坑。
数据库：
DBC系：BDE Administrator建HeroDB，PATH指向D:\MirServer\Mud2\DB
MySQL系：起MySQL服务，导库，账号给全权限，确认角色表、物品表、爆率表都在
改IP是第一步也是最容易漏的。批量替换下面文件里的127.0.0.1为公网IP或域名：
Mir200\!Setup.txt
DBServer配置
LoginGate.ini
RunGate配置
www/config.json（H5前端配置，server_ip、ws_port必须改）
serverlist.json（区名、IP、端口）
H5端额外要配WebServer端口，一般80或8080，外网要在安全组放行。
四、启动顺序
DBServer / MySQL
LoginSrv
LoginGate（7000）
SelGate（7100）
RunGate（7200）
WebServer（80/8080，起www目录）
M2Server / GameServer
M2黑窗无红字，WebServer能访问http://IP:8080/index.html看到登录框，就算立住了。
WebSocket端口单独配，别和7000-7200混用。前端game.js里ws地址写全，比如ws://IP:9000/ws，只改列表不改ws地址，表现就是能看登录框但点开始没反应。
五、资源加载与黑屏排查
H5不是完全无端，是微端+流加载。首屏加载1-10MB的WebGL壳，后续地图、怪物、技能特效按需从CDN拉。
黑屏常见原因按顺序查：
能登录能建角色但进图黑屏
网关监听还绑着127.0.0.1。配置文件里BindAddr、LocalAddr、GameServerAddr全改成外网IP或0.0.0.0。本机连本机走环回能凑合，外网进图阶段服务端把场景数据发到内网地址，直接黑屏。
微端没起或地址错
客户端进图去微端拉地图、特效、UI资源，微端还是127.0.0.1，本机找不到就黑屏或卡加载。起UpdateServer+UpdateGate，端口8000，PAK密码全绿，默认/电信/网通三个分组建齐。
PAK密码不对
服务端和前端pak密钥不一致，微端拉下来的资源解不开。回登录器配置器看哪行红，逐行核对。
资源站点路径和微端配置对不上
模型透明、装备黑块、NPC不显示，基本是资源路径没对齐。开启资源强制校验，让客户端精准匹配模型素材。
CDN资源404
新地图、新装备贴图没传上CDN，进图黑块。专属副本、自定义地图要单独加进资源打包列表，更新资源索引文件。
进图转圈不跳转
资源站点延迟高、加载超时阈值低、素材损坏。调高超时时间，开加载重试，替换损坏素材，清客户端缓存。
浏览器缓存命中旧资源
改了资源玩家端没变化，清Cache和MicroCache再进。资源版本号每次更新递增，强制重新拉。
手机端卡进度条
WebSocket端口没放通，或页面没开HTTPS。2026年手机浏览器对非HTTPS的WebSocket限制很严，必须上SSL证书。
六、端口与防火墙全链路
云服务器有双层防火墙：云控制台安全组 + 系统防火墙，两层都要通。
必须放行的端口：
80（HTTP）
443（HTTPS）
7000（登录网关）
7100（角色网关）
7200（游戏网关）
8000（微端）
9000（WebSocket，按实际配置）
8080（WebServer备用）
8888（部分端资源服务）
只改M2不改网关，选区掉线；只改网关不改前端，列表能读但进不去；只开安全组没开系统防火墙，本机能连外网连不上。
七、三端数据同步
PC、安卓、H5共用中心数据库。关键设计：
角色表用user_id + platform联合主键
移动、战斗、背包、交易所有写操作都走服务端校验，前端只发指令不存逻辑
WebSocket连接池复用，按聊天/战斗/移动/交易分通道，避免队头阻塞
移动速度、技能CD由服务端计时，前端只做显示，防加速挂
合击版开英雄同步开关，英雄等级、装备、技能独立存表，主号下线回写状态
八、前端适配要点
PC浏览器：完整技能栏、小地图、任务追踪全显示。
手机浏览器：技能栏压缩到8个以内，虚拟摇杆+自动拾取，媒体查询重排按钮位置。
微信环境：额外包一层小游戏框架，触控事件映射到原有键鼠逻辑。
UI资源按512x512切片，图片转png序列帧，地图切512x512区块，WebGL开纹理压缩，首屏资源能从40MB压到7MB左右，4G网下加载从20秒缩到3秒。
加载阶段做三件事防黑屏：分批次预加载（UI/场景/音效分开，设超时阈值）、失败自动重试切备用CDN、Loading动画占位别只黑屏。
九、自己搭的最小路径
本机先跑通
WebServer起在127.0.0.1:8080，浏览器开index.html，能注册能进图。
租云服务器
4核8G 10M独享，公网IP重配一遍所有配置文件。国内服务器域名必须备案，不然80/443被拦页面打不开，嫌麻烦用香港节点。
出H5页
朋友用浏览器打开网址就能进，不用传客户端。先关微端用本地资源跑通，再切微端流式加载。
上SSL
宝塔面板一键Let's Encrypt证书，手机浏览器兼容性立刻好一大截。
扩三端
安卓APK、iOS签名包后续再加，同账号验证数据同步。
资源走CDN
别让玩家全从源站拉，晚高峰会炸。
十、成本账本
自娱自乐（10人内）
低配云主机2核4G 10M：150-300/月
H5端：0元（用开源或自带WebServer的包）
合计首月200-500元
小圈子开区（50-200人）
4核8G或8核16G，20-50M独享，基础高防：800-1500/月
H5端授权：3000-8000一次性
SSL证书：免费
首年2-4万
商业运营（500人+）
16核32G高防BGP，100M独享：3000-6000/月
深度定制版本：2-5万一次性
运维+客服：1-2万/月
首年15-30万起
带挂机机制的网页版对散人更友好，版本设计上优先做自动拾取、自动打怪、装备保值、自由交易，别一上来堆氪金系统。
十一、日常维护
定时重启
传奇类服务端普遍内存泄漏，跑两三天内存缓慢升高。宝塔计划任务加每天凌晨重启脚本，数据库每天备份，保留最近7天，异地再同步一份。
日志监控
M2日志红字是第一线索，WebServer访问日志看资源404，网关日志看连接数异常。
资源更新流程
改pak.txt密码和路径 → 重启UpdateServer重扫索引 → 登录器资源版本号加一 → 重新生成登录器分发 → 玩家端自动拉新资源。
十二、常见故障速查
能看登录框但点开始没反应
ws地址没改，或WebSocket端口没放行。
进图黑屏
网关绑127.0.0.1、微端没起、PAK密码错、资源路径不对，按第五节顺序查。
手机端卡进度条
没上HTTPS，或WebSocket端口被手机浏览器拦。
部分地图黑屏
自定义地图没进资源打包列表，补进索引重新生成。
角色存不住
数据库没写权限，或表没导全。
攻沙掉线
带宽不够，独享带宽必须买，共享带宽晚高峰直接掉速。
十三、排错固定顺序
WebServer能开index.html
config.json里IP、ws地址、端口全对
M2无红字，三个网关都监听0.0.0.0
微端起，PAK密码全绿
CDN资源能直链访问无404
浏览器清缓存重进
手机端关高清预加载先跑流畅模式
同账号PC登录后手机登录数据一致
网页版的核心不是“把端游搬进浏览器”，是把资源加载、协议、数据同步重做一遍。端游那套直接套H5外壳必黑屏必卡顿。先按真H5架构搭，资源走CDN，通信走WebSocket，数据走中心库，三端自然就通了。
版本内容（爆率、装备、NPC、活动）和端游共用一套脚本逻辑，改Mir200\Envir下文件，H5前端自动读。前期别在画面效果上死磕，先把“能进、能打、不黑屏、数据不丢”四条跑稳，再谈光柱和特效。
传奇国度这种页游形态的价值在于低门槛：玩家点开就玩，不用下几个G客户端，不用装运行库，不用配DBC。技术侧把这套体验做出来，比堆画面更重要。
