---
title: "Docker-Container vom Mac aus nicht erreichbar: Ports und IPs · Kilobat-Anleitungen"
url: "https://kilobat.app/de/guides/docker-container-from-mac.html"
description: "Verbinde dich von macOS aus mit einem Dienst in Docker Desktop oder OrbStack: Port veröffentlichen, localhost nutzen und wissen, wann Container-IP-Adressen funktionieren."
---

Entwickler

# Docker-Container vom Mac aus nicht erreichbar

Docker führt Container auf dem Mac in einer virtuellen Linux-Maschine aus. Um einen Container von macOS aus zu erreichen, veröffentlichst du meist einen Port auf localhost.

Gilt für: Docker Desktop und OrbStack unter aktuellen macOS-Versionen. · Geprüft: 29. Oktober 2026

## Symptome

- `curl localhost:8080` scheitert, aber der Dienst funktioniert im Container.
- Du kannst die IP-Adresse des Containers weder anpingen noch dich damit verbinden.
- Auf dem Mac erscheint keine Schnittstelle `docker0`.
- Der Dienst funktioniert unter Linux, aber nicht auf dem Mac.

## Mögliche Ursachen

- **Der Port ist nicht veröffentlicht.** Ohne `-p` leitet Docker Desktop den Port nicht an den Mac weiter.
- **Container-IPs bei Docker Desktop.** Laut der Dokumentation von Docker Desktop ist dessen Bridge-Netzwerk vom Host aus nicht erreichbar.
- **Der Dienst lauscht im Container auf 127.0.0.1.** Dann kann sich nur der Container selbst damit verbinden.
- **Ein falsches Port-Paar.** In `-p 8080:80` ist 8080 der Port auf dem Mac und 80 der Port im Container.

## So prüfst du es

1. Liste die laufenden Container und ihre veröffentlichten Ports auf.

   ```
   docker ps
   ```

   Ausgabe Die Spalte PORTS zeigt Paare wie `0.0.0.0:8080->80/tcp`. Kein Paar bedeutet, dass der Port nicht veröffentlicht ist.
2. Zeige die veröffentlichten Ports eines Containers an.

   ```
   docker port my-container
   ```
3. Teste den Dienst im Container, falls das Image wget enthält. Eine Antwort bedeutet, dass der Dienst funktioniert.

   ```
   docker exec my-container wget -qO- http://localhost:80
   ```
4. Sieh nach, welcher Prozess auf dem Mac auf dem Port lauscht.

   ```
   lsof -nP -iTCP:8080 -sTCP:LISTEN
   ```

## So behebst du es

1. Starte den Container mit einem veröffentlichten Port. Die erste Zahl ist der Port auf dem Mac.

   ```
   docker run -d -p 8080:80 nginx
   ```
2. Verbinde dich vom Mac aus mit localhost und dem Port auf dem Mac.

   ```
   curl http://localhost:8080
   ```
3. Lass den Dienst im Container auf 0.0.0.0 statt auf 127.0.0.1 lauschen. Die Einstellung dafür steht in seiner Dokumentation.
4. Ist der Port auf dem Mac belegt, wähle einen anderen. Siehe [Port auf dem Mac bereits belegt](https://kilobat.app/de/guides/port-already-in-use.html).
5. Mit OrbStack kannst du auch die IP-Adresse des Containers oder seinen Namen `container-name.orb.local` verwenden.

## Mit Kilobat

1. Die Prüfungen von Kilobat laufen auf dem Mac. Nutze `--context container`, wenn der fehlerhafte Code in einem Container läuft. Der Bericht endet dann mit einem Befehl, den du dort ausführst.

   ```
   kilobat why http://localhost:8080 --context container
   ```

## Fragen

**Warum kann ich einen Container in Docker Desktop nicht anpingen?**

Laut Docker-Dokumentation kann Docker Desktop keinen Datenverkehr vom Mac zu Linux-Containern routen. Veröffentliche stattdessen einen Port.

**Funktioniert OrbStack anders?**

Ja. Laut OrbStack-Dokumentation kannst du dich vom Mac aus per IP-Adresse und über `.orb.local`-Namen mit Containern verbinden.

## Quellen

- [Docker Docs: Explore networking how-tos on Docker Desktop](https://docs.docker.com/desktop/features/networking/networking-how-tos/)
- [Docker Docs: Networking on Docker Desktop](https://docs.docker.com/desktop/features/networking/)
- [OrbStack Docs: Container networking](https://docs.orbstack.dev/docker/network)
- lsof(8), Manpage aus macOS 27.2

Quellen geprüft am 29. Oktober 2026. Die Manpages sind die mit macOS installierten; öffne eine mit `man <name>` im Terminal.

## Verwandte Anleitungen

- [Ein Container erreicht localhost auf dem Mac nicht](https://kilobat.app/de/guides/localhost-from-container.html): Jeder Container hat seinen eigenen Netzwerk-Stack.
- [Port auf dem Mac bereits belegt](https://kilobat.app/de/guides/port-already-in-use.html): Auf einem TCP-Port und einer Adresse kann nur ein Prozess lauschen.
- [Herausfinden, warum eine Website oder API keine Verbindung bekommt](https://kilobat.app/de/guides/recipes/why-cant-it-connect.html): Funktioniert das Internet, aber eine Adresse nicht, prüft Kilobat jede Schicht der Reihe nach.
- [Port 5000 oder 7000 auf dem Mac belegt: AirPlay-Empfänger](https://kilobat.app/de/guides/airplay-receiver-port-5000.html): Apple führt die TCP-Ports 5000 und 7000 für AirPlay.