filecli

FILE CLI

filecli 是一个基于 Go 语言开发的简易文件传输工具，既可作为文件服务器使用，也可作为客户端进行文件的上传和下载操作。它提供了命令行界面和网页界面两种交互方式，方便用户在不同场景下使用。

功能特点

• 跨平台：python -m http.server已经很好用了，但很遗憾并不是所有机器上都有python，所以写个简单的文件服务，传个文件用
• 多模式运行：支持服务器模式、客户端上传模式和客户端下载模式
• 网页界面：提供简洁的网页上传表单，方便通过浏览器上传文件
• 命令行操作：支持通过命令行进行文件的上传和下载
• 灵活配置：可指定绑定地址、端口、服务目录和 HTTP 协议版本
• 日志记录：记录访问日志，便于追踪文件传输情况

安装

从源码编译

1. 确保已安装 Go 1.16 或更高版本

2. 克隆代码仓库：

   git clone https://github.com/c0mentropy/filecli
   cd filecli
   

3. 编译：

   go build -o filecli
   

   也可查看make help编译

4. 将生成的 filecli 可执行文件添加到系统 PATH 中（可选）

使用方法

服务器模式（默认）

启动文件服务器：filecli [options] [port]

服务器选项

示例

1. 使用默认配置启动服务器（端口 8000，当前目录）：

   filecli
   

2. 在端口 8080 上启动服务器，服务 /data 目录：

   filecli -d /data 8080
   

3. 绑定到本地回环地址，使用 HTTP/1.1 协议：

   filecli -b 127.0.0.1 -p HTTP/1.1 9000
   

启动后，可以通过以下方式访问：

• 文件浏览：http://服务器地址:端口
• 上传表单：http://服务器地址:端口/upload-form

客户端上传模式

通过命令行上传文件到服务器：filecli upload [options]

上传选项

示例

1. 上传本地文件 test.txt 到服务器 192.168.1.100 的 8000 端口：

   filecli upload -s 192.168.1.100 -p 8000 -l test.txt
   

2. 上传本地文件 docs.pdf 到服务器，并指定远程文件名为 document.pdf：

   filecli upload -s example.com -p 8080 -l docs.pdf -r document.pdf
   

客户端下载模式

通过命令行从服务器下载文件：filecli download [options]

下载选项

示例

1. 从服务器 192.168.1.100 下载 data.zip 到本地：

   filecli download -s 192.168.1.100 -p 8000 -r data.zip
   

2. 从服务器下载 report.csv 并保存到本地 ./downloads/report.csv：

   filecli download -s example.com -p 8080 -r report.csv -l ./downloads/report.csv
   

版本信息

filecli --version

filecli version v0.1.1

帮助信息

• 查看整体帮助：

  • filecli --help

• 查看特定子命令的帮助：

  • filecli upload --help

  • filecli download --help

联系方式

• 作者：Ckyan Comentropy
• 邮箱：[email protected]
• GitHub：https://github.com/c0mentropy/filecli

贡献

欢迎贡献代码和报告 Bug！ 欢迎在 GitHub 上提交 Issue 或 Pull Request

许可证

该项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件