Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 156 Commits
cmd/ssh2docker		cmd/ssh2docker
contrib		contrib
examples		examples
pkg		pkg
resources		resources
vendor		vendor
.gitignore		.gitignore
.goxc.json		.goxc.json
.travis.yml		.travis.yml
Dockerfile		Dockerfile
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
auth.go		auth.go
auth_test.go		auth_test.go
circle.yml		circle.yml
client.go		client.go
glide.lock		glide.lock
glide.yaml		glide.yaml
renovate.json		renovate.json
server.go		server.go

Repository files navigation

ssh2docker

🔧 SSH server that can create new Docker containers and/or join existing ones, with session, and dynamic configuration support

SSH chroot with steroids

┌────────────┐│bobby@laptop│└────────────┘│└──sshcontainer1@mycorp.biz──┐▼┌──────────┐┌──────────────────────────────┤ssh2docker├──┐│└──────────┘││dockerexec -it│││container1│││┌──────/bin/bash──────────┘││┌────────┼───────────────────────────────┐│││docker│││││┌───────▼──┐┌──────────┐┌──────────┐│││││container1││container2││container3│││││└──────────┘└──────────┘└──────────┘│││└────────────────────────────────────────┘│└────────────────────────────────────────────┘

Usage

NAME:   ssh2docker - SSH portal to Docker containersUSAGE:   ssh2docker [global options] command [command options] [arguments...]AUTHOR(S):   Manfred Touron <https://github.com/moul/ssh2docker>COMMANDS:   help, hShows a list of commands or help for one commandGLOBAL OPTIONS:   --verbose, -V                 Enable verbose mode   --syslog-server               Configure a syslog server, i.e: udp://localhost:514   --bind, -b ":2222"            Listen to address   --host-key, -k "built-in"     Path or complete SSH host key to use, use 'system' for keys in /etc/ssh   --allowed-images              List of allowed images, i.e: alpine,ubuntu:trusty,1cf3e6c   --shell "/bin/sh"             DEFAULT shell   --docker-run-args "-it --rm"  'docker run' arguments   --no-join                     Do not join existing containers, always create new ones   --clean-on-startup            Cleanup Docker containers created by ssh2docker on start   --password-auth-script      Password auth hook file   --publickey-auth-script      Public-key auth hook file   --local-user          If setted, you can spawn a local shell (not withing docker) by SSHing to this user   --banner          Display a banner on connection   --help, -h         show help   --version, -v         print the version

Example

Server

$ssh2dockerINFO[0000] Listening on port 2222INFO[0001] NewClient (0): User="alpine", ClientVersion="5353482d322e302d4f70656e5353485f362e362e317031205562756e74752d327562756e747532"INFO[0748] NewClient (1): User="ubuntu", ClientVersion="5353482d322e302d4f70656e5353485f362e362e317031205562756e74752d327562756e747532"

Client

$ssh localhost -p 2222 -l alpineHost key fingerprint is 59:46:d7:cf:ca:33:be:1f:58:fd:46:c8:ca:5d:56:03+--[ RSA 2048]----+|          . .E   ||         . .  o  ||          o    +.||         +   . .*||        S    .oo=||           . oB+.||            oo.+o||              ...||              .o.|+-----------------+alpine@localhost's password:/ # cat /etc/alpine-release3.2.0/ # ^D

$ssh localhost -p 2222 -l ubuntuHost key fingerprint is 59:46:d7:cf:ca:33:be:1f:58:fd:46:c8:ca:5d:56:03+--[ RSA 2048]----+|          . .E   ||         . .  o  ||          o    +.||         +   . .*||        S    .oo=||           . oB+.||            oo.+o||              ...||              .o.|+-----------------+ubuntu@localhost's password:#lsb_release -aNo LSB modules are available.Distributor ID:UbuntuDescription:Ubuntu 14.04.3 LTSRelease:14.04Codename:trusty#^D

Install

Install latest version using Golang (recommended)

$go get github.com/moul/ssh2docker/cmd/ssh2docker

Install latest version using Homebrew (Mac OS X)

$brew install https://raw.githubusercontent.com/moul/ssh2docker/master/contrib/homebrew/assh.rb --HEAD

or the latest released version

$brew install https://raw.githubusercontent.com/moul/ssh2docker/master/contrib/homebrew/assh.rb

Test with Docker

You can testssh2docker within Docker, but you will have some limitations, i.e: cannot run with boot2docker.

Here is an example about how to use ssh2docker inside Docker

$docker run --privileged -v /var/lib/docker:/var/lib/docker -it --rm -p 2222:2222 moul/ssh2docker

Changelog

master (unreleased)

Support ofdocker-exec-args in hook scripts and in CLI args
Sending environment variables to auth scripts
TTY is now dynamic (@quentinperez)
Support of exec commands without tty, i.e: git-server, rsync, tftp, ...
Support of API hooks for password and public key authentication (#80)
Support of exec requests (#51)
Support ofdocker-run-args in hook scripts (#30)
Support of--syslog-server + refactored logs (#71)
Do not ask for a password if only--publickey-auth-script is present (#72)
Code refactor (split in modules), update examples, bump dependencies
Support of--syslog-server=unix:///dev/log (#74)

full commits list

v1.2.0 (2015-11-22)

Support of--host-key=system to use OpenSSH keys (#45)
Support of custom entrypoint (#63)
Support of public-key authentication (#2)
Handling custom environment variables, user and command in password script (#57)
Replacing "_" by "/" on default image name to handle ControlMaster on clients
Support of--banner option (#26)
Add a not-yet-implemented warning for exec (#51)
Support of--local-user option, to allow a specific user to be a local shell (#44)
Kill connection when exiting shell (ctrl+D) (#43)