《石器时代8.0 H5网页版》Windows本地端三步部署指南：微端/网页连接、改IP与GM账号说

wktony

《石器时代8.0 H5网页版》资源包含Windows本地端、微端、Linux手工端与虚拟机端，本次说明以Windows本地端为主。整套服务不依赖外部数据库，解压后按“放行防火墙、启动服务端、打开游戏”三步即可跑起来。游戏页面、资源与WebSocket均由saserver通过HTTP提供，因此不能只双击client\index.html，必须通过服务端地址访问。
- 三步启动，路径简单：解压到不带空格、尽量不带中文的路径，例如`D:\StoneAgeH5\`，确认assets约1.2GB完整解压。首次以管理员身份运行“放行防火墙.bat”，放行8800端口。双击“启动服务端.bat”后会出现最小化的黑色日志窗口，不能关闭，关闭即停止服务。双击“打开游戏.bat”即用浏览器打开`http://127.0.0.1:8800/`，在登录页注册新账号即可开始。
- 状态与停止有专门脚本：双击“停止服务端.bat”停止服务；双击“查看状态.bat”可检查进程、8800端口与HTTP自检情况。
- 同机、局域网、外网连接方式清晰：同一台机器在浏览器或微端地址栏填`127.0.0.1`，端口8800，协议http。局域网另一台机器需先用ipconfig查看IPv4地址，再用“设置IP.bat”登记该IP，微端或浏览器改用该IP访问，并确保两台机器互通、防火墙已放行8800。外网需在云安全组或路由器端口映射放行8800；因HTTP为明文，务必限制来源IP并使用强密码。
- 改IP只需登记与放行：服务端监听`0.0.0.0:8800`，换IP不需要修改程序配置，客户端WebSocket按浏览器地址栏同源推导。真正要做的是新环境防火墙或安全组放行8800，以及微端或浏览器改用新地址。`server.ip`默认`127.0.0.1`，只是脚本与提示使用的登记值，包内不写真实公网IP。
- GM账号机制：`config.local.yaml`中的`gms: [admin]`只是把admin保留为管理员名，不会自动创建账号，也没有默认密码。需要GM时，在登录页用admin注册并自行设置8至64位密码和安全码，登录后按Esc，系统窗口会多出“GM指令”菜单。已有账号想提权，可把登录账号名写入gms，重启服务端后重新登录；正式服建议改用不显眼的名字。
- 存档与配置集中：`bin/saserver.db`保存账号、角色、家族等全部存档，基于SQLite，删除即清空全部数据，操作前先备份。`config.yaml`为官方设定，不建议修改；`config.local.yaml`用于本机覆盖addr、gms、TLS，改完需重启；`server.ip`由“设置IP.bat”维护；`docs/手册.md`为官方完整手册。需要开机自启时，可把“后台启动.bat”的快捷方式放入`%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup`，用户登录后自动启动，无需管理员权限，也不会弹确认框。
安全与常见问题：HTTP为明文传输，密码MD5可被截获重放，仅建议本机、局域网或小范围使用；对外请限制来源IP、使用独立强密码，有已备案域名与证书后可在`config.local.yaml`配置`tlsCert`与`tlsKey`。打不开8800时，先运行“查看状态.bat”，确认防火墙已放行、8800未被其他程序占用（可用`netstat -ano | find ":8800"`检查）、黑色日志窗口未被关闭。换端口需修改`config.local.yaml`中的addr，同时调整防火墙规则与微端端口。路径带空格或中文导致异常时，换到`D:\StoneAgeH5`这类简单路径重试。杀软误报`saserver.exe`时，可加入白名单，该程序为Go静态编译服务端。第一次启动会生成`bin/saserver.db`，属正常现象。

百度链接: https://pan.baidu.com/s/1W4R5CszH-ftQimVcCj-SUQ?pwd=y3hk 提取码: y3hk
夸克链接：https://pan.quark.cn/s/82c7d9eb1521?pwd=aYB6 提取码：aYB6