317 lines
11 KiB
Go
317 lines
11 KiB
Go
// Package config 负责应用配置的加载与校验。
|
||
//
|
||
// 配置以 yml 文件为唯一来源，环境变量仅作为覆盖手段（便于容器部署注入敏感值）。
|
||
// 加载优先级：环境变量 > yml 文件 > 代码内置默认值。
|
||
package config
|
||
|
||
import (
|
||
"fmt"
|
||
"os"
|
||
"path/filepath"
|
||
"strconv"
|
||
"strings"
|
||
|
||
"github.com/goccy/go-yaml"
|
||
)
|
||
|
||
// Config 应用总配置，结构与 configs/config.yml 一一对应。
|
||
type Config struct {
|
||
Server ServerConfig `yaml:"server"`
|
||
Database DatabaseConfig `yaml:"database"`
|
||
JWT JWTConfig `yaml:"jwt"`
|
||
Upload UploadConfig `yaml:"upload"`
|
||
CORS CORSConfig `yaml:"cors"`
|
||
ClientSign ClientSignConfig `yaml:"client_sign"`
|
||
|
||
// loadedFrom 记录实际生效的配置文件绝对路径，仅用于启动日志。
|
||
// 小写不导出，yml 无法覆盖它。
|
||
loadedFrom string
|
||
}
|
||
|
||
// ServerConfig HTTP 服务配置。
|
||
type ServerConfig struct {
|
||
Port string `yaml:"port"`
|
||
Mode string `yaml:"mode"`
|
||
ShutdownTimeout int `yaml:"shutdown_timeout"`
|
||
|
||
// SSGPort 是「仅供构建期（astro build）使用的内部端口」，与对外公开的 Port 完全隔离。
|
||
// 该端口只挂 /api/ssg/* 路由，由 docker-compose 绑定到 127.0.0.1（回环），
|
||
// nginx 也绝不反代它，因此外部网络根本不可达，SSG 全量/全 ID 数据不会外泄。
|
||
// 为空时 normalize 兜底为 "8091"。
|
||
SSGPort string `yaml:"ssg_port"`
|
||
// SSGToken 是 SSG 端口的可选访问令牌（防御纵深）。
|
||
// 为空表示不校验（依赖回环绑定即可）；非空时 /api/ssg/* 必须带 ?token= 或 X-SSG-Token 头。
|
||
// 通过环境变量 SSG_TOKEN 注入，切勿加 PUBLIC_ 前缀以免进入前端 bundle。
|
||
SSGToken string `yaml:"ssg_token"`
|
||
|
||
// HashIDSecret 是「公开 ID 混淆」的部署级盐值。
|
||
// 公开接口对外只暴露编码后的无序串（如 xK9mP2）而非自增主键，防止爬虫顺序枚举；
|
||
// 该盐值决定编码结果，不同部署应使用不同随机串，避免被反向推导。
|
||
// 为空时使用内置默认盐（仅防顺序枚举，不算安全），生产务必通过环境变量注入随机值。
|
||
HashIDSecret string `yaml:"hashid_secret"`
|
||
}
|
||
|
||
// DatabaseConfig MySQL 连接与连接池配置。
|
||
type DatabaseConfig struct {
|
||
Host string `yaml:"host"`
|
||
Port string `yaml:"port"`
|
||
User string `yaml:"user"`
|
||
Password string `yaml:"password"`
|
||
Name string `yaml:"name"`
|
||
Charset string `yaml:"charset"`
|
||
LogLevel string `yaml:"log_level"`
|
||
MaxIdleConns int `yaml:"max_idle_conns"`
|
||
MaxOpenConns int `yaml:"max_open_conns"`
|
||
ConnMaxLifetime int `yaml:"conn_max_lifetime"`
|
||
}
|
||
|
||
// DSN 组装 MySQL 连接串。
|
||
func (d DatabaseConfig) DSN() string {
|
||
charset := d.Charset
|
||
if charset == "" {
|
||
charset = "utf8mb4"
|
||
}
|
||
return fmt.Sprintf(
|
||
"%s:%s@tcp(%s:%s)/%s?charset=%s&parseTime=True&loc=Local&timeout=10s",
|
||
d.User, d.Password, d.Host, d.Port, d.Name, charset,
|
||
)
|
||
}
|
||
|
||
// Addr 返回 host:port 形式的数据库地址，用于日志展示。
|
||
func (d DatabaseConfig) Addr() string {
|
||
return d.Host + ":" + d.Port + "/" + d.Name
|
||
}
|
||
|
||
// JWTConfig 令牌签发配置。
|
||
type JWTConfig struct {
|
||
Secret string `yaml:"secret"`
|
||
ExpireHours int `yaml:"expire_hours"` // access token 有效期（小时）
|
||
RefreshExpireHours int `yaml:"refresh_expire_hours"` // refresh token 有效期（小时）
|
||
}
|
||
|
||
// UploadConfig 图片静态资源配置。
|
||
type UploadConfig struct {
|
||
Dir string `yaml:"dir"`
|
||
URLPrefix string `yaml:"url_prefix"`
|
||
}
|
||
|
||
// CORSConfig 跨域配置。
|
||
type CORSConfig struct {
|
||
AllowOrigins []string `yaml:"allow_origins"`
|
||
AllowMethods []string `yaml:"allow_methods"`
|
||
AllowHeaders []string `yaml:"allow_headers"`
|
||
MaxAge int `yaml:"max_age"`
|
||
}
|
||
|
||
// ClientSignConfig 公开接口「前端 JS 签名」配置。
|
||
//
|
||
// 给 /runway-looks（列表）与 /brands 两个批量查询接口加一层请求签名校验，
|
||
// 用于识别「请求大概率由前端 JS 构造」、抬高 casual 爬虫的批量抓取成本。
|
||
//
|
||
// 安全定位（务必知悉）：
|
||
// - 这是「提高成本」而非「加密」——Secret 必须出现在前端 bundle 才能签名，对浏览器可见；
|
||
// 有决心的爬虫可反编译 JS 复刻签名逻辑。它用于拖慢 casual 爬虫，不能作为唯一防线。
|
||
// - 真正有效的组合是：本签名（识别大概率真前端）+ 按 IP 限流（兜住总量）。
|
||
// - Enabled=false 或 Secret 为空时中间件为 noop（不拦截），便于灰度与回滚。
|
||
type ClientSignConfig struct {
|
||
// Enabled 开关：false 时中间件不拦截，便于灰度上线与紧急回滚。
|
||
Enabled bool `yaml:"enabled"`
|
||
// Secret 签名密钥，必须与前端的 CLIENT_SIGN_SECRET 完全一致。生产经环境变量 CLIENT_SIGN_SECRET 注入随机长串。
|
||
Secret string `yaml:"secret"`
|
||
// TTLSeconds 签名时间戳容忍窗口（秒），用于防重放。默认 30。
|
||
TTLSeconds int `yaml:"ttl_seconds"`
|
||
}
|
||
|
||
// defaultConfig 返回内置默认值，保证 yml 缺字段时服务仍可启动。
|
||
func defaultConfig() *Config {
|
||
return &Config{
|
||
Server: ServerConfig{
|
||
Port: "8090",
|
||
Mode: "debug",
|
||
ShutdownTimeout: 10,
|
||
SSGPort: "8091",
|
||
SSGToken: "",
|
||
HashIDSecret: "",
|
||
},
|
||
Database: DatabaseConfig{
|
||
Host: "127.0.0.1",
|
||
Port: "3306",
|
||
User: "root",
|
||
Password: "root",
|
||
Name: "db_dev",
|
||
Charset: "utf8mb4",
|
||
LogLevel: "warn",
|
||
MaxIdleConns: 10,
|
||
MaxOpenConns: 100,
|
||
ConnMaxLifetime: 3600,
|
||
},
|
||
JWT: JWTConfig{
|
||
Secret: "dev-secret-change-me-fashion-2026",
|
||
ExpireHours: 2, // access token 2 小时（短命，泄漏窗口小）
|
||
RefreshExpireHours: 720, // refresh token 30 天（长命，落库可吊销）
|
||
},
|
||
Upload: UploadConfig{
|
||
Dir: "./uploads",
|
||
URLPrefix: "/uploads",
|
||
},
|
||
CORS: CORSConfig{
|
||
AllowOrigins: []string{"*"},
|
||
AllowMethods: []string{"GET", "POST", "PUT", "DELETE", "OPTIONS"},
|
||
AllowHeaders: []string{"Content-Type", "Authorization", "X-Requested-With", "X-Sign", "X-Sign-Ts", "X-Sign-Nonce"},
|
||
MaxAge: 86400,
|
||
},
|
||
ClientSign: ClientSignConfig{
|
||
Enabled: false,
|
||
Secret: "",
|
||
TTLSeconds: 30,
|
||
},
|
||
}
|
||
}
|
||
|
||
// candidatePaths 返回配置文件的查找顺序。
|
||
// 显式指定（-config 参数 / CONFIG_PATH 环境变量）优先，其次按约定路径查找，
|
||
// 这样无论从项目根目录还是从 cmd 子目录启动都能定位到配置。
|
||
func candidatePaths(explicit string) []string {
|
||
if explicit != "" {
|
||
return []string{explicit}
|
||
}
|
||
if p := os.Getenv("CONFIG_PATH"); p != "" {
|
||
return []string{p}
|
||
}
|
||
return []string{
|
||
"configs/config.yml",
|
||
"config.yml",
|
||
filepath.Join("..", "..", "configs", "config.yml"),
|
||
}
|
||
}
|
||
|
||
// Load 加载配置：读取 yml → 应用环境变量覆盖 → 归一化校验。
|
||
//
|
||
// explicit 为显式指定的配置文件路径，传空字符串则按约定路径查找。
|
||
// 找不到配置文件不视为错误（返回默认值 + 环境变量），便于纯环境变量的容器部署。
|
||
func Load(explicit string) (*Config, error) {
|
||
cfg := defaultConfig()
|
||
|
||
var loadedFrom string
|
||
for _, p := range candidatePaths(explicit) {
|
||
data, err := os.ReadFile(p)
|
||
if err != nil {
|
||
continue
|
||
}
|
||
if err := yaml.Unmarshal(data, cfg); err != nil {
|
||
return nil, fmt.Errorf("解析配置文件 %s 失败: %w", p, err)
|
||
}
|
||
abs, _ := filepath.Abs(p)
|
||
loadedFrom = abs
|
||
break
|
||
}
|
||
if loadedFrom == "" && explicit != "" {
|
||
return nil, fmt.Errorf("配置文件不存在: %s", explicit)
|
||
}
|
||
cfg.loadedFrom = loadedFrom
|
||
|
||
cfg.applyEnv()
|
||
cfg.normalize()
|
||
return cfg, nil
|
||
}
|
||
|
||
// LoadedFrom 返回实际加载的配置文件路径；为空表示未找到配置文件、全部使用默认值与环境变量。
|
||
func (c *Config) LoadedFrom() string { return c.loadedFrom }
|
||
|
||
// applyEnv 用环境变量覆盖 yml 中的值，便于容器部署注入敏感配置。
|
||
func (c *Config) applyEnv() {
|
||
envStr("SERVER_PORT", &c.Server.Port)
|
||
envStr("GIN_MODE", &c.Server.Mode)
|
||
envStr("SSG_PORT", &c.Server.SSGPort)
|
||
envStr("SSG_TOKEN", &c.Server.SSGToken)
|
||
envStr("HASHID_SECRET", &c.Server.HashIDSecret)
|
||
|
||
envStr("DB_HOST", &c.Database.Host)
|
||
envStr("DB_PORT", &c.Database.Port)
|
||
envStr("DB_USER", &c.Database.User)
|
||
// 同时兼容 DB_PASSWORD 与 DB_PASS：
|
||
// 原项目代码只读 DB_PASS，而 docker-compose.yml 注入的是 DB_PASSWORD，
|
||
// 二者不一致导致容器里的密码配置实际未生效（仅因默认值恰好相同而未暴露）。
|
||
// 这里两个都支持，DB_PASSWORD 优先，修正该隐患。
|
||
envStr("DB_PASS", &c.Database.Password)
|
||
envStr("DB_PASSWORD", &c.Database.Password)
|
||
envStr("DB_NAME", &c.Database.Name)
|
||
envStr("DB_LOG_LEVEL", &c.Database.LogLevel)
|
||
|
||
envStr("JWT_SECRET", &c.JWT.Secret)
|
||
envInt("JWT_EXPIRE_HOURS", &c.JWT.ExpireHours)
|
||
envInt("JWT_REFRESH_EXPIRE_HOURS", &c.JWT.RefreshExpireHours)
|
||
|
||
envBool("CLIENT_SIGN_ENABLED", &c.ClientSign.Enabled)
|
||
envStr("CLIENT_SIGN_SECRET", &c.ClientSign.Secret)
|
||
envInt("CLIENT_SIGN_TTL", &c.ClientSign.TTLSeconds)
|
||
|
||
envStr("UPLOAD_DIR", &c.Upload.Dir)
|
||
envStr("UPLOAD_URL_PREFIX", &c.Upload.URLPrefix)
|
||
}
|
||
|
||
// normalize 兜底与校验：修正非法值，避免运行期出现难以定位的问题。
|
||
func (c *Config) normalize() {
|
||
if c.Server.Port == "" {
|
||
c.Server.Port = "8090"
|
||
}
|
||
if c.Server.SSGPort == "" {
|
||
c.Server.SSGPort = "8091"
|
||
}
|
||
switch c.Server.Mode {
|
||
case "debug", "release", "test":
|
||
default:
|
||
c.Server.Mode = "debug"
|
||
}
|
||
if c.Server.ShutdownTimeout <= 0 {
|
||
c.Server.ShutdownTimeout = 10
|
||
}
|
||
if c.Database.MaxIdleConns <= 0 {
|
||
c.Database.MaxIdleConns = 10
|
||
}
|
||
if c.Database.MaxOpenConns <= 0 {
|
||
c.Database.MaxOpenConns = 100
|
||
}
|
||
if c.JWT.ExpireHours <= 0 {
|
||
c.JWT.ExpireHours = 168
|
||
}
|
||
if c.JWT.RefreshExpireHours <= 0 {
|
||
c.JWT.RefreshExpireHours = 720
|
||
}
|
||
if c.Upload.Dir == "" {
|
||
c.Upload.Dir = "./uploads"
|
||
}
|
||
// 静态前缀必须以 / 开头且不以 / 结尾，保证与数据库中图片路径拼接一致
|
||
prefix := strings.TrimSpace(c.Upload.URLPrefix)
|
||
if prefix == "" {
|
||
prefix = "/uploads"
|
||
}
|
||
if !strings.HasPrefix(prefix, "/") {
|
||
prefix = "/" + prefix
|
||
}
|
||
c.Upload.URLPrefix = strings.TrimRight(prefix, "/")
|
||
if len(c.CORS.AllowOrigins) == 0 {
|
||
c.CORS.AllowOrigins = []string{"*"}
|
||
}
|
||
}
|
||
|
||
func envStr(key string, dst *string) {
|
||
if v := strings.TrimSpace(os.Getenv(key)); v != "" {
|
||
*dst = v
|
||
}
|
||
}
|
||
|
||
func envInt(key string, dst *int) {
|
||
if v := strings.TrimSpace(os.Getenv(key)); v != "" {
|
||
if n, err := strconv.Atoi(v); err == nil {
|
||
*dst = n
|
||
}
|
||
}
|
||
}
|
||
|
||
func envBool(key string, dst *bool) {
|
||
if v := strings.TrimSpace(strings.ToLower(os.Getenv(key))); v != "" {
|
||
*dst = v == "1" || v == "true" || v == "yes"
|
||
}
|
||
}
|