qsftpd
qsftpd 是对象存储提供的 FTP Server。用户通过简单的配置,即可通过 FTP 协议使用对象存储服务。该工具已在 GitHub 开源,更多详情可参见 https://github.com/qingstor/qsftpd
安装
qsftpd 支持 Linux、macOS 和 Windows 操作系统。用户可访问 GitHub 项目的 Releases 页面查看和下载相应版本。
配置
在正式使用 qsftpd 工具之前,需要创建并填写配置文件 qsftpd.yaml
。详细操作步骤如下:
-
在终端执行如下命令,创建配置文件:
touch qsftpd.yaml
-
配置文件内容如下:
qingstor: access_key_id: access_key_id_example secret_access_key: secret_access_key_example host: qsstor.com port: 443 protocol: https log_level: warn bucket_name: bucket_name_example zone: pek3a listen_host: 127.0.0.1 listen_port: 21 public_host: 127.0.0.1 max_connections: 128 start_port: 6000 end_port: 7000 log_level: error cache_path: /var/cache/qsftpd # 认证设置,默认允许匿名用户登录,也可以指定特定的用户登录 #users: # username_example: password_example
参数说明:
-
qingstor
用于标识后续字段为对象存储的基本信息。 -
access_key_id
与secret_access_key
用于访问对象存储的 AK 与 SK,须根据实际情况进行填写。具体可参照 [获取 Access Key](/storage/object-storage/api/practices/signature/#获取-access-key)。 -
host
对象存储的域名。公有云环境无需修改。 -
port
访问对象存储的端口号。公有云环境无需修改。 -
protocol
访问对象存储的协议。公有云环境无需修改。 -
log_level
对象存储的日志级别。日志内容显示从多到少依次可设置为:debug,info,warn,error,fatal,panic。 -
bucket_name
待访问的对象存储的 Bucket 名。须根据实际情况进行填写。 -
zone
待访问的对象存储的 Zone。 -
listen_host listen_port public_host max_connections
FTP Server 配置,监听的端口号以及最大连接数。 -
start_port end_port
FTP 数据连接建立方式为被动模式时,将会随机在start_port
与end_port
之间选择端口号进行数据传输。默认值是从 6000 至 7000。 -
log_level
FTP Server 的日志等级。日志内容显示从多到少依次可设置为:debug,info,warn,error,fatal,panic。 -
cache_path
缓存路径,qsftpd 将会在每次启动时清除cache_path
配置的目录。 -
users
认证设置,默认允许匿名用户登录,也可以指定的用户登录。若指定用户,须根据配置上文中的示例进行填写用户信息。 -
除
access_key_id,secret_access_key,bucket_name,zone
以外,其余字段均有默认值,用户可无需修改。 -
qsftpd 的配置文件可根据需要进行配置。模板可以 查看。
-
使用说明
帮助信息
用户可执行如下命令行,查看帮助信息:
$ qsftpd -h
A FTP server that persists all data to QingStor Object Storage.
Usage:
qsftpd [flags]
Flags:
-c, --config string Specify config file (default "qsftpd.yaml")
-h, --help help for qsftpd
-v, --version Show version
选项列表
根据前文可知,qsftpd 支持的常规命令选项如下所示:
参数简写 | 参数全名 | 类型 | 是否必须 | 说明 |
---|---|---|---|---|
-c |
--config |
string |
否 |
指定配置文件的路径,默认为 |
-h |
--help |
string |
否 |
输出帮助信息 |
-v |
--version |
string |
否 |
输出版本信息 |
使用示例
-
创建配置文件,如
qsftpd.yaml
,按照前文的配置文件说明进行配置。 -
执行如下命令,启动 FTP Server,终端显示如下打印,即,说明服务端准备就绪:
# qsftpd -c path/to/your/qsftpd.yaml [2017-04-12T03:24:40.541Z #2527] INFO -- : Listening... 127.0.0.1:21 [2017-04-12T03:24:40.541Z #2527] INFO -- : Starting... [2017-04-12T03:24:49.330Z #2527] INFO -- : FTP Client connected: ftp.connected, id: 76e209d6a89448279e947a7babe0097d, RemoteAddr: 127.0.0.1:51788, Total: 1
-
在客户端,执行如下命令行,通过 FTP 客户端连接 FTP Server 进行测试:
# ftp -a 127.0.0.1 Connected to 127.0.0.1. 220 Welcome to QSFTP Server 331 User name okay, need password. 230 Password ok, continue Remote system type is UNIX. Using binary mode to transfer files. ftp>
-
客户端成功链接后,FTP 服务端显示如下打印:
[2017-04-12T03:24:49.330Z #2527] INFO -- : FTP Client connected: ftp.connected, id: 76e209d6a89448279e947a7babe0097d, RemoteAddr: 127.0.0.1:51788, Total: 1
-
在客户端执行如下命令行,查看文件列表:
ftp> ls 229 Entering Extended Passive Mode (|||6081|) 150 Using transfer connection d------ 1 ftp ftp 0 Nov 30 00:00 test-output 226 Closing transfer connection
-
在客户端执行如下命令行,上传文件:
ftp> put AUTHORS local: AUTHORS remote: AUTHORS 229 Entering Extended Passive Mode (|||6887|) 150 Using transfer connection 100% |***********************************| 146 91.68 KiB/s 00:00 ETA 226 Closing transfer connection 146 bytes sent in 00:00 (2.19 KiB/s) ftp>