mirror of
https://github.com/caddyserver/website.git
synced 2025-04-22 13:06:16 -04:00
7819a84e59
* docs: Changes for v2.5.2 release * docs: Remove -X POST Curl automatically uses POST for -d and --data-binary. I intentionally left it in to be explicit to learners, but maybe best practices are better. * api: /adapt endpoint and Etag usage * api: Minor tweaks * Alright fine * Clarify Etag usage * CEL embedded matchers * Oops * Lots more adjustments Co-authored-by: Francis Lavoie <lavofr@gmail.com>
41 lines
1.2 KiB
Markdown
41 lines
1.2 KiB
Markdown
---
|
|
title: bind (Caddyfile directive)
|
|
---
|
|
|
|
# bind
|
|
|
|
Overrides the interface to which the server's socket should bind. Normally, the listener binds to the empty (wildcard) interface. However, you may force the listener to bind to another hostname or IP instead. (This directive accepts only a host, not a port.)
|
|
|
|
Note that binding sites inconsistently may result in unintended consequences. For example, if two sites on the same port resolve to `127.0.0.1` and only one of those sites is configured with `bind 127.0.0.1`, then only one site will be accessible since the other will bind to the port without a specific host; the OS will choose the more specific matching socket. (Virtual hosts are not shared across different listeners.)
|
|
|
|
`bind` accepts [network addresses](/docs/conventions#network-addresses), but may not include a port.
|
|
|
|
|
|
## Syntax
|
|
|
|
```caddy-d
|
|
bind <hosts...>
|
|
```
|
|
|
|
- **<hosts...>** is the list of host interfaces to bind which to bind the listener.
|
|
|
|
|
|
## Examples
|
|
|
|
To make a socket accessible only on the current machine, bind to the loopback interface (localhost):
|
|
|
|
```caddy-d
|
|
bind 127.0.0.1
|
|
```
|
|
|
|
To include IPv6:
|
|
|
|
```caddy-d
|
|
bind 127.0.0.1 [::1]
|
|
```
|
|
|
|
To bind to a Unix domain socket at `/run/caddy`:
|
|
|
|
```caddy-d
|
|
bind unix//run/caddy
|
|
```
|