refactor(backend): rename OpenFlare directory to lowercase openflare

This commit is contained in:
ryan
2026-08-30 17:43:23 +08:00
parent 06d5fedbfc
commit c93ff6674f
543 changed files with 819 additions and 819 deletions
@@ -0,0 +1,139 @@
// Copyright 2026 Arctel.net
// SPDX-License-Identifier: Apache-2.0
// Package geoipupdate schedules local MaxMind GeoIP database updates for the agent.
package geoipupdate
import (
"context"
"errors"
"fmt"
"log/slog"
"os"
"path/filepath"
"time"
"Wavelet/openflare/share/geoip"
)
// Updater periodically downloads a fresh GeoIP MMDB file and seeds missing
// databases via download (or relies on image-provided files under data_dir).
type Updater struct {
MMDBPath string
DownloadURL string
CityMMDBPath string
CityDownloadURL string
UpdateInterval time.Duration
downloadDatabase func(context.Context, string, string) error
}
// EnsureInitialDatabases downloads any missing Country/City MMDB once.
// When files already exist (e.g. Docker image COPY), this is a no-op.
// Network is used only when a managed path is absent — not for binary embeds.
func (u *Updater) EnsureInitialDatabases(ctx context.Context) error {
if u == nil {
return nil
}
return u.ensureMissingDatabases(ctx)
}
func (u *Updater) ensureMissingDatabases(ctx context.Context) error {
databases := u.managedDatabases()
var errs []error
for _, database := range databases {
if database.path == "" || database.downloadURL == "" {
continue
}
exists, err := fileExists(database.path)
if err != nil {
errs = append(errs, fmt.Errorf("stat GeoIP %s mmdb failed: %w", database.name, err))
continue
}
if exists {
continue
}
if err := u.download(ctx, database.path, database.downloadURL); err != nil {
errs = append(errs, fmt.Errorf("seed GeoIP %s mmdb failed: %w", database.name, err))
continue
}
slog.Info("seeded GeoIP mmdb via download", "database", database.name, "path", database.path)
}
return errors.Join(errs...)
}
func fileExists(path string) (bool, error) {
path = filepath.Clean(path)
if path == "" || path == "." {
return false, nil
}
info, err := os.Stat(path)
if err == nil {
if !info.Mode().IsRegular() {
return false, fmt.Errorf("GeoIP MMDB path is not a regular file: %s", path)
}
return true, nil
}
if os.IsNotExist(err) {
return false, nil
}
return false, err
}
func (u *Updater) download(ctx context.Context, path string, downloadURL string) error {
if u.downloadDatabase != nil {
return u.downloadDatabase(ctx, path, downloadURL)
}
return geoip.DownloadMaxMindDatabase(ctx, path, downloadURL)
}
func (u *Updater) managedDatabases() []struct {
name string
path string
downloadURL string
} {
return []struct {
name string
path string
downloadURL string
}{
{name: "Country", path: u.MMDBPath, downloadURL: u.DownloadURL},
{name: "City", path: u.CityMMDBPath, downloadURL: u.CityDownloadURL},
}
}
func (u *Updater) updateDatabases(ctx context.Context) error {
var errs []error
for _, database := range u.managedDatabases() {
if database.path == "" || database.downloadURL == "" {
continue
}
if err := u.download(ctx, database.path, database.downloadURL); err != nil {
errs = append(errs, fmt.Errorf("update GeoIP %s mmdb failed: %w", database.name, err))
continue
}
slog.Info("GeoIP mmdb updated", "database", database.name, "path", database.path)
}
return errors.Join(errs...)
}
// Run starts the periodic GeoIP update loop and blocks until ctx is cancelled.
func (u *Updater) Run(ctx context.Context) {
if u == nil || u.MMDBPath == "" || u.UpdateInterval <= 0 {
return
}
if err := u.EnsureInitialDatabases(ctx); err != nil {
slog.Warn("initialize GeoIP databases failed", "country_path", u.MMDBPath, "city_path", u.CityMMDBPath, "error", err)
}
ticker := time.NewTicker(u.UpdateInterval)
defer ticker.Stop()
for {
select {
case <-ctx.Done():
return
case <-ticker.C:
if err := u.updateDatabases(ctx); err != nil {
slog.Warn("update GeoIP databases failed", "error", err)
}
}
}
}
@@ -0,0 +1,116 @@
// Copyright 2026 Arctel.net
// SPDX-License-Identifier: Apache-2.0
package geoipupdate
import (
"context"
"errors"
"os"
"path/filepath"
"slices"
"strings"
"testing"
)
func TestEnsureInitialDatabasesDownloadsMissingOnly(t *testing.T) {
tempDir := t.TempDir()
countryPath := filepath.Join(tempDir, "GeoLite2-Country.mmdb")
cityPath := filepath.Join(tempDir, "GeoLite2-City.mmdb")
if err := os.WriteFile(cityPath, []byte("existing-city"), 0o600); err != nil {
t.Fatal(err)
}
var downloaded []string
updater := &Updater{
MMDBPath: countryPath,
DownloadURL: "https://geo.example/GeoLite2-Country.mmdb",
CityMMDBPath: cityPath,
CityDownloadURL: "https://geo.example/GeoLite2-City.mmdb",
downloadDatabase: func(_ context.Context, path, _ string) error {
downloaded = append(downloaded, path)
return os.WriteFile(path, []byte("downloaded"), 0o600)
},
}
if err := updater.EnsureInitialDatabases(context.Background()); err != nil {
t.Fatalf("EnsureInitialDatabases failed: %v", err)
}
if !slices.Equal(downloaded, []string{countryPath}) {
t.Fatalf("expected only missing Country download, got %#v", downloaded)
}
if data, err := os.ReadFile(cityPath); err != nil || string(data) != "existing-city" {
t.Fatalf("existing City must stay untouched, data=%q err=%v", data, err)
}
if data, err := os.ReadFile(countryPath); err != nil || string(data) != "downloaded" {
t.Fatalf("Country should be seeded via download, data=%q err=%v", data, err)
}
}
func TestEnsureInitialDatabasesNoOpWhenPresent(t *testing.T) {
tempDir := t.TempDir()
countryPath := filepath.Join(tempDir, "GeoLite2-Country.mmdb")
cityPath := filepath.Join(tempDir, "GeoLite2-City.mmdb")
if err := os.WriteFile(countryPath, []byte("c"), 0o600); err != nil {
t.Fatal(err)
}
if err := os.WriteFile(cityPath, []byte("city"), 0o600); err != nil {
t.Fatal(err)
}
updater := &Updater{
MMDBPath: countryPath,
DownloadURL: "https://geo.example/GeoLite2-Country.mmdb",
CityMMDBPath: cityPath,
CityDownloadURL: "https://geo.example/GeoLite2-City.mmdb",
downloadDatabase: func(_ context.Context, path, downloadURL string) error {
t.Fatalf("must not download when files exist: %s %s", path, downloadURL)
return nil
},
}
if err := updater.EnsureInitialDatabases(context.Background()); err != nil {
t.Fatalf("EnsureInitialDatabases failed: %v", err)
}
}
func TestUpdateDatabasesAttemptsCityAfterCountryFailure(t *testing.T) {
var paths []string
updater := &Updater{
MMDBPath: "/data/GeoLite2-Country.mmdb",
DownloadURL: "https://geo.example/GeoLite2-Country.mmdb",
CityMMDBPath: "/data/GeoLite2-City.mmdb",
CityDownloadURL: "https://geo.example/GeoLite2-City.mmdb",
downloadDatabase: func(_ context.Context, path, _ string) error {
paths = append(paths, path)
if path == "/data/GeoLite2-Country.mmdb" {
return errors.New("country unavailable")
}
return nil
},
}
err := updater.updateDatabases(context.Background())
if err == nil || !slices.Equal(paths, []string{"/data/GeoLite2-Country.mmdb", "/data/GeoLite2-City.mmdb"}) {
t.Fatalf("expected independent Country then City attempts, paths=%#v err=%v", paths, err)
}
}
func TestEnsureInitialDatabasesRejectsDirectoryPath(t *testing.T) {
tempDir := t.TempDir()
// Point Country path at a directory so fileExists must not treat it as seeded.
updater := &Updater{
MMDBPath: tempDir,
DownloadURL: "https://geo.example/GeoLite2-Country.mmdb",
downloadDatabase: func(_ context.Context, path, downloadURL string) error {
t.Fatalf("must not download when path is a directory: %s %s", path, downloadURL)
return nil
},
}
err := updater.EnsureInitialDatabases(context.Background())
if err == nil {
t.Fatal("expected error when MMDB path is a directory")
}
if !strings.Contains(err.Error(), "not a regular file") {
t.Fatalf("expected regular-file error, got %v", err)
}
}