Sunshine项目中的CURL错误35问题分析与解决方案

问题背景

Sunshine是一款开源的流媒体服务器软件，在最新版本v2025.122.141614中，部分Windows 10用户遇到了游戏封面无法下载的问题。系统日志显示错误信息为"CURL error 35"，具体表现为尝试从IGDB图片服务器下载封面时失败，创建了零字节的空文件。

技术分析

CURL错误35的本质

CURL错误代码35(SSL connect error)表明在建立SSL/TLS安全连接时出现了问题。深入分析发现，这是由于Sunshine默认使用了TLS 1.3协议，而Windows 10的Schannel安全包原生不支持TLS 1.3导致的协议不匹配。

底层机制

Windows系统使用Schannel SSP(安全支持提供程序)来处理SSL/TLS通信。根据微软官方文档，Windows 10的Schannel实现最高仅支持到TLS 1.2版本。当Sunshine尝试使用TLS 1.3建立连接时，Schannel会返回SEC_E_ALGORITHM_MISMATCH(0x80090331)错误，表明客户端和服务器之间没有共同支持的加密算法。

用户环境验证

多位用户报告了相同问题，验证环境包括：

• 操作系统：Windows 10
• 架构：amd64/x86_64
• 网络环境：直接连接和代理均出现相同问题
• 浏览器测试：相同URL在浏览器中可以正常访问

解决方案

临时解决方案

对于急需解决问题的用户，可以尝试以下方法：

1. 在Internet属性中启用"使用TLS 1.3(实验性)"选项
2. 修改注册表相关键值以启用TLS 1.3支持

但需要注意的是，这些方法在某些系统上可能无效，因为Windows 10对TLS 1.3的支持并不完整。

官方修复方案

Sunshine开发团队已经发布了修复版本，主要变更包括：

1. 移除了强制使用TLS 1.3的限制
2. 允许系统自动协商SSL/TLS协议版本
3. 保持与Windows 10 Schannel的兼容性

多位用户已确认该修复版本有效解决了封面下载问题。

技术建议

对于开发者而言，在处理SSL/TLS连接时应注意：

1. 考虑目标平台的协议支持情况
2. 避免硬编码SSL/TLS版本
3. 实现协议版本自动协商机制
4. 提供详细的错误日志记录

对于终端用户，如果遇到类似问题，建议：

1. 检查系统日志获取详细错误信息
2. 确认操作系统和软件版本
3. 尝试更新到软件的最新版本
4. 必要时向开发者提供详细的故障报告

总结

Sunshine项目中的CURL错误35问题揭示了跨平台软件开发中加密协议兼容性的重要性。通过分析问题根源和提供针对性解决方案，不仅解决了当前用户面临的实际问题，也为类似场景下的开发实践提供了有价值的参考。