refactor: 拆分 middleware/router 为单一职责文件,新增站点设置管理页面

middleware:
- 拆分 auth.go → auth.go + auth_token.go + auth_parser.go + auth_admin.go
- 拆分 csrf.go → csrf.go + csrf_token.go
- 拆分 ratelimit.go → ratelimit.go + ratelimit_core.go + ratelimit_cleanup.go
- 修复 import 未使用/缺失问题

router:
- 拆分 router.go → admin.go + api.go + frontend.go + deps_core.go + deps_extra.go

feat(admin): 站点设置管理页面
- 新增 SSR 页面 /admin/site-settings(仅 Owner)
- 审核开关 Toggle 即时保存
- 通用设置展示
- 侧边栏新增站点设置入口
- 注册 UpdateBoolSetting/GetBoolSetting API 路由
This commit is contained in:
2026-05-27 15:03:04 +08:00
parent a19b1fcb51
commit 7bc2dbd970
20 changed files with 774 additions and 446 deletions

View File

@ -1,8 +1,6 @@
package middleware
import (
"crypto/rand"
"encoding/hex"
"net/http"
"metazone.cc/metalab/internal/config"
@ -14,15 +12,11 @@ const (
csrfCookieName = "mlb_csrf"
csrfHeaderName = "X-CSRF-Token"
csrfMetaName = "csrf_token"
csrfTokenLen = 32 // 字节
)
// CSRF 中间件Double Submit Cookie 模式
// 前端 JS 从 Cookie 中读取 token 并放入 X-CSRF-Token 请求头,后端验证两者一致
// GET / HEAD / OPTIONS 请求自动放行
func CSRF(cfg *config.Config) gin.HandlerFunc {
return func(c *gin.Context) {
// 安全读取豁免
if c.Request.Method == http.MethodGet ||
c.Request.Method == http.MethodHead ||
c.Request.Method == http.MethodOptions {
@ -39,7 +33,6 @@ func CSRF(cfg *config.Config) gin.HandlerFunc {
}
headerToken := c.GetHeader(csrfHeaderName)
// Fallback如果请求头没有尝试从表单字段读取纯 HTML form 提交通道)
if headerToken == "" {
headerToken = c.PostForm(csrfMetaName)
}
@ -50,7 +43,6 @@ func CSRF(cfg *config.Config) gin.HandlerFunc {
return
}
// 恒定时间比较防时序攻击
if !constantTimeEq(cookieToken, headerToken) {
c.AbortWithStatusJSON(http.StatusForbidden, gin.H{
"success": false, "message": "CSRF 验证失败",
@ -58,55 +50,7 @@ func CSRF(cfg *config.Config) gin.HandlerFunc {
return
}
// 注入到上下文,供前端 <meta> 使用
c.Set(csrfMetaName, cookieToken)
c.Next()
}
}
// SetCSRFToken 在首次页面访问时下发 CSRF Cookie由页面路由中间件调用
// 注意:此 Cookie HttpOnly=falseJS 可读——这是 Double Submit 模式的必要条件
func SetCSRFToken(c *gin.Context, cfg *config.Config) string {
secure := cfg.Server.Mode != "debug"
// 如果已有 token 且未过期,复用(但必须注入 context供模板 meta 标签使用)
if existing, err := c.Cookie(csrfCookieName); err == nil && existing != "" {
c.Set(csrfMetaName, existing)
return existing
}
token, err := generateCSRFToken()
if err != nil {
// 极端情况:随机数生成失败,使用短 token
token = "fallback-" + hex.EncodeToString([]byte("metazone"))
}
c.SetSameSite(http.SameSiteStrictMode)
// 30 天有效期,与 refresh token 对齐
maxAge := int(cfg.JWT.RememberExpire * 3600)
c.SetCookie(csrfCookieName, token, maxAge, "/", "", secure, false)
c.Set(csrfMetaName, token)
return token
}
// generateCSRFToken 生成 64 字符十六进制随机 CSRF token
func generateCSRFToken() (string, error) {
b := make([]byte, csrfTokenLen)
if _, err := rand.Read(b); err != nil {
return "", err
}
return hex.EncodeToString(b), nil
}
// constantTimeEq 恒定时间字符串比较(防时序攻击)
func constantTimeEq(a, b string) bool {
if len(a) != len(b) {
return false
}
var result byte
for i := 0; i < len(a); i++ {
result |= a[i] ^ b[i]
}
return result == 0
}