《石器时代8.0》H5网页版单机端：Win本地端+微端+Linux手工端+虚拟机端，三步启动完整教程

《石器时代8.0》H5网页版整合包，包含Win本地端、微端、Linux手工端与虚拟机端多种形态，可按需选择使用。以下为Win本地端的完整启动与配置说明。

三步快速启动

第一步：解压到合适路径

将整个文件夹解压到一个不带空格、最好不带中文的路径，例如 D:\StoneAgeH5\石器H5服务端\ 或 D:\StoneAgeH5\。请注意不要只解压出一部分，assets资源约1.2GB，必须完整解压。

第二步：放行防火墙

右键「放行防火墙.bat」→ 以管理员身份运行（只需执行一次）。Windows防火墙默认会拦截8800端口，不放行的话其他机器无法连接进来。

第三步：启动服务端并进入游戏

双击「启动服务端.bat」，会出现一个最小化的黑色日志窗口，请不要关闭它，关闭即代表服务停止。随后双击「打开游戏.bat」，浏览器会打开 http://127.0.0.1:8800/，在登录页点击「注册新账号」即可开始游玩。

停止服务：双击「停止服务端.bat」。查看状态：双击「查看状态.bat」（可查看进程、8800端口与HTTP自检情况）。

微端与网页游戏的连接方式

同一台机器：浏览器或微端地址栏填 127.0.0.1，端口8800，协议http。

局域网另一台机器或独立微端：

1. 在这台Windows上运行 ipconfig，查看「IPv4地址」（如192.168.x.x）。

2. 先用「设置IP.bat」把登记IP改成这个值（详见下文）。

3. 微端地址栏填这个IP，端口8800，协议http；或直接浏览器打开 http://192.168.x.x:8800/。

4. 两台机器要能互通，且Windows防火墙已放行8800。

外网访问：需要云安全组或路由器端口映射放行8800。由于HTTP为明文传输，务必限制来源IP并使用强密码。

注意：不能只双击 client\index.html——页面、资源、WebSocket都必须由saserver通过http://提供。

修改IP（设置IP.bat）

用法二选一：双击「设置IP.bat」按提示输入新IP；或在命令行执行 设置IP.bat 192.168.1.100。

该脚本会校验IPv4格式、写入 server.ip、打印新的访问地址与微端填写方式，并给出防火墙提醒。「查看状态.bat」会显示当前登记值。

重要说明：H5服务端监听的是 0.0.0.0:8800，更换IP不需要修改任何程序配置。客户端WebSocket也是按浏览器地址栏同源推导的，改的只是「登记/提示」，不是程序里的硬编码IP。换IP后真正要做的只有两件事：① 新环境的防火墙/安全组放行8800；② 微端或浏览器改用新地址。server.ip 默认 127.0.0.1（本机），只是给脚本和提示用的登记值。本包不写任何真实公网IP，可放心分发。

GM账号说明

config.local.yaml 里的 gms: [admin] 只是把admin这个名字保留给管理员，不会创建账号，也没有默认密码。要使用GM功能：在登录页「注册新账号」时用admin注册，自己设置密码（8至64位）与安全码，登录后按Esc，系统窗口会多出「GM指令」菜单。已有账号想提权：把它的登录账号名写进gms，重启服务端后重新登录即可。正式服建议改成不显眼的名字。

存档与配置

如需开机自启：把「后台启动.bat」的快捷方式放进 %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup，用户登录后会自动启动，无需管理员权限，也不会弹出确认框。

安全与常见问题

1. HTTP明文风险：密码的MD5在网络中相当于明文，可被截获重放。仅建议本机、局域网或小范围使用；对外请限制来源IP、使用独立强密码，有已备案域名与证书后可在 config.local.yaml 中配置 tlsCert / tlsKey。

2. 打不开8800：先运行「查看状态.bat」，确认防火墙已放行、8800未被其他程序占用（可用 netstat -ano | find ":8800" 检查）、黑色日志窗口没有被关闭。

3. 更换端口：修改 config.local.yaml 中的addr，同时修改防火墙规则里的端口，微端端口也要同步更改。

4. 路径带空格或中文导致异常：换到 D:\StoneAgeH5 这类简单路径重试。

5. 杀软误报saserver.exe：这是Go静态编译的服务端程序，加入白名单即可。

6. 首次启动生成bin/saserver.db：属于正常现象。