Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/benhunter/nebula-docker-quickstart

docker docker-compose nebula network overlay

Last synced: 6 days ago
JSON representation

Host: GitHub
URL: https://github.com/benhunter/nebula-docker-quickstart
Owner: benhunter
License: mit
Created: 2023-10-29T22:22:06.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-10-30T08:47:59.000Z (over 1 year ago)
Last Synced: 2024-04-18T15:58:01.356Z (10 months ago)
Topics: docker, docker-compose, nebula, network, overlay
Language: Dockerfile
Homepage:
Size: 26.4 KB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Nebula Docker Quickstart

A Nebula overlay network in Docker Compose. Configures a Lighthouse and two server endpoints. Demonstrates nginx and ssh accessible only from inside the overlay network.

Based on the [Nebula Quick Start Guide](https://nebula.defined.net/docs/guides/quick-start/). Tested on Mac with M1 Apple Silicon.

# Setup

```sh
./setup-mac.sh
docker compose up -d --build
```

# SSH

```sh
docker compose exec netshoot2 ssh [email protected]
```

Won't work outside overlay:
```sh
docker compose exec netshoot2 ssh [email protected]
```

# Nginx

```sh
docker compose exec netshoot2 http 192.168.100.11
```

Won't work outside overlay:
```sh
docker compose exec netshoot2 http 192.168.42.11
```

# ICMP

```sh
docker compose exec server1 ping 192.168.100.1 -c 2
docker compose exec server1 ping 192.168.42.42 -c 2
docker compose exec server1 ping 192.168.100.12 -c 2
docker compose exec server1 ping 192.168.42.12 -c 2
docker compose exec lighthouse ping 192.168.100.11 -c 2
docker compose exec lighthouse ping 192.168.42.11 -c 2
docker compose exec lighthouse ping 192.168.100.12 -c 2
docker compose exec lighthouse ping 192.168.42.12 -c 2
docker compose exec server2 ping 192.168.100.1 -c 2
docker compose exec server2 ping 192.168.42.42 -c 2
docker compose exec server2 ping 192.168.100.11 -c 2
docker compose exec server2 ping 192.168.42.11 -c 2
```
# Iterate

```sh
docker compose down && docker compose up -d --build
```

Run single container with normal nebula entrypoint
```sh
docker run --rm -v ./lighthouse/config.yaml:/config/config.yaml -v ./lighthouse/pki:/etc/nebula --cap-add=NET_ADMIN --device /dev/net/tun nebula-alpine
```

Run and attach to shell
```sh
docker run -it --rm -v ./lighthouse/config.yaml:/config/config.yaml -v ./lighthouse/pki:/etc/nebula --cap-add=NET_ADMIN --device /dev/net/tun --entrypoint sh nebula-alpine
```

Direct ssh (would reqire a host port mapping)
```sh
ssh -i ubuntu-ssh/ssh_keys/id_rsa -p 2222 root@localhost
```