feat(widget): 优化访客在线轨迹、GeoIP与多站点渠道
CI / Frontend (typecheck + lint + build) (push) Successful in 2m5s
CI / Backend (go vet + test) (push) Failing after 5m20s

This commit is contained in:
yml2213
2026-11-06 18:21:30 +08:00
parent 24fac1bcf1
commit 38d6fc1684
37 changed files with 1071 additions and 123 deletions
+136
View File
@@ -0,0 +1,136 @@
package geoip
import (
"fmt"
"net"
"strings"
"sync"
"time"
"github.com/oschwald/geoip2-golang"
)
const cacheTTL = 30 * time.Minute
type Location struct {
CountryCode string
Country string
Province string
City string
Region string
}
type cacheEntry struct {
location Location
found bool
expireAt time.Time
}
var (
reader *geoip2.Reader
cacheMu sync.Mutex
cache = map[string]cacheEntry{}
cacheCap = 10_000
)
// Init opens an optional MaxMind GeoLite2/GeoIP2 City database.
func Init(path string) error {
Close()
path = strings.TrimSpace(path)
if path == "" {
return nil
}
opened, err := geoip2.Open(path)
if err != nil {
return fmt.Errorf("打开 GeoIP 数据库失败: %w", err)
}
reader = opened
return nil
}
func Close() {
if reader != nil {
_ = reader.Close()
reader = nil
}
cacheMu.Lock()
cache = map[string]cacheEntry{}
cacheMu.Unlock()
}
func Enabled() bool {
return reader != nil
}
func Lookup(ip string) (Location, bool) {
parsed := net.ParseIP(strings.TrimSpace(ip))
if parsed == nil || reader == nil {
return Location{}, false
}
now := time.Now()
cacheMu.Lock()
if cached, ok := cache[ip]; ok && now.Before(cached.expireAt) {
cacheMu.Unlock()
return cached.location, cached.found
}
cacheMu.Unlock()
city, err := reader.City(parsed)
if err != nil {
return Location{}, false
}
location := Location{
CountryCode: strings.ToUpper(city.Country.IsoCode),
Country: localizedName(city.Country.Names),
City: localizedName(city.City.Names),
}
if len(city.Subdivisions) > 0 {
location.Province = localizedName(city.Subdivisions[len(city.Subdivisions)-1].Names)
}
location.Region = buildRegion(location)
found := location.Country != "" || location.Province != "" || location.City != ""
cacheMu.Lock()
if len(cache) >= cacheCap {
for key, item := range cache {
if now.After(item.expireAt) {
delete(cache, key)
}
}
}
if len(cache) < cacheCap {
cache[ip] = cacheEntry{location: location, found: found, expireAt: now.Add(cacheTTL)}
}
cacheMu.Unlock()
return location, found
}
func localizedName(names map[string]string) string {
for _, key := range []string{"zh-CN", "zh", "en"} {
if value := strings.TrimSpace(names[key]); value != "" {
return value
}
}
for _, value := range names {
if value = strings.TrimSpace(value); value != "" {
return value
}
}
return ""
}
func buildRegion(location Location) string {
parts := make([]string, 0, 3)
for _, value := range []string{location.Country, location.Province, location.City} {
value = strings.TrimSpace(value)
if value == "" {
continue
}
if len(parts) > 0 && parts[len(parts)-1] == value {
continue
}
parts = append(parts, value)
}
return strings.Join(parts, " ")
}
+21
View File
@@ -0,0 +1,21 @@
package geoip
import "testing"
func TestBuildRegion(t *testing.T) {
got := buildRegion(Location{Country: "中国", Province: "广东省", City: "深圳市"})
if got != "中国 广东省 深圳市" {
t.Fatalf("buildRegion=%q", got)
}
got = buildRegion(Location{Country: "中国", Province: "中国", City: ""})
if got != "中国" {
t.Fatalf("重复地区应去重: %q", got)
}
}
func TestLocalizedNamePrefersChinese(t *testing.T) {
got := localizedName(map[string]string{"en": "China", "zh-CN": "中国"})
if got != "中国" {
t.Fatalf("应优先中文名: %q", got)
}
}
+22
View File
@@ -0,0 +1,22 @@
package geoip
import (
"os"
"testing"
)
func TestLookupWithConfiguredDatabase(t *testing.T) {
path := os.Getenv("GEOIP_TEST_DB")
if path == "" {
t.Skip("未设置 GEOIP_TEST_DB")
}
if err := Init(path); err != nil {
t.Fatal(err)
}
defer Close()
location, ok := Lookup("8.8.8.8")
if !ok || location.Country == "" {
t.Fatalf("GeoIP 查询失败: %+v ok=%v", location, ok)
}
}