命令行工具:用一条指令发文件和文本
从 v1.18.0 起,官方第一次提供了独立的命令行客户端,与图形应用使用同一套协议、同一个 Rust 网络核心。它适合写脚本、远程终端、或者单纯不喜欢鼠标的用户。
装在哪、怎么调
CLI 随官方发布渠道分发(发布页有对应平台的可执行文件),装好后命令名是 localsend-cli。查看全部选项与快捷键:
localsend-cli --help
注意:CLI 是独立程序,与手机上的图形版是两个东西;它不需要图形界面参与,适合挂在服务器或无桌面的环境里。
发文件与目录
基本用法,参数可以是文件、目录或二者的混合:
localsend-cli send report.pdf photo.jpg ./project-backup
运行后出现发现的设备列表,交互式选择目标,回车开始传输。目录按递归收集,目录层级在接收端保留;空目录不会发送(协议按文件条目组织),原因见整个文件夹怎么传。
免交互指定目标
脚本场景里不想停在设备选择,用目标参数直接指定:
localsend-cli send --to "Cute Tomato" report.pdf
localsend-cli send --to 192.168.27.26 report.pdf
两种写法的规则:设备别名必须能唯一锁定一台已发现的设备;IP 地址则直接向该地址的默认端口 53317 发起 HTTPS 探测,绕过发现流程——正是手动输入 IP 直连的命令行版。
发文本
localsend-cli send --to "Cute Tomato" --text "要发的内容"
管道输入也支持,命令输出直接发出去:
echo "Hello" | localsend-cli send --to "Cute Tomato" --text -
文本规则:超过 64KB 自动转成 txt 文件发送;标准输入要求 UTF-8 编码、上限 16MB,更大的数据请按文件发。
实用场景
- 备份脚本跑完,把日志文件顺手推到自己的电脑上。
- 服务器上没有图形界面,把导出的报表发到手机。
- 结合任务计划(cron、任务计划程序),定时把目录快照发到固定设备——目标用 IP 直达,全程无人值守。