Total Pageviews

Monday 28 September 2020

croc


Easily and securely send files from one computer to another.

https://schollz.com/software/croc6

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

For more information about croc, see my blog post.

Example

Install

Download the latest release for your system, or install a release from the command-line:

$ curl https://getcroc.schollz.com | bash

On macOS you can install the latest release with Homebrew:

$ brew install croc

On macOS you can also install the latest release with MacPorts:

$ sudo port selfupdate
$ sudo port install croc

On Windows you can install the latest release with Scoop or Chocolatey:

$ scoop install croc
$ choco install croc

On Unix you can install the latest release with Nix:

$ nix-env -i croc

On Arch Linux you can install the latest release with pacman:

$ pacman -S croc

On Ubuntu you can install with snap:

$ snap install croc

On Gentoo you can install with portage:

$ emerge net-misc/croc

On Termux you can install with pkg:

$ pkg install croc

On FreeBSD you can install with pkg:

$ pkg install croc

Or, you can install Go and build from source (requires Go 1.12+):

$ GO111MODULE=on go get -v github.com/schollz/croc/v8

Usage

To send a file, simply do:

$ croc send [file(s)-or-folder]
Sending 'file-or-folder' (X MB)
Code is: code-phrase

Then to receive the file (or folder) on another computer, you can just do

$ croc code-phrase

The code phrase is used to establish password-authenticated key agreement (PAKE) which generates a secret key for the sender and recipient to use for end-to-end encryption.

There are a number of configurable options (see --help). A set of options (like custom relay, ports, and code phrase) can be set using --remember.

Custom code phrase

You can send with your own code phrase (must be more than 4 characters).

$ croc send --code [code-phrase] [file(s)-or-folder]

Use pipes - stdin and stdout

You can pipe to croc:

$ cat [filename] | croc send

In this case croc will automatically use the stdin data and send and assign a filename like "croc-stdin-123456789". To receive to stdout at you can always just use the --yes will automatically approve the transfer and pipe it out to stdout.

$ croc --yes [code-phrase] > out

All of the other text printed to the console is going to stderr so it will not interfere with the message going to stdout.

Send text

Sometimes you want to send URLs or short text. In addition to piping, you can easily send text with croc:

$ croc send --text "hello world"

This will automatically tell the receiver to use stdout when they receive the text so it will be displayed.

Self-host relay

The relay is needed to staple the parallel incoming and outgoing connections. By default, croc uses a public relay but you can also run your own relay:

$ croc relay

By default it uses TCP ports 9009-9013. Make sure to open those up. You can customized the ports (e.g. croc relay --ports 1111,1112), but you must have a minimum of 2 ports for the relay. The first port is for communication and the subsequent ports are used for the multiplexed data transfer.

You can send files using your relay by entering --relay to change the relay that you are using if you want to custom host your own.

$ croc --relay "myrelay.example.com:9009" send [filename]

Note, when sending, you only need to include the first port (the communication port). The subsequent ports for data transfer will be transmitted back to the user from the relay.

Self-host relay (docker)

If it's easier you can also run a relay with Docker:

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

Be sure to include the password for the relay otherwise any requests will be rejected.

$ croc --pass YOURPASSWORD --relay "myreal.example.com:9009" send [filename]

Note: when including --pass YOURPASSWORD you can instead pass a file with the password, e.g. --pass FILEWITHPASSWORD.

Acknowledgements

croc has gone through many iterations, and I am awed by all the great contributions! If you feel like contributing, in any way, by all means you can send an Issue, a PR, ask a question, or tweet me (@yakczar).

Thanks @warner for the idea@tscholl2 for the encryption gists@skorokithakis for code on proxying two connections. Finally thanks for making pull requests @maximbaz@meyermarcel@Girbons@techtide@heymatthew@Lunsford94@lummie@jesuiscamille@threefjord@marcossegovia@csleong98@afotescu@callmefever@El-JojA@anatolyyyyyy@goggle@smileboywtu@nicolashardy@fbartels@rkuprov@xenrox and Ipar!


from https://github.com/schollz/croc

( 点对点的数据传输工具-Croc

Croc是一款强调安全性的点对点数据传输开源工具,该命令行工具允许两台计算机设备以一种简单和安全的方式来传输文件或文件夹。基于Go语言编写,遵守MIT开源协议。

功能特色:
    允许任意两台计算机设备直接进行数据传输;
    提供了端到端加密支持(PAKE);
    支持跨平台传输(Windows、Linux和macOS);
    支持多文件传输;
    允许断线后的文件续传;
    不需要本地服务器或端口转发;
    支持IPv6和IPv4;
    支持使用代理,如Tor等;

源码: https://github.com/schollz/croc )

-------------------------------------------------


兩台電腦透過 croc 工具來傳送檔案 (簡單, 加密, 快速)

croc is a tool that allows any two computers to simply and securely transfer files and folders.

Croc office github

兩台電腦透過 croc 工具來傳送檔案

systemctl的方法后台运行croc relay:

配置 croc.service ( /etc/systemd/system/croc.service )

[Unit]
Description=Croc
Documentation=https://github.com/schollz/croc
After=network.target network-online.target nss-lookup.target mysql.service mariadb.service mysqld.service

[Service]
Type=simple
StandardError=journal
ExecStart=/usr/local/bin/croc relay
ExecReload=/bin/kill -HUP \$MAINPID
ExecStop=/usr/local/bin/croc
LimitNOFILE=51200
Restart=on-failure
RestartSec=1s

[Install]
WantedBy=multi-user.target
启用/启动 croc:
##加载服务文件
systemctl daemon-reload

systemctl enable | disable  croc

systemctl start croc

systemctl restart | stop croc

No comments:

Post a Comment