Sunshine游戏串流容器化部署终极指南用Docker三分钟跑通自托管串流服务【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款面向 Moonlight 客户端的自托管游戏串流服务端用 Docker 容器化部署能帮你把一台普通 Linux 主机变成随时可玩的游戏串流服务器。这篇实操指南按环境自检 → 首次启动 → 配置持久化 → 生产化加固 → 最终验证的顺序推进全程手把手不看复杂的容器理论也能跑通。动手前先花两分钟做环境自检确认你的 CPU 架构落在哪一列镜像按基础操作系统区分标签后缀不同系统对硬件架构的支持并不一致。启动之前先对照下表确认自己的平台在支持范围内标签后缀SUNSHINE_OSamd64 / x86_64arm64 / aarch64debian-bookworm✅✅ubuntu-22.04✅✅ubuntu-24.04✅✅确认方式很简单运行uname -m输出x86_64或aarch64都能对应上表找到可用镜像。如果你用的是树莓派这类 ARM 设备选 Debian 或 Ubuntu 系标签即可不用为架构单独折腾。检查 GPU 驱动与设备节点串流要流畅硬件编码基本是刚需。启动容器前先在宿主机执行ls /dev/dri确认存在renderD128之类的设备节点再跑vainfo或nvidia-smi验证驱动可用。这一步没做好后面大概率会遇到画质糊、CPU 狂飙的尴尬。确认端口没有被占用Sunshine 需要 TCP 47984-47990、TCP 48010 以及 UDP 47998-48000 三段端口。用ss -tuln | grep 479快速查一下若有冲突把宿主侧端口改掉即可见后文端口冲突解法。第一步搞懂镜像标签的新规矩从 v0.18.0 版本开始Sunshine 的镜像标签规则变了latest、master、vX.X.X这类单一标签不再单独可用必须用版本-操作系统的组合格式例如latest-ubuntu-24.04。其中前半段SUNSHINE_VERSION支持四种取值具体版本号如v0.21.0生产环境推荐latest跟随最新稳定版master开发分支尝鲜用别上生产具体的 commit hash用于精确复现某个提交。后半段SUNSHINE_OS就是上表里的debian-bookworm、ubuntu-22.04、ubuntu-24.04。组合起来拉取即可比如docker pull lizardbyte/sunshine:v0.21.0-ubuntu-22.04。第二步三分钟用 docker run 把服务跑起来这里先给一份能直接跑通的最小命令预计耗时 3 分钟难度一颗星docker run -d \ --device /dev/dri/ \ --namesunshine \ --restartunless-stopped \ --ipchost \ -e PUID1000 \ -e PGID1000 \ -e TZAsia/Shanghai \ -v /home/你的用户名/sunshine:/config \ -p 47984-47990:47984-47990/tcp \ -p 48010:48010 \ -p 47998-48000:47998-48000/udp \ lizardbyte/sunshine:latest-ubuntu-22.04容器起来后浏览器打开http://宿主机IP:47990你会看到首次配置界面——为 Web 管理面板设置一个用户名和密码之后就能进主界面了--ipchost是共享宿主机内存/信号量对硬件编码很友好--device /dev/dri/则把 GPU 设备直通进容器。这两项先加上后面讲参数时再细说。第三步给配置上保险防止重启即失忆容器是用完即走的配置文件如果不挂出来容器一删全没了。镜像内部把配置目录固定为/config它实际软链接到用户主目录下的.config/sunshine所以数据卷映射-v 宿主机目录:/config是必须的——这就是你的保险箱。接着解决权限问题容器以非 root 用户运行用户 IDPUID和组 IDPGID如果和宿主机目录属主不一致就会出现容器里能写、外面读不了的怪毛病。先执行id 你的用户名拿到两个数字比如uid1000(me) gid1000(me)再把它们填进-e PUID1000 -e PGID1000同时保证宿主机目录属主一致chown -R 1000:1000 /home/你的用户名/sunshine小提示不同基础镜像内置的默认 UID 并不统一ubuntu-22.04 默认 1000/1000ubuntu-24.04 默认 1001/1001所以别偷懒务必显式指定。另外PUID/PGID 是在构建镜像时写死的改完需要重建镜像才生效。第四步按需调优把串流性能榨出来核心参数都在这张表里照着选就行参数作用示例值必需-p 外部:47990Web 管理界面端口内部固定 479908080:47990✅ 必须-v 目录:/config配置文件持久化目录/home/me/sunshine✅ 必须-p 47984-47989/tcp、48010、47998-48000/udp串流通信端口保持默认✅ 必须--device /dev/dri/GPU 硬件编码设备直通/dev/dri/强烈推荐--ipchost共享宿主机内存与信号量-推荐-e PUID / PGID容器内用户/组 ID1000推荐-e TZ时区保证日志时间准确Asia/Shanghai可选串流相关的高级选项比如 UPnP 自动端口转发、编码器选择都在 Web 面板里进Configuration页用搜索框直接搜关键词即可快速定位第五步上生产用 Compose 或 Podman 托管单条docker run适合快速验证长期跑建议把配置固化成docker-compose.yml团队协作和回溯都方便version: 3 services: sunshine: image: lizardbyte/sunshine:latest-ubuntu-24.04 container_name: sunshine restart: unless-stopped devices: - /dev/dri:/dev/dri volumes: - /home/你的用户名/sunshine:/config environment: - PUID1000 - PGID1000 - TZAsia/Shanghai ipc: host ports: - 47984-47990:47984-47990/tcp - 48010:48010 - 47998-48000:47998-48000/udp保存后一条docker compose up -d即可启动。注意我在这里补上了devices段——Compose 不会自动继承宿主机设备GPU 直通必须显式声明。如果你用的是 Podman无守护进程、rootless 友好把--ipchost换成--usernskeep-id即可保持用户命名空间一致其余参数大同小异podman run -d \ --device /dev/dri/ \ --namesunshine \ --restartunless-stopped \ --usernskeep-id \ -e PUID1000 -e PGID1000 -e TZAsia/Shanghai \ -v /home/你的用户名/sunshine:/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} # 在这里通过 apt-get 安装 steam、wayland-protocols、weston 等依赖 ENTRYPOINT steam sunshine构建时用--build-arg分别传版本和操作系统即可。社区里的 Games on Whales 项目就是这么把 Sunshine 与 Steam 容器打通的值得参考。更详细的构建流程见官方文档docs/building.md。最后验证一切正常的标志是什么启动后做四连测docker ps里 sunshine 容器状态为 Updocker logs sunshine无致命报错浏览器能打开 Web 面板并登录用 Moonlight 客户端添加主机能被自动发现或手动添加成功发起一次串流会话确认画面与帧率正常。万一哪一步卡住Web 面板的 Logs 页是最直接的线索来源编码器缺失、共享内存异常都会在这里现形高频坑位的症状 → 原因 → 解法症状一Web 面板打不开或串流端口不通原因外部端口与宿主机其他服务冲突。 解法只改冒号左侧保留右侧内部端口例如-p 8080:47990访问时用新端口。症状二容器里能写配置宿主机却改不动 / 反过来原因PUID/PGID 与数据卷目录属主不一致。 解法id查值后对齐-e PUID/PGID并对挂载目录执行chown -R。症状三串流延迟高、CPU 爆满、日志报Encoder not found原因GPU 设备未直通或驱动不完整。 解法确认宿主机ls /dev/dri有设备、驱动正常容器加上--device /dev/dri/Compose 别忘了devices段。症状四日志时间比本地慢 8 小时原因未设置时区。 解法加-e TZAsia/Shanghai后重建容器。更多排查思路可参考官方排障手册docs/troubleshooting.md。收尾三条让服务长期稳定的习惯最后补几个实战中沉淀下来的习惯篇幅有限不展开但每条都踩过坑生产环境固定版本号把latest换成vX.X.X升级前先看 docs/changelog.md 再决定定期备份/config目录配对信息、应用列表都在里面丢了等于重新配对一遍所有客户端顺手看资源占用docker stats sunshine一眼看清 CPU/内存给容器加上资源上限避免串流时把宿主机拖垮。到这里一台稳定可用的 Sunshine 串流服务就交付了。之后无论是调编码参数还是挂 Steam 容器都是在今天这套地基上做加法——祝你串流愉快。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考