Synopsis:

Download

./sshmirror ~/local/dir [email protected] /remote/dir

Description:

A fast, continuous, one-directional (local⇒remote) filesystem synchronization client (over SSH).

Basic usage scenario - local development with constant uploading to remote server via SSH. So basically, a fast alternative to SFTP manager of Jetbrains IDEs.

Example usage:

• download binary for your OS and architecture here (please note: initially developed for Linux-amd64, not tested on other platforms, thus may not work properly there)
• ensure, that you have ssh and rsync binaries installed system-wide (locally, and on remote server):

  sudo apt-get install ssh rsync

• start program:

  ./sshmirror \
      -i=~/.ssh/my_rsa \
      -e='(^\.git/|^\.idea/|~$)' \
      ~/myProject [email protected] /var/www/html/myProject

  where:
  • ~/myProject - LOCAL (source) directory to be read from
  • [email protected] - address and username (if needed) for remote server
  • /var/www/html/myProject - REMOTE (destination) directory to be written to
    (see all possible flags and description with ./sshmirror -h)
• make some changes to files in your local directory (create/edit/move/delete)
• see them being reflected on remote server

Proc:

• speed (especially on slow connections). See sample benchmark:
  • switching between git branches with total difference of 30 files (550Kb)
    • PhpStorm: 1.5min
    • sshmirror: 3sec

Cons:

• one-directional. So, to check remote files, you'll have to use other tools (f.e. sshfs)
• no visible speed-up on frequent uploading of singular files (speed-up is ≈10%)

Features:

• using rsync. Credits: https://github.com/WayneD/rsync
• transferring in batches instead of one-by-one. Modifications are grouped into a batch if one of the following is true:
  • last modification was made 0.5sec ago
  • first modification was made 5sec ago
• using ssh "Master connection" feature to keep one constant connection. Thus, once-in-a-while uploads do not need to establish connection over again

---

Please submit bugs reports to https://github.com/0leksandr/sshmirror/issues