通用配置

配置支持中文显示的 CLI 环境

如需要配置支持中文显示的 CLI 环境，请执行如下命令配置：

1export LANG=en_US.UTF-8

说明： 可先执行 locale 命令查看当前环境的语言支持情况，若不是 LANG=en_US.UTF-8，可执行上述命令进行修改。

该命令仅对当前 Shell 会话生效。如需持久生效，可将配置写入用户 Shell 配置文件。若当前环境设置了 LC_ALL，其优先级高于 LANG，各 LC_* 分类可能仍显示为 LC_ALL 的值。

配置 AK/SK、Region、Host 信息

使用 BOS CLI 工具之前，推荐先设置 Access Key、Secret Access Key、Region 和 Host。可以通过 -c 或 --configure 设置 AK、SK、Region 和 Host 信息。

1$ bce -c [<conf-path>]
2BOS Access Key ID [None]: <your-access-key-id>
3BOS Secret Access Key [None]: <your-secret-access-key>
4BCE Security Token [None]: <your-security-token>
5Default region name [bj]: <region>
6Default domain [bj.bcebos.com]: <host>

说明：

• <conf-path> 为本地文件目录，当用户有多个百度智能云账户时，通过指定 <conf-path> 将不同账号的配置文件写到不同目录下，执行命令时可以指定目录选择对应账户的配置。
• 不指定 <conf-path> 时，CLI 在配置完成后将配置文件自动写到当前用户主目录 ~/.bce；指定 <conf-path> 时，将配置文件自动写到指定目录。
• 即使不设置 AK/SK，您也可以通过 BOS CLI 访问 public 权限的 bucket。
• 当且仅当 您使用 临时授权访问 提供的 AK/SK 访问 BOS 时，才需要您提供 Security Token。
• 指定 Region 之后您可以不指定 Host，BOS CLI 可自动拼接 Host 为 Region.bcebos.com。
• 如果您指定了 Host，那么 BOS CLI 不再自动拼接 Host，而是访问您指定的 Host。
• 可以填写 None 将 AK/SK、Region 以及 Domain 设置为空。当 Region 设置为空时默认值为 bj；当 Domain 设置为空时默认使用 Region 拼接，当两个同时为空时默认访问 bj.bcebos.com。

注意：

• 如果您使用的 AK/SK 是直接从百度智能云控制台的安全认证中获取的，请将 Security Token 设置为空或者 none。

BOS 相关配置

bce -c 命令除了可以进行通用设置，还支持设置自动切换域名，另还支持设置 BOS 上传的相关属性，如断点续传有效期、是否使用 HTTPS 协议及分块上传的多线程数。

设置自动切换域名

BOS 拥有多个 Region，如果您需要在不同 Region 下面进行操作，CLI 的“自动切换域名”功能可以根据您当前操作的 Bucket 所在 Region，来自动切换域名。为了方便您的使用，CLI 会默认开启此功能。

如果您想让您所有的操作请求都发送到您指定的域名或者 Host（通过 bce -c 配置的 domain），您可以通过 bce -c 命令关闭“自动切换域名”功能，设置为 no 表示关闭此功能。

1$ bce -c [<conf-path>]
2Default use auto switch domain [yes]: no

说明： 取值可以是 yes 和 no，yes 代表开启根据 Bucket 所在 Region 自动切换域名，no 表示关闭。缺省情况下为开启。

设置断点续传有效期

CLI 支持文件上传的断点续传。当某次上传因为意外中断，您可以重新执行命令，继续上一次的上传。断点续传功能需要设置有效期，有效期是指在该时间内，如出现中断，重新上传时可续传断点之后的部分；如超过该有效期，则会开始一次新的上传。

1$ bce -c [<conf-path>]
2Default breakpoint_file_expiration [7] days: <expiration-days>

说明： 续传有效期应设置为大于等于 0 的整数，设为为“-1”表示永久保留。缺省续传有效期为 7 天。

设置 HTTPS 协议上传

为了保证用户数据的安全性，建议用户 使用 HTTPS 协议上传。是否使用 HTTPS 可以通过 bce -c 命令进行设置，设置为 no 代表使用 HTTP 协议上传。

1$ bce -c [<conf-path>]
2Default use https protocol [no]: yes

说明： 取值可以是 yes 和 no，缺省情况下使用 HTTP 协议上传。

设置分块并行上传线程数

大文件分块上传时，可以通过 bce -c 命令设置并行上传的线程数。

1$ bce -c [<conf-path>]
2Default multi upload thread num [10]: <thread-num>

说明： 并行上传的线程数应设置为大于等于 1 的整数，缺省为 10。