完善初始化向导、通知配置与证书流程

This commit is contained in:
xuans committed 2026-08-29 11:52:31 +08:00
1 parent b2833b761d
commit f85ef10527
41 files changed
+3645 -1697

No files matched your search

+92 -14
View File
@@ -7,8 +7,10 @@ import (
"net/mail"
"net/url"
"os"
"os/user"
"path/filepath"
"runtime"
"strconv"
"strings"
)
@@ -72,10 +74,12 @@ type PathsConfig struct {
}
type ACMEConfig struct {
CA string `json:"ca"`
Environment string `json:"environment"`
AccountEmail string `json:"account_email"`
RenewalThresholdDays int `json:"renewal_threshold_days"`
CA string `json:"ca"`
Environment string `json:"environment"`
AccountEmail string `json:"account_email"`
RenewalThresholdDays int `json:"renewal_threshold_days"`
PropagationTimeoutSecs int `json:"propagation_timeout_secs"`
PropagationPollingIntervalSecs int `json:"propagation_polling_interval_secs"`
}
type DNSConfig struct {
@@ -119,8 +123,14 @@ func Default(baseDir string) Config {
MaxOpenConns: 4, MaxIdleConns: 2, ConnMaxLifetimeMins: 30,
},
Paths: paths,
ACME: ACMEConfig{CA: "letsencrypt", Environment: "staging", RenewalThresholdDays: 6},
DNS: DNSConfig{VerificationState: "not_configured"},
ACME: ACMEConfig{
CA: "letsencrypt",
Environment: "staging",
RenewalThresholdDays: 6,
PropagationTimeoutSecs: 900,
PropagationPollingIntervalSecs: 10,
},
DNS: DNSConfig{VerificationState: "not_configured"},
Notification: NotificationConfig{
HTTPHeaders: map[string]string{},
HTTPPath: "/api/email/send",
@@ -207,6 +217,12 @@ func (c *Config) Normalize() {
if c.DNS.VerificationState == "" {
c.DNS.VerificationState = "not_configured"
}
if c.ACME.PropagationTimeoutSecs == 0 {
c.ACME.PropagationTimeoutSecs = 900
}
if c.ACME.PropagationPollingIntervalSecs == 0 {
c.ACME.PropagationPollingIntervalSecs = 10
}
if c.Notification.HTTPPath == "" {
c.Notification.HTTPPath = "/api/email/send"
}
@@ -258,9 +274,44 @@ func (c Config) Save(path string) error {
if err := os.Chmod(path, 0o600); err != nil {
return fmt.Errorf("设置配置文件权限失败:%w", err)
}
if err := applyLinuxServiceOwnership(filepath.Dir(path), path); err != nil {
return fmt.Errorf("设置配置文件归属失败:%w", err)
}
return nil
}
// applyLinuxServiceOwnership 在 root 初始化配置时,将配置目录和文件交给 Scert 服务用户管理。
// 非 Linux、非 root 进程或系统尚未创建 Scert 用户时保持原有行为,便于开发环境使用。
func applyLinuxServiceOwnership(directory, path string) error {
if runtime.GOOS != "linux" || os.Geteuid() != 0 {
return nil
}
serviceUser, err := user.Lookup("Scert")
if err != nil {
return nil
}
serviceGroup, err := user.LookupGroup("Scert")
if err != nil {
return nil
}
uid, err := strconv.Atoi(serviceUser.Uid)
if err != nil {
return fmt.Errorf("解析 Scert 用户编号失败:%w", err)
}
gid, err := strconv.Atoi(serviceGroup.Gid)
if err != nil {
return fmt.Errorf("解析 Scert 用户组编号失败:%w", err)
}
if err := os.Chown(directory, uid, gid); err != nil {
return err
}
if err := os.Chmod(directory, 0o700); err != nil {
return err
}
return os.Chown(path, uid, gid)
}
func (c Config) Validate() error {
if c.Version != CurrentVersion {
return fmt.Errorf("配置版本不兼容:%d", c.Version)
@@ -303,6 +354,15 @@ func (c Config) Validate() error {
if c.ACME.RenewalThresholdDays < 1 {
return fmt.Errorf("续期阈值必须大于 0")
}
if c.ACME.PropagationTimeoutSecs < 1 || c.ACME.PropagationTimeoutSecs > 86400 {
return fmt.Errorf("DNS 传播等待时间必须在 1 到 86400 秒之间")
}
if c.ACME.PropagationPollingIntervalSecs < 1 {
return fmt.Errorf("DNS 传播检测间隔必须大于 0")
}
if c.ACME.PropagationPollingIntervalSecs > c.ACME.PropagationTimeoutSecs {
return fmt.Errorf("DNS 传播检测间隔不能大于传播等待时间")
}
if c.DNS.VerificationState != "not_configured" && c.DNS.VerificationState != "pending" && c.DNS.VerificationState != "verified" && c.DNS.VerificationState != "failed" {
return fmt.Errorf("DNS 验证状态无效:%s", c.DNS.VerificationState)
}
@@ -369,19 +429,37 @@ func (c Config) Validate() error {
// ResetURL 返回通过主 Web 服务访问密码重置入口的公开地址。
func (c Config) ResetURL() string {
host := strings.TrimSpace(c.Web.Hostname)
if host == "" {
host = strings.TrimSpace(c.Web.PublicIP)
rawHost := strings.TrimSpace(c.Web.Hostname)
if rawHost == "" {
rawHost = strings.TrimSpace(c.Web.PublicIP)
}
if host == "" {
if rawHost == "" {
return ""
}
if parsed, err := url.Parse(host); err == nil && parsed.Hostname() != "" {
host = parsed.Hostname()
}
host, _ := splitResetHost(rawHost)
host = strings.Trim(host, "[]")
if ip := net.ParseIP(host); ip != nil && strings.Contains(host, ":") {
if ip := net.ParseIP(host); ip != nil && ip.To4() == nil {
host = "[" + host + "]"
}
return (&url.URL{Scheme: "https", Host: host, Path: "/reset"}).String()
}
func splitResetHost(rawHost string) (string, string) {
trimmed := strings.TrimSpace(rawHost)
withoutBrackets := strings.Trim(trimmed, "[]")
if net.ParseIP(withoutBrackets) != nil {
return withoutBrackets, ""
}
parseTarget := trimmed
if !strings.Contains(parseTarget, "://") {
parseTarget = "//" + parseTarget
}
if parsed, err := url.Parse(parseTarget); err == nil && parsed.Hostname() != "" {
return parsed.Hostname(), parsed.Port()
}
if parsedHost, parsedPort, err := net.SplitHostPort(trimmed); err == nil {
return parsedHost, parsedPort
}
return withoutBrackets, ""
}
+95 -3
View File
@@ -78,12 +78,12 @@ func TestValidateRejectsInvalidPort(t *testing.T) {
}
}
func TestResetURLUsesWebHostnameWithoutPort(t *testing.T) {
func TestResetURLAlwaysUsesWebHostnameWithoutPort(t *testing.T) {
cfg := Default(t.TempDir())
cfg.Web.Hostname = "scert.example.test"
cfg.Server.Port = 8443
if value := cfg.ResetURL(); value != "https://scert.example.test/reset" {
t.Fatalf("域名密码重置地址不正确:%s", value)
t.Fatalf("密码重置地址不得暴露主服务端口:%s", value)
}
cfg.Server.Port = 443
if value := cfg.ResetURL(); value != "https://scert.example.test/reset" {
@@ -91,7 +91,7 @@ func TestResetURLUsesWebHostnameWithoutPort(t *testing.T) {
}
}
func TestResetURLSupportsPublicIPv6(t *testing.T) {
func TestResetURLSupportsPublicIPv6WithoutPort(t *testing.T) {
cfg := Default(t.TempDir())
cfg.Web.PublicIP = "2001:db8::10"
cfg.Server.Port = 8443
@@ -116,3 +116,95 @@ func TestSavedConfigDoesNotContainIndependentResetPort(t *testing.T) {
t.Fatalf("配置文件不应再包含独立密码重置监听配置:%s", content)
}
}
func TestResetURLIgnoresExplicitPortAndURLInput(t *testing.T) {
cfg := Default(t.TempDir())
cfg.Web.Hostname = "https://scert.example.test:9443"
cfg.Server.Port = 5200
if value := cfg.ResetURL(); value != "https://scert.example.test/reset" {
t.Fatalf("外部地址中的显式端口不得出现在重置地址中:%s", value)
}
}
func TestResetURLIgnoresPathFromWebHostname(t *testing.T) {
cfg := Default(t.TempDir())
cfg.Web.Hostname = "scert.example.test/manage"
cfg.Server.Port = 8443
if value := cfg.ResetURL(); value != "https://scert.example.test/reset" {
t.Fatalf("管理页面域名附带路径时重置地址不正确:%s", value)
}
}
func TestResetURLUsesExternalProxyAddress(t *testing.T) {
cfg := Default(t.TempDir())
cfg.Web.Hostname = "scert.example.test"
cfg.Server.HTTPSMode = "proxy"
cfg.Server.Port = 5200
if value := cfg.ResetURL(); value != "https://scert.example.test/reset" {
t.Fatalf("代理模式不应暴露核心服务端口:%s", value)
}
}
func TestResetURLSupportsIPv6WithoutPort(t *testing.T) {
cfg := Default(t.TempDir())
cfg.Web.PublicIP = "2001:db8::10"
cfg.Server.Port = 443
if value := cfg.ResetURL(); value != "https://[2001:db8::10]/reset" {
t.Fatalf("IPv6 默认 HTTPS 地址不正确:%s", value)
}
}
func TestDefaultACMEPropagationSettings(t *testing.T) {
cfg := Default(t.TempDir())
if cfg.ACME.PropagationTimeoutSecs != 900 || cfg.ACME.PropagationPollingIntervalSecs != 10 {
t.Fatalf("默认 DNS 传播参数不正确:%+v", cfg.ACME)
}
}
func TestNormalizeRestoresMissingACMEPropagationSettings(t *testing.T) {
cfg := Default(t.TempDir())
cfg.ACME.PropagationTimeoutSecs = 0
cfg.ACME.PropagationPollingIntervalSecs = 0
cfg.Normalize()
if cfg.ACME.PropagationTimeoutSecs != 900 || cfg.ACME.PropagationPollingIntervalSecs != 10 {
t.Fatalf("旧配置的 DNS 传播参数未补齐:%+v", cfg.ACME)
}
}
func TestValidateRejectsInvalidACMEPropagationTimeout(t *testing.T) {
for _, value := range []int{0, 86401} {
cfg := Default(t.TempDir())
cfg.ACME.PropagationTimeoutSecs = value
if err := cfg.Validate(); err == nil {
t.Fatalf("无效 DNS 传播等待时间未被拒绝:%d", value)
}
}
}
func TestValidateRejectsInvalidACMEPropagationInterval(t *testing.T) {
for _, value := range []int{0, 901} {
cfg := Default(t.TempDir())
cfg.ACME.PropagationPollingIntervalSecs = value
if err := cfg.Validate(); err == nil {
t.Fatalf("无效 DNS 传播检测间隔未被拒绝:%d", value)
}
}
}
func TestSaveAndLoadACMEPropagationSettings(t *testing.T) {
dir := t.TempDir()
cfg := Default(dir)
cfg.ACME.PropagationTimeoutSecs = 1200
cfg.ACME.PropagationPollingIntervalSecs = 15
path := filepath.Join(dir, "config", "scert.json")
if err := cfg.Save(path); err != nil {
t.Fatalf("保存配置失败:%v", err)
}
loaded, err := Load(path)
if err != nil {
t.Fatalf("读取配置失败:%v", err)
}
if loaded.ACME.PropagationTimeoutSecs != 1200 || loaded.ACME.PropagationPollingIntervalSecs != 15 {
t.Fatalf("DNS 传播参数持久化不一致:%+v", loaded.ACME)
}
}