The documentation was written on 23 May 2022.
此版本为 OneTiny 基础版,仅保留指定共享路径、端口号、是否允许上传三个选项,不带配置文件、登陆等功能。可保障最基础的文件传输功能。
若需要使用配置、登录、图形界面等,请前往 CUI 版 和 GUI 版 进行下载。
OneTiny 是一个用于局域网内共享文件的微型程序,它能将当前工作目录临时共享目录,对局域网内其他主机共享,通过浏览器访问 http://局域网IP:9090
来访问和下载共享目录中的文件。
简而言之与命令 python -m http.server 9090
做的是同样的事情。
我有两台设备,一台装着 Linux 系统,一台装着 Windows 系统,偶尔需要互相传输文件。
在 Linux 上我可以在任意一个目录下使用命令 python -m http.server 9090
,从而在 Windows 上或局域网内其他主机上通过浏览器访问 http://局域网IP:9090
查看所有文件,也可以下载;
但是这条命令在 Windows 上不可行,所以需要编写一个程序可以运行在 Windows 上实现同样的功能。
- 核心功能:gin
- CLI管理:urfave/cli
可从本仓库的 Release 中下载对应版本。已提供 Linux 版、Windows 版,Mac 版,其他系统的同学请下载后自行编译。
Linux、Mac:
$ curl -LJ https://github.com/TCP404/OneTiny/releases/download/v0.3.0/OneTiny -o onetiny
$ chmod u+x ./onetiny # 赋予执行权限
$ cp onetiny /usr/bin # 复制到可执行文件目录并修改可执行文件名称
Mac 用户注意:
第一次打开会提示未验证开发者,可以打开 「访达」 ,打开文件所在目录,在
onetiny
文件处右键打开。 之后就可以直接用命令行运行了。
Windows
点击最新版本的 OneTiny.exe
进行下载
Windows 用户注意: 下载时可能会有损害计算机提示,点击 「仍然保留」 即可。
需先安装Golang
$ git clone https://github.com/TCP404/OneTiny-base.git
$ go mod tidy
$ go build
onetiny
├── 不指定时可直接运行,采用默认值
├── --road -r 指定共享目录路径
├── --port -p 指定访问端口
└── --allow -a 指定是否允许上传
Windows:
下载后双击 OneTiny.exe
即可运行(需管理员权限)。
可以在CMD中切换到 OneTiny.exe
所在目录,执行以下任一命令:
> OneTiny # 将运行在 http://本机局域网IP:9090,共享目录为当前工作目录,禁止上传
> OneTiny.exe # 将运行在 http://本机局域网IP:9090,共享目录为当前工作目录,禁止上传
> OneTiny -p {端口号} # 将运行在 http://本机局域网IP:端口号,共享目录为当前工作目录,禁止上传
> OneTiny -r {共享目录绝对路径} # 将运行在 http://本机局域网IP:9090,共享目录为指定目录,禁止上传
> OneTiny -a [1|t|T|true|True|TRUE|空] # 将运行在 http://本机局域网IP:9090,共享目录为当前工作目录,允许上传
> onetiny -h # 打印帮助信息
> onetiny --help
> onetiny -v # 打印版本信息
> onetiny --version
> onetiny -r=C:\Users\Boii -p=8192 -a -x=2 # 将运行在 「http://本机局域网IP:8192」,共享目录为 「C:\Users\Boii」 ,允许上传,允许访问共享目录往下2层
Linux、Mac:
$ onetiny # 将运行在 http://本机局域网IP:9090,共享目录为当前工作目录,禁止上传
$ onetiny -p {端口号} # 将运行在 http://本机局域网IP:端口号,共享目录为当前工作目录,禁止上传
$ onetiny -r {共享目录绝对路径} # 将运行在 http://本机局域网IP:9090,共享目录为指定工作目录,禁止上传
$ onetiny -a [1|t|T|true|True|TRUE|空] # 将运行在 http://本机局域网IP:9090,共享目录为当前工作目录,允许上传
$ onetiny -h # 打印帮助信息
$ onetiny --help
$ onetiny -v # 打印版本信息
$ onetiny --version
$ onetiny -r=/home/boii -p=8192 -a -x=2 # 将运行在 「http://本机局域网IP:8192」,共享目录为 「/home/boii」,允许上传,允许访问共享目录往下2层
更多信息:
全局命令:
$ onetiny -h
NAME:
OneTiny - 一个用于局域网内共享文件的FTP程序
USAGE:
onetiny [GLOBAL OPTIONS] COMMAND [COMMAND OPTIONS] [参数...]
VERSION:
v1.0.0
AUTHOR:
Boii <i@tcp404.com>
COMMANDS:
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--road 路径, -r 路径 指定对外开放的目录路径 (default: /)
--port 端口, -p 端口 指定开放的端口 (default: 9090)
--allow 是否, -a 是否 指定是否允许访问者上传 (default: false)
--help, -h 打印帮助信息 (default: false)
--version, -v 打印版本信息 (default: false)
- 运行程序后,程序会提示此次服务运行在哪个端口,共享的是哪个目录,是否允许上传,允许访问的最大深度。
- 打开浏览器,输入程序提示框中给出的地址,回车即可访问。
打开浏览器输入程序给出的地址,即可访问共享目录中的文件:
点击文件链接即可下载。
Linux:
命令行中使用快捷键 Ctrl + C
即可停止程序运行。
Windows: 关闭cmd命令框即可。
注意:
- 在 Linux 或 Mac 系统下,需要将可执行文件移动至
/usr/bin
下:才能像内置命令一样使用。可以改成你喜欢的名字。mv ./OneTiny /usr/bin/tiny- Windows 下载时可能会有损害计算机提示,点击仍然保留即可。