curl 是一个强大的命令行工具，用于通过各种协议与网络进行交互。本文将详细介绍使用 curl 上传文件的相关选项。
1. 基础文件上传：使用 POST 方法
最基本的文件上传方式是使用 POST 请求通过表单提交文件。curl 使用 -F 选项来发送文件，这相当于模拟表单提交。
示例 1：上传单个文件
假设我们有一个文件 example.txt，并且目标服务器的上传接口为 http://example.com/upload，我们可以使用以下命令上传文件：
curl -X POST -F "file=@/path/to/example.txt" http://example.com/upload解释：
-X POST: 指定 HTTP 请求方法为POST。-F "file=@/path/to/example.txt": 使用-F选项来模拟表单数据，并上传文件。file是表单字段的名称，@符号后面是文件的路径。这里的file会被视为表单的一个字段，example.txt将作为文件上传。http://example.com/upload: 上传目标的 URL。
2. 上传多个文件
如果你需要一次上传多个文件，可以使用多个 -F 选项来发送多个文件。
示例 2：上传多个文件
curl -X POST -F "file1=@/path/to/file1.txt" -F "file2=@/path/to/file2.jpg" http://example.com/upload这里，我们上传了两个文件 file1.txt 和 file2.jpg，每个文件作为不同的表单字段 file1 和 file2 上传。
3. 上传文件并附加其他表单数据
除了文件，通常你还需要附加其他表单数据，比如用户名、邮箱等。使用 -F 选项，你可以轻松地同时上传文件和其他表单字段数据。
示例 3：上传文件并附加表单数据
curl -X POST -F "username=johndoe" -F "email=johndoe@example.com" -F "file=@/path/to/file.txt" http://example.com/upload这将上传文件 file.txt 并同时附加 username 和 email 字段。
4. 通过 PUT 方法上传文件
除了 POST 请求，文件也可以通过 PUT 请求上传。PUT 请求通常用于更新资源或者替代资源。使用 -T 选项来上传文件，curl 会自动使用 PUT 方法。
示例 4：使用 PUT 方法上传文件
curl -X PUT -T /path/to/example.txt http://example.com/upload解释：
-T /path/to/example.txt: 使用-T选项来指定要上传的文件，这会自动触发PUT请求。http://example.com/upload: 目标 URL，用于接收文件的服务器端点。
5. 上传文件时设置请求头
在某些情况下，你可能需要自定义请求头，特别是当上传的文件需要特定的内容类型或认证时。使用 -H 选项，你可以在请求中添加自定义的 HTTP 头部。
示例 5：设置 Content-Type 和认证头部
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer your-token" -F "file=@/path/to/example.txt" http://example.com/upload解释：
-H "Content-Type: application/json": 设置Content-Type请求头为application/json，通常用于发送 JSON 数据。-H "Authorization: Bearer your-token": 设置Authorization请求头，用于带上 API 令牌进行身份验证。-F "file=@/path/to/example.txt": 上传文件example.txt。
6. 上传文件并保存响应
上传文件后，服务器可能会返回一些响应数据，例如上传成功的信息或文件的下载 URL。如果你希望将响应数据保存到文件中，可以使用 -o 选项来指定输出文件名。
示例 6：保存服务器响应
curl -X POST -F "file=@/path/to/example.txt" http://example.com/upload -o response.txt这会将服务器的响应数据保存到 response.txt 文件中。
7. 上传文件并通过认证上传
许多文件上传接口需要用户进行认证才能进行操作。如果你需要通过 Basic Authentication 或其他方式进行认证，可以使用 -u 选项。
示例 7：使用 Basic Authentication 上传文件
curl -u username:password -X POST -F "file=@/path/to/example.txt" http://example.com/upload解释：
-u username:password: 使用基本认证，username和password用于身份验证。- 其他部分与前面一样，用来上传文件。
8. 通过 Unix 套接字上传文件
如果你使用的是本地服务并且需要通过 Unix 套接字进行通信，而不是通过 HTTP 协议，可以使用 --unix-socket 选项。
示例 8：通过 Unix 套接字上传文件
curl -X POST -F "file=@/path/to/example.txt" --unix-socket /var/run/unit/control.sock http://localhost/upload解释：
--unix-socket /var/run/unit/control.sock: 指定 Unix 套接字文件路径。http://localhost/upload: 目标 URL，可以使用localhost访问服务。
9. 常见问题解决
9.1 未设置 Content-Type
如果你上传的是 JSON 数据或其他特殊格式的数据，但没有显式设置 Content-Type，服务器可能无法正确解析数据。因此，上传 JSON 时，记得设置 Content-Type: application/json。
9.2 文件权限问题
上传文件时，确保文件有适当的读取权限。如果 curl 无法访问文件，它将无法上传。检查文件权限并确保文件对当前用户可读。
9.3 大文件上传
如果你上传的是大文件，可以使用 --limit-rate 来限制上传速度，以防止上传过程占用过多带宽：
curl -X POST -F "file=@/path/to/largefile.zip" --limit-rate 1M http://example.com/upload这会将上传速度限制为每秒 1MB。
总结
curl 是上传文件的强大工具，支持多种协议和方法，适用于各种文件上传场景。从基本的 POST 上传，到复杂的多文件上传、文件和数据混合上传，再到通过认证上传，curl 提供了丰富的选项来满足不同的需求。掌握这些基本用法后，你可以灵活地根据不同场景使用 curl 来完成文件上传任务。
原文 https://blog.csdn.net/2301_79518550/article/details/145651963