通用配置

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

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

$ export LANG=en_US.UTF-8

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

配置AK/SK、Region、Host信息

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

$ bce -c  [<conf-path>]
$ BOS Access Key ID [None]: Enter Your AK
$ BOS Secret Access Key [None]: Enter Your SK
$ BCE Security Token [None]: Enter Your Security Token
$ Default region name [bj]: Enter Your region
$ Default domain [bj.bcebos.com]: Enter Your 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表示关闭此功能。

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

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

设置断点续传有效期

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

$ bce -c [<conf-path>]
$ Default breakpoint_file_expiration [7] days: Enter the period of keep breakpoint file

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

设置HTTPS协议上传

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

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

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

设置分块并行上传线程数

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

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

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