手把手教程：使用开源项目在NAS上搭建私人H5棋牌游戏室

April 4, 2026

厌倦了公共棋牌平台的种种限制？想和朋友们在一个完全私密、公平、无后台干预的环境里畅玩？今天，我就带你一步步在自家的NAS上，部署一个功能完整的H5棋牌游戏平台。这个开源项目基于商用级架构，支持斗地主、麻将等多种游戏，无需安装任何客户端，在手机、电脑、平板的浏览器上打开就能玩，真正实现“私人游戏室”的自由。

给新手的核心建议：如果你是第一次尝试这类部署，请务必严格按照教程的步骤操作。先不要急着修改复杂的配置或配置外网访问，成功的第一步，是确保在内网环境下一切运行正常。稳扎稳打，我们开始吧。

第一步：获取与准备项目文件

下载源码：首先，访问该项目的GitHub仓库：https://github.com/openinggame/qp，下载整个项目的ZIP压缩包。

创建项目目录：在你的NAS上，找一个合适的位置（比如Docker或共享文件夹下），新建一个名为 openinggame 的文件夹。将下载好的ZIP文件放入其中。

解压与精简：解压ZIP文件。解压后你会看到很多文件和文件夹。为了部署清晰，我们只需要保留三个核心文件：docker-compose.yml、mongo_data.tar.gz 和 mysql.tar.gz。其他文件可以暂时移走或删除，避免干扰。

解压数据库文件：分别解压 mongo_data.tar.gz 和 mysql.tar.gz 这两个压缩包。解压后，你的 openinggame 文件夹结构应该大致如下，包含了数据库的预置数据目录。

*   **`mongo_data` 目录**：里面存放的是MongoDB数据库的初始数据文件。

*   **`mysql` 目录**：里面存放的是MySQL数据库的初始数据文件。

至此，文件准备工作就完成了。

第二步：通过Docker Compose部署

现在进入核心的部署环节。我们将使用Docker Compose来一键启动所有服务。

创建Docker项目/堆栈：打开你NAS上的Docker管理工具（如群晖的Docker套件、Portainer等）。找到创建“Stack”（堆栈）或“项目”的选项。
配置项目：
- 名称：可以命名为 openinggame。
- 路径：选择我们刚才准备好的 openinggame 文件夹作为工作目录。
- 配置文件：将文件夹内的 docker-compose.yml 文件内容粘贴或上传到配置编辑器中。

理解并修改配置：原版 docker-compose.yml 配置较全，但为了简化，我推荐使用下面这个调整过的版本。它主要做了两点优化：一是将数据卷挂载改为相对路径 (./)，更易管理；二是移除了需要手动创建的外部网络，让Docker自动处理。

你唯一需要修改的地方，就是下面配置中 web 服务下的 API_HOST 环境变量。请将其中的 192.168.31.90 替换成你NAS在局域网内的实际IP地址。

services:
  web:
    container_name: web0
    image: openinggame/web:v1
    ports:
      - "8080:80"  # 将NAS的8080端口映射到容器的80端口
    environment:
      - API_HOST=192.168.31.90 # 【关键】请修改为你的NAS内网IP
    depends_on:
      - server
  server:
    container_name: server0
    image: openinggame/server:v1
    ports:
      - "81:81"
    depends_on:
      - etcd
      - kafka
      - redis1
      - mysql
      - mongodb
  mysql:
    image: mysql:8.0.23
    container_name: mysql0
    command:
      --default-authentication-plugin=mysql_native_password
      --character-set-server=utf8mb4
      --collation-server=utf8mb4_general_ci
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: root
    volumes:
      - ./mysql:/var/lib/mysql
      - ./mysqlconf:/etc/mysql/conf.d
  redis0:
    container_name: redis0
    image: redis:latest
    volumes:
      - ./redisdata0:/data
    command: redis-server --requirepass 123456
    depends_on:
      - etcd
  redis1:
    container_name: redis1
    image: redis:latest
    volumes:
      - ./redisdata1:/data
    command: redis-server --requirepass 123456
    depends_on:
      - etcd
  redis2:
    container_name: redis2
    image: redis:latest
    volumes:
      - ./redisdata2:/data
    command: redis-server --requirepass 123456
    depends_on:
      - mysql
      - etcd
      - redis1
  zookeeper:
    container_name: zookeeper
    image: wurstmeister/zookeeper
    restart: always
  kafka:
    container_name: kafka0
    image: wurstmeister/kafka:2.12-2.3.0
    environment:
      - KAFKA_BROKER_ID=0
      - KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://kafka0:9092
      - KAFKA_LISTENERS=PLAINTEXT://0.0.0.0:9092
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always
    depends_on:
      - zookeeper
  etcd:
    image: quay.io/coreos/etcd:v3.2.32
    container_name: etcd0
    environment:
      ETCDCTL_API: 3
    command:
      - etcd
      - --name=etcd0
      - --data-dir=/data/etcd-data
      - --advertise-client-urls=http://etcd0:2379
      - --listen-client-urls=http://0.0.0.0:2379
    restart: always
    volumes:
      - ./etcd0_data:/etcd-data
  mongodb:
    container_name: mongodb0
    image: mongo:4.4.4
    restart: always
    volumes:
      - ./mongo_data:/data/db
      - ./mongodb_logs:/data/logs
    command: --auth
    depends_on:
      - etcd

启动项目：保存配置，然后启动这个堆栈。Docker会开始拉取镜像并创建容器。整个过程可能需要几分钟，取决于你的网络速度。
检查状态：启动完成后，在Docker容器列表中，你应该能看到一系列容器（web0, server0, mysql0, redis0/1/2, mongodb0, etcd0, kafka0, zookeeper）的状态都变为“Up”（运行中）。