免登录接口必须显式放行,白名单仅包含明确无需认证的少数端点,如/healthz、/login、/public/**、/webhook/stripe等,严禁将业务接口(如/api/v1/users)纳入;推荐分组路由设计,白名单路由单独分组不挂认证中间件,确保路径、方法、IP三维度精确匹配与最小必要放行。

免登录接口必须显式放行,不能靠“不在黑名单里就放行”这种逻辑——白名单是精确匹配,漏一条路径就可能引发未授权访问。
哪些路由该放进白名单?
白名单不是“所有 GET 接口”,而是明确知道无需认证的少数几个端点。常见场景包括:
-
/healthz、/readyz这类探针接口 -
/login、/register、/forgot-password等认证流程入口 -
/public/*下的静态资源或公开文档(如/public/swagger.json) - 第三方回调地址,比如
/webhook/stripe,必须确认来源 IP 已受控
别把 /api/v1/users 这种业务接口加进去——它应该走 JWT 或 Key Auth 中间件校验,白名单里只放真正“裸奔也安全”的路径。
用 echo.Group 配合中间件做分组白名单
最干净的做法是把免登录路由单独分组,不套认证中间件:
e := echo.New()
// 白名单分组:不挂任何认证中间件
public := e.Group("/api")
public.GET("/health", healthHandler)
public.POST("/login", loginHandler)
public.POST("/register", registerHandler)
// 认证分组:挂 JWT 中间件
protected := e.Group("/api/v1")
protected.Use(echojwt.JWT([]byte("your-secret")))
protected.GET("/users", listUsersHandler)
protected.PUT("/users/:id", updateUserHandler)
这样结构清晰,不会出现“某个路由被多个中间件叠加影响”的混乱。注意:/api 和 /api/v1 是两个独立前缀,/api/v1 不会继承 /api 的中间件。
用自定义中间件实现路径级白名单判断
如果必须在全局中间件里做放行(比如统一鉴权逻辑),就别硬编码 if path == "/login",而要用标准匹配:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 用
strings.HasPrefix(c.Request().URL.Path, "/public/")处理前缀 - 用
echo.RouteName()或c.Request().Method + " " + c.Request().URL.Path做完整匹配(避免/loginx被误放) - 白名单列表建议定义为
map[string]struct{},查表 O(1),别用切片遍历 - 千万别用
strings.Contains()判断路径——/admin/login会被/login白名单意外放过
示例片段:
var publicPaths = map[string]struct{}{
"GET /health": {},
"POST /login": {},
"POST /register": {},
"GET /public/docs": {},
}
e.Use(func(next echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
method := c.Request().Method
path := c.Request().URL.Path
key := method + " " + path
if _, ok := publicPaths[key]; ok {
return next(c)
}
// 其他路径走 JWT 校验
return echojwt.JWT([]byte("secret"))(next)(c)
}
})
CIDR 白名单要配合 net.IPNet 做精确网段判断
如果白名单还涉及 IP 段(比如只允许内网调用 /metrics),就不能只比对字符串:
- 用
net.ParseCIDR("10.0.0.0/8")解析网段 - 用
ipNet.Contains(clientIP)判断,而不是strings.HasPrefix(ipStr, "10.") - 获取真实客户端 IP 要注意 X-Forwarded-For 和 X-Real-IP 头,Echo 默认不自动解析,得自己写逻辑或启用
middleware.ProxyHeaders() - IPv6 地址要统一转成
net.IP再比,别直接字符串比较
这个环节最容易出错:看似放行了 192.168.1.0/24,结果因为没处理代理头,拿到的是负载均衡器 IP,整条链路就失效了。
白名单的本质是“最小必要放行”,路径、方法、IP 三个维度都得卡死。多写一行配置,少一个漏洞;少一次字符串误判,多一分生产环境安全感。










