十年网站开发经验 + 多家企业客户 + 靠谱的建站团队
量身定制 + 运营维护+专业推广+无忧售后,网站问题一站解决
gofs
是基于golang开发的一款开箱即用的跨平台文件同步工具,支持在本地磁盘之间同步、从远程服务器同步变更到本地、将本地文件变更推送到远程服务器三种模式。开源地址如下:Github & Gitee,欢迎Star或者提交Issue和PR!
创新互联主营通城网站建设的网络公司,主营网站建设方案,重庆APP开发公司,通城h5成都小程序开发搭建,通城网站营销推广欢迎通城等地区企业咨询
首先需要确保已经安装了Go (版本必须是1.18+),然后你就可以使用下面的命令来安装gofs
了
如果你不需要自行从源码编译安装,也可以直接下载最新发布的二进制文件
go install github.com/no-src/gofs/...@latest
你可以使用build-docker.sh脚本来构建docker镜像,首先你需要克隆本仓库并且cd
到本仓库的根目录
$ ./scripts/build-docker.sh
或者使用以下命令直接从DockerHub中拉取docker镜像
$ docker pull nosrc/gofs
更多关于发布与docker的脚本参见scripts目录
在windows系统中,你可以使用下面的命令构建一个在后台运行的不带命令行界面的程序
go install -ldflags="-H windowsgui" github.com/no-src/gofs/...@latest
请确保文件同步的源目录和目标目录都已经存在,如果目录不存在,则用你实际的目录替换下面的路径进行提前创建
$ mkdir source dest
生成仅用于测试的证书和密钥文件,生产中请替换为正式的证书
TLS证书和密钥文件仅用于与Web文件服务器和远程磁盘服务端进行安全通讯
$ go run $GOROOT/src/crypto/tls/generate_cert.go --host 127.0.0.1
2021/12/30 17:21:54 wrote cert.pem
2021/12/30 17:21:54 wrote key.pem
查看你的工作目录
$ ls
cert.pem key.pem source dest
监控本地源目录将变更同步到目标目录
你可以使用logically_delete
命令行参数来启用逻辑删除,从而避免误删数据
设置checkpoint_count
命令行参数来使用文件中的检查点来减少传输未修改的文件块,默认情况下checkpoint_count=10
,这意味着它最多有10+2
个检查点。在头部和尾部还有两个额外的检查点。第一个检查点等于chunk_size
,它是可选的。最后一个检查点等于文件大小,这是必需的。由checkpoint_count
设置的检查点偏移量总是大于chunk_size
,除非文件大小小于或等于chunk_size
,那么checkpoint_count
将变为0
,所以它是可选的
默认情况下,如果源文件的大小和修改时间与目标文件相同,则忽略当前文件的传输。你可以使用force_checksum
命令行参数强制启用校验和来比较文件是否相等
默认的校验和哈希算法为md5
,你可以使用checksum_algorithm
命令行参数来更改默认的哈希算法,当前支持的算法如下:md5
、sha1
、sha256
、sha512
、crc32
、crc64
、adler32
、fnv-1-32
、fnv-1a-32
、fnv-1-64
、fnv-1a-64
、fnv-1-128
、fnv-1a-128
如果你想要降低同步的频率,你可以使用sync_delay
命令行参数来启用同步延迟,当事件数量大于等于sync_delay_events
或者距离上次同步已经等待超过sync_delay_time
时开始同步
$ gofs -source=./source -dest=./dest
执行一次全量同步,直接将整个源目录同步到目标目录
$ gofs -source=./source -dest=./dest -sync_once
定时执行全量同步,将整个源目录同步到目标目录
# 每30秒钟将源目录全量同步到目标目录
$ gofs -source=./source -dest=./dest -sync_cron="*/30 * * * * *"
启动守护进程来创建一个工作进程处理实际的任务,并将相关进程的pid信息记录到pid文件中
$ gofs -source=./source -dest=./dest -daemon -daemon_pid
启动一个Web文件服务器用于访问远程的源目录和目标目录
Web文件服务器默认使用HTTPS协议,使用tls_cert_file
和tls_key_file
命令行参数来指定相关的证书和密钥文件
如果你不需要使用TLS进行安全通讯,可以通过将tls
命令行参数指定为false
来禁用它
如果将tls
设置为true
,则服务器默认运行端口为443
,反之默认端口为80
,你可以使用server_addr
命令行参数来自定义服务器运行端口,例如-server_addr=":443"
如果你在服务器端启用tls
命令行参数,可以通过tls_insecure_skip_verify
命令行参数来控制客户端是否跳过验证服务器的证书链和主机名,默认为true
出于安全考虑,你应该设置rand_user_count
命令行参数来随机生成指定数量的用户或者通过users
命令行参数自定义用户信息来保证数据的访问安全,禁止用户匿名访问数据
如果rand_user_count
命令行参数设置大于0,则随机生成的账户密码将会打印到日志信息中,请注意查看
如果你需要启用gzip压缩响应结果,则添加server_compress
命令行参数,但是目前gzip压缩不是很快,在局域网中可能会影响传输效率
# 启动一个Web文件服务器并随机创建3个用户
# 在生产环境中请将`tls_cert_file`和`tls_key_file`命令行参数替换为正式的证书和密钥文件
$ gofs -source=./source -dest=./dest -server -tls_cert_file=cert.pem -tls_key_file=key.pem -rand_user_count=3
启动一个远程磁盘服务端作为一个远程文件数据源
source
命令行参数详见远程磁盘服务端数据源协议
注意远程磁盘服务端的用户至少要拥有读权限,例如:-users="gofs|password|r"
你可以使用checkpoint_count
和sync_delay
命令行参数就跟本地磁盘一样
# 启动一个远程磁盘服务端
# 在生产环境中请将`tls_cert_file`和`tls_key_file`命令行参数替换为正式的证书和密钥文件
# 为了安全起见,请使用复杂的账户密码来设置`users`命令行参数
$ gofs -source="rs://127.0.0.1:8105?mode=server&local_sync_disabled=true&path=./source&fs_server=https://127.0.0.1" -dest=./dest -users="gofs|password|r" -tls_cert_file=cert.pem -tls_key_file=key.pem
启动一个远程磁盘客户端将远程磁盘服务端的文件变更同步到本地目标目录
source
命令行参数详见远程磁盘服务端数据源协议
使用sync_once
命令行参数,可以直接将远程磁盘服务端的文件整个全量同步到本地目标目录,就跟全量同步一样
使用sync_cron
命令行参数,可以定时将远程磁盘服务端的文件整个全量同步到本地目标目录,就跟定时同步一样
使用force_checksum
命令行参数强制启用校验和来比较文件是否相等,就跟本地磁盘一样
你可以使用sync_delay
命令行参数就跟本地磁盘一样
# 启动一个远程磁盘客户端
# 请将`users`命令行参数替换为上面设置的实际账户名密码
$ gofs -source="rs://127.0.0.1:8105" -dest=./dest -users="gofs|password"
启动一个远程磁盘服务端作为一个远程文件数据源,并使用push_server
命令行参数启用远程推送服务端
注意远程推送服务端的用户至少要拥有读写权限,例如:-users="gofs|password|rw"
# 启动一个远程磁盘服务端并启用远程推送服务端
# 在生产环境中请将`tls_cert_file`和`tls_key_file`命令行参数替换为正式的证书和密钥文件
# 为了安全起见,请使用复杂的账户密码来设置`users`命令行参数
$ gofs -source="rs://127.0.0.1:8105?mode=server&local_sync_disabled=true&path=./source&fs_server=https://127.0.0.1" -dest=./dest -users="gofs|password|rw" -tls_cert_file=cert.pem -tls_key_file=key.pem -push_server
启动一个远程推送客户端将本地文件变更同步到远程推送服务端
使用chunk_size
命令行参数来设置大文件上传时切分的区块大小,默认值为,即
1MB
你可以使用checkpoint_count
和sync_delay
命令行参数就跟本地磁盘一样
更多命令行参数用法请参见远程磁盘客户端
# 启动一个远程推送客户端并且启用本地磁盘同步,将source目录下的文件变更同步到本地dest目录和远程推送服务器上
# 请将`users`命令行参数替换为上面设置的实际账户名密码
$ gofs -source="./source" -dest="rs://127.0.0.1:8105?local_sync_disabled=false&path=./dest" -users="gofs|password"
启动一个SFTP客户端,将发生变更的文件同步到SFTP服务器
$ gofs -source="./source" -dest="sftp://127.0.0.1:22?local_sync_disabled=false&path=./dest&remote_path=/gofs_sftp_server" -users="sftp_user|sftp_pwd"
启动一个SFTP推送客户端,将发生变更的文件同步到SFTP服务器
$ gofs -source="./source" -dest="sftp://127.0.0.1:22?local_sync_disabled=false&path=./dest&remote_path=/gofs_sftp_server" -users="sftp_user|sftp_pwd"
启动一个SFTP拉取客户端,将文件从SFTP服务器拉到本地目标路径
启动一个MinIO推送客户端,将发生变更的文件同步到MinIO服务器
$ gofs -source="./source" -dest="minio://127.0.0.1:9000?local_sync_disabled=false&path=./dest&remote_path=minio-bucket" -users="minio_user|minio_pwd"
启动一个MinIO拉取客户端,将文件从MinIO服务器拉到本地目标路径
$ gofs -source="minio://127.0.0.1:9000?remote_path=minio-bucket" -dest="./dest" -users="minio_user|minio_pwd" -sync_once
如果你需要在两个无法直接相连的设备之间同步文件,可以使用反向代理作为中继服务器来实现,详情参见中继模式
远程磁盘服务端数据源协议基于URI基本语法,详见RFC 3986
方案名称为rs
远程磁盘服务端数据源在远程磁盘服务端模式下使用0.0.0.0
或者其他本地网卡IP地址作为主机名,在远程磁盘客户端
模式下使用远程磁盘服务端的IP地址或者域名作为主机名
远程磁盘服务端数据源端口号,默认为8105
仅在远程磁盘服务端模式下设置以下参数
path
远程磁盘服务端真实的本地源目录mode
指定运行模式,只有在远程磁盘服务端模式下需要手动指定为server
,默认为远程磁盘客户端模式fs_server
Web文件服务器地址,例如https://127.0.0.1
local_sync_disabled
是否将远程磁盘服务端的文件变更同步到远程本地的目标目录,可选值为true
或false
,默认值为false
远程磁盘服务端模式下的示例
rs://127.0.0.1:8105?mode=server&local_sync_disabled=true&path=./source&fs_server=https://127.0.0.1
\_/ \_______/ \__/ \____________________________________________________________________________/
| | | |
方案 主机名 端口号 参数
基于Web文件服务器的应用管理接口
默认情况下,仅允许私有地址和回环地址访问管理接口的相关路由
你可以通过将manage_private
命令行参数设置为false
来禁用默认行为,允许公网IP访问管理接口的路由
$ gofs -source=./source -dest=./dest -server -tls_cert_file=cert.pem -tls_key_file=key.pem -rand_user_count=3 -manage
pprof访问地址如下:
https://127.0.0.1/manage/pprof/
读取应用程序配置,默认返回json
格式,当前支持json
和yaml
格式
https://127.0.0.1/manage/config
或者使用format
参数来指定返回的配置格式
https://127.0.0.1/manage/config?format=yaml
使用report
命令行参数来启用报告接口的路由并且开始收集报告数据,需要先启用manage
命令行参数
报告接口详情参见Report API
https://127.0.0.1/manage/report
默认情况下会启用文件日志与控制台日志,你可以将log_file
命令行参数设置为false
来禁用文件日志
使用log_level
命令行参数设置日志的等级,默认级别是INFO
,可选项为:DEBUG=0
INFO=1
WARN=2
ERROR=3
使用log_dir
命令行参数来设置日志文件目录,默认为./logs/
使用log_flush
命令行参数来设置自动刷新日志到文件中,默认启用
使用log_flush_interval
命令行参数设置自动刷新日志到文件中的频率,默认为3s
使用log_event
命令行参数启用事件日志,所有事件都会记录到文件中,默认为禁用
使用log_sample_rate
命令行参数设置采样日志的采样率,取值范围为0到1,默认值为1
使用log_format
命令行参数设置日志输出格式,当前支持text
与json
,默认为text
# 在"本地磁盘"模式下设置日志信息
$ gofs -source=./source -dest=./dest -log_file -log_level=0 -log_dir="./logs/" -log_flush -log_flush_interval=3s -log_event
如果需要的话,你可以使用配置文件来代替所有的命令行参数,当前支持json
和yaml
格式
所有的配置字段名称跟命令行参数一样,你可以参考配置示例或者配置接口的响应结果
$ gofs -conf=./gofs.yaml
你可以使用checksum
命令行参数来计算并打印文件的校验和
chunk_size
、checkpoint_count
和checkpoint_count
命令行参数在这里同在本地磁盘中一样有效
$ gofs -source=./gofs -checksum
$ gofs -h
$ gofs -v
$ gofs -about