Sunshine项目Docker容器化部署完全指南

最新推荐文章于 2025-06-10 15:56:36 发布

毕艾琳

最新推荐文章于 2025-06-10 15:56:36 发布

阅读量307

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00059/article/details/148361009

Sunshine项目Docker容器化部署完全指南

Sunshine Sunshine: Sunshine是一个自托管的游戏流媒体服务器，支持通过Moonlight在各种设备上进行低延迟的游戏串流。项目地址: https://gitcode.com/gh_mirrors/su/Sunshine

前言

Sunshine作为一款开源的远程游戏串流服务端软件，通过Docker容器化部署可以大幅简化安装配置流程。本文将全面解析Sunshine的Docker镜像使用方式，帮助开发者快速搭建游戏串流环境。

版本变更说明

自v0.18.0版本起，Sunshine的Docker镜像标签命名规则发生了重要变化：

不再支持latest、master、vX.X.X等简单标签
必须使用组合标签格式：<版本>-<操作系统>
支持使用具体的commit hash作为版本标识

镜像构建指南

Sunshine提供的Docker镜像主要作为基础镜像使用，方便开发者集成到自己的项目中。以下是典型的使用示例：

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

# 安装必要的依赖
RUN apt-get update && apt-get install -y \
    steam \
    wayland-protocols \
    weston

# 设置启动命令
ENTRYPOINT ["steam", "&&", "sunshine"]

版本选择参数

SUNSHINE_VERSION：支持以下格式
- 特定版本号（如v0.18.0）
- 最新稳定版（latest）
- 开发分支（master）
- 具体commit hash
SUNSHINE_OS：支持的基础操作系统
- archlinux
- debian-bookworm
- ubuntu-22.04
- ubuntu-24.04

容器部署方案

1. Docker直接运行

docker run -d \
  --device /dev/dri/ \
  --name=sunshine-container \
  --restart=unless-stopped \
  --ipc=host \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -v /path/to/config:/config \
  -p 47984-47990:47984-47990/tcp \
  -p 48010:48010 \
  -p 47998-48000:47998-48000/udp \
  lizardbyte/sunshine:latest-ubuntu-22.04

2. Docker Compose方案

version: '3'
services:
  sunshine:
    image: lizardbyte/sunshine:latest-ubuntu-22.04
    container_name: sunshine
    restart: unless-stopped
    devices:
      - /dev/dri:/dev/dri
    volumes:
      - /path/to/config:/config
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    ipc: host
    ports:
      - "47984-47990:47984-47990/tcp"
      - "48010:48010"
      - "47998-48000:47998-48000/udp"

3. Podman运行方案

podman run -d \
  --device /dev/dri/ \
  --name=sunshine-container \
  --restart=unless-stopped \
  --userns=keep-id \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -v /path/to/config:/config \
  -p 47984-47990:47984-47990/tcp \
  -p 48010:48010 \
  -p 47998-48000:47998-48000/udp \
  lizardbyte/sunshine:latest-ubuntu-22.04

关键参数详解

| 参数 | 作用 | 示例值 | 是否必需 | |------|------|--------|----------| | -p 47990:47990 | Web管理界面端口 | 可修改为8080:47990 | 是 | | -v /config | 配置文件存储路径 | /home/user/sunshine | 是 | | --device /dev/dri | GPU直通设备 | - | 推荐 | | --ipc=host | 共享内存设置 | - | 推荐 | | PUID/PGID | 用户/组ID | 1000 | 推荐 | | TZ | 时区设置 | Asia/Shanghai | 可选 |

架构支持情况

| 操作系统 | x86_64 | ARM64 | |---------|--------|-------| | Archlinux | ✔️ | ❌ | | Debian Bookworm | ✔️ | ✔️ | | Ubuntu 22.04 | ✔️ | ✔️ | | Ubuntu 24.04 | ✔️ | ✔️ |