Hexagon

Hexagon 是一个 Web-first 的网络桌游对战中心 MVP。当前包含大厅、昵称入口、房间同步、观战位、桌边聊天气泡、单人 AI 桌，以及文件夹式游戏插件。

本地运行

npm install
npm run build
npm run dev

打开：

http://127.0.0.1:5173

小主机部署：Docker Compose

如果还没拉代码：

git clone https://github.com/PawnPony/Hexagon.git
cd Hexagon

在项目目录执行：

sudo docker compose up -d --build
sudo docker compose ps
sudo docker ps --filter name=hexagon

服务会跑在：

http://127.0.0.1:5173
http://127.0.0.1:5173/admin

Cloudflare Tunnel 的 Public Hostname 服务地址填：

http://127.0.0.1:5173

FRP 的本地服务也指向 127.0.0.1:5173。

查看管理令牌：

sudo docker compose exec hexagon cat /app/data/admin-token.txt

如果想让 Compose 一起跑 Cloudflare Tunnel

把 Cloudflare Tunnel Token 写进 .env：

echo "CF_TOKEN=你的 Cloudflare Tunnel Token" >> .env
sudo docker compose --profile tunnel up -d --build

Cloudflare Tunnel 的 Public Hostname 服务地址填：

http://hexagon:5173

更新

在小主机的项目目录执行：

git pull
sudo docker compose up -d --build
sudo docker compose ps

管理面板

管理面板地址：

/admin

可以在面板里做这些事：

• 查看服务运行状态、在线连接、房间列表
• 修改大厅名称和大厅公告
• 开关维护模式
• 关闭等待桌、结算桌或全部房间

数据和配置

Docker 会把服务端配置保存到：

./data/server-config.json
./data/admin-token.txt

备份时保留 data/ 即可。如果你额外创建了 .env，也一起备份。

备用部署方式

裸机 systemd、FRP 中转、公网 VPS + Nginx、HTTPS 证书等补充放在：

docs/deployment.md

游戏插件协议在：

docs/game-plugin-protocol.md

给 AI 生成新游戏文件夹的完整上下文在：

docs/ai-game-folder-spec.md

新增游戏流程在：

docs/adding-a-game.md