---
title: 从源码构建支持 SFTP 的 curl：企业运维实践
description: 介绍在企业 Linux 环境中从源码构建支持 SFTP 协议的 curl 的完整流程，涵盖依赖准备、风险控制、构建步骤、验证方法与回退方案，并强调第三方源码的安全风险与版本差异。
url: "https://www.lanever.com/docs/%e4%bb%8e%e6%ba%90%e7%a0%81%e6%9e%84%e5%bb%ba%e6%94%af%e6%8c%81-sftp-%e7%9a%84-curl%ef%bc%9a%e4%bc%81%e4%b8%9a%e8%bf%90%e7%bb%b4%e5%ae%9e%e8%b7%b5/"
updated: "2026-10-12"
category: Linux
---

# 从源码构建支持 SFTP 的 curl：企业运维实践

> **参考来源与致谢**
>
>
>
> - **引用来源：**[How to build the latest curl from sources to allow downloading files via sftp?](https://askubuntu.com/questions/1128780/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 路径。

不同发行版与版本的具体行为可能存在差异，参数与支持范围请以对应版本官方文档为准。
