M3 完成:env 业务配置全进 DB,WebUI 可改,改完立即生效(无需重启)。
新增:
- controller/settings.go: 3 个 handler
- GET /api/settings: 读所有设置,api_key 永远打码
- PUT /api/settings: 部分更新(白名单字段);default_speaker 改时校验
音色必须在 voices 表里(避免引用不存在);改完调 LoadRuntimeConfig 即时生效
- PUT /api/settings/api-key: 独立端点,只改 api_key
改造:
- setting/config.go: 用 LoadRuntimeConfig(store) 替代 InitTTSConfig
- 不再读 BYTEDANCE_TTS_* env,完全从 store.Settings 拿
- 必填项缺失返 error,设 TTSConfigErr(/v1/audio/speech 返 503)
- 定义 Store 接口(避免 setting → store 循环 import)
- 字段映射: BYTEDANCE_TTS_API_KEY → api_key, BYTEDANCE_TTS_RESOURCE_ID
→ default_resource_id, ... 全部一一对应
- controller/tts.go: voice 路由
- voice 为空 → 用 setting.TTSOptions.Speaker (即 store.default_speaker)
- voice 非空 → 查 voices 表,替换 opts.Speaker / ResourceID / Model
- 命中但 enabled=0 → 仍可用(显式 voice 覆盖)
- 未命中 → 400 unknown_voice
- voice 路由日志: "[tts] voice=xxx 命中 (speaker=... resource=... model=...)"
- router/admin.html: 加 #settings tab (24.78KB, 仍 <30KB 预算)
- API key 区:打码显示 + 独立更新按钮
- 路由/格式区:default_resource_id / default_speaker (下拉源 /api/voices) /
default_format / sample_rate / model
- "保存" 按钮 PUT /api/settings + 立即 reload (settingsOk 提示)
- router/router.go: 挂 /api/settings[/{api-key}] 三路由
- main.go: Detect 之后调 LoadRuntimeConfig,失败也允许进入
(env 阶段无 db,LogStartupSummary 仍显示 BYTEDANCE_TTS_* 必填项用于诊断)
测试(都被 .gitignore 排除,本地保留):
- 已有 store/installer/middleware/router/telemetry 测试保持全绿
- e2e 验证(本机跑通 9 场景):
- install 写入 3 voices + 7 settings
- 重启后 main.go log: "TTS 运行时配置已加载(api_key=***, speaker=default-voice, resource=volc.megatts.icl, format=wav)" — 确认走 DB 不读 env
- GET /api/settings 返所有字段
- voice=clone-voice-1 命中 S_clone_1 + seed-tts-2.0-expressive
- voice=clone-voice-2 命中 S_clone_2 + volc.megatts.icl-2
- voice=unknown 返 400 unknown_voice
- PUT /api/settings 改 default_speaker 即时生效
- PUT /api/settings/api-key 改 key 即时生效
- PUT /api/settings default_speaker=ghost 返 400 default_speaker_missing
注意: e2e 里的 TTS 500 是因为我用假 key 调上游,路由逻辑本身正确。
换真火山 API key 即可 work。
二进制大小: ~17MB → ~18MB (+1MB)
未 push(等用户测试 M1+M2+speaker fix 全部稳定后,跟 51bd7ae+70865a3 一起或单独 push)
120 lines
3.7 KiB
Go
120 lines
3.7 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"log"
|
|
"net/http"
|
|
"os"
|
|
"os/signal"
|
|
"syscall"
|
|
"time"
|
|
|
|
"github.com/volcano-tts/tts-api/controller"
|
|
"github.com/volcano-tts/tts-api/installer"
|
|
"github.com/volcano-tts/tts-api/metrics"
|
|
"github.com/volcano-tts/tts-api/middleware"
|
|
"github.com/volcano-tts/tts-api/router"
|
|
"github.com/volcano-tts/tts-api/setting"
|
|
)
|
|
|
|
// ttsDBPath 返回数据库/lock 所在路径;空时落到当前目录的 tts.db。
|
|
func ttsDBPath() string {
|
|
if p := os.Getenv("TTS_DB_PATH"); p != "" {
|
|
return p
|
|
}
|
|
return "tts.db"
|
|
}
|
|
|
|
func main() {
|
|
log.SetFlags(log.LstdFlags | log.Lshortfile)
|
|
log.SetPrefix("[TTS-Server] ")
|
|
|
|
// 1) 加载引导环境变量(PORT / OPENAI_TTS_API_KEY / TTS_ADMIN_KEY 等)
|
|
setting.InitAllConfigs()
|
|
metrics.Init()
|
|
middleware.InitRateLimiter()
|
|
setting.LogStartupSummary()
|
|
|
|
// 2) 启动期关键步骤:打开/建库 → 检测 lock → 判定模式
|
|
dbPath := ttsDBPath()
|
|
if err := installer.EnsureDBDir(dbPath); err != nil {
|
|
log.Fatalf("FATAL: cannot create db dir: %v", err)
|
|
}
|
|
st, res, err := installer.Detect(dbPath)
|
|
if err != nil {
|
|
log.Fatalf("FATAL: installer detect failed: %v", err)
|
|
}
|
|
if res.Corrupted {
|
|
log.Printf("[main] 注意: 启动时检测到 db 损坏并已自愈回退(备份=%s)", res.BackupTo)
|
|
}
|
|
// 注入 setup 控制器需要的 store + dbPath(无论哪种模式都注入,正常模式下备用)
|
|
controller.SetSetupState(st, dbPath)
|
|
// 注入 admin 控制器需要的 store + 指标文本写入器(M2)
|
|
controller.SetAdminStore(st)
|
|
controller.SetMetricsTextWriter(func(w http.ResponseWriter) error {
|
|
metrics.Meter.Handler().ServeHTTP(w, &http.Request{})
|
|
return nil
|
|
})
|
|
// M3: 从 store 加载运行时 TTS 配置(替代原来的 env-based InitTTSConfig)
|
|
if st != nil {
|
|
if err := setting.LoadRuntimeConfig(st); err != nil {
|
|
log.Printf("[main] TTS 运行时配置加载失败:%v(将保持 install mode 或返 503)", err)
|
|
} else {
|
|
log.Printf("[main] TTS 运行时配置已加载(api_key=***, speaker=%s, resource=%s, format=%s)",
|
|
setting.TTSOptions.Speaker, setting.TTSOptions.ResourceID, setting.TTSOptions.Format)
|
|
}
|
|
}
|
|
log.Printf("[main] 当前模式: %s (db=%s lock=%s)", res.Mode, dbPath, res.LockPath)
|
|
|
|
controller.InitController()
|
|
controller.SetStartTime(time.Now())
|
|
|
|
r := router.Setup()
|
|
|
|
server := &http.Server{
|
|
Addr: ":" + setting.Server.Port,
|
|
Handler: middleware.CORS(r),
|
|
ReadTimeout: 30 * time.Second,
|
|
WriteTimeout: 120 * time.Second,
|
|
IdleTimeout: 60 * time.Second,
|
|
}
|
|
|
|
quit := make(chan os.Signal, 1)
|
|
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
|
|
|
|
go func() {
|
|
if installer.GetMode() == installer.ModeSetup {
|
|
log.Printf("Starting TTS Server in SETUP mode")
|
|
log.Printf("Open browser to http://localhost:%s/setup to install", setting.Server.Port)
|
|
} else {
|
|
log.Printf("Starting ByteDance TTS to OpenAI API Adapter Server")
|
|
log.Printf("Listening on port: %s", setting.Server.Port)
|
|
log.Printf("OpenAI TTS endpoint: http://localhost:%s/v1/audio/speech", setting.Server.Port)
|
|
log.Printf("Admin WebUI: http://localhost:%s/admin", setting.Server.Port)
|
|
}
|
|
log.Printf("Health check: http://localhost:%s/health", setting.Server.Port)
|
|
log.Printf("Metrics: http://localhost:%s/metrics", setting.Server.Port)
|
|
|
|
if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
|
|
log.Fatalf("Server failed to start: %v", err)
|
|
}
|
|
}()
|
|
|
|
<-quit
|
|
log.Println("Shutting down server...")
|
|
|
|
// 关闭 db 连接(仅当 st 非 nil 时)
|
|
if st != nil {
|
|
_ = st.Close()
|
|
}
|
|
|
|
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
|
|
defer cancel()
|
|
|
|
if err := server.Shutdown(ctx); err != nil {
|
|
log.Printf("Server forced to shutdown: %v", err)
|
|
} else {
|
|
log.Println("Server exited gracefully")
|
|
}
|
|
}
|