upload

在浏览器和主机之间传输文件:upload 负责上传,download 负责下载,目录会以临时 TAR 返回。

文件版本 1.2.4稳定别名: download
lil-terminal

概览

upload 把浏览器变成无 SSH 主机上的实用文件通道:可以把一个或多个文件上传到当前目录或指定目录,用 -f 明确允许覆盖,并通过 download 完成反向传输。下载目录时会自动创建临时 TAR,PHP 的上传限制则作为主机环境的真实约束清楚说明,而不会被命令悄悄隐藏。

通过浏览器传输文件

upload 和 download 直接通过浏览器传输;部署时可与归档命令组合,把大量文件作为一个包移动。

语法

lil-terminal
upload [dst] [-f]

参考

upload

选择文件并上传到当前目录

upload <dir>

将文件上传到 <dir>

<dir> -f

将文件上传到 <dir> 并替换同名文件

<file> -f

将单个文件上传到精确路径并替换现有文件

download

归档并下载当前目录

download <file>

下载可读取的文件

download <dir>

自动归档目录并下载临时 TAR 文件

-n <name>

使用其他下载文件名(不重命名源文件)

上传目标

不指定目标时,选择的文件写入当前目录。upload <dir> 会自动创建不存在的目录;使用 -f 才允许替换其中同名文件。upload <file> -f 是按精确路径替换单个文件的明确形式。

目录下载

直接执行 download 会归档当前目录;download <dir> 对其他目录执行同样操作。lil-terminal 会创建临时 TAR、传输给浏览器并在完成后删除。源目录树不会被重命名或修改。

主机限制

一次选择最多 20 个文件。实际大小还受 upload_max_filesize、post_max_size、max_file_uploads、临时空间、Web 服务器、反向代理和控制面板限制。过大的请求可能在到达 PHP 前就被拒绝。

安全性

文件名会被规范化,目标路径使用正常的文件系统解析器检查;除非明确使用 -f,已有文件会被保留。传输令牌很快过期,不会形成可重复使用的公开下载 URL。

交互式 sandbox 预览

可直接在页面中运行预先准备的示例。结果已预先生成并在浏览器中显示;服务器不会执行任何终端命令。

将文件上传到 <dir>

安装与管理

安装当前兼容版本。完整功能请选择 Base,精简包请选择 Minimum;已安装模块的更新请使用 upgrade。

Base 与 Minimum 是同一当前模块版本的两个包。

Base 包

安装包含本地参考和全部已发布模式的完整包。

install upload
Minimum 包

安装精简包。该包不包含本地参考;help <cmd> -i 会打开当前服务器参考。

install upload -m
精确公开版本

安装这个确切的已发布版本。

install upload -v 1.2.4
检查或升级

让 upgrade 检查兼容性,仅在需要时替换已安装块。

upgrade upload
删除模块

删除扩展块,不影响核心和其他模块。

install upload -u

示例

示例可复制,但网站不会执行。请先检查路径、权限和破坏性选项。

将文件上传到 <dir>
cd \sandbox | pwd | upload images
sandbox

picker       opens immediately
destination  sandbox/images
选择文件并上传到当前目录
upload
picker       opens immediately
destination  current directory
Upload · folder
upload tmp -f
picker       opens immediately
destination  sandbox/tmp
replace      same-named files
Upload · exact
upload tmp/replacement.txt -f
tmp/
  replacement.txt
自动归档目录并下载临时 TAR 文件
download images
archive  images-20260809-a1b2.tar
source   sandbox/images
temporary archive removed after streaming

downloadupload 模块提供;两个传输方向共用相同的路径与安全检查。

Upload · directory
download README.txt -n readme-copy.txt
Download started  readme-copy.txt
Source            sandbox/README.txt

downloadupload 模块提供;两个传输方向共用相同的路径与安全检查。

处理不存在的下载目标
download \sandbox\missing.txt
未找到文件或目录

downloadupload 模块提供;两个传输方向共用相同的路径与安全检查。

本示例使用的文件: sandbox/tmp/README.txt

该示例使用受保护的 /sandbox/ 文档工作区中的文件或目录。

lil-terminal sandbox temporary workspace

Commands in the public documentation use this directory for disposable copies,
archives, uploads and files created during examples. Review destructive commands
before running them and restore the sandbox from the release package when needed.

相关文档

当前公开版本

v1.2.42026-08-09

语言同步

完成 upload 的本地帮助与服务器帮助同步,并加强本地化安全性。