第一步：选对服务器，提前准备环境 别信“随便买台云服务器就行”这种话。我见过太多团队，一开始图省事，结果上线第一天就崩了——回头一查，问题全出在这一环。 必须用独立公网 的云服务器，别碰共
第一步：选对服务器，提前准备环境
别信“随便买台云服务器就行”这种话。我见过太多团队，一开始图省事，结果上线第一天就崩了——回头一查，问题全出在这一环。
- 必须用独立公网IP的云服务器，别碰共享带宽或者弹性公网IP。那种流量像坐过山车，一到高峰期直接断连，用户刚进游戏就掉线，谁受得了？
- 推荐配置：2核4G 50GB SSD硬盘 10Mbps带宽起步。但说实话，跑起来才发现，日活一超过500人，10Mbps撑不了两天，加载慢得像卡在PPT里。建议直接上20Mbps，至少别让用户骂你“这破平台怎么这么卡”。
- 操作系统：清清爽爽的 CentOS 7⁄8 或 Ubuntu 20.04 就行，别碰 Debian、Alpine 这类“轻量但不稳”的发行版。有些包网系统依赖特定内核模块，小众系统一上来就报错，调试半天发现是系统不兼容。
- 关键动作：防火墙必须关掉，或者手动放行这几个端口：
9999（wgcloud服务端）5188（agent通信端口）80和443（后面要绑域名，不开放等于白搭）
✅ 实战提醒：有团队在阿里云部署时，用了“安全组默认拒绝所有入站”，结果连不上。不是代码问题，是网络策略没开。改完后立马通了——这不是技术问题，是流程漏了。
（你想想，连基本的入口都没打开，还指望系统自己跳出来？）⚠️ 补充盲点：如果你用的是腾讯云，务必确认“实例网络类型”是“基础网络”而不是“VPC”。VPC环境下某些内网通信会失败，尤其涉及 agent 自动注册时，根本连不上服务器。我见过一个团队，折腾了三天才意识到这个问题，真是哭笑不得。
第二步：安装 MySQL 数据库（看似简单，实则陷阱多）
这一步看着像“装个数据库”那么简单，可真正出问题的90%都藏在这里。
- 安装命令没错，但很多人忘了执行
mysql_secure_installation，结果默认空密码，黑客三分钟就能进。别问为什么，问就是被扫了。 - 创建库和用户时，一定要加
IDENTIFIED BY '你的强密码'，不能只写CREATE USER 'wguser'@'%'就完事。不然连接时报错“密码错误”，你去查半天才发现是根本没设密码。 - 字符集也得盯紧：
utf8mb4是必须的。因为部分游戏名称含表情符号或特殊中文，utf8会截断，前端一显示就乱码，用户体验直接拉垮。
真实踩坑案例：某团队用
utf8字符集，上线后发现“澳门银河”变成“澳门银”，查了半天才发现是编码问题。换回utf8mb4后才正常——这哪是技术问题，这是认知问题。风险提示：不要把数据库和应用放在同一台服务器上。一旦服务器被入侵，整个平台数据全暴露。就算只是测试环境，也建议分开部署。别想着“反正没人用”，等真出事了再后悔，那就晚了。
第三步：安装 JDK 1.8（服务端必需，版本要盯死）
- 必须用 Oracle JDK 1.8，不是 OpenJDK。部分 WG 包网系统底层依赖 Oracle 的 JVM 特性，用 OpenJDK 会报
UnsupportedClassVersionError，启动直接崩。 - 下载地址必须来自 Oracle 官方，别从第三方网站下。网上很多“免登录下载”链接全是打包木马，一运行就中招。
- 解压路径必须是
/opt/jdk1.8.0_381，别改名字。脚本里硬编码了这个路径，你要是改成/opt/jdk1.8，少了个0，启动就挂。 - 环境变量写进
/etc/profile没问题，但记得执行source /etc/profile，否则java -version显示的还是旧版本，搞半天还以为环境没配好。
❗ 常见错误：有人复制命令后忘记改
your_password，或者把export JAVA_HOME=/opt/jdk1.8.0_381写成JAVA_HOME=/opt/jdk1.8，少了个0，启动就崩。这种低级错误，真的能让人当场发疯。平替方案：如果不想折腾 JDK，可以用 Docker 部署。找一个官方镜像，比如
openjdk:8-jdk-alpine，虽然不是完美兼容，但能跑通基本功能，适合快速验证原型。省时间，也省心。
第四步：下载并部署 wgcloud 源码（最易翻车环节）
- 下载地址是
https://www.wgstart.com/download/wgcloud-v3.5.tar.gz，但这网站经常挂。建议提前准备好离线包，或者用 GitHub 镜像（如果有）。 - 解压后进入目录，别急着运行
start.sh。先检查文件权限是否完整，有没有缺失.jar文件。有时候压缩包损坏，解出来缺几个核心文件，启动就报错。 - 修改
application.properties时，必须确认serverUrl是公网可访问的地址。如果写的是内网 IP，agent 根本连不上，你以为是系统问题，其实是配置错了。
⚠️ 致命错误：数据库连接字符串中
useSSL=false必须写，不能省略。很多新人都删掉这句，结果连接超时，查半天才发现是 SSL 握手失败。别不信，真有人为此蹲了一晚上。强烈劝退指南：如果你预算低于 3000 元/月，且没有运维经验，强烈不建议用 wgcloud 原生部署。维护成本高，升级难，出问题没人帮你修。不如直接用现成的 SaaS 平台，便宜还省心。别为了省几千块，把自己逼成“兼职运维”。
第五步：部署 agent 客户端（监控用，但极易失联）
- 在另一台机器上部署 agent，最好用独立服务器，别用自己电脑。笔记本休眠、断电、杀毒软件拦截，都会导致 agent 断线。你早上一开机，平台显示“设备离线”，用户投诉“无法登录”，你才知道是部署位置错了。
serverUrl必须是公网可访问的域名或 IP，不能写localhost。不然连不上，你还在那看日志，以为是后端挂了。- 启动后，立刻去浏览器打开
http://你的IP:9999，确认 agent 是否出现在“在线设备”列表。没出现？说明通信失败，赶紧查日志。
真实教训：有团队把 agent 放在本地电脑，每天早上上班才开机，结果平台显示“设备离线”，用户投诉“无法登录”。根本不是系统问题，是部署位置错了。这种事，我见过不止一次。
业内共识：现在主流做法是用 Docker Nginx 反向代理 自动心跳检测 来管理 agent。比手动部署稳定十倍，还能自动重连。别再用原始方式了，太费精力。
第六步：绑定域名与启用 HTTPS（可选但必须做）
- 域名建议买
xxx.hk，别用.com或.net。HK 域名更容易通过本地服务商审核，且在港台地区访问更快，延迟更低。 - DNS 解析时，别用
CNAME，必须用A 记录。某些 CDN 服务会干扰代理逻辑，导致反向代理失效。 - 使用 Let’s Encrypt 申请证书时，必须确保 80 端口开放，否则
certbot无法验证域名所有权，证书申请失败。
⚠️ 大坑预警：很多人在用 Nginx 时，忘记把
location /的请求转发到9999端口。结果页面打不开，以为是后端挂了，其实只是反向代理没配好。这种问题，排查起来特别耗时间。平替方案：如果不想搞复杂配置，可以用 Cloudflare Pages Worker 搭一个静态前端，再用 API 网关对接后端。成本低、速度快、抗攻击能力强，适合中小型项目。别总想着“自己搭”，有时候借力才是聪明。
常见问题解答（FAQ）
Q1：我不会写代码，能不能自己搭？
可以，但前提是你会照着做，而不是“想当然”地改配置。
- 不懂命令就别瞎试，复制粘贴前先确认每行命令的作用；
- 不懂网络就别随意开端口，尤其是
9999和5188，容易被扫描器盯上。
如果你是第一次接触服务器，强烈建议先花一天时间学基础命令：
ssh、scp、vim、systemctl、netstat。否则后面一出错就懵。别嘴上说“我能行”，结果连日志在哪都找不到。
Q2：为什么登录提示“连接失败”？
最常见原因：
- 服务器防火墙没开
9999端口（尤其阿里云需在控制台安全组放行）；
application.properties中数据库地址写错，比如写成了127.0.0.1；
- 未安装 JDK，或
JAVA_HOME没配置；
- 服务启动后崩溃，查看日志
logs/start.log才能定位。
✅ 正确排查顺序：先看
netstat -tuln | grep 9999，再查日志，最后确认配置文件。别一上来就重启，那是浪费时间。
Q3：要不要备案？香港平台需要吗？
不需要备案，但必须确保服务器物理位置在境外。
- 如果你在大陆租用“香港节点”服务器（如阿里云香港机房），法律上仍属于中国大陆管辖范围，一旦涉赌，一样会被追责。
- 真正合规的做法是：租用位于香港本地的独立服务器，由本地运营商提供，并确保所有用户访问路径不经过大陆网络。
警告：任何声称“大陆机房也能合法运营赌博平台”的说法都是骗人的。别信，别碰。
Q4：能不能接入真人游戏、体育投注？
可以，但你要清楚代价：
- 真人荷官接口通常按“每局流水抽成”，成本高；
- 体育盘口接口需要支付高额授权费，且有风控限制；
- 所有第三方接口都可能突然下架，你得自己处理切换。
业内平替方案：先用模拟游戏 虚拟币系统跑通流程，等用户量上来再逐步接入真实接口。别一上来就堆资源，风险太大。
Q5：部署后多久能上线？
最快3小时，但这是理想状态。
- 真实情况：至少预留半天时间处理突发问题，比如网络不通、数据库连接失败、证书申请失败。
- 加上域名解析生效时间（一般10分钟~2小时），真正能对外访问，大概需要6~12小时。
✅ 实战建议：不要追求“当天上线”。先在内部测试，确认无误再对外发布。别为了赶进度，把漏洞直接扔给用户。
最后提醒：
- 切勿在大陆服务器上部署赌博类平台，违法风险极高；
- 所有数据请备份，尤其是数据库；
- 定期更新 wgcloud 版本，防止漏洞被利用；
- 如果你属于预算低于3000元/月、无运维经验、希望快速上线，放弃原生部署，改用现成 SaaS 平台，才是务实选择。
你现在要做的，不是盲目执行命令，而是先问自己一句：我能不能扛住接下来的维护压力？
如果答案是“不能”，那就别硬上。
真正的高手，不是能把系统跑起来的人，而是知道什么时候该停下来的人。