docker-wormhole

KO | EN

gitlite — search

#javascript #hacktoberfest #react #typescript #golang #android #linux #macos #windows #awesome #cli #vue #awesome-list #security

docker-wormhole

(★ 18)

Wormhole Docker base image (Based on Ubuntu 14.04)

docker-wormhole 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# docker-wormhole
Wormhole Docker base image (Based on Ubuntu 14.04)

This image automatically connects your container to Wormhole Network, an overlay network solution that enables networking between your Docker containers on different hosts. This way you can move your containers to different servers, even on different hosting locations, without having to change your application's architecture.

The image is meant to serve as a base image for your own containers. Please clone this repository or fork it to build your own images with Wormhole's overlay networking included.

You'll need a free account in [Wormhole Network](https://wormhole.network) and to create a hub and a hub user. See the [documentation](https://wormhole.network/docs/) for simple instructions.

## Building docker-wormhole

git clone https://github.com/pjperez/docker-wormhole
    cd docker-wormhole

Download your config (.vpn) and linuxconfig files from your dashboard at [Wormhole Network](https://wormhole.network) and use them to replace the placeholders before the next step.

sudo docker build -t wormhole/client .
  
## Running docker-wormhole

sudo docker run --rm -t -i --device=/dev/net/tun --cap-add=NET_ADMIN wormhole/client

It is important to keep **-i** flag to make the session interactive, as you'll be asked to input your hub user's password twice. The --cap-add=NET_ADMIN and --device=/dev/net/tun are needed for SoftEther to create the tun adapter inside the container.

This is what you'll see after running it:

The SoftEther VPN Client service has been started.
	The commands written in the file "linuxconfig" will be used instead of input from keyboard.
	vpncmd command - SoftEther VPN Command Line Management Utility
	SoftEther VPN Command Line Management Utility (vpncmd command)
	Version 4.19 Build 9599   (English)
	Compiled 2015/10/19 20:28:20 by yagi at pc30
	Copyright (c) SoftEther VPN Project. All Rights Reserved.
	
	Connected to VPN Client "127.0.0.1:5555".
	
	VPN Client>AccountImport MyHUB-myuser.vpn
	AccountImport command - Import VPN Connection Setting
	The VPN Connection Setting "MyHUB" has been imported.
	The command completed successfully.
	
	VPN Client>AccountPasswordSet MyHUB /TYPE:STANDARD
	AccountPasswordSet command - Set User Authentication Type of VPN Connection Setting to Password Authentication
	Please enter the password. To cancel press the Ctrl+D key.
	
	Password: ************************
	Confirm input: ************************
	
	
	The command completed successfully.
	
	VPN Client>NicCreate wormhole
	NicCreate command - Create New Virtual Network Adapter
	The command completed successfully.
	
	VPN Client>AccountNicSet MyHUB /NIC:wormhole
	AccountNicSet command - Set Virtual Network Adapter for VPN Connection Setting to Use
	The command completed successfully.
	
	VPN Client>AccountConnect MyHUB
	AccountConnect command - Start Connection to VPN Server using VPN Connection Setting
	The command completed successfully.
	
	Acquiring IP address...
	IP address acquired!
	
And this is what the server sees:

2016-01-15 19:42:26.406 The connection "CID-743" (IP address: 1.2.3.4, Host name: 1.2.3.4, Port number: 1168, Client name: "SoftEther VPN Client", Version: 4.19, Build: 9599) is attempting to connect to the Virtual Hub. The auth type provided is "Password authentication" and the user name is "myuser".
	
	2016-01-15 19:42:26.406 Connection "CID-743": Successfully authenticated as user "myuser".
	2016-01-15 19:42:26.406 Connection "CID-743": The new session "SID-MYUSER-19" has been created. (IP address: 1.2.3.4, Port number: 1168, Physical underlying protocol: "Standard TCP/IP (IPv4)")
	
	2016-01-15 19:42:26.406 Session "SID-MYUSER-19": The parameter has been set. Max number of TCP connections: 2, Use of encryption: Yes, Use of compression: No, Use of Half duplex communication: No, Timeout: 20 seconds.
	
	2016-01-15 19:42:26.406 Session "SID-MYUSER-19": VPN Client details: (Client product name: "SoftEther VPN Client", Client version: 419, Client build number: 9599, Server product name: "SoftEther VPN Server (64 bit)", Server version: 419, Server build number: 9599, Client OS name: "Linux", Client OS version: "Unknown Linux Version", Client product ID: "--", Client host name: "6bb06fc1b280", Client IP address: "172.17.0.2", Client port number: 43429, Server host name: "amsterdam-hub.wormhole.network", Server IP address: "4.3.2.1", Server port number: 443, Proxy host name: "", Proxy IP address: "0.0.0.0", Proxy port number: 0, Virtual Hub name: "MyHUB", Client unique ID: "30D35CC2852F39D4B062A070BDE3FCF1")
	
	2016-01-15 19:42:26.519 SecureNAT: The DHCP entry 555 has been created. MAC address: 00-AC-34-56-78-12, IP address: 100.64.0.13, host name: 6bb06fc1b280, expiration span: 7200 seconds
	
	2016-01-15 19:42:26.519 Session "SID-SECURENAT-1": The DHCP server of host "00-AC-34-A7-D3-1F" (100.64.0.1) on this session allocated, for host "SID-MYUSER-19" on another session "00-AC-34-56-78-12", the new IP address 100.64.0.13.

Now your container is reachable on 100.64.0.13 inside your virtual network. Of course, all the traffic inside the network is encrypted for privacy and security purposes.

**Note:** As soon as the container is connected, it will die. This is **by design** as this container is a mere template to build your own services, boosted by [Wormhole Network](https://wormhole.network) connectivity.

## Use cases

The main use case for docker-wormhole is to make network reachability easier between your microservices, without having to expose ports, configure NAT or work with firewalls.

## Images available

Available images based on docker-wormhole:

- [docker-iperfserver](https://github.com/pjperez/docker-iperfserver): iPerf 2 server running on default settings. Reachable through the overlay network.
- [docker-iperfclient](https://github.com/pjperez/docker-iperfclient): iPerf 2 client running 32 parallel threads. Reaches the iPerf server through the overlay network.
- **NEW** [docker-whminecraft](https://github.com/pjperez/docker-whminecraft): The easiest Minecraft server to launch and join, ever!! It works out of the box on any network. Powered by Wormhole's overlay network.

If you build one, send us a link to info@wormhole.network

docker-wormhole

docker-wormhole 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

docker-wormhole

docker-wormhole 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README