参考来源与致谢
- 引用来源:How to build the latest curl from sources to allow downloading files via sftp?
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
企业内需要让 curl 支持 SFTP 协议下载文件,而发行版仓库自带的 curl 未编译 libssh2 支持时,可考虑从源码构建。该方式适用于受控的运维环境,需具备编译工具链与 root 权限。
从第三方源码安装软件存在安全风险。执行前必须确认源码来源可信,并在测试环境验证后再用于生产。
准备与风险 #
- 确认已安装编译工具链(如 gcc、make、autoconf、libtool)及 OpenSSL 开发包。
- 准备 libssh2 源码包,并确认其版本与目标 curl 版本兼容。
- 记录当前 curl 版本与安装路径,便于回退。
- 卸载系统 curl 可能影响依赖它的软件包,操作前应评估依赖关系。
- 建议在测试环境或快照/容器中先行验证,避免直接影响生产主机。
处理步骤 #
1. 构建并安装 libssh2 #
tar -xzf libssh2-[版本].tar.gz
cd libssh2-[版本]
./configure
make
sudo make install
安装后确认库文件位于 /usr/local/lib,必要时更新动态链接库缓存。
2. 处理现有 curl #
卸载发行版 curl 前先备份配置与相关脚本:
sudo apt purge curl
部分 libcurl 相关包被其他软件依赖,卸载可能导致依赖断裂。是否卸载需结合 apt-cache rdepends 等工具评估,不确定时保留。
3. 获取 curl 源码 #
git clone [curl 源码仓库地址]
cd curl
仓库中的 GIT-INFO 文件包含构建说明,构建流程可能随版本变化,应以该文件及对应版本文档为准。
4. 编译安装 #
./buildconf
./configure --disable-libcurl-option --disable-shared --with-libssh2=/usr/local
make
sudo make install
使用静态链接可减少运行时找不到 libcurl 共享库的问题。若出现符号查找错误或共享库加载失败,可检查链接方式与库路径。
验证方法 #
curl -V
输出中 Protocols 列表应包含 sftp,Features 中应体现 libssh2 相关信息。随后可用测试账号尝试从 SFTP 服务器下载文件,确认功能正常。
回退建议 #
- 源码安装的 curl 可通过
sudo make uninstall卸载。 - 卸载后重新通过发行版包管理器安装原 curl 版本。
- 若已卸载 libcurl 相关包,需按依赖关系恢复。
- 生产变更前保留系统快照或备份,确保可快速还原。
常见问题 #
- curl 报 symbol lookup error 或找不到 libcurl.so:多为共享库路径冲突,可改用静态链接或调整库搜索路径。
- 卸载 curl 后其他软件异常:说明存在依赖,应恢复原包并重新评估方案。
- 构建失败:检查 libssh2 安装路径、编译工具版本及 configure 参数,参考对应版本文档。
- SFTP 未出现在协议列表:确认 configure 时已正确指定 libssh2 路径。
不同发行版与版本的具体行为可能存在差异,参数与支持范围请以对应版本官方文档为准。
