PocketBase 部署步骤(一次性):
1. 到 pocketbase.io 下载 Windows 单文件版(pocketbase.exe),双击运行(默认地址 http://127.0.0.1:8090);
2. 浏览器打开 http://127.0.0.1:8090/_/ 进入管理后台,创建集合(Collections)命名为 rooms,添加字段:
· roomCode(Text,可勾选唯一)| hostUid(Text)| playerIndex(JSON)| gameState(JSON);
3. 集合的 API 规则(测试期):List / View / Create / Update / Delete 规则都留空(=公开);
4. 回到本页,填写服务地址并保存。局域网联机:将 pocketbase.exe 所在电脑的局域网 IP 填入(如 http://192.168.1.5:8090),并放行防火墙 8090 端口;好友在同一 WiFi 下用该地址即可加入;已有 ZeroTier 等虚拟内网时,填对方设备的 ZeroTier 私有 IP(10.x/172.x)同样可用。
5. 公网联机(发布后):本页若部署为 https 网页(如 Cloudflare Pages),PocketBase 也必须挂在 https:// 开头的公网域名(云服务器 + 域名 + HTTPS 证书,或 Cloudflare Tunnel 等);浏览器只允许 https 页面访问 https 后端,localhost 不能用于公网联机。
无需任何外部 CDN,所有通信走你自己的 PocketBase 服务。
🚀 PocketBase 服务(本机一键启动)
仅「运行游戏主机(房主电脑)」使用:一键启动本机 PocketBase。若 8090 端口已有 PocketBase 在运行(或已手动启动),状态会显示「运行中」,无需重复启动。
前置:需先双击运行 「启动公网隧道服务.bat」(隧道桥黑窗口保持常开)。
点击上方按钮检测并启动
点击后检测本设备能否连上服务器(请求 /api/health 与游戏页);把本页发给玩家,让他们先点这里确认能连通再进房。
🌐 公网隧道(Cloudflare Tunnel)
仅「运行 PocketBase 的主机(房主电脑)」使用:一键把本机 PocketBase 变成 https://xxxxx.trycloudflare.com 公网地址(浏览器只允许 https 页面访问 https 后端)。
其他设备(手机/朋友)不要点启动,只需等房主把地址填入联机设置即可进房。
前置:先在主机上双击运行 「启动公网隧道服务.bat」(会弹出一个隧道桥黑窗口,保持常开)。
未启动(需先运行「启动公网隧道服务.bat」)