27 lines
942 B
Markdown
27 lines
942 B
Markdown
# file
|
|
|
|
被控端文件管理 HTTP 能力（自 remote-backend-server internal/handlers/file 移植，
|
|
去 DB 依赖）：目录浏览、改名、删除、上传、下载（断点支持）、目录创建。
|
|
|
|
## 路由
|
|
|
|
```go
|
|
import "git.zeroonesoft.cn/golib/remote-core/file"
|
|
|
|
file.RegisterRoutersGatewayFile(r *gin.RouterGroup)
|
|
```
|
|
|
|
| 方法 | 路径 | 说明 |
|
|
|---|---|---|
|
|
| GET/POST | `/file/list` | 目录列表（POST 收 JSON `{path}`，避免路径含 `#` 等字符被 query 截断） |
|
|
| PUT | `/file/name` | 重命名 |
|
|
| DELETE | `/file` | 删除文件/目录 |
|
|
| GET/HEAD | `/file/download` | 下载（HEAD 取大小，GET 支持 Range 续传） |
|
|
| POST | `/file/upload` | 上传 |
|
|
| POST | `/file/dir` | 创建目录 |
|
|
|
|
## 注意
|
|
|
|
- 与 shell/process 同为被控 HTTP 能力，经 zonat 隧道 + web-gateway 反代出网。
|
|
- 路径参数来自控制端，接入公网前务必在网关侧做鉴权与路径白名单校验。
|