Dropbox Uploader 技术文档

Dropbox Uploader 是一个基于 BASH 脚本的工具，用于上传、下载、删除、列出文件等操作，支持 Dropbox 在线文件共享、同步和备份服务。本文档将详细介绍如何安装和使用该工具，以及项目 API 的使用方法。

1. 安装指南

首先，使用 git 克隆仓库：

git clone https://github.com/andreafabrizi/Dropbox-Uploader.git

或者使用 curl 命令手动下载脚本：

curl "https://raw.githubusercontent.com/andreafabrizi/Dropbox-Uploader/master/dropbox_uploader.sh" -o dropbox_uploader.sh

然后为脚本文件添加执行权限并运行：

chmod +x dropbox_uploader.sh
./dropbox_uploader.sh

首次运行脚本时，会引导用户配置 Dropbox 访问权限。配置信息将存储在 ~/.dropbox_uploader 目录下。

2. 项目使用说明

Dropbox Uploader 的命令行语法较为简单：

./dropbox_uploader.sh [PARAMETERS] COMMAND...

以下是可用的命令：

• upload <LOCAL_FILE/DIR ...> <REMOTE_FILE/DIR>：上传本地文件或目录到 Dropbox 远程文件夹。
• download <REMOTE_FILE/DIR> [LOCAL_FILE/DIR]：从 Dropbox 下载文件或目录到本地文件夹。
• delete <REMOTE_FILE/DIR>：从 Dropbox 删除文件或目录。
• move <REMOTE_FILE/DIR> <REMOTE_FILE/DIR>：移动或重命名 Dropbox 上的文件或目录。
• copy <REMOTE_FILE/DIR> <REMOTE_FILE/DIR>：复制 Dropbox 上的文件或目录。
• mkdir <REMOTE_DIR>：在 Dropbox 上创建远程目录。
• list [REMOTE_DIR]：列出 Dropbox 远程文件夹的内容。
• monitor [REMOTE_DIR] [TIMEOUT]：监控 Dropbox 远程文件夹的变化。
• share <REMOTE_FILE>：获取指定文件或目录的公开分享链接。
• saveurl <URL> <REMOTE_DIR>：直接从 URL 下载文件到 Dropbox 文件夹（文件不会先下载到本地）。
• search <QUERY>：在 Dropbox 上搜索特定模式的文件或目录。
• info：打印 Dropbox 账户的一些信息。
• space：打印 Dropbox 账户的存储空间使用信息。
• unlink：将脚本从 Dropbox 账户中解联。

3. 项目 API 使用文档

Dropbox Uploader 使用官方 Dropbox API v2 进行认证和文件操作。具体的使用方法请参考上面的命令行使用说明。

4. 项目安装方式

除了使用 git 和 curl 的方式安装外，还可以通过以下方式进行安装：

• 在 Debian 和 Ubuntu Linux 上安装 BASH 和 cURL：

sudo apt-get install bash
sudo apt-get install curl

• 在 BSD 上安装 BASH 和 cURL：

cd /usr/ports/shells/bash && make install clean
cd /usr/ports/ftp/curl && make install clean

• 在 Cygwin 上安装必要的包：

curl
ca-certificates
dos2unix

在运行脚本前，使用 dos2unix 命令转换脚本文件。

结束语

本文档介绍了 Dropbox Uploader 的安装方法、使用说明以及 API 使用方法。通过这些信息，用户可以更好地了解和使用这个强大的工具。