命令行工具

从你的终端上传。一条命令：脚本用 JSON 输出；大文件使用可续传的分片上传。源码在 GitHub。

安装

Homebrew（macOS & Linux）

brew install storageto/tap/storageto

Go

go install github.com/storageto/cli/cmd/storageto@latest

确保 ~/go/bin 在你的 PATH 中。

预编译二进制文件

从 GitHub Releases 下载对应的 tarball（macOS ARM/Intel、Linux ARM/Intel）。

用法

单个文件

storageto upload photo.jpg

URL:     https://storage.to/FQxyz1234
Raw:     https://storage.to/r/FQxyz1234
Size:    2.1 MB
Expires: 2026-04-15T12:00:00Z

多个文件

传入多个路径或一个通配模式（glob）——会自动分组到一个集合中：

storageto upload file1.txt file2.txt file3.txt
storageto upload *.log
storageto upload src/**/*.go

大文件

超过 5 GB 的文件会自动分块，并使用可续传的分片上传并行处理。进度会直接在行内打印：

  1.2 GB / 10.0 GB (12.0%)

按 Ctrl+C 取消——服务器会自动清理未完成的上传。

参数

参数	描述
-c, --collection	即使只有单个文件也强制创建集合。
-v, --verbose	显示详细的进度输出。
--json	输出 JSON 结果（机器可读，非常适合脚本）。
--no-token	完全匿名上传——不要读取或写入身份令牌文件。
--api <url>	覆盖 API 端点（默认是 https://storage.to）。
-h, --help	显示帮助信息。

JSON 输出

storageto upload photo.jpg --json

{
  "url": "https://storage.to/FQxyz1234",
  "raw_url": "https://storage.to/r/FQxyz1234",
  "filename": "photo.jpg",
  "size": 2202009,
  "human_size": "2.1 MB",
  "expires_at": "2026-04-15T12:00:00Z"
}

身份令牌

CLI 会在首次使用时保存一个随机的 访客令牌，因此同一台机器的重复上传会共享配额并归属到同一来源。这不是账号登录——只是一个按机器划分的标识符。

操作系统	路径
macOS	~/Library/Application Support/storageto/token
Linux	~/.config/storageto/token
Windows	%AppData%\storageto\token

传入 --no-token 可完全跳过令牌文件。

脚本编写

将 --json 输出通过管道传给 jq 以提取 URL：

URL=$(storageto upload build.zip --json | jq -r '.url')
echo "Uploaded to $URL"

版本与更新

storageto version

Homebrew 用户：brew upgrade storageto。Go 用户：用最新的标签重新运行 go install。