Sunshine项目：实现客户端连接/断开时自动执行命令的解决方案

背景介绍

Sunshine是一款开源的远程桌面服务器软件，它允许用户通过Moonlight等客户端远程访问主机。在实际使用中，用户经常需要在客户端连接或断开时自动执行某些系统命令，例如调整音量、切换显示模式等操作。

问题分析

Sunshine当前版本存在一个功能限制：它只能在会话启动和结束时执行DO/UNDO命令，而无法在客户端连接或断开时触发这些操作。这导致了一些使用场景下的不便：

1. 当客户端暂时断开连接（如最小化Moonlight）时，UNDO命令不会执行
2. 显示模式切换等操作只能在会话完全结束时才恢复
3. 音量控制等设置会保持到会话完全退出

技术解决方案

针对这一问题，我们可以通过监控Sunshine日志文件并解析特定事件来实现更精细的控制。以下是详细的实现方案：

PowerShell监控脚本实现

$logFilePath = "C:\Program Files\Sunshine\config\sunshine.log"
$connectedBatchFilePath = "C:\Temp\muteVolume.bat"
$disconnectedBatchFilePath = "C:\Temp\UnmuteVolume.bat"
$matchPatternClientConnected = "CLIENT CONNECTED"
$matchPatternClientDisconnected = "CLIENT DISCONNECTED"

# 检查日志文件是否存在
if (-Not (Test-Path $logFilePath)) {
    Write-Error "日志文件不存在: $logFilePath"
    exit
}

# 实时监控日志文件内容
Get-Content $logFilePath -Wait | ForEach-Object {
    if ($_ -match $matchPatternClientConnected ) {
        # 客户端连接时执行批处理文件
        Start-Process -WindowStyle hidden -FilePath $connectedBatchFilePath
    }

    if ($_ -match $matchPatternClientDisconnected ) {
        # 客户端断开时执行批处理文件
        Start-Process -WindowStyle hidden -FilePath $disconnectedBatchFilePath
    }
}

配套批处理文件示例

muteVolume.bat内容：

@echo off
C:\temp\SetVol mute

UnmuteVolume.bat内容：

@echo off
C:\temp\SetVol unmute

部署方案

1. 将上述PowerShell脚本保存为.ps1文件
2. 创建对应的批处理文件
3. 通过Windows任务计划程序设置脚本开机自启
   • 选择"不管用户是否登录都要运行"
   • 设置"隐藏"运行方式以避免弹出窗口

方案优势

1. 实时响应：能够立即检测到客户端连接状态变化
2. 灵活性：可以自由定义连接/断开时执行的操作
3. 低资源占用：仅监控日志文件变化，系统开销小
4. 兼容性：适用于各种需要触发系统命令的场景

扩展应用

此方案不仅适用于音量控制，还可应用于：

1. 显示模式切换
2. 网络QoS设置调整
3. 后台服务启停
4. 系统性能模式切换

注意事项

1. 确保Sunshine日志路径与脚本中配置一致
2. 批处理文件需要有执行权限
3. 对于生产环境，建议添加日志记录功能以跟踪脚本执行情况
4. 可考虑添加错误处理和重试机制增强可靠性

通过这种方案，用户可以实现比Sunshine原生功能更精细的控制粒度，满足各种自动化需求。