如何用Docker 5分钟部署Sunshine游戏串流服务器零基础避坑指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款开源、自托管的游戏串流服务端专门配合 Moonlight 客户端使用能把你的电脑变成随时随地可访问的游戏主机。本文用 Docker 带你 5 分钟完成部署从镜像标签、端口映射、GPU 直通到各种权限坑位一步步照抄就能跑通全程零基础友好。一、痛点开篇装个串流服务怎么这么折腾先讲个真实场景。上周朋友跟我抱怨他照着仓库里的说明手动编译 Sunshine折腾了一整晚还是没起来一会儿缺依赖库一会儿编译报错好不容易装好了系统一更新又打回原形。换台机器不好意思全部从头再来。这其实是自托管串流服务的老大难。Sunshine 要做的事很多——采集画面、硬件编码、处理输入、转发网络流背后牵扯一堆图形、编码、虚拟输入相关的系统库而每个发行版的环境又不太一样。手动部署的每一步都可能成为劝退你的理由。Docker 就是冲着这个痛点来的。它把 Sunshine 以及它需要的所有环境打包成一个镜像你拉下来就能跑换机器只是重新拉一次的事想回滚版本切换镜像标签就行。说白了容器帮你把环境地狱彻底隔离在了一层壳里。二、快速认知四个概念一次讲透动手之前先花三分钟把几个高频词搞清楚。看不懂概念后面命令里的每个参数都会让你发怵搞懂了一切就顺理成章。概念一句话解释生活类比镜像打包好的环境快照只读安装包容器镜像运行起来的实例可写安装后的程序端口映射把宿主机端口转发给容器内服务门牌号指路数据卷挂载到容器里的宿主目录数据持久化保险箱设备直通把宿主机的硬件借给容器使用外接显卡镜像和容器镜像相当于安装包容器是跑起来的程序。你拉取的是镜像启动的是容器删掉容器不影响镜像随时能再起一个。端口映射Sunshine 在容器内部监听 47990 等端口宿主机必须把对应端口映射出来Moonlight 客户端才能找到它。映射是单向门——你指定的宿主机端口指向容器端口。设备直通--device /dev/dri串流最吃硬件编码。只有把显卡设备借进容器编码才能走 GPU否则退化成软件编码画质和延迟都会很难看。数据卷-v /configSunshine 的配置默认存在容器里的 /config 目录。不挂载出来的话容器一删配置、配对信息全部归零所以这步一定不能省。是不是比想象中简单下面进入正题跟着做就行。三、手把手实战五步跑通你的第一个串流容器这一节是全篇重点我会放慢速度每一条命令都带上注释。建议你开个终端边看边敲。第1步 先做环境自检确认两件事Docker 装好了、显卡驱动正常。以 Linux 为例docker --version # 确认 Docker 可用 ls /dev/dri # 能看到 renderD128 等节点说明显卡可直通如果你的机器上/dev/dri不存在先去装好显卡驱动再继续这一步没做好后面串流会卡成 PPT。第2步 拉取正确标签的镜像这一步最容易翻车重点来了从 v0.18.0 版本起Sunshine 官方镜像的标签规则变了不再支持latest、master、vX.X.X这种单独标签必须使用组合格式版本-操作系统例如latest-ubuntu-22.04版本部分也可以填具体的 commit hash。# 正确姿势 docker pull lizardbyte/sunshine:latest-ubuntu-22.04 docker pull lizardbyte/sunshine:v0.18.0-ubuntu-22.04 # 错误示范v0.18.0 之后这样拉会报错 docker pull lizardbyte/sunshine:latest版本部分支持四类写法具体版本号如 v0.18.0、latest最新稳定版、master开发分支、某次提交的 hash。操作系统部分目前可选archlinux、debian-bookworm、ubuntu-22.04、ubuntu-24.04。第3步 初始化配置目录在宿主机上建一个目录存放配置并提前把权限交给容器内用户免得启动后写不进去mkdir -p /path/to/config sudo chown -R 1000:1000 /path/to/config第4步 一条命令把容器拉起来下面是完整版 docker run参数都标了注释照着抄就行docker run -d \ --device /dev/dri/ \ # 显卡直通硬件编码必需 --namesunshine-container \ # 自定义容器名 --restartunless-stopped \ # 开机自启异常退出自动拉起 --ipchost \ # 共享宿主机内存传帧数据很吃内存 -e PUID1000 \ # 容器内用户 ID -e PGID1000 \ # 容器内用户组 ID -e TZAsia/Shanghai \ # 时区决定日志时间 -v /path/to/config:/config \ # 配置持久化 -p 47984-47990:47984-47990/tcp \ # 控制通道 Web 管理界面(47990) -p 48010:48010 \ # 媒体流通道 -p 47998-48000:47998-48000/udp \ # 视频/音频流 lizardbyte/sunshine:latest-ubuntu-22.04如果你习惯用 docker compose把下面这段存成 docker-compose.yml再执行docker compose up -d效果一样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: - PUID1000 - PGID1000 - TZAsia/Shanghai ipc: host ports: - 47984-47990:47984-47990/tcp - 48010:48010 - 47998-48000:47998-48000/udp第5步 验证成果登录 Web 界面并完成配对浏览器打开http://你的主机IP:47990会进入 Sunshine 的 Web 管理登录页按提示创建账号登录即可登录后进入 Applications 页面默认已经有 Desktop、Steam 这些应用卡片点右上角的 Add New 可以继续添加你想串流的游戏或程序到这里容器就算正式跑起来了。最后一步在手机或平板装好 Moonlight 客户端添加主机时填电脑的 IP用 Web 界面里显示的 PIN 码完成配对就能开始你的第一次串流了。四、进阶与自定义从能跑到跑得顺手基础部署没问题后这几个问题你迟早会遇到版本选哪个、ARM 设备能不能用、参数怎么按需调、能不能和 Steam 生态组队。版本与架构怎么选镜像的架构支持并不统一动手前先对号入座操作系统x86_64ARM64Archlinux支持不支持Debian Bookworm支持支持Ubuntu 22.04支持支持Ubuntu 24.04支持支持我的建议很直白Intel/AMD 台式机ubuntu-22.04 或 debian-bookworm 随便选稳ARM 设备软路由、开发板这类优先 debian-bookworm 和 ubuntu-24.04用 Arch 的玩家就别惦记 ARM64 镜像了。参数速查与按需调整参数作用示例是否必需-p 47990:47990Web 管理界面端口可改成 8080:47990是-v /config配置文件存储路径/home/你的用户名/sunshine是--device /dev/driGPU 直通设备-推荐--ipchost共享宿主机内存-推荐PUID/PGID容器内用户/组 ID1000推荐TZ时区Asia/Shanghai可选如果默认的 Web 端口 47990 被别的服务占了把映射改成-p 8080:47990然后访问http://IP:8080就行其他端口照旧。PUID/PGID 建议改成你宿主机实际用户的 ID避免文件归属混乱。想在 Web 界面里快速定位某个配置项可以用顶部搜索框比如搜 Upnp 就能直接找到网络端口转发相关的开关Podman 用户的平替方案不用 Docker 也可以玩。Podman 的启动命令几乎一样唯一要记得的是把用户映射参数换成--usernskeep-id其余照抄podman run -d \ --device /dev/dri/ \ --namesunshine-container \ --restartunless-stopped \ --usernskeep-id \ -e PUID1000 \ -e PGID1000 \ -e TZAsia/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把它当积木集成进自己的镜像官方镜像本身就是按基础镜像设计的方便你往上叠加依赖。比如想让容器里直接带上 Steam可以这么写 DockerfileARG SUNSHINE_VERSIONlatest ARG SUNSHINE_OSubuntu-22.04 FROM lizardbyte/sunshine:${SUNSHINE_VERSION}-${SUNSHINE_OS} # 在基础镜像上补齐 Steam 和 Wayland 相关依赖 RUN apt-get update apt-get install -y \ steam \ wayland-protocols \ weston ENTRYPOINT [steam, , sunshine]构建时通过 ARG 传不同的版本和系统同一套 Dockerfile 就能随意切换灵活度很高。五、避坑手册四个高频翻车现场最后分享四个我见过最多的问题都按现象 → 原因 → 解决来整理遇到直接对号入座。坑1容器反复重启日志全是 Permission denied现象容器起不来挂载目录里写不进任何文件。原因宿主机目录的属主和容器内 PUID/PGID 对不上。解决把目录权限交给容器内用户sudo chown -R 1000:1000 /path/to/config坑2串流画面卡成幻灯片GPU 完全不干活现象能连上但帧率极低CPU 占用爆表。原因显卡设备没直通进容器或宿主机驱动本身没装好。解决确认ls /dev/dri有输出且启动命令里保留了--device /dev/dri/。还不生效的话去 Web 界面的 Logs 页看有没有 Encoder not found 之类的报错日志里通常直接写明问题坑3Web 界面打不开或打开的是别的程序现象访问 47990 端口没反应或者跳到了完全无关的页面。原因端口被其他服务占用了。解决改宿主机的端口映射比如-p 8080:47990之后用http://IP:8080访问。坑4容器日志时间总是差好几个小时现象日志时间戳全是 UTC和本地时间对不上。原因没设置时区。解决启动时加一行-e TZAsia/Shanghai其他地区按需替换即可。六、收尾从跑起来到玩明白还记得开头那个折腾一整晚的朋友吗现在他只需要复制一条 docker run5 分钟服务就能恢复如初换机器也只是重新拉一次镜像的事。手动部署时代最折磨人的环境问题被容器干净利落地挡在了门外。给你几条收尾建议求稳日常使用锁定具体版本比如 v0.18.0-ubuntu-22.04别追 latest升级更可控求新想尝鲜新功能随时切到 master 分支标签体验勤备份/config 目录定期备份——容器丢了能重建配置和配对记录丢了才是真麻烦控资源串流很吃资源给容器加上 CPU/内存限额别让它拖垮整台机器。想继续深入仓库的 docs 目录就是最好的向导部署全流程看 docs/getting_started.md画质与延迟调优看 docs/performance_tuning.md遇到问题先去 docs/troubleshooting.md 翻一翻。想从源码开始折腾也可以 clone 下来自己编译git clone https://gitcode.com/GitHub_Trending/su/Sunshine一句话收束Sunshine 负责把游戏画面送出去Docker 负责把 Sunshine 养在无菌室里。跑通部署之后你会发现真正值得花时间的不是环境配置而是串流画质、延迟和输入体验的调优——那才是这份乐趣真正开始的地方。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何用Docker 5分钟部署Sunshine游戏串流服务器：零基础避坑指南
如何用Docker 5分钟部署Sunshine游戏串流服务器零基础避坑指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款开源、自托管的游戏串流服务端专门配合 Moonlight 客户端使用能把你的电脑变成随时随地可访问的游戏主机。本文用 Docker 带你 5 分钟完成部署从镜像标签、端口映射、GPU 直通到各种权限坑位一步步照抄就能跑通全程零基础友好。一、痛点开篇装个串流服务怎么这么折腾先讲个真实场景。上周朋友跟我抱怨他照着仓库里的说明手动编译 Sunshine折腾了一整晚还是没起来一会儿缺依赖库一会儿编译报错好不容易装好了系统一更新又打回原形。换台机器不好意思全部从头再来。这其实是自托管串流服务的老大难。Sunshine 要做的事很多——采集画面、硬件编码、处理输入、转发网络流背后牵扯一堆图形、编码、虚拟输入相关的系统库而每个发行版的环境又不太一样。手动部署的每一步都可能成为劝退你的理由。Docker 就是冲着这个痛点来的。它把 Sunshine 以及它需要的所有环境打包成一个镜像你拉下来就能跑换机器只是重新拉一次的事想回滚版本切换镜像标签就行。说白了容器帮你把环境地狱彻底隔离在了一层壳里。二、快速认知四个概念一次讲透动手之前先花三分钟把几个高频词搞清楚。看不懂概念后面命令里的每个参数都会让你发怵搞懂了一切就顺理成章。概念一句话解释生活类比镜像打包好的环境快照只读安装包容器镜像运行起来的实例可写安装后的程序端口映射把宿主机端口转发给容器内服务门牌号指路数据卷挂载到容器里的宿主目录数据持久化保险箱设备直通把宿主机的硬件借给容器使用外接显卡镜像和容器镜像相当于安装包容器是跑起来的程序。你拉取的是镜像启动的是容器删掉容器不影响镜像随时能再起一个。端口映射Sunshine 在容器内部监听 47990 等端口宿主机必须把对应端口映射出来Moonlight 客户端才能找到它。映射是单向门——你指定的宿主机端口指向容器端口。设备直通--device /dev/dri串流最吃硬件编码。只有把显卡设备借进容器编码才能走 GPU否则退化成软件编码画质和延迟都会很难看。数据卷-v /configSunshine 的配置默认存在容器里的 /config 目录。不挂载出来的话容器一删配置、配对信息全部归零所以这步一定不能省。是不是比想象中简单下面进入正题跟着做就行。三、手把手实战五步跑通你的第一个串流容器这一节是全篇重点我会放慢速度每一条命令都带上注释。建议你开个终端边看边敲。第1步 先做环境自检确认两件事Docker 装好了、显卡驱动正常。以 Linux 为例docker --version # 确认 Docker 可用 ls /dev/dri # 能看到 renderD128 等节点说明显卡可直通如果你的机器上/dev/dri不存在先去装好显卡驱动再继续这一步没做好后面串流会卡成 PPT。第2步 拉取正确标签的镜像这一步最容易翻车重点来了从 v0.18.0 版本起Sunshine 官方镜像的标签规则变了不再支持latest、master、vX.X.X这种单独标签必须使用组合格式版本-操作系统例如latest-ubuntu-22.04版本部分也可以填具体的 commit hash。# 正确姿势 docker pull lizardbyte/sunshine:latest-ubuntu-22.04 docker pull lizardbyte/sunshine:v0.18.0-ubuntu-22.04 # 错误示范v0.18.0 之后这样拉会报错 docker pull lizardbyte/sunshine:latest版本部分支持四类写法具体版本号如 v0.18.0、latest最新稳定版、master开发分支、某次提交的 hash。操作系统部分目前可选archlinux、debian-bookworm、ubuntu-22.04、ubuntu-24.04。第3步 初始化配置目录在宿主机上建一个目录存放配置并提前把权限交给容器内用户免得启动后写不进去mkdir -p /path/to/config sudo chown -R 1000:1000 /path/to/config第4步 一条命令把容器拉起来下面是完整版 docker run参数都标了注释照着抄就行docker run -d \ --device /dev/dri/ \ # 显卡直通硬件编码必需 --namesunshine-container \ # 自定义容器名 --restartunless-stopped \ # 开机自启异常退出自动拉起 --ipchost \ # 共享宿主机内存传帧数据很吃内存 -e PUID1000 \ # 容器内用户 ID -e PGID1000 \ # 容器内用户组 ID -e TZAsia/Shanghai \ # 时区决定日志时间 -v /path/to/config:/config \ # 配置持久化 -p 47984-47990:47984-47990/tcp \ # 控制通道 Web 管理界面(47990) -p 48010:48010 \ # 媒体流通道 -p 47998-48000:47998-48000/udp \ # 视频/音频流 lizardbyte/sunshine:latest-ubuntu-22.04如果你习惯用 docker compose把下面这段存成 docker-compose.yml再执行docker compose up -d效果一样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: - PUID1000 - PGID1000 - TZAsia/Shanghai ipc: host ports: - 47984-47990:47984-47990/tcp - 48010:48010 - 47998-48000:47998-48000/udp第5步 验证成果登录 Web 界面并完成配对浏览器打开http://你的主机IP:47990会进入 Sunshine 的 Web 管理登录页按提示创建账号登录即可登录后进入 Applications 页面默认已经有 Desktop、Steam 这些应用卡片点右上角的 Add New 可以继续添加你想串流的游戏或程序到这里容器就算正式跑起来了。最后一步在手机或平板装好 Moonlight 客户端添加主机时填电脑的 IP用 Web 界面里显示的 PIN 码完成配对就能开始你的第一次串流了。四、进阶与自定义从能跑到跑得顺手基础部署没问题后这几个问题你迟早会遇到版本选哪个、ARM 设备能不能用、参数怎么按需调、能不能和 Steam 生态组队。版本与架构怎么选镜像的架构支持并不统一动手前先对号入座操作系统x86_64ARM64Archlinux支持不支持Debian Bookworm支持支持Ubuntu 22.04支持支持Ubuntu 24.04支持支持我的建议很直白Intel/AMD 台式机ubuntu-22.04 或 debian-bookworm 随便选稳ARM 设备软路由、开发板这类优先 debian-bookworm 和 ubuntu-24.04用 Arch 的玩家就别惦记 ARM64 镜像了。参数速查与按需调整参数作用示例是否必需-p 47990:47990Web 管理界面端口可改成 8080:47990是-v /config配置文件存储路径/home/你的用户名/sunshine是--device /dev/driGPU 直通设备-推荐--ipchost共享宿主机内存-推荐PUID/PGID容器内用户/组 ID1000推荐TZ时区Asia/Shanghai可选如果默认的 Web 端口 47990 被别的服务占了把映射改成-p 8080:47990然后访问http://IP:8080就行其他端口照旧。PUID/PGID 建议改成你宿主机实际用户的 ID避免文件归属混乱。想在 Web 界面里快速定位某个配置项可以用顶部搜索框比如搜 Upnp 就能直接找到网络端口转发相关的开关Podman 用户的平替方案不用 Docker 也可以玩。Podman 的启动命令几乎一样唯一要记得的是把用户映射参数换成--usernskeep-id其余照抄podman run -d \ --device /dev/dri/ \ --namesunshine-container \ --restartunless-stopped \ --usernskeep-id \ -e PUID1000 \ -e PGID1000 \ -e TZAsia/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把它当积木集成进自己的镜像官方镜像本身就是按基础镜像设计的方便你往上叠加依赖。比如想让容器里直接带上 Steam可以这么写 DockerfileARG SUNSHINE_VERSIONlatest ARG SUNSHINE_OSubuntu-22.04 FROM lizardbyte/sunshine:${SUNSHINE_VERSION}-${SUNSHINE_OS} # 在基础镜像上补齐 Steam 和 Wayland 相关依赖 RUN apt-get update apt-get install -y \ steam \ wayland-protocols \ weston ENTRYPOINT [steam, , sunshine]构建时通过 ARG 传不同的版本和系统同一套 Dockerfile 就能随意切换灵活度很高。五、避坑手册四个高频翻车现场最后分享四个我见过最多的问题都按现象 → 原因 → 解决来整理遇到直接对号入座。坑1容器反复重启日志全是 Permission denied现象容器起不来挂载目录里写不进任何文件。原因宿主机目录的属主和容器内 PUID/PGID 对不上。解决把目录权限交给容器内用户sudo chown -R 1000:1000 /path/to/config坑2串流画面卡成幻灯片GPU 完全不干活现象能连上但帧率极低CPU 占用爆表。原因显卡设备没直通进容器或宿主机驱动本身没装好。解决确认ls /dev/dri有输出且启动命令里保留了--device /dev/dri/。还不生效的话去 Web 界面的 Logs 页看有没有 Encoder not found 之类的报错日志里通常直接写明问题坑3Web 界面打不开或打开的是别的程序现象访问 47990 端口没反应或者跳到了完全无关的页面。原因端口被其他服务占用了。解决改宿主机的端口映射比如-p 8080:47990之后用http://IP:8080访问。坑4容器日志时间总是差好几个小时现象日志时间戳全是 UTC和本地时间对不上。原因没设置时区。解决启动时加一行-e TZAsia/Shanghai其他地区按需替换即可。六、收尾从跑起来到玩明白还记得开头那个折腾一整晚的朋友吗现在他只需要复制一条 docker run5 分钟服务就能恢复如初换机器也只是重新拉一次镜像的事。手动部署时代最折磨人的环境问题被容器干净利落地挡在了门外。给你几条收尾建议求稳日常使用锁定具体版本比如 v0.18.0-ubuntu-22.04别追 latest升级更可控求新想尝鲜新功能随时切到 master 分支标签体验勤备份/config 目录定期备份——容器丢了能重建配置和配对记录丢了才是真麻烦控资源串流很吃资源给容器加上 CPU/内存限额别让它拖垮整台机器。想继续深入仓库的 docs 目录就是最好的向导部署全流程看 docs/getting_started.md画质与延迟调优看 docs/performance_tuning.md遇到问题先去 docs/troubleshooting.md 翻一翻。想从源码开始折腾也可以 clone 下来自己编译git clone https://gitcode.com/GitHub_Trending/su/Sunshine一句话收束Sunshine 负责把游戏画面送出去Docker 负责把 Sunshine 养在无菌室里。跑通部署之后你会发现真正值得花时间的不是环境配置而是串流画质、延迟和输入体验的调优——那才是这份乐趣真正开始的地方。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考