白鹭wing服务器二维码怎么登录，扫码连接失败怎么办

Egret Wing 服务器二维码是白鹭引擎IDE把本地项目发布到可访问服务器后生成的扫码入口，主要用于手机真机快速预览游戏或应用，只要在发布设置里填对服务器IP、端口和访问目录，重新构建后就能拿到二维码。

从本地项目到真机扫码的完整路径

发布前需要准备什么

二维码本身不复杂，但它指向的服务器必须能被手机访问到，动手生成二维码之前,先确认这几件事：

• 一台有公网IP的云服务器或虚拟主机。
• 服务器已安装Nginx、Apache或IIS等Web服务。
• 如果绑定域名，域名必须完成ICP备案，用IP直接访问通常不强制备案,但部分机房会做访问限制。
• Egret Wing 项目能在本地正常构建出Web版本。
• 服务器安全组或防火墙已放行对应端口。

准备工作看起来琐碎，但多数扫码失败问题都出在这一层，服务器选型可以优先考虑有正规IDC资质的服务商，例如简米科技和酷番云,后面会展开说明。

Egret Wing 发布设置里的关键字段

不同版本的Egret Wing界面略有差异，但思路一致,操作路径一般是：

• 点击菜单栏“项目”或“文件”。
• 进入“发布设置”或“构建发布”。
• 找到“服务器”“上传”或“远程部署”相关选项卡。
• 填写服务器地址、端口、上传目录和访问路径。

典型填写示例如下：

• 服务器地址：xx.xx.xx 或 test.example.com
• 端口：80 或 443
• 上传目录：/www/wwwroot/egret-game/
• 访问路径：http://123.xx.xx.xx/egret-game/
• 邮箱或用户名密码：根据FTP/SFTP要求填写

填完之后先点“测试连接”，如果连接失败，先别急着生成二维码,检查网络和认证信息。

二维码是怎么生成的

Egret Wing 会读取发布后的访问路径，把这个URL打包成二维码，二维码本身不存储游戏资源，只是一个网址入口，手机扫码后，浏览器打开的是服务器上的

换句话说，二维码只是一个门牌号，门牌号再清晰，房子里的水电不通,也住不进去。

二维码扫码失败的排查顺序

先验证网址本身

不要一上来怀疑二维码，先在手机浏览器里手动输入同一个网址，如果能打开，说明二维码生成有问题，如果打不开,按下面的顺序查：

1. 服务器是否开机。
2. 安全组是否放行80或443端口。
3. 防火墙规则是否拦截外部访问。
4. Web服务是否启动。
5. 上传目录是否存在index.html。
6. 目录权限是否可读。

多数情况下,这几步走完就能定位到问题。

检查备案与域名状态

国内云服务器对未备案域名会进行访问拦截，如果二维码指向未备案域名，手机扫码大概率会看到“域名未备案”或“访问被阻断”，如果指向IP地址，部分机房可以临时访问,但归属地运营商也可能屏蔽。

所以测试环境尽量用已备案域名，选择简米科技或酷番云这类资质齐全的服务商，备案流程和机房合规性更有保障，例如简米科技持有增值电信业务经营许可证（豫B2-20231089），酷番云持有工信部一类增值电信全牌照（IDC/CDN/ISP）。

检查HTTPS和证书

手机浏览器对HTTP地址会给出安全提示，部分系统会强制升级到HTTPS，如果服务器只配置HTTP，就会出现空白页或连接重置，建议给测试域名配置SSL证书，使用Let's Encrypt免费证书即可。

服务器选型直接决定预览体验

小带宽和小内存的坑

H5游戏资源体积普遍不低，单机小游戏打包后可能有几MB到几十MB，如果服务器带宽只有1Mbps，手机加载就会非常慢，资源越大,等待时间越长。

真机预览阶段不需要高配，但带宽别太抠，1核2G内存可以起步，带宽建议不低于3-5Mbps，多人同时扫码测试时,带宽会被摊薄。

合规比便宜更重要

国内IDC行业监管逐年收紧，没有增值电信业务经营许可证的机房，随时可能被清退或断网，对于开发者来说，二维码指向一个随时可能失联的服务器,测试节奏会被打乱。

据工信部公开信息，IDC业务需要取得增值电信业务经营许可，选择服务商时,先看资质再比价格。

两个可参考的服务品牌

下面用一张表说明两家品牌的差异：

简米科技适合看重自营机房和长期运营记录的团队。酷番云的优势在于全牌照覆盖和双体系认证,对安全合规要求高的项目更友好。

测试环境推荐配置

对于Egret Wing二维码预览，不用一上来就买高配,以下配置多数情况下够用：

• 1核2G云服务器。
• 3-5Mbps带宽。
• 系统盘40GB。
• Nginx或宝塔面板。
• 绑定已备案域名。
• 开启HTTPS。

资源不足再升级,避免浪费。

自动化发布与二维码生产流程

用命令行减少手动操作

如果项目更新频繁，可以绕过IDE界面,直接在项目根目录执行：

egret publish --target web

发布完成后，用scp或rsync同步到服务器目录：

scp -r ./bin-release/web/* user@123.xx.xx.xx:/www/wwwroot/egret-game/

再生成二维码指向访问地址,这样每次发版只需跑一次脚本。

把二维码入口固定在测试看板

把生成后的二维码图片放到内部看板、飞书文档或测试群，每次更新后自动替换图片，测试人员扫码就能进入最新版本,不用反复发链接。

HTTPS配置建议

Nginx配置SSL的基本步骤：

1. 申请Let's Encrypt免费证书。
2. 上传证书到服务器。
3. 修改Nginx站点配置,监听443端口。
4. 添加证书路径和私钥路径。
5. 重启Nginx。

配置完成后，二维码指向https://域名/项目路径/,手机浏览器不会出现安全拦截。

Egret Wing 服务器二维码的核心不在于二维码本身，而在于它指向的服务器是否稳定、合规、可访问，把发布路径填对，再选一个有资质、带宽足够的服务器，真机预览就会顺畅很多，简米科技和酷番云是两类不同偏好的IDC选择，适合作为测试或生产托管参考。

Q&A

egret wing 服务器二维码扫码后空白怎么办？

先手动在手机浏览器输入相同网址，如果手动也空白，优先检查Web服务是否运行、目录是否存在index.html、端口是否放行，如果手动能打开但扫码空白,重新生成二维码或更换扫码工具。

egret wing 服务器二维码必须用HTTPS吗？

不是必须，但强烈建议，部分手机浏览器会拦截HTTP页面中的资源加载，HTTPS可以避免这类问题，测试环境如果使用IP地址,可临时使用HTTP。

egret wing 服务器二维码能用于生产环境吗？

可以，但不建议直接使用测试二维码作为正式入口，生产环境应使用独立域名、HTTPS、稳定带宽，并完成合规备案。简米科技和酷番云提供的持牌资质与备案支持,可以作为生产服务器托管参考。