游戏介绍:
# 本地兼容服务
当前提供浏览器适配入口、登录、初始化数据、客户端设置保存。已通过本地和服务器浏览器进场验证,可进入冰川时代主场景;不代表完整玩法服务端。
## 启动
在项目根目录执行 `powershell -ExecutionPolicy Bypass -File .\tools\start-local.ps1`,
然后打开 http://127.0.0.1:18880/ 。窗口中按 Ctrl+C 停止。
脚本在前台运行已有构建产物,不自动打开浏览器或停止其他进程。
服务器身份可用启动参数配置,默认仍为 `serverId=1`、`groupId=1`、`serverList=[1]`:
“`powershell
# 直接运行新构建产物(项目根目录)
./artifacts/bin/shiguang.exe -root . -server-id 7 -group-id 9 -server-list ‘7,8’
# 或通过既有本地启动脚本传入
powershell -ExecutionPolicy Bypass -File ./tools/start-local.ps1 -ServerId 7 -GroupId 9 -ServerList ‘7,8’
“`
未指定 `server-list` 时只包含本服;显式列表必须唯一、为正整数且包含本服。
`server-list` 是活动分组声明,不会自动创建远端服务或跨进程匹配;登录列表只发布本实例地址。
已有角色归属、冻结赛程不随启动参数迁移,新服应使用独立 `-data-dir` 或独立数据库。
玩法中的武道比赛组、地图编号和轮次不属于这些部署参数。
重新构建(在 `server` 目录):
“`powershell
& ‘C:\Program Files\Go\bin\go.exe’ test ./…
& ‘C:\Program Files\Go\bin\go.exe’ vet ./…
& ‘C:\Program Files\Go\bin\go.exe’ build -o ../artifacts/bin/shiguang.exe ./gateway/cmd
“`
重新生成网页(在项目根目录):`node tools/build-web.cjs`。
不要直接修改生成的 `frontend/web/__APP__.js`、`_logic_.js`、`_tbd_.js`;
适配变更写入生成脚本,原包保留在 `frontend/packages`。
## 模块
沿用参考工程的 gateway / game / modules / pkg / proto 分层思路,协议根据本游戏客户端实现。
| 路径 | 职责 |
| — | — |
| gateway/cmd | HTTP、静态网页和资源镜像入口 |
| gateway | WebSocket 生命周期、二进制帧与心跳 |
| proto | MessagePack 请求、响应和推送,保留空字符串序号键 |
| game/message | 路由、会话和统一拒绝响应 |
| game/modules/account | 本地测试登录、服务列表、临时票据 |
| game/modules/user | 登录初始化和登出 |
| game/modules/role | 允许的客户端设置保存 |
| game/modules/decorate | 初次形象设置 |
| pkg/storage | 本地 JSON,或 MySQL 持久化与 Redis 版本缓存 |
| pkg/gameconfig/data | 从包内表导出的部分配置 |
服务为单进程;默认仅监听 `127.0.0.1:18880`。角色保存在 `server/data`,
票据保存在内存,重启后需重新登录。未知玩法请求返回拒绝,未模拟支付和奖励成功。
本地初始角色数据为兼容测试数据,不是官方账号存档。
## 验证边界
离线测试使用原客户端 MessagePack 库产生请求,并用该库解码 Go 回包。
覆盖登录、设置保存及重读、非法资产写入拒绝、拒绝后继续处理和本地票据校验。
已通过实际 WebSocket 登录、初始化推送、心跳及浏览器主场景验证。
配置导出中的部分本地化文字是文本 ID,部分表仍需运行时加载。
资源清单尚有 166 项无法还原路径,见 `artifacts/unresolved-resources.json`。
此前的工具访问限制已恢复,现可通过 HTTP 页面联调。
回滚时恢复生成脚本和网页适配文件即可;原始缓存与参考工程未改动。
保留 `server/data` 可保留本地角色,重建网页不会删除该目录。
## 服务器部署(2026-10-21)
入口:http://101.35.235.96:81/ 。客户端位于 `/data/frontend/web`,资源位于
`/data/frontend/cdn`,服务端位于 `/data/server`。Nginx 81 端口代理 HTTP 与 WebSocket,
Go 仅监听 `127.0.0.1:18880`。部署配置见 `deploy/`,由 systemd 管理 `shiguang.service`。
MySQL `shiguang.roles` 是角色权威存储,事务及行锁保证同账号并发写入串行提交。
Redis 仅监听 loopback,用带数据库版本的键缓存角色,TTL 5 分钟,启用 AOF;
缓存缺失或不可用时读取 MySQL,不以缓存恢复覆盖数据库。SQL 修改提交后再写缓存。
现有 JSON 角色已通过 `-import-json` 导入,只插入不存在的角色,不覆盖已有 SQL 数据。
独立数据库账号仅有 SELECT/INSERT/UPDATE 权限,凭据位于 root 保护的
`/etc/shiguang/storage.json`,通过 systemd LoadCredential 传递,不在源码内。
`-storage-config` 启用 SQL,未提供时继续使用本地 JSON。
`-public-url` 设置客户端收到的公共服务地址。票据仍在内存,服务重启需重新登录。
维护命令:`systemctl status shiguang redis`、`journalctl -u shiguang -n 50`、
`systemctl restart shiguang`。Nginx 配置修改后先执行 nginx -t 再 reload。
数据库初始化脚本 `tools/deploy-setup.py` 仅适用于首次安装,已有库或凭据目录会拒绝重建。
存储集成测试需显式设置 `SHIGUANG_STORAGE_TEST_CONFIG`,只创建唯一测试账号,
验证并发更新、失败回滚、Redis 填充/丢失/连接失效和重新打开存储后的持久化。
测试账号保留供审计;不清空 Redis 或删除既有玩家。
网页现提供注册、密码登录和退出。账号名统一小写,密码以 bcrypt 哈希保存;
MySQL accounts/auth_sessions 保存账号及会话,Redis 缓存会话资料,数据库始终校验有效期和撤销状态。
兼容路径 /player/testLogin 仅向已登录浏览器签发游戏票据,忽略客户端 uId,不能匿名冒用。
每个游戏请求重新校验登录状态,退出后旧票据不能继续修改角色。
旧测试角色仍保留,但不允许用户仅凭名字认领;新注册账号使用独立角色标识。
当前 81 端口为 HTTP,部署正式账号前应配置域名和可信 HTTPS;不要在此使用其他网站的密码。
建筑收益结算等未实现玩法仍返回拒绝。166 项资源路径尚未恢复。
## 全量配置 556
运行 `node tools/extract-config.cjs` 可复现导出,位于 `server/pkg/gameconfig/data`。
共 1,115 张表/常量对象、452,649 条表数据、1,449 个函数引用。
manifest.json 记录源文件与导出文件 SHA256、行数和版本;functions.json 保留原函数源码。
文本字段保留原本地化 ID;函数引用不是已移植的 Go 业务逻辑。
范围包括客户端注册的全部 tb 表及 38 个动态资源表,不含正式服实时下发的活动配置。
导出先写暂存目录并验证,旧目录移动到 artifacts/config-backups 后才切换。
安装环境:
Nginx 1.30
MySQL 5.7
PHP 8.3
redis-7.4
上传服务端“data.zip”到服务器根目录
配置环境:
cd /data/server/deploy
./setup.sh
启动游戏:
cd /data/server/deploy
./start.sh
停止游戏:
cd /data/server/deploy
./stop.sh
注意事项
在搭建过程中,可能会遇到各种问题,建议仔细阅读搭建教程,并尝试自己解决。
如果遇到无法解决的问题,可以在相关论坛或社区寻求帮助。
请遵守相关法律法规,不要利用搭建的游戏环境从事任何违法活动。
游戏截图:
下载地址:
默认解压密码:www.aae.ink
如果不是此解压密码,注意看压缩包的注释,推荐使用winrar进行解压!



![[一键安装] 【转载】原神3.4真端服务端+源码+配套客户端+详尽说明+GM工具+源码说明文件|Aae_Source](https://www.aae.ink/wp-content/uploads/2023/08/61c86a488f104207.png)








![[一键安装] 崩坏3V1.5版本一键端启动端分享+一键代理+免虚拟机一键启动+女武神ID+详细指令+极简一键修改|Aae_Source](https://www.aae.ink/wp-content/uploads/2023/09/94d6cdea56150351-1024x490.png)









请登录后查看评论内容