tsukisama9292/steam

Steam(with KasmVNC) 镜像文档

镜像概述

本镜像为Steam游戏玩家设计，基于Ubuntu 22.04系统，集成KasmVNC实现远程访问。通过容器化方式提供便捷的Steam游戏环境，内置多种实用工具，支持CPU和GPU（Nvidia、Intel、AMD等）配置，适合需要远程运行Steam游戏的场景。

核心功能与工具

主要工具

• Steam (Flatpak版)

  • 注意事项：可通过KasmVNC全屏模式解决游戏全屏黑屏问题。
  • 已修复问题：运行时强制关闭GPU加速已修复黑屏问题。手动修复方法：进入设置→界面→启用Web视图中的GPU加速渲染，取消勾选该选项。

• Chrome

  • 注意事项：若需在Xfce中将Chrome设为默认浏览器，进入设置管理器→首选应用程序→Web浏览器，从列表中选择Google Chrome。

• VSCode

  • 注意事项：已预装gnome-keyring，首次启动VSCode会提示设置密钥环。若无需加密快速设置，可留空密码字段→点击继续→选择不加密存储密码。

• uv (Python工具)

• tree (命令行工具)

使用场景

• 远程访问Steam游戏环境，无需本地安装Steam
• 多实例部署，支持多个用户同时使用（通过不同端口区分）
• 适用于个人游戏玩家或小型团队共享游戏环境
• 支持CPU运行或GPU加速（需对应显卡驱动配置）

使用方法

环境要求

• Docker及Docker Compose已安装
• 若使用GPU，需安装对应显卡驱动（Nvidia需安装nvidia-docker runtime）

Docker Compose配置

CPU仅模式

yaml
x-default-opts: &default-opts
  tty: true
  stdin_open: true
  privileged: true
  ipc: private
  image: docker.xuanyuan.run/tsukisama9292/steam:1.17.0-rolling-daily
  environment:
    - LC_ALL=zh_TW.UTF-8  # 语言设置（繁体中文）
    - TZ=Asia/Taipei       # 时区设置
    - VNC_PW=password      # VNC访问密码
  shm_size: "512mb"       # 共享内存大小
  restart: unless-stopped  # 重启策略
  networks:
    - network
  userns_mode: host        # Steam需使用host用户命名空间

services:
  steamos_1:
    <<: *default-opts
    container_name: steamos_1
    hostname: steamos_1
    ports:
      - 6901:6901  # VNC端口映射（主机端口:容器端口）
    volumes:
      - home_1:/home/kasm-user  # 持久化用户数据

  steamos_2:
    <<: *default-opts
    container_name: steamos_2
    hostname: steamos_2
    ports:
      - 6902:6901
    volumes:
      - home_2:/home/kasm-user

  steamos_3:
    <<: *default-opts
    container_name: steamos_3
    hostname: steamos_3
    ports:
      - 6903:6901
    volumes:
      - home_3:/home/kasm-user

networks:
  network:

volumes:
  home_1:
  home_2:
  home_3:

Nvidia GPU模式

yaml
x-default-opts: &default-opts
  tty: true
  stdin_open: true
  privileged: true
  ipc: private
  image: docker.xuanyuan.run/tsukisama9292/steam:1.17.0-rolling-daily
  runtime: nvidia  # 使用nvidia运行时
  environment:
    - LC_ALL=zh_TW.UTF-8
    - TZ=Asia/Taipei
    - VNC_PW=password
    - NVIDIA_DRIVER_CAPABILITIES=all  # 启用所有Nvidia驱动功能
  shm_size: "512mb"
  restart: unless-stopped
  networks:
    - network
  userns_mode: host
  deploy:
    resources:
      reservations:
        devices:
        - driver: nvidia
          count: "all"  # 使用所有可用Nvidia GPU
          capabilities: [gpu]

services:
  steamos_1:
    <<: *default-opts
    container_name: steamos_1
    hostname: steamos_1
    ports:
      - 6901:6901
    volumes:
      - home_1:/home/kasm-user

  steamos_2:
    <<: *default-opts
    container_name: steamos_2
    hostname: steamos_2
    ports:
      - 6902:6901
    volumes:
      - home_2:/home/kasm-user

  steamos_3:
    <<: *default-opts
    container_name: steamos_3
    hostname: steamos_3
    ports:
      - 6903:6901
    volumes:
      - home_3:/home/kasm-user

networks:
  network:

volumes:
  home_1:
  home_2:
  home_3:

Intel、AMD、Radeon或Nouveau GPU

需手动配置GPU，参考文档：https://kasmweb.com/docs/latest/how_to/manual_intel_amd.html

启动步骤

1. 更新镜像：

   bash
   docker compose pull
   

2. 启动服务：

   bash
   docker compose up -d
   

3. 访问VNC：
   通过浏览器访问 http://<主机IP>:<端口>（如http://192.168.1.100:6901），输入配置的VNC密码（默认password）即可连接。

注意事项

• VNC_PW环境变量需设置安全密码，避免未授权访问
• 多实例部署时，需确保主机端口不冲突
• 持久化卷（volumes）用于保存用户数据，删除容器后数据不会丢失
• 若遇到性能问题，可适当调整shm_size（共享内存）大小