caddy-master.zip_Linux https server_golang

<p align="center"> <a href="https://caddyserver.com"><img src="https://user-images.githubusercontent.com/1128849/36338535-05fb646a-136f-11e8-987b-e6901e717d5a.png" alt="Caddy" width="450"></a> </p> <h3 align="center">Every Site on HTTPS <!-- Serve Confidently --></h3> <p align="center">Caddy is a general-purpose HTTP/2 web server that serves HTTPS by default.</p> <p align="center"> <a href="https://dev.azure.com/mholt-dev/Caddy/_build?definitionId=1"><img src="https://img.shields.io/azure-devops/build/mholt-dev/afec6074-9842-457f-98cf-69df6adbbf2e/1/master.svg?label=cross-platform%20tests"></a> <a href="https://godoc.org/github.com/mholt/caddy"><img src="https://img.shields.io/badge/godoc-reference-blue.svg"></a> <a href="https://goreportcard.com/report/mholt/caddy"><img src="https://goreportcard.com/badge/github.com/mholt/caddy"></a> <br> <a href="https://twitter.com/caddyserver" title="@caddyserver on Twitter"><img src="https://img.shields.io/badge/twitter-@caddyserver-55acee.svg" alt="@caddyserver on Twitter"></a> <a href="https://caddy.community" title="Caddy Forum"><img src="https://img.shields.io/badge/community-forum-ff69b4.svg" alt="Caddy Forum"></a> <a href="https://sourcegraph.com/github.com/mholt/caddy?badge" title="Caddy on Sourcegraph"><img src="https://sourcegraph.com/github.com/mholt/caddy/-/badge.svg" alt="Caddy on Sourcegraph"></a> </p> <p align="center"> <a href="https://caddyserver.com/download">Download</a> · <a href="https://caddyserver.com/docs">Documentation</a> · <a href="https://caddy.community">Community</a> </p> --- Caddy is a **production-ready** open-source web server that is fast, easy to use, and makes you more productive. Available for Windows, Mac, Linux, BSD, Solaris, and [Android](https://github.com/mholt/caddy/wiki/Running-Caddy-on-Android). <p align="center"> <b>Thanks to our special sponsor:</b> <br><br> <a href="https://relicabackup.com"><img src="https://caddyserver.com/resources/images/sponsors/relica.png" width="220" alt="Relica - Cross-platform file backup to the cloud, local disks, or other computers"></a> </p> ## Menu - [Features](#features) - [Install](#install) - [Quick Start](#quick-start) - [Running in Production](#running-in-production) - [Contributing](#contributing) - [Donors](#donors) - [About the Project](#about-the-project) ## Features - **Easy configuration** with the Caddyfile - **Automatic HTTPS** on by default (via [Let's Encrypt](https://letsencrypt.org)) - **HTTP/2** by default - **Virtual hosting** so multiple sites just work - Experimental **QUIC support** for cutting-edge transmissions - TLS session ticket **key rotation** for more secure connections - **Extensible with plugins** because a convenient web server is a helpful one - **Runs anywhere** with **no external dependencies** (not even libc) [See a more complete list of features built into Caddy.](https://caddyserver.com/features) On top of all those, Caddy does even more with plugins: choose which plugins you want at [download](https://caddyserver.com/download). Altogether, Caddy can do things other web servers simply cannot do. Its features and plugins save you time and mistakes, and will cheer you up. Your Caddy instance takes care of the details for you! <p align="center"> <b>Powered by</b> <br> <a href="https://github.com/mholt/certmagic"><img src="https://user-images.githubusercontent.com/1128849/49704830-49d37200-fbd5-11e8-8385-767e0cd033c3.png" alt="CertMagic" width="250"></a> </p> ## Install Caddy binaries have no dependencies and are available for every platform. Get Caddy any of these ways: - **[Download page](https://caddyserver.com/download)** (RECOMMENDED) allows you to customize your build in the browser - **[Latest release](https://github.com/mholt/caddy/releases/latest)** for pre-built, vanilla binaries - **[AWS Marketplace](https://aws.amazon.com/marketplace/pp/B07J1WNK75?qid=1539015041932&sr=0-1&ref_=srh_res_product_title&cl_spe=C)** makes it easy to deploy directly to your cloud environment. <a href="https://aws.amazon.com/marketplace/pp/B07J1WNK75?qid=1539015041932&sr=0-1&ref_=srh_res_product_title&cl_spe=C" target="_blank"> <img src="https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png" alt="Get Caddy on the AWS Marketplace" height="25"/></a> ## Build To build from source you need **[Git](https://git-scm.com/downloads)** and **[Go](https://golang.org/doc/install)** (1.12 or newer). **To build Caddy without plugins:** <!-- TODO: This env variable will not be required starting with Go 1.13 --> 1. Set the transitional environment variable for Go modules: `export GO111MODULE=on` 2. Run `go get github.com/mholt/caddy/caddy` Caddy will be installed to your `$GOPATH/bin` folder. With these instructions, the binary will not have embedded version information (see [golang/go#29228](https://github.com/golang/go/issues/29228)), but it is fine for a quick start. **To build Caddy with plugins (and with version information):** There is no need to modify the Caddy code to build it with plugins. We will create a simple Go module with our own `main()` that you can use to make custom Caddy builds. <!-- TODO: This env variable will not be required starting with Go 1.13 --> 1. Set the transitional environment variable for Go modules: `export GO111MODULE=on` 2. Create a new folder anywhere and within create a Go file (extension `.go`) with the contents below, adjusting to import the plugins you want to include: ```go package main import ( "github.com/mholt/caddy/caddy/caddymain" // plug in plugins here, for example: // _ "import/path/here" ) func main() { // optional: disable telemetry // caddymain.EnableTelemetry = false caddymain.Run() } ``` 3. `go mod init caddy` 4. Run `go get github.com/mholt/caddy` 5. `go install` will then create your binary at `$GOPATH/bin`, or `go build` will put it in the current directory. **To install Caddy's source code for development:** <!-- TODO: This env variable will not be required starting with Go 1.13 --> 1. Set the transitional environment variable for Go modules: `export GO111MODULE=on` 2. Run `git clone https://github.com/mholt/caddy.git` in any folder (doesn't have to be in GOPATH). You can make changes to the source code from that clone and checkout any commit or tag you wish to develop on. When building from source, telemetry is enabled by default. You can disable it by changing `caddymain.EnableTelemetry = false` in run.go, or use the `-disabled-metrics` flag at runtime to disable only certain metrics. ## Quick Start To serve static files from the current working directory, run: ``` caddy ``` Caddy's default port is 2015, so open your browser to [http://localhost:2015](http://localhost:2015). ### Go from 0 to HTTPS in 5 seconds If the `caddy` binary has permission to bind to low ports and your domain name's DNS records point to the machine you're on: ``` caddy -host example.com ``` This command serves static files from the current directory over HTTPS. Certificates are automatically obtained and renewed for you! Caddy is also automatically configuring ports 80 and 443 for you, and redirecting HTTP to HTTPS. Cool, huh? ### Customizing your site To customize how your site is served, create a file named Caddyfile by your site and paste this into it: ```plain localhost push browse websocket /echo cat ext .html log /var/log/access.log proxy /api 127.0.0.1:7005 header /api Access-Control-Allow-Origin * ``` When you run `caddy` in that directory, it will automatically find and use that Caddyfile. This simple file enables server push (via Link headers), allows directory browsing (for folders without an index file), hosts a WebSocket echo server at /echo, serves clean URLs, logs requests to an access log, proxies all API requests to a backend on port 7005, and adds the coveted `Access-Control-Allow-Origin: *` header for all responses from the API. Wow! Caddy can do a lot with just a few