GOW (Games on Whales) Docker镜像文档

镜像概述与主要用途

GOW（Games on Whales）是一个专注于在Docker容器环境中实现游戏及图形用户界面（GUI）流式传输的解决方案。其核心用途是通过硬件加速（HW acceleration）和低延迟传输技术，将Docker容器内运行的游戏或图形应用流式分发至客户端设备，使用户可跨终端流畅访问容器内图形内容。该镜像基于GitHub Actions进行自动化构建，确保版本更新的及时性与可靠性。

核心功能与特性

Docker环境图形流式传输
支持将Docker容器内运行的游戏、桌面应用或GUI程序通过网络流式传输至客户端设备，无需在客户端本地安装应用。
硬件加速支持
集成硬件加速能力，可直接利用主机GPU资源（如NVIDIA、AMD或Intel显卡），提升图形渲染性能，保障游戏及图形应用的流畅运行。
低延迟传输优化
通过优化流式传输协议，减少数据传输延迟，确保游戏操作及GUI交互的实时性，提升远程访问体验。
自动化构建与版本管理
基于GitHub Actions实现自动化构建流程，确保镜像版本持续更新且稳定可靠。

使用场景与适用范围

跨设备游戏流式访问
游戏玩家可在本地或远程设备（如PC、平板、智能电视）上流式访问Docker容器中运行的游戏，降低客户端硬件配置要求。
硬件加速图形应用测试
开发者可在Docker隔离环境中测试需要硬件加速的GUI应用，通过流式传输实时查看运行效果，简化测试环境配置。
低延迟远程图形管理
适用于需要远程访问Docker容器内图形界面的场景（如服务器端图形应用管理、云端工作站），通过低延迟传输提升操作流畅度。
容器化图形应用分发
企业或开发者可通过Docker容器打包图形应用，结合GOW实现跨平台、一致的图形应用流式分发。

使用方法与配置说明

前提条件

主机需安装Docker 20.10+及Docker Compose（可选）。
主机需配备支持硬件加速的GPU，并安装对应Docker运行时（如NVIDIA GPU需安装nvidia-docker）。
网络环境建议为有线连接或高性能Wi-Fi，以保障低延迟传输。

获取镜像

GOW镜像可通过仓库获取（具体地址请参考文档），基础拉取命令如下：

bash
docker pull gamesonwhales/gow:latest

基本使用示例

1. docker run 命令示例

以下为启动GOW容器的基础命令，包含硬件加速配置与流式传输端口映射（具体参数需根据***文档调整）：

bash
docker run -d \
  --name gow-stream \
  --privileged \  # 访问硬件设备时需启用（根据安全需求调整）
  --device /dev/dri:/dev/dri \  # 挂载DRI设备以支持硬件加速
  -p 8080:8080 \  # 流式传输端口（示例，具体端口参考***文档）
  -e DISPLAY=:0 \  # 显示服务配置
  -v /tmp/.X11-unix:/tmp/.X11-unix \  # 共享X11 socket（如使用X11转发）
  gamesonwhales/gow:latest

2. docker-compose 配置示例

创建docker-compose.yml文件，配置GOW服务及相关依赖：

yaml
version: '3.8'
services:
  gow:
    image: gamesonwhales/gow:latest
    container_name: gow-service
    privileged: true  # 按需启用（访问硬件设备时）
    devices:
      - /dev/dri:/dev/dri  # 硬件加速设备挂载
    ports:
      - "8080:8080"  # 流式传输端口
    environment:
      - DISPLAY=:0  # 显示设置
      - GOW_STREAM_PROTOCOL=webrtc  # 流式传输协议（示例，具体参考***文档）
    volumes:
      - /tmp/.X11-unix:/tmp/.X11-unix  # X11 socket共享
      - ./gow-data:/data  # 持久化存储（游戏配置、流设置等）
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

关键配置说明

硬件加速配置

设备挂载：通过--device /dev/dri:/dev/dri挂载DRI设备（通用硬件加速），NVIDIA GPU需额外挂载/dev/nvidia0等设备并配置nvidia-docker运行时。
环境变量：部分场景需设置NVIDIA_VISIBLE_DEVICES=all（NVIDIA GPU）或INTEL_DRIVER=iris（Intel显卡）等驱动相关参数。