dbxcli:一个为 Dropbox 用户和团队管理员提供的命令行工具
特性
- 支持基本的文件操作,如 ls、cp、mkdir、mv(通过 Files API)。
- 支持搜索
- 支持文件修改和文件恢复
- 大文件的分块上传,大目录的分页列表。
- 支持不断增长的团队业务
安装
从 发布 页面下载 Mac、Windows 和 Linux 的预编译二进制文件。
Mac OSX 安装预编译的二进制文件
这些说明旨在帮助专家和新手用户。如果这些说明对你不起作用,请提交问题。
- 确保你下载了二进制文件,并将其放在你的 $PATH 上的文件夹中。如果您不确定这意味着什么,请转到第2步。否则,请跳到第3步
- 在你的主目录下创建一个bin目录。
$ mkdir ~/bin
$ cd ~/bin
- 在 ~/.bash_profile 文件的末尾添加以下一行。关于如何找到这个文件的说明链接
export PATH=$PATH:$HOME/bin
- 下载适用于 OSX 的 dbxcli 二进制文件并重新命名。重要:请检查以下 URL 上的标签 v2.1.1 是否为 发布 页面上的最新版本标签。
$ wget https://github.com/dropbox/dbxcli/releases/download/v2.1.1/dbxcli-darwin-amd64 $ mv dbxcli-darwin-amd64 dbxcli
- 最后,把二进制文件做成可执行文件,就可以了。
$ chmod +x dbxcli
自行构建说明
对于新手来说,go 的构建过程可能有点玄乎,可以按照这些步骤自己构建 dbxcli。
- 确保安装了 git、go 和 gox。
- 创建一个 Go 文件夹。例如,mkdir $HOME/go 或 mkdir $HOME/.go。导航到它。
- go get github.com/dropbox/dbxcli。没错,你不需要手动克隆它,这就帮你完成了。
- cd ~/go/src/github.com/dropbox/dbxcli(根据第2步进行相应调整)。
现在我们需要暂停一下,获取开发密钥。
- 前往 https://www.dropbox.com/developers/apps(必要时登录),选择 "创建应用"。使用 Dropbox API,并给它完整的 Dropbox 访问权限。命名并创建应用程序。
- 你会看到一个仪表板,上面有一个 "App Key" 和一个 "App secret"。
- 用网页上的密钥替换 root.go 中 personalAppKey 的值。
- 用网页上的秘密替换 personalAppSecret 的值。
最后,我们准备好构建了。运行 go build,你会看到一个 dbxcli 二进制文件已经在当前目录下创建。恭喜你,我们完成了
使用方法
dbxcli 在很大程度上是自文档化的。运行 dbxcli -h 查看支持的命令列表。
$ dbxcli --help Use dbxcli to quickly interact with your Dropbox, upload/download files, manage your team and more. It is easy, scriptable and works on all platforms! Usage: dbxcli [command] Available Commands: cp Copy files du Display usage information get Download a file ls List files mkdir Create a new directory mv Move files put Upload files restore Restore files revs List file revisions rm Remove files search Search team Team management commands version Print version information Flags: --as-member string Member ID to perform action as -v, --verbose Enable verbose logging Use "dbxcli [command] --help" for more information about a command. $ dbxcli team --help Team management commands Usage: dbxcli team [command] Available Commands: add-member Add a new member to a team info Get team information list-groups List groups list-members List team members remove-member Remove member from a team Global Flags: --as-member string Member ID to perform action as -v, --verbose Enable verbose logging Use "dbxcli team [command] --help" for more information about a command.
--verbose选项将开启详细的日志记录,对调试很有用。
我们需要您的帮助
dbxcli 正在积极开发中。正如您从 API 文档 中看到的那样,我们目前只支持少量的功能,而且只是对可能的功能进行了简单的介绍。我们希望您,我们的用户,能够提供反馈,以指导我们下一步的开发和如何改进这个工具。
所以,请提交功能请求,报告错误,或者更好的是,给我们发送拉取请求。下面是更多关于贡献的内容。
贡献
- 第1步:如果你要提交非实质性的修改,请先填写 Dropbox 贡献者许可协议。
- 第二步:发送一个拉取请求
- 第三步:获益!
有用的资源