Sunshine:自托管串流服务端
Docker 自部署自托管游戏串流服务端
工具介绍
Sunshine:自托管串流服务端
开源串流服务端,GameStream 停更后的社区继任者,AMD、Intel、NVIDIA 显卡通吃,配合 Moonlight 客户端组成完全自建的串流方案。
一、核心优势
1. 不挑硬件
机制:调用各平台硬件编码器,现代独显与多数核显都能开,不再绑定某一品牌显卡。
对你的意义:不必为了串流升级显卡,老主机也能当串流源。
2. 部署形态灵活
机制:Windows、Linux、macOS 原生可装,也有容器化方案,配 Web 管理面板远程改配置。
对你的意义:装在一台常开机器上,全家设备随时调用它的算力。
3. 生态兼容
机制:与 Moonlight 客户端协议互通,虚拟显示器、手柄映射、多用户会话均有社区方案。
对你的意义:从客厅大屏到掌机,串流链路可以按需扩展。
4. 参数可深调
机制:编码器、码率、帧率、量化范围等参数开放,可按网络与设备逐项微调。
对你的意义:同一套部署既服务客厅 4K 大屏,也服务路上的手机,各配一套参数即可。
二、适合谁
想自建串流不依赖官方服务的折腾党、家庭内网多屏共享一台主机的玩家、用 AMD/Intel 显卡的原 GameStream 用户。
三、上手三步
- 主机上安装 Sunshine,浏览器打开本地管理页设置账号。
- 安装 Moonlight 客户端,输入 PIN 完成配对。
- 调整分辨率与编码参数,串流跑几局看延迟。
四、边界与局限
首次配置有门槛,编码器参数与虚拟显示器对新手不算友好;外网串流要自行打通网络与安全边界;版本迭代快,配置项偶有变动,升级前先备份配置文件。换来的是数据全程不出家门、硬件自由。
惊蛰 整理 · 2026-09 收录
评测视频
点击跳转 B 站观看原视频已聚合 6 条评测视频 ·5 位博主独立评测
部署速查
部署前提
- 官方定位(LizardByte 官方文档 Docker 章节,v0.23.0):该镜像的用途是让你在自己的 Docker 项目里方便地集成最新版 Sunshine;官方明示现阶段不作为独立容器使用、应视为实验性,多数场景官方仍以发行版安装包为主路径。
- 镜像双源:Docker Hub
lizardbyte/sunshine与ghcr.io/lizardbyte/sunshine。 - tag 规则:v0.18.0 起
latest、master、vX.X.X等裸 tag 停用,必须使用「版本-系统」组合格式,如latest-ubuntu-22.04。官方架构表列出的系统后缀:archlinux(仅 amd64)、debian-bookworm、debian-bullseye、fedora-38、fedora-39、ubuntu-20.04、ubuntu-22.04,arm64 支持以官方表格为准。 - 端口为固定段且全部必填:47984-47990/tcp、48010/tcp、47998-48000/udp;Web UI 在 47990,外部端口可改、容器内部必须保持 47990。
- 配置文件保存在容器内
/config,务必挂载持久化;PUID/PGID 需与宿主机数据目录属主一致,事后修改需重建镜像。
docker-compose.yml
以下为官方文档 Using docker-compose 一节模板(<values> 替换为你的实际值;镜像按上节 tag 规则落实际值,如 lizardbyte/sunshine:latest-ubuntu-22.04):
version: '3'
services:
sunshine:
image: lizardbyte/sunshine:latest-ubuntu-22.04
container_name: sunshine
restart: unless-stopped
volumes:
- <path to data>:/config
environment:
- PUID=<uid>
- PGID=<gid>
- TZ=<timezone>
ports:
- "47984-47990:47984-47990/tcp"
- "48010:48010"
- "47998-48000:47998-48000/udp"
官方 compose 模板未包含 GPU 设备映射;同页 docker run 示例带 --device /dev/dri/,需要硬件编码的用户可在 services.sunshine 下自行补 devices: ["/dev/dri/"]。
启动与初始化
docker compose up -d后浏览器访问http://<host_ip>:47990进入 Web UI(官方参数表:Web UI Port 47990)。- 在 Web UI 完成账号设置,装好 Moonlight 客户端后输入 PIN 完成配对。
- 升级:把镜像 tag 换成新的「版本-系统」组合,执行
docker compose pull && docker compose up -d。
本页由编辑 惊蛰 整理与维护 · 了解幕后







