auto-tls Auto TLS 原文:https://echo.labstack.com/docs/cookbook/auto-tls
This recipe demonstrates how to obtain TLS certificates for a domain automatically from Let’s Encrypt. Echo#StartAutoTLS
accepts an address which should listen on port 443
.
Browse to https://<DOMAIN>
. If everything goes fine, you should see a welcome message with TLS enabled on the website.
TIP
Server cookbook/auto-tls/server.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
package main
import (
"crypto/tls"
"golang.org/x/crypto/acme"
"net/http"
"github.com/labstack/echo/v4"
"github.com/labstack/echo/v4/middleware"
"golang.org/x/crypto/acme/autocert"
)
func main () {
e := echo . New ()
// e.AutoTLSManager.HostPolicy = autocert.HostWhitelist("<DOMAIN>")
// Cache certificates to avoid issues with rate limits (https://letsencrypt.org/docs/rate-limits)
e . AutoTLSManager . Cache = autocert . DirCache ( "/var/www/.cache" )
e . Use ( middleware . Recover ())
e . Use ( middleware . Logger ())
e . GET ( "/" , func ( c echo . Context ) error {
return c . HTML ( http . StatusOK , `
<h1>Welcome to Echo!</h1>
<h3>TLS certificates automatically installed from Let's Encrypt :)</h3>
` )
})
e . Logger . Fatal ( e . StartAutoTLS ( ":443" ))
}
func customHTTPServer () {
e := echo . New ()
e . Use ( middleware . Recover ())
e . Use ( middleware . Logger ())
e . GET ( "/" , func ( c echo . Context ) error {
return c . HTML ( http . StatusOK , `
<h1>Welcome to Echo!</h1>
<h3>TLS certificates automatically installed from Let's Encrypt :)</h3>
` )
})
autoTLSManager := autocert . Manager {
Prompt : autocert . AcceptTOS ,
// Cache certificates to avoid issues with rate limits (https://letsencrypt.org/docs/rate-limits)
Cache : autocert . DirCache ( "/var/www/.cache" ),
//HostPolicy: autocert.HostWhitelist("<DOMAIN>"),
}
s := http . Server {
Addr : ":443" ,
Handler : e , // set Echo as handler
TLSConfig : & tls . Config {
//Certificates: nil, // <-- s.ListenAndServeTLS will populate this field
GetCertificate : autoTLSManager . GetCertificate ,
NextProtos : [] string { acme . ALPNProto },
},
//ReadTimeout: 30 * time.Second, // use custom timeouts
}
if err := s . ListenAndServeTLS ( "" , "" ); err != http . ErrServerClosed {
e . Logger . Fatal ( err )
}
}