尧图网页设计 
curl--pubkey选项详解为 SFTP/SCP 显式指定 SSH 公钥文件【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl导读--pubkey是 curl 命令行工具中用于 SFTP、SCP 协议的 SSH 公钥认证选项它允许你显式指定存放 SSH 公钥的文件路径与--key私钥文件搭配组成一套完整的公钥认证方案。读完本文你将掌握--pubkey的语法、默认行为公钥自动提取机制、与--key/--pass等选项的配合方式以及 curl 底层在 libssh2/libssh 两个 SSH 后端中如何使用该公钥文件完成认证的完整调用链。--pubkey基本用法选项元信息该选项定义于 docs/cmdline-opts/pubkey.md其 front matter 中记录了完整的选项属性属性值Long 名称--pubkey参数key公钥文件名适用协议SFTP、SCP帮助文本SSH Public key filename分类sftp、scp、ssh、auth引入版本7.16.2Multisingle选项只能出现一次官方示例为curl --pubkey file.pub sftp://example.com/命令行基本用法--pubkey需要一个公钥文件名作为参数典型用法是与--key一起使用# 显式指定私钥与公钥文件进行 SFTP 上传 curl --key ~/.ssh/id_ed25519 --pubkey ~/.ssh/id_ed25519.pub \ -u username: sftp://example.com/path/to/file # SCP 下载场景 curl --key ./client_key --pubkey ./client_key.pub \ -u username: scp://example.com/remote/path/file参数解析在 src/tool_getparam.c 中完成随后存储到配置结构体config-pubkey字段见 src/tool_cfgable.h。关键行为公钥的自动提取文档明确指出curl 会尝试自动从私钥文件中提取公钥因此通常不需要显式传递--pubkey。这一行为在源码 lib/vssh/vssh.c 中有明确实现注释Unless the user explicitly specifies a public key file, let the SSH library extract the public key from the private key file. This is done by passing sshc-pub_key NULL.即只有当用户显式指定公钥文件时sshc-pub_key才会被设置为该文件路径否则保持为 NULL交由底层 SSH 库从私钥中自行推导公钥。提取的前提条件自动提取存在一个硬性前提文档原文该功能要求 libcurl 在编译时链接的 libssh2 版本为 1.2.8 或更高且该 libssh2 自身必须链接了 OpenSSL。该能力自 curl 7.39.0 起提供。也就是说libssh2 1.2.8 且链接 OpenSSL公钥可以从私钥文件自动推导--pubkey通常可以省略libssh2 更老版本或未链接 OpenSSL必须显式给出--pubkey公钥文件否则公钥认证可能失败。与其他 SSH 选项的配合--pubkey通常与以下选项搭配使用构成完整的 SSH 认证参数集选项作用文档--key key指定私钥文件名。未指定时 curl 依次尝试~/.ssh/id_rsa、~/.ssh/id_dsa、./id_rsa、./id_dsakey.md--pass phrase私钥口令passphrasepass.md--pubkey key指定公钥文件名本文主题pubkey.md--user user:password指定 SSH 用户名认证时以该用户身份进行user.md注意--key同时适用于 TLS 与 SSHSCP/SFTP而--pubkey仅适用于 SSH 场景。私钥的默认查找路径与--pubkey配对的私钥默认查找逻辑在 lib/vssh/vssh.c 中实现当用户未通过--key/CURLOPT_SSH_PRIVATE_KEYFILE指定私钥时curl 依次探测$HOME/.ssh/id_rsa、$HOME/.ssh/id_dsa随后尝试当前目录下的id_rsa、id_dsa全部不存在则以空字符串兜底。libcurl 编程接口CURLOPT_SSH_PUBLIC_KEYFILE--pubkey在 libcurl 层面对应CURLOPT_SSH_PUBLIC_KEYFILE选项其语义见 lib/setopt.c 注释为Use this file instead of the $HOME/.ssh/id_dsa.pub file即用指定文件替代默认的$HOME/.ssh/id_dsa.pub。该选项在 lib/easyoptions.c 中被注册为字符串类型CURLOT_STRING。命令行工具与 libcurl 的对接发生在 src/config2setopts.c/* SSH and SSL private key uses same command-line option */ MY_SETOPT_STR(curl, CURLOPT_SSH_PRIVATE_KEYFILE, config-key); MY_SETOPT_STR(curl, CURLOPT_SSH_PUBLIC_KEYFILE, config-pubkey);在 C 程序中对应的用法为#include curl/curl.h int main(void) { CURL *curl curl_easy_init(); if(!curl) return 1; curl_easy_setopt(curl, CURLOPT_URL, sftp://example.com/path/file); curl_easy_setopt(curl, CURLOPT_USERNAME, username); curl_easy_setopt(curl, CURLOPT_SSH_PRIVATE_KEYFILE, /home/user/.ssh/id_ed25519); curl_easy_setopt(curl, CURLOPT_SSH_PUBLIC_KEYFILE, /home/user/.ssh/id_ed25519.pub); curl_easy_perform(curl); curl_easy_cleanup(curl); return 0; }源码级原理公钥认证的底层调用链密钥文件的准备阶段Curl_ssh_setup_pkey()lib/vssh/vssh.c是整个认证准备的核心函数检查ssh_auth_types中是否启用了CURLSSH_AUTH_PUBLICKEY公钥认证方式解析私钥优先使用CURLOPT_SSH_PRIVATE_KEYFILE指定文件否则按上文默认路径探测解析公钥读取CURLOPT_SSH_PUBLIC_KEYFILE即--pubkey的值若为空字符串则视同 NULL交由 SSH 库自动提取设置口令passphrase来自--pass或CURLOPT_KEYPASSWD通过infof()输出调试信息例如SSH: public key file xxx可在-v详细模式下观察到。libssh2 后端的认证调用在 libssh2 后端lib/vssh/libssh2.c认证最终由libssh2_userauth_publickey_fromfile_ex()完成该调用同时传入用户名、公钥文件路径、私钥文件路径与口令rc libssh2_userauth_publickey_fromfile_ex(sshc-ssh_session, user, curlx_uztoui(strlen(user)), sshc-pub_key, sshc-priv_key, sshc-passphrase);其中sshc-pub_key为 NULL 时libssh2 会尝试从私钥中提取公钥——这正是文档所述自动提取机制的落地处。返回LIBSSH2_ERROR_EAGAIN时表示需重试非阻塞场景。libssh 后端的对应实现若 curl 以 libssh 为 SSH 后端认证流程位于 lib/vssh/libssh.c其主机公钥校验部分使用ssh_get_server_publickey()获取服务器公钥再与 known hosts 中的条目比对。测试用例佐证仓库测试数据中可看到--pubkey的实际使用样例这些测试依赖本地 SSH 测试服务器路径中的%LOGDIR、%HOSTIP等为测试框架变量tests/data/test1446SFTP 结合--remote-time同时指定--key与--pubkeytests/data/test1583SFTP 目录与空文件操作两次请求均使用--key/--pubkeytests/data/test1725SCP 主机密钥错误场景配合--hostpubmd5与--pubkey验证失败路径。这些测试证明显式提供公钥文件如curl_client_key.pub与私钥文件配对是 SFTP/SCP 功能回归测试的标准配置方式。使用建议与注意事项优先省略--pubkey在满足 libssh2 1.2.8 OpenSSL 的构建条件下直接省略该选项让 curl 自动提取公钥更省事显式指定的场景公钥与私钥分离存储、公钥位于非标准路径、或使用的 libssh2 不支持自动提取时必须显式传--pubkey文件格式公钥文件应为 OpenSSH 格式如ssh-ed25519 AAAA...、ssh-rsa AAAA...即通常ssh-keygen生成的.pub文件权限问题认证失败时可用-v查看SSH: public key file ...与SSH: private key file ...调试输出确认 curl 实际读取的密钥路径是否正确选项唯一性--pubkey为 single 类型命令行中只能出现一次。【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 curl `--pubkey` 选项详解：为 SFTP/SCP 显式指定 SSH 公钥文件
curl--pubkey选项详解为 SFTP/SCP 显式指定 SSH 公钥文件【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl导读--pubkey是 curl 命令行工具中用于 SFTP、SCP 协议的 SSH 公钥认证选项它允许你显式指定存放 SSH 公钥的文件路径与--key私钥文件搭配组成一套完整的公钥认证方案。读完本文你将掌握--pubkey的语法、默认行为公钥自动提取机制、与--key/--pass等选项的配合方式以及 curl 底层在 libssh2/libssh 两个 SSH 后端中如何使用该公钥文件完成认证的完整调用链。--pubkey基本用法选项元信息该选项定义于 docs/cmdline-opts/pubkey.md其 front matter 中记录了完整的选项属性属性值Long 名称--pubkey参数key公钥文件名适用协议SFTP、SCP帮助文本SSH Public key filename分类sftp、scp、ssh、auth引入版本7.16.2Multisingle选项只能出现一次官方示例为curl --pubkey file.pub sftp://example.com/命令行基本用法--pubkey需要一个公钥文件名作为参数典型用法是与--key一起使用# 显式指定私钥与公钥文件进行 SFTP 上传 curl --key ~/.ssh/id_ed25519 --pubkey ~/.ssh/id_ed25519.pub \ -u username: sftp://example.com/path/to/file # SCP 下载场景 curl --key ./client_key --pubkey ./client_key.pub \ -u username: scp://example.com/remote/path/file参数解析在 src/tool_getparam.c 中完成随后存储到配置结构体config-pubkey字段见 src/tool_cfgable.h。关键行为公钥的自动提取文档明确指出curl 会尝试自动从私钥文件中提取公钥因此通常不需要显式传递--pubkey。这一行为在源码 lib/vssh/vssh.c 中有明确实现注释Unless the user explicitly specifies a public key file, let the SSH library extract the public key from the private key file. This is done by passing sshc-pub_key NULL.即只有当用户显式指定公钥文件时sshc-pub_key才会被设置为该文件路径否则保持为 NULL交由底层 SSH 库从私钥中自行推导公钥。提取的前提条件自动提取存在一个硬性前提文档原文该功能要求 libcurl 在编译时链接的 libssh2 版本为 1.2.8 或更高且该 libssh2 自身必须链接了 OpenSSL。该能力自 curl 7.39.0 起提供。也就是说libssh2 1.2.8 且链接 OpenSSL公钥可以从私钥文件自动推导--pubkey通常可以省略libssh2 更老版本或未链接 OpenSSL必须显式给出--pubkey公钥文件否则公钥认证可能失败。与其他 SSH 选项的配合--pubkey通常与以下选项搭配使用构成完整的 SSH 认证参数集选项作用文档--key key指定私钥文件名。未指定时 curl 依次尝试~/.ssh/id_rsa、~/.ssh/id_dsa、./id_rsa、./id_dsakey.md--pass phrase私钥口令passphrasepass.md--pubkey key指定公钥文件名本文主题pubkey.md--user user:password指定 SSH 用户名认证时以该用户身份进行user.md注意--key同时适用于 TLS 与 SSHSCP/SFTP而--pubkey仅适用于 SSH 场景。私钥的默认查找路径与--pubkey配对的私钥默认查找逻辑在 lib/vssh/vssh.c 中实现当用户未通过--key/CURLOPT_SSH_PRIVATE_KEYFILE指定私钥时curl 依次探测$HOME/.ssh/id_rsa、$HOME/.ssh/id_dsa随后尝试当前目录下的id_rsa、id_dsa全部不存在则以空字符串兜底。libcurl 编程接口CURLOPT_SSH_PUBLIC_KEYFILE--pubkey在 libcurl 层面对应CURLOPT_SSH_PUBLIC_KEYFILE选项其语义见 lib/setopt.c 注释为Use this file instead of the $HOME/.ssh/id_dsa.pub file即用指定文件替代默认的$HOME/.ssh/id_dsa.pub。该选项在 lib/easyoptions.c 中被注册为字符串类型CURLOT_STRING。命令行工具与 libcurl 的对接发生在 src/config2setopts.c/* SSH and SSL private key uses same command-line option */ MY_SETOPT_STR(curl, CURLOPT_SSH_PRIVATE_KEYFILE, config-key); MY_SETOPT_STR(curl, CURLOPT_SSH_PUBLIC_KEYFILE, config-pubkey);在 C 程序中对应的用法为#include curl/curl.h int main(void) { CURL *curl curl_easy_init(); if(!curl) return 1; curl_easy_setopt(curl, CURLOPT_URL, sftp://example.com/path/file); curl_easy_setopt(curl, CURLOPT_USERNAME, username); curl_easy_setopt(curl, CURLOPT_SSH_PRIVATE_KEYFILE, /home/user/.ssh/id_ed25519); curl_easy_setopt(curl, CURLOPT_SSH_PUBLIC_KEYFILE, /home/user/.ssh/id_ed25519.pub); curl_easy_perform(curl); curl_easy_cleanup(curl); return 0; }源码级原理公钥认证的底层调用链密钥文件的准备阶段Curl_ssh_setup_pkey()lib/vssh/vssh.c是整个认证准备的核心函数检查ssh_auth_types中是否启用了CURLSSH_AUTH_PUBLICKEY公钥认证方式解析私钥优先使用CURLOPT_SSH_PRIVATE_KEYFILE指定文件否则按上文默认路径探测解析公钥读取CURLOPT_SSH_PUBLIC_KEYFILE即--pubkey的值若为空字符串则视同 NULL交由 SSH 库自动提取设置口令passphrase来自--pass或CURLOPT_KEYPASSWD通过infof()输出调试信息例如SSH: public key file xxx可在-v详细模式下观察到。libssh2 后端的认证调用在 libssh2 后端lib/vssh/libssh2.c认证最终由libssh2_userauth_publickey_fromfile_ex()完成该调用同时传入用户名、公钥文件路径、私钥文件路径与口令rc libssh2_userauth_publickey_fromfile_ex(sshc-ssh_session, user, curlx_uztoui(strlen(user)), sshc-pub_key, sshc-priv_key, sshc-passphrase);其中sshc-pub_key为 NULL 时libssh2 会尝试从私钥中提取公钥——这正是文档所述自动提取机制的落地处。返回LIBSSH2_ERROR_EAGAIN时表示需重试非阻塞场景。libssh 后端的对应实现若 curl 以 libssh 为 SSH 后端认证流程位于 lib/vssh/libssh.c其主机公钥校验部分使用ssh_get_server_publickey()获取服务器公钥再与 known hosts 中的条目比对。测试用例佐证仓库测试数据中可看到--pubkey的实际使用样例这些测试依赖本地 SSH 测试服务器路径中的%LOGDIR、%HOSTIP等为测试框架变量tests/data/test1446SFTP 结合--remote-time同时指定--key与--pubkeytests/data/test1583SFTP 目录与空文件操作两次请求均使用--key/--pubkeytests/data/test1725SCP 主机密钥错误场景配合--hostpubmd5与--pubkey验证失败路径。这些测试证明显式提供公钥文件如curl_client_key.pub与私钥文件配对是 SFTP/SCP 功能回归测试的标准配置方式。使用建议与注意事项优先省略--pubkey在满足 libssh2 1.2.8 OpenSSL 的构建条件下直接省略该选项让 curl 自动提取公钥更省事显式指定的场景公钥与私钥分离存储、公钥位于非标准路径、或使用的 libssh2 不支持自动提取时必须显式传--pubkey文件格式公钥文件应为 OpenSSH 格式如ssh-ed25519 AAAA...、ssh-rsa AAAA...即通常ssh-keygen生成的.pub文件权限问题认证失败时可用-v查看SSH: public key file ...与SSH: private key file ...调试输出确认 curl 实际读取的密钥路径是否正确选项唯一性--pubkey为 single 类型命令行中只能出现一次。【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考