用HuaweiCloud DevKit 与 AI Agent 部署2048小游戏：沙箱、DevBridge 与 ECS实战记录

一、环境准备

这次的目标很简单：让 AI Agent 帮我把一个单文件 2048 小游戏部署到华为云上，并能通过公网访问。第一步是准备环境：本地需要 Node.js 22 或更高版本，然后依次执行 npx huaweicloud-devkit install-hcloud 安装 hcloud 命令行，执行 npx huaweicloud-devkit auth init 完成认证初始化，最后用 npx huaweicloud-devkit doctor 做环境自检。doctor 全部通过后再让 Agent 开工，可以省掉很多“命令找不到”“凭证未配置”之类的低级问题。认证信息只保存在本机，文章里不会出现任何密钥。

二、单文件 HTML 的 2048 设计

为了降低部署复杂度，我让 Agent 把游戏写成一个 index.html：HTML 负责 4×4 棋盘结构，CSS 用网格布局和不同数值的配色，JavaScript 用二维数组保存状态。核心逻辑是“按行压缩、相邻相同合并、随机生成 2 或 4”，方向键与触屏滑动共用同一套移动函数，只要把矩阵旋转或翻转就能复用向左移动的实现。再加上最高分的本地存储和“游戏结束”判断，不依赖任何外部库，一个文件即可运行，非常适合静态托管。

三、沙箱启动失败与替代方案

原计划是用 DevKit 的沙箱直接托管预览，但沙箱启动时先后报出 HD.99008001 和 HD.99003001 两个错误码，重试和重新认证都没有解决。考虑到目标只是验证页面效果，我改为在本地起一个静态服务（监听 8080 端口），再用 DevBridge CLI 把本地服务暴露出来：先执行 devbridge auth login 登录，再执行 devbridge host -p 8080，即可得到可访问的预览地址。这个绕行方案不依赖沙箱，也方便快速迭代页面。经验是：遇到平台侧错误不要硬耗，先确认能否用更轻量的链路达成同样的验证目的。

四、ECS + Nginx 正式部署

预览没问题后，开始做正式部署：创建一台 ECS 并绑定弹性公网 IP，安装 Nginx，把页面放到 /hc-activity/index.html，配置站点根路径指向该目录。同时在安全组中放行入方向 TCP 80 端口，否则外网访问会超时，这是最容易漏掉的一步。配置完成后重载 Nginx。

五、验证

部署后不要只靠浏览器刷新，用命令行更可靠：curl -sI http://公网地址/hc-activity/index.html，看到 HTTP 200 以及 text/html 的响应头，就说明 Nginx、目录和安全组都配置正确；再用浏览器实际玩一局确认交互正常。

六、资源清理

活动或演示结束后务必清理资源，避免持续计费：先删除 ECS 实例，再释放弹性公网 IP，最后删除专用的安全组，并确认控制台中没有残留。把“创建、验证、清理”放进同一份清单，是云上实践的好习惯。

七、小结

整个过程里，DevKit 的 doctor 自检帮助提前发现环境问题，DevBridge 在沙箱不可用时提供了很好的兜底，而 ECS + Nginx 则是最稳妥的静态站点方案。希望这份记录能帮你少踩坑：先本地验证，再正式部署，最后别忘了清理资源。