https://github.com/kiesel/wormhole-go

A golang implementation of wormhole
https://github.com/kiesel/wormhole-go

Last synced: 1 day ago
JSON representation

A golang implementation of wormhole

• Host: GitHub
• URL: https://github.com/kiesel/wormhole-go
• Owner: kiesel
• License: mit
• Created: 2016-04-01T11:24:24.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2016-08-07T19:09:28.000Z (over 8 years ago)
• Last Synced: 2024-11-08T18:23:33.178Z (about 2 months ago)
• Language: Go
• Size: 31.3 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Wormhole

=========

[![Build Status on TravisCI](https://secure.travis-ci.org/kiesel/wormhole-go.png)](http://travis-ci.org/kiesel/wormhole-go)

[![GitHub release](https://img.shields.io/github/release/kiesel/wormhole-go.svg?maxAge=2592000)](https://github.com/kiesel/wormhole-go/releases)

[![license](https://img.shields.io/github/license/kiesel/wormhole-go.svg?maxAge=2592000)](https://github.com/kiesel/wormhole-go/blob/master/LICENSE)

Wormhole is a an application that allows to open files from a commandline within a VM in your favorite editor(s) / applications in the host system.

Prerequisites are that:

* the part of the VM filesystem that is hosting the files in question is mounted in your host OS

* you are logging in via SSH (though that limitation is only relevant for the client part.)

Installation

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

1. Download the latest release from the [GitHub Releases](https://github.com/kiesel/wormhole-go/releases) page.

2. Extract `.wormhole.yml` from the release zip into your home directory.

3. Run `wormhole` / `wormhole.exe`

To start wormhole with your shell, put this line into `.bashrc` / `.zshrc`:

```sh

(nohup $HOME/wormhole.exe -quiet 2>&1 &)

```

Client installation

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

You'll need a client, too. Given you're using bash / zsh or a compatible shell, you can use [kiesel/wormhole](https://github.com/kiesel/wormhole).

Security

--------

Wormhole opens a port on a designated interface for you; when binding to public network interfaces, you might expose yourself to serious security risks.

The recommended setup is therefore, to bind it to the loopback address 127.0.0.1 / ::1 and use SSH to make that port available to your client system (which would usually be a local VM). The configuration file `.ssh/config` would look like this:

    Host vbox vb 127.0.0.1

      Hostname 127.0.0.1

      Port 2222

      RemoteForward 127.0.0.1:5115 127.0.0.1:5115