dan9i10/xray-core
1
0
Fork 0
mirror of https://github.com/XTLS/Xray-core.git synced 2026-05-08 14:13:22 +00:00
Code Issues Packages Projects Releases Wiki Activity

API & Commands: Add GetUsersStatsRequest(); Improve api statsonlineiplist (#5776)

Browse Source 
https://github.com/XTLS/Xray-core/pull/5776#issuecomment-4230007504
This commit is contained in:
Yury Kastov
2026-04-11 22:09:24 +03:00
committed by GitHub
parent 32937846c5
commit a91a88c7b2
10 changed files with 580 additions and 116 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
features/stats/stats.go
View File

@@ -2,7 +2,6 @@ package stats
import (
"context"
"time"
"github.com/xtls/xray-core/common"
"github.com/xtls/xray-core/common/errors"
@@ -21,7 +20,7 @@ type Counter interface {
Add(int64) int64
}
// OnlineMap is the interface for stats.
// OnlineMap is the interface for tracking online IP addresses.
//
// xray:api:stable
type OnlineMap interface {
@@ -31,10 +30,10 @@ type OnlineMap interface {
AddIP(string)
// RemoveIP decrements the reference count for the given IP. Deletes at zero.
RemoveIP(string)
// List returns all currently online IPs.
List() []string
// IPTimeMap returns a snapshot copy of IPs to their last-seen times.
IPTimeMap() map[string]time.Time
// ForEach calls fn for each online IP with its last-seen Unix timestamp.
// If fn returns false, iteration stops.
// The callback must not call AddIP/RemoveIP on the same OnlineMap (would deadlock).
ForEach(func(string, int64) bool)
}
// Channel is the interface for stats channel.
@@ -86,13 +85,19 @@ type Manager interface {
UnregisterCounter(string) error
// GetCounter returns a counter by its identifier.
GetCounter(string) Counter
// VisitCounters calls visitor on all managed counters.
// The visitor runs under a read lock; it must not call RegisterCounter or UnregisterCounter (would deadlock).
VisitCounters(func(string, Counter) bool)
// RegisterOnlineMap registers a new onlinemap to the manager. The identifier string must not be empty, and unique among other onlinemaps.
// RegisterOnlineMap registers a new OnlineMap to the manager. The identifier string must not be empty, and unique among other OnlineMaps.
RegisterOnlineMap(string) (OnlineMap, error)
// UnregisterOnlineMap unregisters a onlinemap from the manager by its identifier.
// UnregisterOnlineMap unregisters an OnlineMap from the manager by its identifier.
UnregisterOnlineMap(string) error
// GetOnlineMap returns a onlinemap by its identifier.
// GetOnlineMap returns an OnlineMap by its identifier.
GetOnlineMap(string) OnlineMap
// VisitOnlineMaps calls visitor on all managed online maps.
// The visitor runs under a read lock; it must not call RegisterOnlineMap or UnregisterOnlineMap (would deadlock).
VisitOnlineMaps(func(string, OnlineMap) bool)
// RegisterChannel registers a new channel to the manager. The identifier string must not be empty, and unique among other channels.
RegisterChannel(string) (Channel, error)
@@ -115,7 +120,7 @@ func GetOrRegisterCounter(m Manager, name string) (Counter, error) {
return m.RegisterCounter(name)
}
// GetOrRegisterOnlineMap tries to get the OnlineMap first. If not exist, it then tries to create a new onlinemap.
// GetOrRegisterOnlineMap tries to get the OnlineMap first. If not exist, it then tries to create a new OnlineMap.
func GetOrRegisterOnlineMap(m Manager, name string) (OnlineMap, error) {
onlineMap := m.GetOnlineMap(name)
if onlineMap != nil {
@@ -142,7 +147,7 @@ func ManagerType() interface{} {
return (*Manager)(nil)
}
// NoopManager is an implementation of Manager, which doesn't has actual functionalities.
// NoopManager is an implementation of Manager, which doesn't have actual functionality.
type NoopManager struct{}
// Type implements common.HasType.
@@ -165,6 +170,9 @@ func (NoopManager) GetCounter(string) Counter {
return nil
}
// VisitCounters implements Manager.
func (NoopManager) VisitCounters(func(string, Counter) bool) {}
// RegisterOnlineMap implements Manager.
func (NoopManager) RegisterOnlineMap(string) (OnlineMap, error) {
return nil, errors.New("not implemented")
@@ -180,6 +188,9 @@ func (NoopManager) GetOnlineMap(string) OnlineMap {
return nil
}
// VisitOnlineMaps implements Manager.
func (NoopManager) VisitOnlineMaps(func(string, OnlineMap) bool) {}
// RegisterChannel implements Manager.
func (NoopManager) RegisterChannel(string) (Channel, error) {
return nil, errors.New("not implemented")