// Package storefrontshell turns the built SPA index.html into a per-host HTML // shell. Tenant names, icons and SEO tags are resolved on the server so that // crawlers and link previews do not see the main-site brand on tenant domains. package storefrontshell import ( "bytes" "context" "crypto/sha256" "encoding/hex" "encoding/json" "fmt" "html" "io" "net/http" "regexp" "strings" "sync" "time" "go.uber.org/zap" ) const ( maxShellBytes = 2 << 20 shellCacheTTL = 3 * time.Second ) var ( shellPlaceholderPattern = regexp.MustCompile(`(?is)]*>`) fallbackIconLinkPattern = regexp.MustCompile(`(?is)]*id=["']site-(?:apple-touch-)?icon["'][^>]*>\s*`) titlePattern = regexp.MustCompile(`(?is).*?`) headPattern = regexp.MustCompile(`(?is)]*>`) ) // Provider fetches and caches the built index.html from Caddy's internal // storefront-shell endpoint. The endpoint serves the exact artifact that Caddy // is serving, so asset hashes always stay in sync with the frontend build. type Provider struct { url string client *http.Client logger *zap.Logger ttl time.Duration mu sync.RWMutex body []byte etag string fetchedAt time.Time } func NewProvider(url string, logger *zap.Logger) *Provider { return &Provider{ url: strings.TrimSpace(url), client: &http.Client{Timeout: 3 * time.Second}, logger: logger, ttl: shellCacheTTL, } } func (p *Provider) Get(ctx context.Context) ([]byte, error) { if p == nil || p.url == "" { return nil, fmt.Errorf("storefront shell url is empty") } p.mu.RLock() body := append([]byte(nil), p.body...) etag := p.etag fetchedAt := p.fetchedAt p.mu.RUnlock() if len(body) > 0 && time.Since(fetchedAt) < p.ttl { return body, nil } req, err := http.NewRequestWithContext(ctx, http.MethodGet, p.url, nil) if err != nil { return nil, err } if etag != "" { req.Header.Set("If-None-Match", etag) } resp, err := p.client.Do(req) if err != nil { if len(body) > 0 { p.warn("读取前台 HTML 模板失败,使用上次缓存", err) return body, nil } return nil, err } defer resp.Body.Close() switch resp.StatusCode { case http.StatusNotModified: if len(body) == 0 { return nil, fmt.Errorf("storefront shell returned 304 without cache") } p.mu.Lock() p.fetchedAt = time.Now() p.mu.Unlock() return body, nil case http.StatusOK: data, readErr := io.ReadAll(io.LimitReader(resp.Body, maxShellBytes)) if readErr != nil { if len(body) > 0 { p.warn("读取前台 HTML 模板失败,使用上次缓存", readErr) return body, nil } return nil, readErr } if len(bytes.TrimSpace(data)) == 0 { return nil, fmt.Errorf("storefront shell is empty") } p.mu.Lock() p.body = data p.etag = resp.Header.Get("ETag") p.fetchedAt = time.Now() p.mu.Unlock() return data, nil default: if len(body) > 0 { p.warn(fmt.Sprintf("读取前台 HTML 模板返回 %d,使用上次缓存", resp.StatusCode), nil) return body, nil } return nil, fmt.Errorf("storefront shell status %d", resp.StatusCode) } } func (p *Provider) warn(message string, err error) { if p.logger == nil { return } if err != nil { p.logger.Warn(message, zap.Error(err)) return } p.logger.Warn(message) } // Meta holds the tenant-specific values injected into the HTML shell. type Meta struct { SiteCode string SiteName string Title string Description string Canonical string FaviconURL string AppleIconURL string ThemeColor string OGImageURL string } // BuildMeta derives SEO and brand metadata from the tenant profile. Missing // profile fields fall back to the same defaults used by the SPA. func BuildMeta(profile map[string]any, tenantCode, tenantName, scheme, host, path string) Meta { if profile == nil { profile = map[string]any{} } siteName := firstNonEmpty(stringValue(profile, "site_name"), tenantName, "官方租号平台") title := "官方租号平台" if siteName != "" && !strings.Contains(siteName, "官方租号平台") { title = siteName + " - 官方租号平台" } else if siteName != "" { title = siteName } description := firstNonEmpty(stringValue(profile, "seo_description"), storefrontDescription(profile)) if description == "" { if siteName != "" && siteName != "官方租号平台" { description = siteName + "官方租号平台,精选三角洲行动账号,逐号核验、独立订单与专属售后。" } else { description = "精选三角洲行动账号租赁平台,逐号核验、独立订单与专属售后。" } } favicon, appleIcon, themeColor := fallbackBrand(tenantCode) favicon = safeAssetURL(firstNonEmpty(stringValue(profile, "favicon_url"), favicon)) appleIcon = safeAssetURL(firstNonEmpty(stringValue(profile, "apple_touch_icon_url"), appleIcon)) themeColor = firstNonEmpty(stringValue(profile, "theme_color"), themeColor) ogImage := safeAssetURL(firstNonEmpty(stringValue(profile, "og_image_url"), stringValue(profile, "logo_url"))) ogImage = absoluteURL(scheme, host, ogImage) canonicalPath := path if canonicalPath == "" { canonicalPath = "/" } if !strings.HasPrefix(canonicalPath, "/") { canonicalPath = "/" + canonicalPath } canonical := "" if scheme != "" && host != "" { canonical = scheme + "://" + host + canonicalPath } return Meta{ SiteCode: strings.TrimSpace(tenantCode), SiteName: siteName, Title: title, Description: description, Canonical: canonical, FaviconURL: favicon, AppleIconURL: appleIcon, ThemeColor: themeColor, OGImageURL: ogImage, } } func (m Meta) HTML(includeTitle bool) string { var b strings.Builder if includeTitle { fmt.Fprintf(&b, "%s\n", html.EscapeString(m.Title)) } fmt.Fprintf(&b, ``+"\n") fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.SiteCode)) fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.SiteName)) fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.Description)) fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.ThemeColor)) fmt.Fprintf(&b, ``+"\n") fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.SiteName)) fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.Title)) fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.Description)) if m.Canonical != "" { fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.Canonical)) fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.Canonical)) } if m.OGImageURL != "" { fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.OGImageURL)) } fmt.Fprintf(&b, ``+"\n") if m.FaviconURL != "" { fmt.Fprintf(&b, ``+"\n", iconType(m.FaviconURL), html.EscapeString(m.FaviconURL)) } if m.AppleIconURL != "" { fmt.Fprintf(&b, ``+"\n", html.EscapeString(m.AppleIconURL)) } return b.String() } // Inject replaces the placeholder block in the built index.html. The title is // always replaced separately so the fallback title does not become a duplicate // tag when the server injects description, OG and icon metadata. func Inject(shell []byte, meta Meta) []byte { if len(shell) == 0 { return shell } out := fallbackIconLinkPattern.ReplaceAll(shell, nil) if titlePattern.Match(out) { out = titlePattern.ReplaceAll(out, []byte(""+html.EscapeString(meta.Title)+"")) } if loc := shellPlaceholderPattern.FindIndex(out); loc != nil { block := []byte(meta.HTML(false)) merged := make([]byte, 0, len(out)+len(block)) merged = append(merged, out[:loc[0]]...) merged = append(merged, block...) merged = append(merged, out[loc[1]:]...) return merged } if idx := bytes.Index(out, []byte("")); idx >= 0 { extra := []byte(meta.HTML(false)) // 旧版 HTML 没有占位块时,把注入内容放在 开头, // 确保 site-bootstrap.js 执行前已经能看到 site-shell 标记。 if head := headPattern.FindIndex(out); head != nil { merged := make([]byte, 0, len(out)+len(extra)) merged = append(merged, out[:head[1]]...) merged = append(merged, extra...) merged = append(merged, out[head[1]:]...) return merged } merged := make([]byte, 0, len(out)+len(extra)) merged = append(merged, out[:idx]...) merged = append(merged, extra...) merged = append(merged, out[idx:]...) return merged } return out } // ETag returns a stable validator for the rendered shell. It includes both the // source shell and the tenant metadata so title/profile changes invalidate it. func ETag(meta Meta, shell []byte) string { sum := sha256.New() _, _ = sum.Write(shell) _, _ = sum.Write([]byte(meta.HTML(true))) return `"` + hex.EncodeToString(sum.Sum(nil)[:16]) + `"` } func firstNonEmpty(values ...string) string { for _, value := range values { if trimmed := strings.TrimSpace(value); trimmed != "" { return trimmed } } return "" } func stringValue(values map[string]any, key string) string { if values == nil { return "" } value, ok := values[key] if !ok { return "" } text, _ := value.(string) return strings.TrimSpace(text) } func storefrontDescription(profile map[string]any) string { if profile == nil { return "" } raw, ok := profile["storefront_text_json"] if !ok { return "" } switch value := raw.(type) { case string: var payload struct { HeroDesc string `json:"hero_desc"` } if json.Unmarshal([]byte(value), &payload) == nil { return strings.TrimSpace(payload.HeroDesc) } case map[string]any: return stringValue(value, "hero_desc") } return "" } func fallbackBrand(tenantCode string) (favicon, appleIcon, themeColor string) { switch strings.ToLower(strings.TrimSpace(tenantCode)) { case "jieyou": return "/jieyou-favicon.svg", "/jieyou-apple-touch-icon.png", "#a64332" case "dachui": return "/apple-touch-icon.png", "/apple-touch-icon.png", "#ff6a00" default: return "/apple-touch-icon.png", "/apple-touch-icon.png", "#ff6a00" } } func iconType(url string) string { path := strings.SplitN(url, "?", 2)[0] if strings.HasSuffix(strings.ToLower(path), ".svg") { return "image/svg+xml" } return "image/png" } // safeAssetURL 只允许站内相对路径、http(s)、协议相对地址和 data:image。 // 租户品牌字段来自后台,仍按不可信输入处理,避免 javascript: 等 URL 进入 head。 func safeAssetURL(value string) string { value = strings.TrimSpace(value) if value == "" { return "" } lower := strings.ToLower(value) if strings.HasPrefix(value, "/") || strings.HasPrefix(lower, "http://") || strings.HasPrefix(lower, "https://") || strings.HasPrefix(value, "//") || strings.HasPrefix(lower, "data:image/") { return value } return "" } func absoluteURL(scheme, host, value string) string { value = strings.TrimSpace(value) if value == "" { return "" } if strings.HasPrefix(value, "http://") || strings.HasPrefix(value, "https://") || strings.HasPrefix(value, "//") { return value } if strings.HasPrefix(value, "/") && scheme != "" && host != "" { return scheme + "://" + host + value } return value }