linuxserver/steamos

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 游戏）：

bash
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 文件：

yaml
---  
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  

启动容器：

bash
docker-compose up -d  

Docker CLI

直接运行命令：

bash
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

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

Docker CLI

bash
# 拉取最新镜像  
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 部署。