feat: 实现管理后台端管理接口(A2)

This commit is contained in:
Nixevol
2026-09-30 07:46:03 +08:00
parent 653b0d1866
commit 63b09beead
6 changed files with 1705 additions and 16 deletions
+18 -12
View File
@@ -36,6 +36,8 @@ type Deps struct {
SessionTTL time.Duration
// SecureCookies 为 true 时 Cookie 始终带 Secure;否则按请求是否 HTTPS 决定。
SecureCookies bool
// KickEndpoint 踢下线钩子(只断开连接);nil 时踢线为 no-op。
KickEndpoint EndpointKickFunc
}
// Handler 是可挂载的管理接口(路由前缀 /api/admin/)。
@@ -48,6 +50,7 @@ type Handler struct {
trusted []*net.IPNet
ttl time.Duration
forceSec bool
kick EndpointKickFunc
mux *http.ServeMux
@@ -76,6 +79,7 @@ func New(d Deps) *Handler {
trusted: d.TrustedProxies,
ttl: ttl,
forceSec: d.SecureCookies,
kick: d.KickEndpoint,
mux: http.NewServeMux(),
lastUsed: make(map[string]time.Time),
}
@@ -103,7 +107,20 @@ func (h *Handler) routes() {
h.mux.Handle("PATCH /api/admin/tokens/{id}", h.auth(h.handleTokenPatch))
h.mux.Handle("DELETE /api/admin/tokens/{id}", h.auth(h.handleTokenDelete))
// 其余管理路由:鉴权生效,业务暂 501
// A2 端管理
h.mux.Handle("GET /api/admin/endpoints", h.auth(h.handleEndpointList))
h.mux.Handle("POST /api/admin/endpoints", h.auth(h.handleEndpointCreate))
h.mux.Handle("POST /api/admin/endpoints/import", h.auth(h.handleEndpointImport))
h.mux.Handle("POST /api/admin/endpoints/batch", h.auth(h.handleEndpointBatch))
h.mux.Handle("GET /api/admin/endpoints/{id}", h.auth(h.handleEndpointGet))
h.mux.Handle("PATCH /api/admin/endpoints/{id}", h.auth(h.handleEndpointPatch))
h.mux.Handle("DELETE /api/admin/endpoints/{id}", h.auth(h.handleEndpointDelete))
h.mux.Handle("POST /api/admin/endpoints/{id}/kick", h.auth(h.handleEndpointKick))
h.mux.Handle("POST /api/admin/endpoints/{id}/reset-login-password", h.auth(h.handleEndpointResetLoginPassword))
h.mux.Handle("PUT /api/admin/endpoints/{id}/talk-password", h.auth(h.handleEndpointTalkPassword))
h.mux.Handle("POST /api/admin/endpoints/{id}/unlock", h.auth(h.handleEndpointUnlock))
// 其余管理路由:鉴权生效,业务暂 501(A3)
for _, p := range stubRoutes {
h.mux.Handle(p, h.auth(h.handleNotImplemented))
}
@@ -111,17 +128,6 @@ func (h *Handler) routes() {
var stubRoutes = []string{
"GET /api/admin/overview",
"GET /api/admin/endpoints",
"POST /api/admin/endpoints",
"POST /api/admin/endpoints/import",
"POST /api/admin/endpoints/batch",
"GET /api/admin/endpoints/{id}",
"PATCH /api/admin/endpoints/{id}",
"DELETE /api/admin/endpoints/{id}",
"POST /api/admin/endpoints/{id}/kick",
"POST /api/admin/endpoints/{id}/reset-login-password",
"PUT /api/admin/endpoints/{id}/talk-password",
"POST /api/admin/endpoints/{id}/unlock",
"GET /api/admin/registration",
"PUT /api/admin/registration",
"GET /api/admin/groups",