指南 · 命令行界面（CLI）

命令行工具

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

macOS · Linux · Windows开源Go

安装

Homebrew（macOS & Linux）

Shell

$ brew install storageto/tap/storageto

Go

Shell

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

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

预编译二进制文件

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

在 GitHub 上查看 ↗GitHub Releases ↗

用法

单个文件

Shell

$ storageto upload photo.jpg

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

多个文件

传入多个路径或通配符（glob）——它们会自动归组到一个集合中：

Shell

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

大文件

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

Output

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 输出

Shell

$ storageto upload photo.jpg --json
{
  "url": "https://storage.to/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 可完全跳过令牌文件。

提示通过 CLI 匿名上传每天最多 50 个文件,3 天后过期。使用免费账户令牌即可解除限制,使用付费令牌则可永久保存文件。

脚本编写

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

Shell

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

版本与更新

Shell

$ storageto version

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

← 上一页

桌面应用

ShareX