42 lines
1.1 KiB
Markdown
42 lines
1.1 KiB
Markdown
---
|
||
title: "DockerHostNetworking"
|
||
type: concept
|
||
tags:
|
||
- "docker"
|
||
- "networking"
|
||
- "container"
|
||
sources: []
|
||
last_updated: 2026-04-20
|
||
---
|
||
|
||
## Overview
|
||
|
||
DockerHostNetworking 是 Docker 容器访问宿主机网络服务的方式。默认情况下，容器内的 `localhost` 指向容器自身而非宿主机，因此需要特殊配置才能让容器访问运行在宿主机上的服务。
|
||
|
||
## Why It Matters for Hermes Agent + Open WebUI
|
||
|
||
Open WebUI 运行在 Docker 容器中，Hermes Agent API Server 运行在宿主机上（端口 8642）。容器内必须通过特殊方式访问宿主机端口。
|
||
|
||
## Options
|
||
|
||
### Option 1: host.docker.internal（推荐 macOS/Windows）
|
||
```bash
|
||
docker run --add-host=host.docker.internal:host-gateway ...
|
||
# 访问：http://host.docker.internal:8642/v1
|
||
```
|
||
|
||
### Option 2: Host Networking（Linux）
|
||
```bash
|
||
docker run --network=host ...
|
||
# 访问：http://localhost:8642/v1
|
||
```
|
||
|
||
### Option 3: Docker Bridge IP
|
||
```bash
|
||
# 先查询：docker inspect bridge | grep Gateway
|
||
docker run -e OPENAI_API_BASE_URL=http://172.17.0.1:8642/v1 ...
|
||
```
|
||
|
||
## See Also
|
||
- [[open-webui-hermes-agent]]
|