LizardByte Sunshine Docker镜像

重要说明

从v0.18.0版本开始，标签名称已变更。不再支持使用latest、master、vX.X.X作为独立标签。

构建自定义容器

该镜像提供了在Docker项目中轻松使用最新Sunshine版本的方法。目前不建议作为独立容器使用，属于实验性阶段。

dockerfile
ARG SUNSHINE_VERSION=latest
ARG SUNSHINE_OS=ubuntu-22.04
FROM lizardbyte/sunshine:${SUNSHINE_VERSION}-${SUNSHINE_OS}

# 安装Steam、Wayland等依赖

ENTRYPOINT steam && sunshine

SUNSHINE_VERSION

• 取值：latest、master、vX.X.X（版本号）、commit哈希

SUNSHINE_OS

Sunshine镜像基于不同基础镜像提供以下标签后缀：

• archlinux
• debian-bookworm
• ubuntu-22.04
• ubuntu-24.04

标签格式

必须组合SUNSHINE_VERSION和SUNSHINE_OS来确定拉取标签，格式为<SUNSHINE_VERSION>-<SUNSHINE_OS>。例如：latest-ubuntu-24.04。

查看所有可用标签：Docker Hub 或 GHCR。

应用案例

以下是使用Sunshine的Docker项目（如有遗漏，请告知我们）：

• Games on Whales

端口和卷映射

以下是必要映射的示例，配置文件将保存在容器内的/config目录。

使用docker run

创建并运行容器（替换<values>为实际值）：

bash
docker run -d \
  --device /dev/dri/ \
  --name=<image_name> \
  --restart=unless-stopped \
  --ipc=host \
  -e PUID=<uid> \
  -e PGID=<gid> \
  -e TZ=<timezone> \
  -v <path to data>:/config \
  -p 47984-47990:47984-47990/tcp \
  -p 48010:48010 \
  -p 47998-48000:47998-48000/udp \
  <image>

使用docker-compose

创建docker-compose.yml文件（替换<values>为实际值）：

yaml
version: '3'
services:
  <image_name>:
    image: <image>
    container_name: sunshine
    restart: unless-stopped
    volumes:
      - <path to data>:/config
    environment:
      - PUID=<uid>
      - PGID=<gid>
      - TZ=<timezone>
    ipc: host
    ports:
      - "47984-47990:47984-47990/tcp"
      - "48010:48010"
      - "47998-48000:47998-48000/udp"

使用podman run

创建并运行容器（替换<values>为实际值）：

bash
podman run -d \
  --device /dev/dri/ \
  --name=<image_name> \
  --restart=unless-stopped \
  --userns=keep-id \
  -e PUID=<uid> \
  -e PGID=<gid> \
  -e TZ=<timezone> \
  -v <path to data>:/config \
  -p 47984-47990:47984-47990/tcp \
  -p 48010:48010 \
  -p 47998-48000:47998-48000/udp \
  <image>

参数说明

需将<values>替换为实际配置。参数格式为左侧:右侧，左侧为宿主机配置，右侧为容器内配置。

示例：-p external:internal表示容器内端口映射到宿主机，如-p 8080:47990将容器内47990端口映射到宿主机8080端口。示例中列出的所有端口均为必填。

用户/组ID说明

使用数据卷（-v）时，宿主机与容器可能出现权限问题。可通过指定PUID和PGID解决，确保宿主机数据卷目录所有者与指定ID一致。

查看当前用户ID：

bash
$ id dockeruser
uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

若需修改已构建镜像的PUID/PGID，需重新构建镜像。

支持的架构

指定lizardbyte/sunshine:latest-<SUNSHINE_OS>或ghcr.io/lizardbyte/sunshine:latest-<SUNSHINE_OS>将自动拉取对应架构镜像。