croc点对点互传文件

最近一段时间比较忙，鲜有时间尝试一些新的、有趣的东西，写的东西也少了。今天抽空给大家介绍一款点对点文件分享工具croc。

croc is a tool that allows any two computers to simply and securely transfer files and folders. AFAIK, croc is the only CLI file-transfer tool that does all of the following:

• allows any two computers to transfer data (using a relay)
• provides end-to-end encryption (using PAKE)
• enables easy cross-platform transfers (Windows, Linux, Mac)
• allows multiple file transfers
• allows resuming transfers that are interrupted
• local server or port-forwarding not needed
• ipv6-first with ipv4 fallback
• can use proxy, like tor

For more information about croc, see my blog post.

上面是来自作者对这款工具的简单介绍，感兴趣的小伙伴可以到官方仓库schollz/croc了解工具详情和安装方法。

本篇博文我们主要聊一下croc工具使用时一些有意思，值得关注的小细节。

---

1. 建立自己的中间媒介

首先，croc依赖一个中间媒介，A用户通过该媒介将文件传给B用户，默认情况下croc使用作者自建的服务器作为中间媒介。

出于安全考虑用户可以使用自有服务器自建媒介，命令如下：

# on your server, after croc installed
croc relay

默认情况下，上述命令启动的croc媒介服务监听9009-9013端口，所以如果使用默认端口的话，请务必向防火墙添加端口9009-9013的入站规则。

croc允许用户在建立私有媒介时使用自定义端口，命令如下:

# on your server, after croc installed
croc relay --ports 10010,10011,10012,10013

上述命令要求croc使用10010-10013等4个端口提供文件共享服务，相应地注意修改防火墙规则。

2. 使用docker/kubernetes容器服务

作者制作了docker镜像方便将croc容器化，镜像地址：schollz/croc

使用docker或者kubernetes时请务必保证端口映射后，服务在主机上的监听地址与服务在容器中的监听地址相同。

例如：

docker run -d -p 9009-9013:9009-9013 -e CROC_PASS='YOURPASSWORD' schollz/croc

部署的服务可以外部使用，而

docker run -d -p 8009-8013:9009-9013 -e CROC_PASS='YOURPASSWORD' schollz/croc

部署的服务外部不能使用。

主要是因为用户和croc媒介交互的时候，croc服务会将自己监听的端口（即上述命令中的9009-9013）告诉用户端，用户端将尝试使用被告知的端口和croc服务通信，但实际上工作在容器下层的服务器监听在8009-8013，这和用户端被告知的情况不一致，所以用户端将不能和croc服务正常通信。

使用kubernetes时，同样需要注意这个问题，服务所曝露在服务器上的真实端口一定要和pod/croc监听的端口保持一致，至于中间的ingress-nginx --> service/croc --> pod/croc 之间采用什么端口并不重要，只要能保证用户访问服务器指定端口能最终连通到pod/croc的同一端口上即可。

说得有一点绕，举个栗子吧：假设你的pod/croc 监听在9009-9013端口，由于pod/croc上层还有service/croc，而service/croc上层有ingress-nginx，假设你的服务是通过ingress-nginx以nodeport的形式曝露到机器端口上，那么ingress-nginx曝露的端口应为9009-9013，只有这样用户在和croc通信时才能保证用户得到的信息和服务器端运行的信息一致，保证正常通信。

3. 简化使用流程

自建croc中继的话，用户在分享文件时需要指明中继服务器的ip和croc服务监听的端口，如

croc --relay "yourserverip:port" --pass yourpassword send /path/to/somfile

每次都这样操作略显繁琐，可以在某次命令中使用--remember参数，将这种常用的参数保存到配置文件$HOME/.config/croc/send.json中，如此一来后续使用时就不需要每次都手动指定 --relay和--pass参数。

使用自建的croc中间媒介，接受文件时也需要手动指定--relay和-pass参数，如下:

croc --relay "yourserverip:port" --pass yourpassword  thesharecode

类似地，可以在某次接受文件时使用--remember将这些常用的参数固化到$HOME/.config/receive.json，此后从同一个中间媒介接受文件时可不指定--relay和--pass。

注意：接受文件时使用--remember会将sharecode一次存储到$HOME/.config/receive.json，建议编辑该文件删除sharecode对应行配置.

---

更多内容，请参考官方说明文档。

croc仅是一个简易的文件分享工具，存在一些安全风险，比如：接受文件的用户必须知道--pass才能接受文件，而任何知道--pass的用户都能利用该口令来使用你部署的croc服务，这并不是理想的使用场景。