tosstome 命令行工具

最近核对 2026-10-28

一次性传输用浏览器页面就够了。命令行工具增加了收件箱：一台随时准备接收的电脑，带有一个固定链接，你的手机或任何其他设备都可以往里发送。它可以在装有 Node.js 22 或更高版本的 Linux、macOS 和 Windows 上运行。

tosstome listen

tosstome listen [--dir DIR] [--new] [--nearby] [--json] [--server URL]

让这台电脑的收件箱保持开启，并把收到的文件保存到 DIR（默认为 ./tosstome-inbox）。它会输出收件箱链接和二维码。文本消息会显示在终端里，同时也保存为 .txt 文件。传输会先尝试 WebRTC 直连，所以同一网络中的手机会通过该网络发送，失败后再回退到中继；每次收到的传输都会显示用了哪一种。

选项	作用
`--dir DIR`	接收文件的文件夹
`--new`	更换收件箱密钥，让旧链接失效
`--nearby`	同时出现在同一网络中浏览器的附近设备列表里；这些文件会放进 `DIR/nearby`
`--json`	每行输出一个 JSON 事件，而不是便于阅读的输出
`--server URL`	使用自托管的服务器，而不是 toss2.me

tosstome url

tosstome url

输出这台电脑的收件箱链接，但不启动收件箱。

tosstome send

tosstome send [FILE...] [--text TEXT] --to LINK

向某个收件箱链接发送文件、文本消息，或两者一起发送。--text - 表示从标准输入读取消息。在 shell 中请给链接加上引号，因为其中包含 #。

tosstome mcp

tosstome mcp [--dir DIR] [--server URL] [--nearby]

作为 MCP 服务器通过 stdio 运行，这样 Claude Code 或 Cursor 之类的编程智能体就能接收你手机发来的文件和文本，也能发回给手机。收件箱会在智能体第一次使用时启动。参见向 AI 智能体发送文件。

密钥保存在哪里

收件箱密钥保存在 ~/.config/tosstome/inbox.json 中。发送密钥是链接的一部分；代理密钥不会离开这个文件。服务器只保存两者的哈希值。

一些用法

把手机上的照片直接传进照片管理软件监视的文件夹。
把手机上的扫描件和收据传进无纸化办公或文档归档的文件夹。
用 tosstome mcp 把手机上的截图直接发给你的编程智能体。
用 tosstome send 把 CI 任务的构建产物发到测试机器。
长任务结束时给另一台电脑发一条通知：make; tosstome send --text "build done" --to "INBOX_LINK"。
用 --nearby 让树莓派接收家里所有人发来的文件。参见手机到服务器。

常见问题

能在 Windows 上运行吗？

可以。它是一个 Node.js 程序，在任何能运行 Node.js 22 或更高版本的地方都能运行，包括 Windows、macOS 和 Linux。

可以自己托管服务器吗？

可以。服务器是开源的，可以运行在 Cloudflare Workers 上，也可以用同样的代码打包成 Docker 镜像运行。用 --server 让命令行工具指向它。

收到的文件会覆盖已有文件吗？

文件在到达期间以 .part 的形式写入，完成后再重命名。发送方提供的文件名会被简化为目标文件夹内的纯文件名，所以发送方无法写到文件夹之外。