1Caddy(8)                                                              Caddy(8)
2
3
4

NAME

6       caddy-reverse-proxy - A quick and production-ready reverse proxy
7
8
9

SYNOPSIS

11       caddy reverse-proxy [flags]
12
13
14

DESCRIPTION

16       A  simple  but production-ready reverse proxy. Useful for quick deploy‐
17       ments, demos, and development.
18
19
20       Simply shuttles HTTP(S) traffic from the --from address to the --to ad‐
21       dress.  Multiple --to addresses may be specified by repeating the flag.
22
23
24       Unless otherwise specified in the addresses, the --from address will be
25       assumed to be HTTPS if a hostname is given, and the --to  address  will
26       be assumed to be HTTP.
27
28
29       If the --from address has a host or IP, Caddy will attempt to serve the
30       proxy over HTTPS with a certificate  (unless  overridden  by  the  HTTP
31       scheme or port).
32
33
34       If serving HTTPS:
35         --disable-redirects can be used to avoid binding to the HTTP port.
36         --internal-certs can be used to force issuance certs using the inter‐
37       nal
38           CA instead of attempting to issue a public certificate.
39
40
41       For proxying:
42         --header-up can be used to set a request header to send  to  the  up‐
43       stream.
44         --header-down  can  be  used to set a response header to send back to
45       the client.
46         --change-host-header sets the Host header on the request to  the  ad‐
47       dress
48           of the upstream, instead of defaulting to the incoming Host header.
49            This is a shortcut for --header-up "Host:  {http.reverse_proxy.up‐
50       stream.hostport}".
51         --insecure disables TLS verification with the upstream. WARNING: THIS
52           DISABLES SECURITY BY NOT VERIFYING THE UPSTREAM'S CERTIFICATE.
53
54
55

OPTIONS

57       --access-log[=false]      Enable the access log
58
59
60       -c,  --change-host-header[=false]       Set upstream Host header to ad‐
61       dress of upstream
62
63
64       -v, --debug[=false]      Enable verbose debug logs
65
66
67       -r, --disable-redirects[=false]      Disable HTTP->HTTPS redirects
68
69
70       -f, --from="localhost"      Address on which to receive traffic
71
72
73       -d, --header-down=[]      Set a response header to  send  back  to  the
74       client (format: "Field: value")
75
76
77       -H,  --header-up=[]       Set  a request header to send to the upstream
78       (format: "Field: value")
79
80
81       -h, --help[=false]      help for reverse-proxy
82
83
84       --insecure[=false]      Disable TLS verification (WARNING: DISABLES SE‐
85       CURITY BY NOT VERIFYING TLS CERTIFICATES!)
86
87
88       -i, --internal-certs[=false]      Use internal CA for issuing certs
89
90
91       -t, --to=[]      Upstream address(es) to which traffic should be sent
92
93
94

SEE ALSO

96       caddy(8)
97
98
99

HISTORY

101       30-Oct-2023 Auto generated by spf13/cobra
102
103
104
105Auto generated by spf13/cobra      Oct 2023                           Caddy(8)