# 下载

{% code fullWidth="true" %}

```
```

{% endcode %}

\`\`\` NAME: singularity download - 从元数据 API 下载 CAR 文件

用法: singularity download \[command options] \<piece\_cid>

类别: 实用工具

选项: 1Fichier

\--fichier-api-key value 您的 API 密钥，从 <https://1fichier.com/console/params.pl> 获取。 \[$FICHIER\_API\_KEY] --fichier-encoding value 后端的编码。 (默认值: "Slash,LtGt,DoubleQuote,SingleQuote,BackQuote,Dollar,BackSlash,Del,Ctl,LeftSpace,RightSpace,InvalidUtf8,Dot") \[$FICHIER\_ENCODING] --fichier-file-password value 如果要下载受密码保护的共享文件，请添加此参数。 \[$FICHIER\_FILE\_PASSWORD] --fichier-folder-password value 如果要列出受密码保护的共享文件夹中的文件，请添加此参数。 \[$FICHIER\_FOLDER\_PASSWORD] --fichier-shared-folder value 如果要下载共享文件夹，请添加此参数。 \[$FICHIER\_SHARED\_FOLDER]

Akamai NetStorage

\--netstorage-account value 设置 NetStorage 帐户名 \[$NETSTORAGE\_ACCOUNT] --netstorage-host value 要连接到的 NetStorage 主机的域名+路径。 \[$NETSTORAGE\_HOST] --netstorage-protocol value 选择 HTTP 或 HTTPS 协议。 (默认值: "https") \[$NETSTORAGE\_PROTOCOL] --netstorage-secret value 设置 NetStorage 帐户密码/G2O 密钥用于身份验证。 \[$NETSTORAGE\_SECRET]

Amazon Drive

\--acd-auth-url value Auth 服务器 URL。 \[$ACD\_AUTH\_URL] --acd-checkpoint value 用于内部轮询的检查点 (用于调试)。 \[$ACD\_CHECKPOINT] --acd-client-id value OAuth 客户端 ID。 \[$ACD\_CLIENT\_ID] --acd-client-secret value OAuth 客户端密码。 \[$ACD\_CLIENT\_SECRET] --acd-encoding value 后端的编码。 (默认值: "Slash,InvalidUtf8,Dot") \[$ACD\_ENCODING] --acd-templink-threshold value 大于等于此大小的文件将通过临时链接下载。 (默认值: "9Gi") \[$ACD\_TEMPLINK\_THRESHOLD] --acd-token value OAuth 访问令牌作为 JSON 字符串。 \[$ACD\_TOKEN] --acd-token-url value 令牌服务器的 URL。 \[$ACD\_TOKEN\_URL] --acd-upload-wait-per-gb value 完整上传失败后，在等待 GiB 时的附加时间。 (默认值: "3m0s") \[$ACD\_UPLOAD\_WAIT\_PER\_GB]

符合 Amazon S3 储存提供商，包括 AWS、阿里巴巴、Ceph、中国移动、Cloudflare、ArvanCloud、DigitalOcean、Dreamhost、华为 OBS、IBM COS、IDrive e2、IONOS Cloud、Liara、Lyve Cloud、Minio、Netease、RackCorp、Scaleway、SeaweedFS、StackPath、Storj、腾讯云 COS、七牛云和 Wasabi

\--s3-access-key-id value AWS 访问密钥 ID。 \[$S3\_ACCESS\_KEY\_ID] --s3-acl value 创建存储桶和存储或复制对象时使用的访问控制列表。 \[$S3\_ACL] --s3-bucket-acl value 创建存储桶时使用的访问控制列表。 \[$S3\_BUCKET\_ACL] --s3-chunk-size value 用于上传的分块大小。 (默认值: "5Mi") \[$S3\_CHUNK\_SIZE] --s3-copy-cutoff value 切换到分块复制的阈值。 (默认值: "4.656Gi") \[$S3\_COPY\_CUTOFF] --s3-decompress 如果设置则解压缩使用 gzip 编码的对象。 (默认值: false) \[$S3\_DECOMPRESS] --s3-disable-checksum 不要将 MD5 校验和与对象元数据一起存储。 (默认值: false) \[$S3\_DISABLE\_CHECKSUM] --s3-disable-http2 禁用 S3 后端的 http2。 (默认值: false) \[$S3\_DISABLE\_HTTP2] --s3-download-url value 自定义下载的终端节点。 \[$S3\_DOWNLOAD\_URL] --s3-encoding value 后端的编码。 (默认值: "Slash,InvalidUtf8,Dot") \[$S3\_ENCODING] --s3-endpoint value S3 API 的终端节点。 \[$S3\_ENDPOINT] --s3-env-auth 从运行时获取 AWS 凭据 (环境变量或 EC2/ECS 元数据，如果没有 env vars)。 (默认值: false) \[$S3\_ENV\_AUTH] --s3-force-path-style 如果为 true，则使用路径样式访问，否则使用虚拟主机样式访问。 (默认


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://data-programs.gitbook.io/singularity/zh/cli-reference/download.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.