常见问题

整套系统由三部分组成，分别装在不同的机器上，不要装混： - 管理端：一台长期开机的服务器。统一汇集账号列表、设备列表和设备在线状态，是客户端登录后看到设备列表的来源（账号不是由管理员分配的——你在服务端自己注册后，管理端从服务端同步过来）。 - 服务端（Sunshine）：要被串流的那台电脑（性能好的那台）。把电脑的画面和声音采集、发送出去；账号在这里自己注册。 - 客户端（Moonlight）：你用来看画面的设备（盒子或另一台电脑）。显示画面，并把键盘鼠标操作传回去。 几点容易搞错的地方： - 整套系统只需要一个管理端，装多了会互相冲突； - 服务端和客户端可以有多台，但都必须连到同一个管理端； - 三台机器不需要在同一个局域网里，只要彼此能连上管理端即可； - 账号不是由管理员分配的——你在服务端自己注册账号，然后拿这套账号在客户端登录。

按下面顺序做，中间任何一步没做完，后面都会卡住： 1. 管理员把管理端装好并启动（这一步由管理员完成）； 2. 在要被串流的那台电脑上装好服务端，启动它并进行用户注册； 3. 服务端启动后会自动向管理端报到，管理端的「设备管理」里就会出现这台电脑； 4. 在你用来看画面的设备上装好客户端，用你自己注册的用户名和密码登录； 5. 登录成功后，设备列表里就会显示可用的电脑，点一下就能开始使用。

按可能性从高到低排查： - 确认用户名和密码正确，注意大小写和空格； - 确认这个账号是否存在，并且没有被禁用或删除； - 确认连的是正确的 Sunshine 主机（网络里有多个主机时容易连错）； - 如果改过密码，用新密码登录。 忘记密码时，到 Temstream配置工具重置即可；如果账号被禁用，请在被串流的电脑上检查账号状态。

这是最常见的问题，原因通常在「管理端 ↔ 服务端」这条链路上。请按这个顺序排查： 1. 确认服务端（被串流电脑上的服务）在运行（右下角图标、服务管理器里的状态都能看）； 2. 确认服务端已成功向管理端报到——管理端的「设备管理」里能看到这台电脑； 3. 确认客户端能连上管理端（设备列表的来源就是管理端）； 4. 如果是外网访问，确认客户端到管理端、以及客户端到服务端的网络都通； 5. 确认防火墙允许相关端口通过（47984 / 47989 / 8443 等）； 6. 仍找不到时，让管理员核对管理端里这台设备的账号关联状态。 ⚠️ 单纯退出客户端再重新登录通常解决不了这个问题；关键是「服务端 → 管理端」和「客户端 → 管理端」这两条链路是否都通。

系统在外网环境下工作时，客户端需要先连上**管理端**（拿到设备列表），然后才能经管理端转去访问服务端。任何一条链路不通，客户端都会卡住。 请依次确认： 1. 你的账号是否已在服务端注册并同步到了管理端。如果管理端没收到这份同步，客户端就拿不到设备，也就不会建立到服务端的隧道； 2. 客户端能否连上管理端。先用浏览器打开管理端的地址确认它可达，再回到客户端登录； 3. 客户端能否连上服务端。如果是 VPN 方案，确认两端都在同一 VPN 网络里；如果走 HTTPS 8443，确认反代和证书都正常； 4. 凭证是否过期或被禁用，重新登录一次看是否清理成功。 如果以上都确认过仍然不行，这多半属于服务端或网络配置的问题，请把现象反馈给管理员。

先理解一下系统怎么判断「在线」：服务端（被串流电脑上的服务）会持续不断地向**管理端**报平安。一旦超过约 3 分钟没有收到消息，管理端就会把这台设备标记为「离线」。 所以「离线」跟画面、跟你手上的客户端无关，要查的是那台被串流的电脑和服务端到管理端的链路： 1. 服务端程序还在运行吗？最常见的原因是程序被关掉、崩溃，或者电脑刚重启过还没启动它； 2. 电脑有没有休眠或睡眠？电脑睡着之后服务端也就停止报平安了。请在电源设置里让它保持唤醒； 3. 服务端到管理端的网络通不通？断网、换了网络、或者用了会拦截网络的安全软件，都会导致报平安失败； 4. 服务端里配置的管理端地址填得对不对？地址写错，它就报到别处去了； 5. 管理端本身是否正常运行。 处理完以上任何一项，等几十秒到一分钟左右，管理端会自动把它重新标记为在线。

这类问题通常出在「传输」而不是「设备」上，按下面的顺序试： 画面卡顿或模糊： - 在 Moonlight 的串流设置里降低画面质量（分辨率、帧率、码率调低一档），这是最立竿见影的办法； - 确认两台机器之间的网络状况：无线网络、跨地区、多人共用同一个网络都会明显影响流畅度； - 如果使用外网访问，尽量选择网络质量更好的时段和线路。 黑屏、进不去画面： - 确认被串流的电脑屏幕处于点亮状态，不要息屏、不要锁定； - 在 Sunshine Web 控制台里确认没有其它账号正在独占使用； - 在被串流的电脑上确认 Sunshine 仍在运行。 没有声音： - 确认被串流电脑上的音频输出设备正常（比如没有被切成不存在的耳机）； - 在 Moonlight 设置里检查音量是否被静音或调到最低。 如果只有某一台设备有问题，其他设备正常，基本可以判断问题出在那台设备本身，请在 Sunshine 主机上协助检查。

「共享磁盘」是串流期间 Sunshine 临时挂载的一块网络磁盘，用来在客户端设备和被串流的电脑之间传文件。 三个正常的现象，不要当成故障： 1. 它只在串流过程中出现，串流一结束就自动消失。所以在不串流的时候去电脑上找，是找不到的——这是设计如此，不是丢失； 2. 在 Moonlight 里查看，也要在串流进行中查看才会显示； 3. Sunshine 默认不开启共享文件夹，需要在 Web 控制台里开启才会出现。 如果串流过程中依然看不到、或者提示无法访问： - 确认客户端设备和 Sunshine 主机在同一个网络里（跨网络共享通常不可用）； - 这种情况请把 Moonlight 提示内容截图，在 Sunshine 主机上核对配置。

在寻求帮助之前，做完这三件事，能解决大部分问题： 第一步：重启服务端 + 客户端。把被串流电脑上的服务端完全退出后重新打开；客户端也完全退出后重新打开。如果最近重启过电脑或路由器，多等一两分钟再试。 第二步：重新登录 + 重新报到。客户端退出当前账号再重新登录一次；同时在被串流的电脑上确认服务端已成功向管理端报到（管理端的「设备管理」里能看到这台电脑）。 第三步：自己看两端的状态。被串流电脑上可看服务端的本地日志；管理端的状态需要管理员核对。这一步同时检查「客户端 → 管理端」和「服务端 → 管理端」两条链路是否通。 反馈给支持时，请尽量带上这些信息，能省掉大量来回沟通： - 你的账号名，以及你在哪台设备上操作； - 屏幕上出现的完整提示文字（或截图）； - 大概是什么时候开始的、之前有没有做过什么改动（比如换了网络、重启过、改过密码）； - 同一时间其他同事能不能正常使用。