feat(pages): 认证页与门户页文案可配置,不再写死
需求:登录页与门户页的内容应可自定义。 实现(配置存数据卷、后台可改、留空回落内置默认,不配置行为不变): - pages.go:pageStr 读取 pageInfo;renderPortalPage 优先数据卷 <data>/portal/index.html 整页覆盖,否则用内置模板替换占位符; authPageInfo 提供登录页字段 - auth.go:登录页标题/副标题/徽标/页脚改为模板数据(含备案号) - gateway.go:kind=portal 的首页改由 admin-server /portal-page 渲染 (静态资源仍由 nginx 提供),使文案可配置 - portal/index.html:加入 <!--PAGE_TITLE--> / <!--HERO_TITLE--> / <!--HERO_SUBTITLE--> / <!--FOOTER--> 占位符 - 后台「站点信息」新增六项文案输入(含回填与保存),并提示整页覆盖方式 - README 新增「认证页与门户页文案(可配置,不写死)」含字段表与自检命令 测试:默认回落、配置取值去空白、认证页字段读取、数据卷覆盖优先、空白覆盖忽略。
This commit is contained in:
@ -139,7 +139,7 @@ func safePortalRedirect(raw string) string {
|
||||
|
||||
var portalLoginTemplate = template.Must(template.New("login").Parse(`<!doctype html>
|
||||
<html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
||||
<title>统一门户登录</title>
|
||||
<title>{{.Title}} - 登录</title>
|
||||
<script>(function(){var s=localStorage.getItem('theme');var p=window.matchMedia('(prefers-color-scheme:dark)').matches;document.documentElement.setAttribute('data-theme',s||(p?'dark':'light'))})()</script>
|
||||
<style>
|
||||
/* 深浅色:默认跟随系统(prefers-color-scheme),手动切换后写入 localStorage。
|
||||
@ -161,16 +161,19 @@ button[type=submit]{width:100%;margin-top:18px;padding:11px;border:0;border-radi
|
||||
@media(prefers-reduced-motion:reduce){*{transition:none!important}}
|
||||
</style></head><body><main class="card">
|
||||
<button class="theme" type="button" onclick="(function(){var n=document.documentElement.getAttribute('data-theme')==='dark'?'light':'dark';document.documentElement.setAttribute('data-theme',n);localStorage.setItem('theme',n)})()" title="切换深浅色" aria-label="切换深浅色">◐</button>
|
||||
<div class="logo">JF</div><h1>统一门户</h1><p class="sub">登录后访问受保护的内部服务</p>
|
||||
<div class="logo">{{.Logo}}</div><h1>{{.Title}}</h1><p class="sub">{{.Subtitle}}</p>
|
||||
{{if .Error}}<div class="err">{{.Error}}</div>{{end}}
|
||||
<form method="post" action="/login?redirect={{.Redirect}}"><label for="u">用户名</label><input id="u" name="username" autocomplete="username" required autofocus><label for="p">密码</label><input id="p" type="password" name="password" autocomplete="current-password" required><button type="submit">登录</button></form>
|
||||
<div class="foot"><a href="https://beian.miit.gov.cn" target="_blank" rel="noopener">京ICP备00000000号-1</a></div></main></body></html>`))
|
||||
<div class="foot">{{if .Footer}}{{.Footer}}{{end}}</div></main></body></html>`))
|
||||
|
||||
func renderPortalLogin(w http.ResponseWriter, redirect, errText string) {
|
||||
w.Header().Set("Content-Type", "text/html; charset=utf-8")
|
||||
w.Header().Set("Cache-Control", "no-store")
|
||||
title, subtitle, logo, icp, gongan := authPageInfo()
|
||||
_ = portalLoginTemplate.Execute(w, map[string]string{
|
||||
"Redirect": url.QueryEscape(redirect), "Error": errText,
|
||||
"Title": title, "Subtitle": subtitle, "Logo": logo,
|
||||
"Footer": beianFooter(icp, gongan),
|
||||
})
|
||||
}
|
||||
|
||||
|
||||
@ -877,6 +877,13 @@ func handlePageInfo(w http.ResponseWriter, r *http.Request) {
|
||||
ICP *string `json:"icp"`
|
||||
Gongan *string `json:"gongan"`
|
||||
NavLinks *[]map[string]any `json:"navLinks"`
|
||||
// 认证页与门户页的可配置文案(原先写死在代码/镜像里)
|
||||
AuthTitle *string `json:"authTitle"`
|
||||
AuthSubtitle *string `json:"authSubtitle"`
|
||||
AuthLogo *string `json:"authLogo"`
|
||||
PortalTitle *string `json:"portalTitle"`
|
||||
HeroTitle *string `json:"heroTitle"`
|
||||
HeroSubtitle *string `json:"heroSubtitle"`
|
||||
}
|
||||
if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
|
||||
jsonErr(w, 400, err.Error())
|
||||
@ -901,7 +908,23 @@ func handlePageInfo(w http.ResponseWriter, r *http.Request) {
|
||||
// 页脚为空(留空 = 交给模板)时,按备案号重新生成。
|
||||
if strings.TrimSpace(mapString(cfg.PageInfo, "footer")) == "" {
|
||||
cfg.PageInfo["footer"] = beianFooter(mapString(cfg.PageInfo, "icp"), mapString(cfg.PageInfo, "gongan"))
|
||||
} // 认证页 / 门户页文案:空串表示回落到内置默认值
|
||||
setPageStr := func(k string, v *string) {
|
||||
if v != nil {
|
||||
if strings.TrimSpace(*v) == "" {
|
||||
delete(cfg.PageInfo, k)
|
||||
} else {
|
||||
cfg.PageInfo[k] = strings.TrimSpace(*v)
|
||||
}
|
||||
}
|
||||
}
|
||||
setPageStr("authTitle", body.AuthTitle)
|
||||
setPageStr("authSubtitle", body.AuthSubtitle)
|
||||
setPageStr("authLogo", body.AuthLogo)
|
||||
setPageStr("portalTitle", body.PortalTitle)
|
||||
setPageStr("heroTitle", body.HeroTitle)
|
||||
setPageStr("heroSubtitle", body.HeroSubtitle)
|
||||
|
||||
if body.NavLinks != nil {
|
||||
cfg.PageInfo["navLinks"] = *body.NavLinks
|
||||
}
|
||||
@ -1206,6 +1229,8 @@ func main() {
|
||||
http.HandleFunc("/api/gateway/import", cors(handleGatewayImport))
|
||||
// 统一登录的账号设置(存数据卷,改完立即生效,不用重新部署)
|
||||
http.HandleFunc("/api/portal-auth", cors(handlePortalAuthSettings))
|
||||
// 门户首页渲染(可配置文案 + 数据卷整页覆盖),供 gateway 的 kind=portal 反代
|
||||
http.HandleFunc("/portal-page", handlePortalPage)
|
||||
// 历史记录管理:列表 / 清空全部 / 删除单条
|
||||
http.HandleFunc("/api/history", cors(func(w http.ResponseWriter, r *http.Request) {
|
||||
switch r.Method {
|
||||
|
||||
89
admin-server/pages.go
Normal file
89
admin-server/pages.go
Normal file
@ -0,0 +1,89 @@
|
||||
package main
|
||||
|
||||
import (
|
||||
"html"
|
||||
"net/http"
|
||||
"os"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
)
|
||||
|
||||
// ── 认证页 / 门户页的可配置渲染 ──
|
||||
//
|
||||
// 原先这两页的文案写死在代码与镜像里(登录页标题、门户页标题/副标题/页脚…),
|
||||
// 改一次就得改代码重新部署。现在统一从 conf.yml 的 pageInfo 读取,
|
||||
// 缺省时回落到当前默认文案(即"不配置也照旧")。
|
||||
//
|
||||
// 覆盖优先级(门户页):
|
||||
// 1. <data>/portal/index.html —— 完全自定义整页(放进去即生效)
|
||||
// 2. 内置模板 + pageInfo 字段替换
|
||||
//
|
||||
// 门户页的静态资源(/css/portal.css、favicon)仍由 nginx 提供,
|
||||
// 因此自定义整页时把它们放在 <data>/portal/ 下即可覆盖。
|
||||
|
||||
const (
|
||||
defaultPortalTitle = "JianF Git - 个人开发环境"
|
||||
defaultPortalHero = "代码、博客与灵感之站"
|
||||
defaultPortalHeroSub = "JianF Git · 代码托管 · 技术博客 · 私有服务入口"
|
||||
defaultAuthTitle = "统一门户"
|
||||
defaultAuthSubtitle = "登录后访问受保护的内部服务"
|
||||
defaultAuthLogo = "JF"
|
||||
)
|
||||
|
||||
// pageStr 读取 pageInfo 中的字符串,缺失时用兜底值。
|
||||
func pageStr(info map[string]any, key, fallback string) string {
|
||||
if v := strings.TrimSpace(mapString(info, key)); v != "" {
|
||||
return v
|
||||
}
|
||||
return fallback
|
||||
}
|
||||
|
||||
// portalOverridePath 数据卷里的整页覆盖文件。
|
||||
func portalOverridePath() string {
|
||||
return filepath.Join(filepath.Dir(confFile), "portal", "index.html")
|
||||
}
|
||||
|
||||
// renderPortalPage 渲染门户首页:优先数据卷覆盖,其次内置模板 + pageInfo 替换。
|
||||
func renderPortalPage() []byte {
|
||||
if b, err := os.ReadFile(portalOverridePath()); err == nil && len(strings.TrimSpace(string(b))) > 0 {
|
||||
return b
|
||||
}
|
||||
builtin, err := os.ReadFile("/app/portal/index.html")
|
||||
if err != nil {
|
||||
return []byte("<!doctype html><meta charset=utf-8><title>Portal</title><h1>Portal</h1>")
|
||||
}
|
||||
cfg, _ := loadConfig()
|
||||
info := map[string]any{}
|
||||
if cfg != nil {
|
||||
info = cfg.PageInfo
|
||||
}
|
||||
rep := strings.NewReplacer(
|
||||
"<!--PAGE_TITLE-->", html.EscapeString(pageStr(info, "portalTitle", defaultPortalTitle)),
|
||||
"<!--HERO_TITLE-->", html.EscapeString(pageStr(info, "heroTitle", defaultPortalHero)),
|
||||
"<!--HERO_SUBTITLE-->", html.EscapeString(pageStr(info, "heroSubtitle", defaultPortalHeroSub)),
|
||||
"<!--FOOTER-->", beianFooter(mapString(info, "icp"), mapString(info, "gongan")),
|
||||
)
|
||||
out := rep.Replace(string(builtin))
|
||||
// 未做占位替换的旧模板(例如自备的 index.html)原样返回
|
||||
return []byte(out)
|
||||
}
|
||||
|
||||
// handlePortalPage 供 nginx 的 kind=portal 路由反代使用。
|
||||
func handlePortalPage(w http.ResponseWriter, r *http.Request) {
|
||||
w.Header().Set("Content-Type", "text/html; charset=utf-8")
|
||||
w.Header().Set("Cache-Control", "no-store")
|
||||
_, _ = w.Write(renderPortalPage())
|
||||
}
|
||||
|
||||
// authPageInfo 返回登录页所需字段(供 auth.go 渲染)。
|
||||
func authPageInfo() (title, subtitle, logo, icp, gongan string) {
|
||||
cfg, err := loadConfig()
|
||||
info := map[string]any{}
|
||||
if err == nil && cfg != nil {
|
||||
info = cfg.PageInfo
|
||||
}
|
||||
return pageStr(info, "authTitle", defaultAuthTitle),
|
||||
pageStr(info, "authSubtitle", defaultAuthSubtitle),
|
||||
pageStr(info, "authLogo", defaultAuthLogo),
|
||||
mapString(info, "icp"), mapString(info, "gongan")
|
||||
}
|
||||
67
admin-server/pages_test.go
Normal file
67
admin-server/pages_test.go
Normal file
@ -0,0 +1,67 @@
|
||||
package main
|
||||
|
||||
import (
|
||||
"os"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"testing"
|
||||
)
|
||||
|
||||
// 未配置任何文案时应回落到内置默认值(不配置也照旧)。
|
||||
func TestPageStrFallbacks(t *testing.T) {
|
||||
empty := map[string]any{}
|
||||
if got := pageStr(empty, "authTitle", defaultAuthTitle); got != defaultAuthTitle {
|
||||
t.Fatalf("空配置应回落默认,得到 %q", got)
|
||||
}
|
||||
info := map[string]any{"authTitle": " 内网入口 ", "heroTitle": ""}
|
||||
if got := pageStr(info, "authTitle", defaultAuthTitle); got != "内网入口" {
|
||||
t.Fatalf("应取配置值并去空白,得到 %q", got)
|
||||
}
|
||||
// 空串视为未配置
|
||||
if got := pageStr(info, "heroTitle", defaultPortalHero); got != defaultPortalHero {
|
||||
t.Fatalf("空串应回落默认,得到 %q", got)
|
||||
}
|
||||
}
|
||||
|
||||
// 认证页字段从 pageInfo 读取,缺失时回落。
|
||||
func TestAuthPageInfoFallback(t *testing.T) {
|
||||
dir := t.TempDir()
|
||||
old := confFile
|
||||
confFile = filepath.Join(dir, "conf.yml")
|
||||
defer func() { confFile = old }()
|
||||
if err := os.WriteFile(confFile, []byte("pageInfo:\n authTitle: 我的门户\n authLogo: AB\n"), 0o644); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
title, subtitle, logo, _, _ := authPageInfo()
|
||||
if title != "我的门户" || logo != "AB" {
|
||||
t.Fatalf("未读到配置值: %q %q", title, logo)
|
||||
}
|
||||
if subtitle != defaultAuthSubtitle {
|
||||
t.Fatalf("未配置的字段应回落默认,得到 %q", subtitle)
|
||||
}
|
||||
}
|
||||
|
||||
// 数据卷里的整页覆盖优先于内置模板。
|
||||
func TestPortalOverrideWins(t *testing.T) {
|
||||
dir := t.TempDir()
|
||||
old := confFile
|
||||
confFile = filepath.Join(dir, "conf.yml")
|
||||
defer func() { confFile = old }()
|
||||
if err := os.MkdirAll(filepath.Join(dir, "portal"), 0o755); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
custom := "<!doctype html><title>我的门户</title>"
|
||||
if err := os.WriteFile(filepath.Join(dir, "portal", "index.html"), []byte(custom), 0o644); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
if got := string(renderPortalPage()); !strings.Contains(got, "我的门户") {
|
||||
t.Fatalf("数据卷覆盖未生效: %q", got)
|
||||
}
|
||||
// 空白覆盖文件应被忽略(回落到内置渲染)
|
||||
if err := os.WriteFile(filepath.Join(dir, "portal", "index.html"), []byte(" \n"), 0o644); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
if got := string(renderPortalPage()); strings.Contains(got, "我的门户") {
|
||||
t.Fatalf("空白覆盖文件应被忽略")
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user