← 返回项目库

桌游战役与角色协作系统｜自托管桌游战役与角色协作工作台

为桌游主持人与固定玩家团队提供自托管战役工作台，管理冒险故事、角色与素材，并将战役记录存入自己的PostgreSQL。

CozyVTT 是基于 React、Express、PostgreSQL 与 Socket.io 的自托管桌游协作应用。本交付保留完整上游应用，中文覆盖本次已验证的核心工作台与表单。实测通过原生初始化接口建立本地管理员，使用真实登录页面登录，在原生表单填写并新建战役，列表与后端接口读回相同记录；刷新、应用与数据库重启后记录保留，并在另一端口完成独立写入。六个真实页面状态展示战役工作台、新建表单、保存结果、战役房间、素材库和管理统计。完整源码包含地图、角色卡、骰子、聊天、战役导入导出等模块；多人实时协作、外部邮件、地图动态光照与完整安全审计未在本次逐项验证，不作为交付承诺。部署需要 Docker Compose、PostgreSQL 与受保护的运行密钥。上游采用 AGPL-3.0，修改后以网络服务提供时应履行源代码公开等许可义务；不提供额外商业授权。 本次构建安装审计：后端生产依赖报告9项漏洞（3中、5高、1严重）；前端构建依赖32项（7中、22高、3严重），后端全量构建依赖52项（6中、44高、2严重）。未做全面安全修复，部署前需完成依赖升级及安全复核。

真实界面

项目截图

共 6 张

桌游战役与角色工作台：桌游战役与角色工作台；原生React/Express与PostgreSQL业务页面
填写新战役与规则设置：填写新战役与规则设置；原生React/Express与PostgreSQL业务页面
新战役保存到团队列表：新战役保存到团队列表；原生React/Express与PostgreSQL业务页面
战役协作与地图会话：战役协作与地图会话；原生React/Express与PostgreSQL业务页面
地图棋子与音频素材库：地图棋子与音频素材库；原生React/Express与PostgreSQL业务页面
平台用户与战役统计：平台用户与战役统计；原生React/Express与PostgreSQL业务页面

适合谁

需要自托管桌游资料、维护固定冒险团队与战役记录的主持人、桌游社群和私有服务器运维者。

商业化思路

适合按部署、中文适配、资料迁移和定制维护服务交付；涉及再分发或网络服务须遵守AGPL-3.0义务，不承诺第三方邮件、游戏内容版权或收费运营许可。

你会拿到什么

  • ✓完整源码包（保留原项目许可证）
  • ✓中文部署说明与环境要求
  • ✓真实部署运行截图
  • ✓源码来源、技术栈与验证记录

部署流程

  1. 1阅读项目详情、原 README 与许可证
  2. 2按部署说明准备服务器和环境变量
  3. 3启动服务并完成网页健康检查
  4. 4替换正式域名、密码和业务配置

真实验证结果

Docker Compose 全部服务运行正常且网页端口响应，等待后台终审和资料整理。 源码包、部署说明和业务证据已上传并对账，等待服务端审核。

部署前须知

具体第三方账号、OAuth 凭证和生产密钥需由使用者自行申请与配置。

部署难度

中等

最低配置

以部署说明和实际验证结果为准

开源许可证

AGPL

最后验证

2026-10-11

技术栈

Docker

授权说明

已检测到原项目许可证文件：LICENSE；发布前仍需人工复核署名和商用边界。

Release notes

版本记录

1 个已发布版本

verified-run-3083

本地真实部署、网页探测与交付物整理通过，已完成 OSS 校验。

部署要求：详见源码包内的慕卿部署说明。

登录后领取