You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

在Canopy终端从GitHub安装orbital.py时遇SSL错误求助

解决pip安装orbital.py时的SSL TLSv1协议版本错误

这个SSLError: [SSL: TLSV1_ALERT_PROTOCOL_VERSION] tlsv1 alert protocol version错误我见得挺多的,本质就是你的pip版本太老旧,不支持GitHub目前要求的TLS 1.2/1.3加密协议,还在尝试用已经被淘汰的TLSv1去建立连接,所以被服务器拒绝了。下面是具体的解决步骤:

  • 第一步:优先升级pip到最新版本
    旧pip是问题的核心,先在Canopy命令行执行这条升级命令:

    python -m pip install --upgrade pip
    

    如果执行这条命令时还是碰到同样的SSL错误,说明连升级pip的源也无法通过旧协议访问,那就换用get-pip.py脚本手动升级:

    1. 用浏览器下载get-pip.py脚本,保存到Canopy的工作目录里
    2. 在Canopy命令行执行:
      python get-pip.py
      
  • 第二步:重新安装orbital.py
    升级完pip后,再执行GitHub仓库的安装命令:

    pip install git+https://github.com/RazerM/orbital.git
    

    你也可以选择先把仓库克隆到本地,再进行安装:

    git clone https://github.com/RazerM/orbital.git
    cd orbital
    pip install .
    
  • 如果问题仍存在?检查OpenSSL版本
    要是升级pip后还是不行,可能是你的系统(或Canopy自带的)OpenSSL库版本太低,不支持新的TLS协议。这时候可以试试:

    • 检查Canopy是否有可用更新,直接把Canopy升级到最新版本
    • 手动更新系统的OpenSSL组件(不同系统操作不同,比如Windows可以下载OpenSSL官方安装包,Linux用对应的包管理器更新)

补充一句:GitHub早在2018年就停止了对TLSv1和TLSv1.1的支持,所以任何依赖旧协议的工具都会出现这类SSL连接错误,升级pip是最直接有效的解决办法。

内容的提问来源于stack exchange,提问作者Rose

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.27 07:07:09