搭建Vagrant本地开发环境报错：添加Laravel Homestead Box时SSL读取失败

嘿，这个错误我之前折腾Homestead的时候也碰到过，errno 10054本质是网络连接被重置，大概率是远程下载时的网络问题或者老版本软件的SSL兼容性问题，给你几个实用的解决办法：

• 手动下载后本地添加（最稳妥）
  绕开远程下载的网络问题，先手动获取Homestead的box文件，然后用本地文件添加的命令：

  vagrant box add laravel/homestead /本地路径/下载好的homestead.box
  

  这样完全避免了远程SSL连接的问题，适合网络环境受限的情况。

• 临时禁用SSL验证（应急用）
  如果只是临时测试，可以先在Git Bash里设置环境变量禁用Vagrant的SSL验证：

  export VAGRANT_INSECURE_SSL=1
  

  然后再执行vagrant box add laravel/homestead命令。注意：这个方法会降低安全性，只建议临时使用，之后记得取消这个变量。

• 清除代理设置
  有时候残留的代理配置会导致连接异常，在Git Bash里执行以下命令清除代理：

  unset http_proxy
  unset https_proxy
  

  之后再尝试添加box的命令。

• 升级Vagrant和VirtualBox版本
  你当前使用的Vagrant 2.0.4和VirtualBox 5.2.10都是比较老旧的版本，可能存在SSL库的兼容性问题。升级到较新的稳定版本（比如Vagrant最新稳定版、VirtualBox 6.x/7.x系列），很多老版本的网络连接问题都会被修复。

补充说明 #

OpenSSL SSL_read: SSL_ERROR_SYSCALL, errno 10054这个错误通常是因为：

• 网络不稳定导致连接被服务器重置
• 区域网络限制无法访问官方下载源
• 老版本软件的SSL协议不兼容服务器端的加密规则

内容的提问来源于stack exchange，提问作者flash