大橘为重

主题切换

01 开始使用：覆盖、启动与首次检查 ​

本章适合第一次把 Go 后端商城覆盖到原易语言后端目录时阅读。目标是让管理知道：包里有什么、应该覆盖到哪里、启动后看哪些状态。

示例视频预留

这里后续可放“从解压覆盖到首次进入后台”的视频，例如：/mp4/newwebdoc/01-start.mp4

一、覆盖包里通常包含什么 ​

新版覆盖包一般包含以下内容：

内容作用
scumwebgo.exeGo 后端主程序，负责网站、API、RCON 发货、日志同步和后台任务
启动商城.batWindows 一键启动脚本，双击即可运行后端
dist前端网页生产资源，玩家前端和商城后台都从这里读取
static新版后端使用的静态资源缓存目录
服务器文件授权、运行配置等基础目录
覆盖说明.txt当前包的简要说明

覆盖包默认不会包含真实服务器的 数据库配置.ini。这点很重要：服务器上的数据库、网站端口、RCON、SFTP/FTP 等真实配置应保留在原运行目录里，不要被测试配置覆盖。

二、覆盖前要确认的目录 ​

把压缩包解压到原商城后端运行目录，也就是以前易语言后端所在的目录。

常见目录示例：

text
E:\Sever\4800\steamapps\common\SCUM Server\SCUM网页商城

覆盖前建议确认目录里至少有：

  • 数据库配置.ini
  • 旧资源目录，如 网站\网页
  • 如使用 FRPC，保留原来的 家庭用户工具 或节点配置目录
  • 如使用授权，保留 服务器文件 中已有授权文件

如果不确定，先完整备份原目录，再覆盖新版文件。

三、启动商城 ​

覆盖完成后，双击：

text
启动商城.bat

也可以直接运行：

text
scumwebgo.exe

黑框里看到下面几类信息，通常说明启动流程正常：

日志关键词说明
数据库 已连接已连接 MySQL 数据库
表结构检查完成后端已完成必要字段、索引和兼容检查
前端 静态资源目录已找到 dist 前端资源
授权 远程验证通过商城授权有效
网站 本机监听成功网站端口已经启动
RCON connected and authenticatedRCON 已连接并认证成功
发货队列 已启动后台发货队列已经开始工作

如果看到授权到期或未填写授权账号，访问网站时会进入授权页面。按页面提示登录、注册或续费后，后端会自动恢复后台任务，不需要反复重启。

授权中心页面 ​

新版授权页会根据当前状态显示不同入口：

场景页面可用操作
授权正常刷新状态、进入商城
授权已到期且已有授权账号扫码续费、卡密续费、重新验证
新商城没有授权账号注册授权账号、登录授权账号、获取验证码
忘记授权密码找回密码后重新验证

授权页会隐藏完整账号密码，只显示必要状态。续费完成后点击“重新验证”或刷新状态即可恢复商城访问。

如果已有授权账号，授权到期后不建议重新注册新账号，优先使用原账号续费。

四、访问网站 ​

优先在服务器本机测试：

text
http://127.0.0.1:网站端口

例如网站端口是 80：

text
http://127.0.0.1

如果本机可以打开，再测试外网地址或反代域名，例如：

text
http://服务器IP:网站端口
https://你的域名

注意：FRPC 只负责把外部域名转发到当前网站端口。后端不会因为 FRPC 域名不可用就停止网站服务。如果本机能访问、外网不能访问，优先检查防火墙、安全组、反代和 FRPC 指向端口。

五、首次进入后台后先看哪里 ​

进入后台后建议按这个顺序检查：

  1. 打开“数据面板”

    • 看授权到期时间是否正常。
    • 看 RCON 状态是否正常。
    • 看发货队列是否暂停。
    • 看最近在线玩家数据是否有刷新。

  2. 打开“程序设置”

    • 检查数据获取间隔、发货速度。
    • 检查商城币名称是否正确。
    • 检查网页在线人数是否需要显示。

  3. 打开“服务端管理”

    • 检查 RCON 相关功能是否能读取玩家或角色信息。

  4. 打开“日志命令”

    • 检查日志下载配置是否可用。
    • 如启用建家权限托管，确认 AdminUsers.ini 同步状态。

六、默认账号与安全建议 ​

测试环境常用管理员账号密码为：

text
dajugame / dajugame

正式服建议在确认后台可以进入后，尽快修改管理员密码，并避免把默认密码发给普通玩家。

七、常见启动问题 ​

1. 端口无法访问 ​

先看黑框是否出现“网站本机监听成功”。如果没有成功，通常是端口被占用、系统端口残留、防火墙或安全软件拦截。

处理顺序：

  1. 换一个网站端口测试是否能打开。
  2. 确认 数据库配置.ini 中的网站端口是否是当前想使用的端口。
  3. 检查 Windows 防火墙和云服务器安全组。
  4. 如果旧进程占用端口，先结束旧后端后再启动。

2. 数据库连接失败 ​

重点检查 数据库配置.ini：

  • 数据库地址
  • 数据库端口
  • 数据库名
  • 用户名
  • 密码

如果 MySQL 在本机，地址通常是 127.0.0.1。如果 MySQL 在远程机器，需要确认远程 MySQL 已允许连接。

3. RCON 连接失败 ​

RCON 失败不一定影响网站打开，但会影响发货、在线玩家同步、建家权限提示、聊天互动等功能。

检查顺序：

  1. RCON 地址、端口、密码是否正确。
  2. 游戏服务器 RCON 是否已开启。
  3. 后端所在机器是否能访问 RCON 端口。
  4. 数据面板中 RCON 状态是否恢复。

4. 前端图片不显示 ​

新版后端会优先读取 dist 和 static，如果资源不存在，还会兼容旧易语言后端的 网站\网页 目录。礼包、商品图片建议仍保留原来的图片目录，避免覆盖后出现缺图。

八、玩家可能会问 ​

玩家说：为什么网站突然跳到授权/续费页面？ ​

通常不是玩家账号问题，而是商城授权到期、授权验证失败或授权账号密码缺失。管理应先进入授权页处理商城授权，授权恢复后玩家页面会恢复访问。

玩家说：网页能打开，但购买后没到账？ ​

先看数据面板的 RCON 和发货状态。如果 RCON 断开或发货暂停，玩家下单可能无法继续发货。恢复 RCON 后再查发货记录。

玩家说：我在线，但网站显示不在线？ ​

在线状态来自 RCON 的在线玩家数据。可能是数据获取间隔未到、RCON 刚断线重连，或玩家刚上线数据还没同步。让玩家稍等一个刷新周期，再看数据面板最近在线玩家同步时间。

九、本章检查清单 ​

  • 已备份旧商城目录。
  • 已覆盖新版包到原运行目录。
  • 服务器原 数据库配置.ini 没有被覆盖。
  • 黑框显示数据库、授权、网站监听正常。
  • 本机 127.0.0.1:端口 可以打开。
  • 后台数据面板能看到 RCON、授权、在线数据状态。

示例视频预留

这里后续可放“启动失败排查”的视频，例如：/mp4/newwebdoc/01-troubleshooting.mp4