最近一段时间比较忙，鲜有时间尝试一些新的、有趣的东西，写的东西也少了。今天抽空给大家介绍一款点对点文件分享工具croc。
crocis 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服务，这并不是理想的使用场景。
