---
title: "简单文件服务"
method: POST
path: "/common/file-server"
tags: ["common"]
---

# 简单文件服务

`POST /common/file-server`

通过 http 暴露指定目录可用于下载，可用于在重建备库时，从其它机器下载备份
在 OS 不允许 ssh 登录（scp/sftp）时，可以临时启动该服务来获取备份文件

## Request body

- DbmServicesMysqlDbToolsDbactuatorPkgComponentsFileserverFileServerComp
  - `extend` DbmServicesMysqlDbToolsDbactuatorPkgComponentsFileserverFileServer
    - `acls` string[] — 访问来源限制，从前往后匹配。格式 `["allow 1.1.1.1/32", "deny all"]`
    - `auth_pass` string — http basic auth pass，为空时会随机生成密码
    - `auth_user` string, required — http basic auth user
    - `bind_address` string, required — http file-server 监听地址. 不提供端口，会在 12000-19999 之间随机选择一个端口，不提供 ip 时默认 localhost
    - `enable_tls` boolean — 暂不支持
    - `max_connections` integer — 限制最大连接数，超过需要等待. 为 0 时表示不限制
    - `mount_path` string, required — 将本地哪个目录通过 http 分享
    - `path_prefix` string — path_prefix 用在生成 url 时的路径前缀. 可留空
    - `print_download` boolean — 输出 download http 的信息，方便使用
    - `proc_maxidle_duration` string — 超过最大空闲时间，自动退出. 示例 3600s, 60m, 1h

---

[API](https://skmtc.net/tencentblueking/apis/dbactuator-api.md) · [All operations](https://skmtc.net/tencentblueking/apis/dbactuator-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tencentblueking/dbactuator-api/revisions/dc22dd49fd50/schema)