推荐开源项目：Go语言CORS中间件 - go-chi/cors

2024-05-24 23:32:20作者：平淮齐Percy

cors

CORS net/http middleware for Go

在构建Web应用时，跨域资源共享（CORS）是一个不可避免的话题。它允许浏览器访问原本因同源策略限制而不能访问的资源。为了帮助开发者轻松处理CORS相关的预检请求，我们今天向您推荐一个强大的Go语言CORS中间件库——go-chi/cors，它是对知名库github.com/rs/cors的一个优化版本。

1、项目介绍

go-chi/cors 是专为chi路由器设计的net/http兼容中间件。这个中间件可以方便地对服务器端进行预飞行CORS检查，确保符合 Fetch API 的要求。由于其设计特性，go-chi/cors 应该作为 chi 路由器的顶级中间件使用。

2、项目技术分析

go-chi/cors 提供了一套完整的配置选项，包括：

AllowedOrigins：指定允许的源，可以是特定域名或通配符。
AllowedMethods：定义允许的HTTP方法。
AllowedHeaders：设置允许客户端发送的头部字段。
ExposedHeaders：暴露给客户端的响应头。
AllowCredentials：如果为真，允许发送和接收带有认证信息的请求。
MaxAge：预检请求的有效时间。

通过这些参数，您可以灵活控制CORS策略，以适应不同的安全需求和场景。

3、项目及技术应用场景

无论您正在开发一个API服务器，还是构建一个需要跨域数据共享的Web应用，go-chi/cors 都能派上大用场。它可以无缝集成到您的Go Web服务中，确保前端应用能够顺利从其他域获取资源。同时，由于其支持通配符，对于需要对多个源开放的公共API来说，配置更加便捷。

4、项目特点

易用性：只需几行代码，即可快速启用CORS支持。
灵活性：提供多种配置选项，可针对不同场景定制CORS策略。
性能优化：设计为高效运行，避免不必要的资源消耗。
与chi路由完美结合：特别针对chi路由器进行了优化，简化了中间件的使用。

使用示例

安装 go-chi/cors：

go get github.com/go-chi/cors

然后在您的应用中这样使用：

func main() {
  r := chi.NewRouter()

  r.Use(cors.Handler(cors.Options{
    AllowedOrigins:   []string{"https://*", "http://*"},
    AllowedMethods:   []string{"GET", "POST", "PUT", "DELETE", "OPTIONS"},
    AllowedHeaders:   []string{"Accept", "Authorization", "Content-Type", "X-CSRF-Token"},
    ExposedHeaders:   []string{"Link"},
    AllowCredentials: false,
    MaxAge:           300,
  }))

  r.Get("/", func(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("welcome"))
  })

  http.ListenAndServe(":3000", r)
}