https://github.com/tg123/docker-sshd
ssh into any docker container/Kubernetes pod without sshd
https://github.com/tg123/docker-sshd
docker kubernetes ssh
Last synced: 7 months ago
JSON representation
ssh into any docker container/Kubernetes pod without sshd
- Host: GitHub
- URL: https://github.com/tg123/docker-sshd
- Owner: tg123
- License: mit
- Created: 2015-04-09T12:05:33.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-02-03T09:07:04.000Z (over 1 year ago)
- Last Synced: 2024-10-16T15:43:24.241Z (12 months ago)
- Topics: docker, kubernetes, ssh
- Language: Go
- Homepage:
- Size: 105 KB
- Stars: 43
- Watchers: 2
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# docker-sshd && kube-sshd
## docker-sshd
with `docker-sshd`, you can `ssh` into docker containers from anywhere,
just like `docker exec -ti CONTAINER_ID /bin/bash` on the docker host machine.
```
+-------------+
| | ssh CONTAINER1@docker-sshd +--------------------+
| ops +------------------------------------> |
| | | docker-sshd |
+-------------+ | |
+----------------+---+
|
|
docker exec -ti CONTAINER1 /bin/bash |
|
+--------------------------------------------------------------+
| | |
| Docker +------------+ +------------+ +------v-----+ |
| | | | | | | |
| | CONTAINER3 | | CONTAINER2 | | CONTAINER1 | |
| | | | | | | |
| +------------+ +------------+ +------------+ |
| |
+--------------------------------------------------------------+
```
## kube-sshd
with `kube-sshd`, you can `ssh` into kubenetes pod from anywhere,
just like `kubectl exec -ti POD /bin/bash`.
```
+-------------+
| | ssh POD1@kube-sshd +--------------------+
| ops +------------------------------------> |
| | | kube-sshd |
+-------------+ | |
+----------------+---+
|
|
kubectl exec -ti POD1 /bin/bash |
|
+--------------------------------------------------------------+
| | |
| k8s +------------+ +------------+ +------v-----+ |
| | | | | | | |
| | POD1 | | POD2 | | POD3 | |
| | | | | | | |
| +------------+ +------------+ +------------+ |
| |
+--------------------------------------------------------------+
```
## Install
```
go get github.com/tg123/docker-sshd/cmd/docker-sshd
```
# Quick start
1. start a container named `CONTAINER1`
```
docker run -d -t --name CONTAINER1 ubuntu top
bd78d93154cff5e8b40d19b1676670a49f582d2522384ecfe0d9e7d60846891e
```
1. start `docker-sshd`
```
docker-sshd
```
1. connect to container with ssh
```
ssh CONTAINER1@127.0.0.1 -p 2232
root@bd78d93154cf:/#
```
## Options
```
--address value, -l value listening address (default: "0.0.0.0")
--port value, -p value listening port (default: 2232)
--server-key value, -i value server key files, support wildcard (default: "/etc/ssh/ssh_host_ed25519_key")
--command value, -c value default exec command (default: "/bin/sh")
```
### Docker related Environment
* `DOCKER_HOST to` set the URL to the docker server, default unix:///var/run/docker.sock.
* `DOCKER_API_VERSION` to set the version of the API to use, leave empty for latest.
* `DOCKER_CERT_PATH` to specify the directory from which to load the TLS certificates (ca.pem, cert.pem, key.pem).
* `DOCKER_TLS_VERIFY` to enable or disable TLS verification (off by default).
see for more detail
## Connecting from vscode
Make sure your container meet the [prerequisites](https://code.visualstudio.com/docs/remote/linux#_remote-host-container-wsl-linux-prerequisites).
Additionally, install [nc](https://linux.die.net/man/1/nc) to your container to have tcp redirect working