LinuxServer.io SteamOS 容器介绍

LinuxServer.io 容器特点

LinuxServer.io 团队推出的容器具有以下核心优势：

• 定期及时的应用更新
• 简单的用户映射（支持 PGID、PUID 设置）
• 基于 s6 覆盖层的自定义基础镜像
• 每周更新基础系统，通过共享通用层减少存储空间占用、 downtime 和带宽消耗
• 定期安全更新

社区与支持渠道

• 博客：容器使用指南、教程及技术观点
• ***：实时社区支持与团队交流
• Discourse：社区论坛，可发布问题与分享经验
• Fleet：在线界面，展示所有维护中的镜像
• GitHub：查看所有仓库源码
• Open Collective：支持我们的开发与维护

linuxserver/steamos 容器

SteamOS 是 Valve 基于 Arch Linux 开发的操作系统。本容器为原生 Arch 系统，添加了 Steam 软件仓库支持，仅适用于搭载现代 AMD/Intel GPU 的 Linux 物理主机。

支持的架构

通过 Docker 清单实现多平台支持，拉取 lscr.io/linuxserver/steamos:latest 即可自动匹配对应架构。具体支持情况如下：

应用设置

注意事项

当前容器处于 Beta 阶段，功能可能频繁更新，可能存在崩溃或兼容性问题（尤其是 Steam 远程播放与 KasmVNC 帧捕获混合使用时）。

硬件要求

SteamOS 针对特定 AMD 硬件设计，仅在搭载现代 AMD GPU 或 Intel ARC/iGPU 的主机上可完全运行。

已知限制

• 首次使用需通过桌面模式（KDE）登录 Steam，之后可切换至 STARTUP=BIGPICTURE（大屏模式）
• Sunshine（串流工具）在桌面模式和大屏模式中均可用，但游戏手柄支持暂不可用
• 桌面模式下，多数 Proton 游戏可能导致 kwin_x11 进程终止，进而禁用键盘和手柄输入；远程播放时建议使用 Valve 原生或 Linux 原生游戏
• Windows 游戏若无法启动，需在设置中强制选择兼容性层（如 Proton Experimental 或 Proton 8）
• 大屏模式（BIGPICTURE）通过 Sunshine 连接时游戏兼容性更佳，运行逻辑与 Steam Deck 一致（仅缺少手柄支持）
• Sunshine 自动发现功能不可用，需手动在客户端输入 IP
• 大屏模式下远程播放体验较差，该模式优化为通过 Sunshine 传输固定分辨率画面

GPU 兼容性

容器集成 Arch ***驱动，推荐使用支持 DRI3 框架的显卡（NVIDIA 不支持 DRI3）。现代 RDNA AMD 显卡或 Intel ARC 显卡体验最佳，低端 GPU 可能支持部分游戏。兼容性与 Steam Deck 一致，Deck 认证游戏基本可正常运行。

NVIDIA 显卡适配

需为游戏添加启动选项（仅支持 OpenGL 游戏）：

LIBGL_KOPPER_DRI2=1 MESA_LOADER_DRIVER_OVERRIDE=zink GALLIUM_DRIVER=zink %command%  

同时需在 Docker 运行参数中添加 --gpus all --runtime nvidia。

使用方法

访问方式

容器启动后，通过以下地址访问：

• HTTP：`[***]
• HTTPS：`[***]

网络配置

Steam 网络发现依赖广播包，跨子网时可能受限。推荐以下网络模式：

推荐方案

• Macvlan：为容器分配独立 IP，接近桥接虚拟机模式，兼容性最佳（避免端口冲突）
• Host 网络：直接使用主机网络，可能存在端口冲突风险

端口转发（默认配置）

本地远程播放需转发以下端口（可选，仅 LAN 环境需要）：

• UDP：27031-27036（Steam 远程播放）、47998-48000（Sunshine）
• TCP：27031-27036（Steam 远程播放）、47984-47990、48010（Sunshine）

游戏体验说明

• 容器模拟 Steam Deck 环境，游戏默认适配其控制器布局和画质设置；桌面模式可通过快捷方式 Steam Desktop Mode 切换
• 游戏分辨率与 Web 界面连接时的桌面分辨率绑定，分辨率调整功能待开发
• Deck 模式下，Steam 登录状态（不含二次验证）暂不持久化，重启容器后需重新登录

部署示例

Docker Compose（推荐）

创建 docker-compose.yml 文件：

---  
services:  
  steamos:  
    image: lscr.io/linuxserver/steamos:latest  
    container_name: steamos  
    hostname: 自定义主机名 #可选  
    cap_add:  
      - NET_ADMIN  
    security_opt:  
      - seccomp:unconfined  
      - apparmor:unconfined #可选（Debian/Ubuntu 主机需开启）  
    environment:  
      - PUID=1000 #用户ID，通过 `id 用户名` 查看  
      - PGID=1000 #组ID，同上  
      - TZ=Asia/Shanghai #时区，如 Asia/Shanghai  
      - DRINODE=/dev/dri/renderD128 #GPU 渲染设备路径  
      - HOST_IP=192.168.1.100 #主机IP，LAN 远程播放需设置  
      - STARTUP=KDE #启动模式：KDE（桌面）或 BIGPICTURE（大屏）  
      - RESOLUTION=1920x1080 #大屏模式分辨率  
    volumes:  
      - /path/to/config:/config #数据持久化目录（替换为实际路径）  
      - /dev/input:/dev/input #可选，手柄支持（仅 Steam 远程播放生效）  
      - /run/udev/data:/run/udev/data #可选，手柄支持  
    ports:  
      - 3000:3000 #Web 界面 HTTP  
      - 3001:3001 #Web 界面 HTTPS  
      - 27031-27036:27031-27036/udp #可选，Steam 远程播放 UDP  
      - 27031-27036:27031-27036 #可选，Steam 远程播放 TCP  
      - 47984-47990:47984-47990 #可选，Sunshine TCP  
      - 48010:48010 #可选，Sunshine TCP  
      - 47998-48000:47998-48000/udp #可选，Sunshine UDP  
    devices:  
      - /dev/dri:/dev/dri #显卡直通  
    shm_size: "1gb" #Steam 浏览器运行所需共享内存  
    restart: unless-stopped  

启动容器：

docker-compose up -d  

Docker CLI

直接运行命令：

docker run -d \  
  --name=steamos \  
  --hostname=自定义主机名 `#可选` \  
  --cap-add=NET_ADMIN \  
  --security-opt seccomp=unconfined \  
  --security-opt apparmor=unconfined `#可选` \  
  -e PUID=1000 \  
  -e PGID=1000 \  
  -e TZ=Asia/Shanghai \  
  -e DRINODE=/dev/dri/renderD128 \  
  -e HOST_IP=192.168.1.100 `#可选` \  
  -e STARTUP=KDE `#可选` \  
  -e RESOLUTION=1920x1080 `#可选` \  
  -p 3000:3000 \  
  -p 3001:3001 \  
  -p 27031-27036:27031-27036/udp `#可选` \  
  -p 27031-27036:27031-27036 `#可选` \  
  -p 47984-47990:47984-47990 `#可选` \  
  -p 48010:48010 `#可选` \  
  -p 47998-48000:47998-48000/udp `#可选` \  
  -v /path/to/config:/config \  
  -v /dev/input:/dev/input `#可选` \  
  -v /run/udev/data:/run/udev/data `#可选` \  
  --device /dev/dri:/dev/dri \  
  --shm-size="1gb" \  
  --restart unless-stopped \  
  lscr.io/linuxserver/steamos:latest  

参数说明

维护与更新

查看容器状态

• 进入容器终端：docker exec -it steamos /bin/bash
• 实时查看日志：docker logs -f steamos
• 查看容器版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' steamos

更新容器

Docker Compose

# 拉取最新镜像  
docker-compose pull steamos  
# 重启容器  
docker-compose up -d steamos  
# 清理旧镜像  
docker image prune  

Docker CLI

# 拉取最新镜像  
docker pull lscr.io/linuxserver/steamos:latest  
# 停止并删除旧容器  
docker stop steamos && docker rm steamos  
# 用原参数启动新容器（数据通过 /config 卷保留）  
docker run [原参数] lscr.io/linuxserver/steamos:latest  

版本历史

• 2024.05.23：新增 Nvidia 显卡使用说明
• 2024.01.15：安装 gperftools 修复 Source 引擎游戏问题
• 2023.11.29：切换至 openbox 作为大屏模式窗口管理器
• 2023.10.06：从 AUR 编译集成 Sunshine
• 2023.08.25：添加音频和软件兼容性依赖
• 2023.07.04：初始发布

注意：Portainer 可能不兼容 cap_add 或 sysctl 设置，建议通过 Docker Compose 或 CLI 部署。