This commit is contained in:
2026-09-22 23:37:05 +03:00
parent cf1c31eb2a
commit 0fc35589e6
25 changed files with 2616 additions and 245 deletions

View File

@@ -45,8 +45,8 @@ Roles are Viewer (read), Operator (Fail2Ban and service actions), and
Administrator (server/firewall/policy administration). Every current mutation
is audited with actor, target, result, time, and source IP. Secrets are excluded.
The backend creates schema on startup. One-minute metric samples are retained 30
days (`METRICS_RETENTION=720h`) and agent logs seven days
The backend creates schema on startup. One-minute metric and connection samples
are retained 30 days (`METRICS_RETENTION=720h`); agent logs and Fail2Ban history seven days
(`LOGS_RETENTION=168h`). PostgreSQL is the only durable history store.
## Grafana and Loki-compatible access

View File

@@ -127,6 +127,9 @@ func (client *AgentClient) Do(ctx context.Context, server Server, method, path s
if err != nil {
return 0, nil, err
}
if method != http.MethodGet && method != http.MethodHead {
request.Close = true
}
request.Header.Set("Authorization", "Bearer "+token)
request.Header.Set("Accept", "application/json")
if len(body) > 0 {

View File

@@ -5,6 +5,7 @@ import (
"crypto/subtle"
"encoding/json"
"errors"
"fmt"
"io"
"log"
"net"
@@ -275,6 +276,7 @@ func (app *App) serverRoute(writer http.ResponseWriter, request *http.Request, u
"listeners": "/v1/network/listeners", "connections": "/v1/network/connections",
"firewall": "/v1/firewall/rules", "fail2ban": "/v1/fail2ban/status",
"wireguard": "/v1/wireguard/status", "services": "/v1/services",
"rate-limits": "/v1/rate-limits",
}
if len(parts) == 2 && request.Method == http.MethodGet {
if parts[1] == "metrics" {
@@ -295,6 +297,25 @@ func (app *App) serverRoute(writer http.ResponseWriter, request *http.Request, u
writeJSON(writer, 200, entries)
return
}
if parts[1] == "connection-history" {
hours := queryHours(request, 24, 24*30)
history, historyErr := app.store.ConnectionHistory(request.Context(), server.ID, time.Now().Add(-time.Duration(hours)*time.Hour))
if historyErr != nil {
writeInternal(writer, historyErr)
return
}
writeJSON(writer, 200, history)
return
}
if parts[1] == "fail2ban-history" {
events, eventErr := app.store.Fail2BanEvents(request.Context(), server.ID, queryLimit(request, 200, 1000))
if eventErr != nil {
writeInternal(writer, eventErr)
return
}
writeJSON(writer, 200, events)
return
}
if agentPath, found := readRoutes[parts[1]]; found {
app.proxyRead(writer, request, server, agentPath)
return
@@ -311,11 +332,51 @@ func (app *App) serverRoute(writer http.ResponseWriter, request *http.Request, u
app.fail2banMutation(writer, request, user, server, parts[2])
return
}
if len(parts) == 4 && request.Method == http.MethodPost && parts[1] == "services" && parts[3] == "restart" && validServiceName(parts[2]) {
if !app.authorize(writer, request, user, csrfHash, RoleOperator) {
if len(parts) == 3 && request.Method == http.MethodPost && parts[1] == "fail2ban" && parts[2] == "configure" {
if !app.authorize(writer, request, user, csrfHash, RoleAdministrator) {
return
}
app.serviceMutation(writer, request, user, server, parts[2])
app.fail2banConfigure(writer, request, user, server)
return
}
if len(parts) == 4 && request.Method == http.MethodPost && parts[1] == "services" && validServiceName(parts[2]) {
operation := parts[3]
requiredRole := RoleOperator
if operation == "install" {
requiredRole = RoleAdministrator
}
if !app.authorize(writer, request, user, csrfHash, requiredRole) {
return
}
app.serviceMutation(writer, request, user, server, parts[2], operation)
return
}
if len(parts) == 3 && parts[1] == "firewall" && parts[2] == "rules" && request.Method == http.MethodPost {
if !app.authorize(writer, request, user, csrfHash, RoleAdministrator) {
return
}
app.firewallAdd(writer, request, user, server)
return
}
if len(parts) == 4 && parts[1] == "firewall" && parts[2] == "rules" && request.Method == http.MethodDelete {
if !app.authorize(writer, request, user, csrfHash, RoleAdministrator) {
return
}
app.managedDelete(writer, request, user, server, "firewall", parts[3])
return
}
if len(parts) == 2 && parts[1] == "rate-limits" && request.Method == http.MethodPost {
if !app.authorize(writer, request, user, csrfHash, RoleAdministrator) {
return
}
app.rateLimitAdd(writer, request, user, server)
return
}
if len(parts) == 3 && parts[1] == "rate-limits" && request.Method == http.MethodDelete {
if !app.authorize(writer, request, user, csrfHash, RoleAdministrator) {
return
}
app.managedDelete(writer, request, user, server, "rate-limits", parts[2])
return
}
writeError(writer, 404, "not found", "not_found")
@@ -352,18 +413,25 @@ func (app *App) fail2banMutation(writer http.ResponseWriter, request *http.Reque
writeError(writer, 502, "agent unavailable", "agent_unavailable")
return
}
if status < 300 {
app.store.AddFail2BanEvent(request.Context(), server.ID, input.Jail, input.IP, action, "operator")
}
writeAgentResponse(writer, status, response)
}
func (app *App) serviceMutation(writer http.ResponseWriter, request *http.Request, user User, server Server, name string) {
func (app *App) serviceMutation(writer http.ResponseWriter, request *http.Request, user User, server Server, name, operation string) {
if !contains([]string{"start", "stop", "restart", "enable", "disable", "install"}, operation) {
writeError(writer, 400, "invalid service operation", "invalid_request")
return
}
status, response, err := app.agent.Do(request.Context(), server, http.MethodPost,
"/v1/services/"+url.PathEscape(name)+"/restart", []byte("{}"))
"/v1/services/"+url.PathEscape(name)+"/"+operation, []byte("{}"))
result := "success"
if err != nil || status >= 300 {
result = "failure"
}
app.store.Audit(request.Context(), &user, server.ID, "service.restart", name, nil,
map[string]string{"requested": "restart"}, result, app.clientIP(request))
app.store.Audit(request.Context(), &user, server.ID, "service."+operation, name, nil,
map[string]string{"requested": operation}, result, app.clientIP(request))
if err != nil {
writeError(writer, 502, "agent unavailable", "agent_unavailable")
return
@@ -371,6 +439,141 @@ func (app *App) serviceMutation(writer http.ResponseWriter, request *http.Reques
writeAgentResponse(writer, status, response)
}
func (app *App) firewallAdd(writer http.ResponseWriter, request *http.Request, user User, server Server) {
var input struct {
Interface string `json:"interface"`
Source string `json:"source"`
Protocol string `json:"protocol"`
Port int `json:"port"`
Target string `json:"target"`
Comment string `json:"comment"`
}
if decodeJSON(writer, request, &input) != nil || !validInterface(input.Interface) || !validIPv4CIDR(input.Source) || !contains([]string{"tcp", "udp"}, input.Protocol) || input.Port < 1 || input.Port > 65535 || !contains([]string{"ACCEPT", "DROP", "REJECT"}, input.Target) || !validComment(input.Comment) {
writeError(writer, 400, "invalid firewall rule", "invalid_request")
return
}
app.forwardMutation(writer, request, user, server, "firewall.add", fmt.Sprintf("%s/%s:%d", input.Source, input.Protocol, input.Port), "/v1/firewall/rules", http.MethodPost, input)
}
func (app *App) rateLimitAdd(writer http.ResponseWriter, request *http.Request, user User, server Server) {
var input struct {
Interface string `json:"interface"`
Source string `json:"source"`
Protocol string `json:"protocol"`
Port int `json:"port"`
Rate int `json:"rate_per_second"`
Burst int `json:"burst"`
Comment string `json:"comment"`
}
if decodeJSON(writer, request, &input) != nil || !validInterface(input.Interface) || !validIPv4CIDR(input.Source) || !contains([]string{"tcp", "udp"}, input.Protocol) || input.Port < 1 || input.Port > 65535 || input.Rate < 1 || input.Rate > 100000 || input.Burst < 1 || input.Burst > 10000 || !validComment(input.Comment) {
writeError(writer, 400, "invalid rate-limit policy", "invalid_request")
return
}
app.forwardMutation(writer, request, user, server, "rate_limit.add", fmt.Sprintf("%s/%s:%d", input.Source, input.Protocol, input.Port), "/v1/rate-limits", http.MethodPost, input)
}
func (app *App) managedDelete(writer http.ResponseWriter, request *http.Request, user User, server Server, kind, id string) {
if len(id) != 16 {
writeError(writer, 400, "invalid managed object id", "invalid_request")
return
}
for _, character := range id {
if !((character >= '0' && character <= '9') || (character >= 'a' && character <= 'f') || (character >= 'A' && character <= 'F')) {
writeError(writer, 400, "invalid managed object id", "invalid_request")
return
}
}
path := "/v1/firewall/rules/" + id
action := "firewall.delete"
if kind == "rate-limits" {
path = "/v1/rate-limits/" + id
action = "rate_limit.delete"
}
app.forwardMutation(writer, request, user, server, action, id, path, http.MethodDelete, map[string]string{"id": id})
}
func (app *App) fail2banConfigure(writer http.ResponseWriter, request *http.Request, user User, server Server) {
var input struct {
Jail string `json:"jail"`
Enabled bool `json:"enabled"`
BanTime int `json:"bantime_seconds"`
FindTime int `json:"findtime_seconds"`
MaxRetry int `json:"maxretry"`
}
if decodeJSON(writer, request, &input) != nil || !validSimpleName(input.Jail) || input.BanTime < 10 || input.BanTime > 2592000 || input.FindTime < 10 || input.FindTime > 86400 || input.MaxRetry < 1 || input.MaxRetry > 100 {
writeError(writer, 400, "invalid Fail2Ban settings", "invalid_request")
return
}
app.forwardMutation(writer, request, user, server, "fail2ban.configure", input.Jail, "/v1/fail2ban/configure", http.MethodPost, input)
}
func (app *App) forwardMutation(writer http.ResponseWriter, request *http.Request, user User, server Server, action, target, path, method string, input any) {
body, _ := json.Marshal(input)
status, response, err := app.agent.Do(request.Context(), server, method, path, body)
if err == nil && status < 300 && (strings.HasPrefix(action, "firewall.") || strings.HasPrefix(action, "rate_limit.")) {
var pending struct {
TransactionID string `json:"transaction_id"`
}
if json.Unmarshal(response, &pending) != nil || len(pending.TransactionID) != 16 {
err = errors.New("agent returned invalid firewall transaction")
} else {
confirmPath := "/v1/firewall/transactions/" + pending.TransactionID + "/confirm"
confirmStatus, confirmResponse, confirmErr := app.agent.Do(request.Context(), server, http.MethodPost, confirmPath, []byte("{}"))
if confirmErr != nil || confirmStatus >= 300 {
err = errors.New("firewall confirmation failed; safety rollback remains armed")
} else {
status = confirmStatus
response = confirmResponse
}
}
}
result := "success"
if err != nil || status >= 300 {
result = "failure"
}
app.store.Audit(request.Context(), &user, server.ID, action, target, nil, input, result, app.clientIP(request))
if err != nil {
writeError(writer, 502, "agent unavailable", "agent_unavailable")
return
}
writeAgentResponse(writer, status, response)
}
func contains(values []string, wanted string) bool {
for _, value := range values {
if value == wanted {
return true
}
}
return false
}
func validInterface(value string) bool {
if len(value) < 1 || len(value) > 15 {
return false
}
for _, c := range value {
if !(c >= 'a' && c <= 'z') && !(c >= 'A' && c <= 'Z') && !(c >= '0' && c <= '9') && !strings.ContainsRune("_.-", c) {
return false
}
}
return true
}
func validIPv4CIDR(value string) bool {
ip, _, err := net.ParseCIDR(value)
return err == nil && ip.To4() != nil
}
func validComment(value string) bool {
if len(value) > 80 {
return false
}
for _, c := range value {
if !(c >= 'a' && c <= 'z') && !(c >= 'A' && c <= 'Z') && !(c >= '0' && c <= '9') && !strings.ContainsRune(" ._-", c) {
return false
}
}
return true
}
func (app *App) clientIP(request *http.Request) string {
if app.config.TrustProxy {
if value := request.Header.Get("X-Real-IP"); net.ParseIP(value) != nil {
@@ -434,6 +637,17 @@ func queryLimit(request *http.Request, fallback, maximum int) int {
return value
}
func queryHours(request *http.Request, fallback, maximum int) int {
value, err := strconv.Atoi(request.URL.Query().Get("hours"))
if err != nil || value < 1 {
return fallback
}
if value > maximum {
return maximum
}
return value
}
func writeAgentResponse(writer http.ResponseWriter, status int, payload []byte) {
if status < 100 || status > 599 {
status = http.StatusBadGateway

View File

@@ -54,6 +54,15 @@ func TestValidators(t *testing.T) {
if !validServiceName("wg-quick@wg0") || validServiceName("nginx/restart") {
t.Fatal("service validation failed")
}
if !validInterface("wg0") || validInterface("../../eth0") {
t.Fatal("interface validation failed")
}
if !validIPv4CIDR("192.168.50.0/24") || validIPv4CIDR("2001:db8::/64") || validIPv4CIDR("0.0.0.0/99") {
t.Fatal("firewall CIDR validation failed")
}
if !validComment("web access") || validComment("bad;reboot") {
t.Fatal("firewall comment validation failed")
}
}
func TestPercent(t *testing.T) {

View File

@@ -75,6 +75,35 @@ CREATE TABLE IF NOT EXISTS agent_log_entries (
);
CREATE INDEX IF NOT EXISTS agent_log_entries_time_idx ON agent_log_entries(event_at DESC);
CREATE INDEX IF NOT EXISTS agent_log_entries_server_time_idx ON agent_log_entries(server_id, event_at DESC);
CREATE TABLE IF NOT EXISTS connection_samples (
server_id text NOT NULL REFERENCES servers(id) ON DELETE CASCADE,
sampled_at timestamptz NOT NULL DEFAULT now(),
protocol text NOT NULL,
local_address text NOT NULL,
local_port integer NOT NULL CHECK (local_port BETWEEN 0 AND 65535),
remote_address text NOT NULL,
remote_port integer NOT NULL CHECK (remote_port BETWEEN 0 AND 65535),
state text NOT NULL,
process text NOT NULL DEFAULT '',
connection_count integer NOT NULL CHECK (connection_count > 0)
);
CREATE INDEX IF NOT EXISTS connection_samples_server_time_idx ON connection_samples(server_id, sampled_at DESC);
CREATE TABLE IF NOT EXISTS fail2ban_events (
id bigserial PRIMARY KEY,
server_id text NOT NULL REFERENCES servers(id) ON DELETE CASCADE,
event_at timestamptz NOT NULL DEFAULT now(),
jail text NOT NULL,
ip text NOT NULL,
action text NOT NULL CHECK (action IN ('ban','unban')),
source text NOT NULL
);
CREATE INDEX IF NOT EXISTS fail2ban_events_server_time_idx ON fail2ban_events(server_id, event_at DESC);
CREATE TABLE IF NOT EXISTS fail2ban_ban_state (
server_id text NOT NULL REFERENCES servers(id) ON DELETE CASCADE,
jail text NOT NULL,
ip text NOT NULL,
PRIMARY KEY(server_id,jail,ip)
);
CREATE TABLE IF NOT EXISTS audit_events (
id bigserial PRIMARY KEY,
user_id text REFERENCES users(id) ON DELETE SET NULL,
@@ -139,6 +168,37 @@ type AgentLogEntry struct {
PID *int `json:"pid,omitempty"`
}
type ConnectionHistoryRow struct {
Protocol string `json:"protocol"`
LocalAddress string `json:"local_address"`
LocalPort int `json:"local_port"`
RemoteAddress string `json:"remote_address"`
Process string `json:"process"`
Samples int64 `json:"samples"`
Peak int `json:"peak"`
FirstSeen time.Time `json:"first_seen"`
LastSeen time.Time `json:"last_seen"`
}
type ConnectionTimelinePoint struct {
SampledAt time.Time `json:"sampled_at"`
Count int64 `json:"count"`
}
type ConnectionHistory struct {
Rows []ConnectionHistoryRow `json:"rows"`
Timeline []ConnectionTimelinePoint `json:"timeline"`
}
type Fail2BanEvent struct {
ID int64 `json:"id"`
EventAt time.Time `json:"event_at"`
Jail string `json:"jail"`
IP string `json:"ip"`
Action string `json:"action"`
Source string `json:"source"`
}
type MetricPoint struct {
ServerID string
ServerName string
@@ -372,6 +432,84 @@ func (store *Store) Logs(ctx context.Context, serverID string, limit int) ([]Age
return entries, rows.Err()
}
func (store *Store) ConnectionHistory(ctx context.Context, serverID string, since time.Time) (ConnectionHistory, error) {
result := ConnectionHistory{Rows: []ConnectionHistoryRow{}, Timeline: []ConnectionTimelinePoint{}}
rows, err := store.pool.Query(ctx, `SELECT protocol,local_address,local_port,remote_address,process,
SUM(connection_count),MAX(connection_count),MIN(sampled_at),MAX(sampled_at)
FROM connection_samples WHERE server_id=$1 AND sampled_at >= $2
GROUP BY protocol,local_address,local_port,remote_address,process
ORDER BY SUM(connection_count) DESC LIMIT 500`, serverID, since)
if err != nil {
return result, err
}
defer rows.Close()
for rows.Next() {
var row ConnectionHistoryRow
if err = rows.Scan(&row.Protocol, &row.LocalAddress, &row.LocalPort, &row.RemoteAddress, &row.Process, &row.Samples, &row.Peak, &row.FirstSeen, &row.LastSeen); err != nil {
return result, err
}
result.Rows = append(result.Rows, row)
}
if err = rows.Err(); err != nil {
return result, err
}
timeline, err := store.pool.Query(ctx, `SELECT date_bin(interval '5 minutes',sampled_at,timestamptz 'epoch'),SUM(connection_count)
FROM connection_samples WHERE server_id=$1 AND sampled_at >= $2
GROUP BY 1 ORDER BY 1 LIMIT 9000`, serverID, since)
if err != nil {
return result, err
}
defer timeline.Close()
for timeline.Next() {
var point ConnectionTimelinePoint
if err = timeline.Scan(&point.SampledAt, &point.Count); err != nil {
return result, err
}
result.Timeline = append(result.Timeline, point)
}
return result, timeline.Err()
}
func (store *Store) Fail2BanEvents(ctx context.Context, serverID string, limit int) ([]Fail2BanEvent, error) {
rows, err := store.pool.Query(ctx, `SELECT id,event_at,jail,ip,action,source FROM fail2ban_events
WHERE server_id=$1 ORDER BY event_at DESC LIMIT $2`, serverID, limit)
if err != nil {
return nil, err
}
defer rows.Close()
events := []Fail2BanEvent{}
for rows.Next() {
var event Fail2BanEvent
if err = rows.Scan(&event.ID, &event.EventAt, &event.Jail, &event.IP, &event.Action, &event.Source); err != nil {
return nil, err
}
events = append(events, event)
}
return events, rows.Err()
}
func (store *Store) AddFail2BanEvent(ctx context.Context, serverID, jail, ip, action, source string) {
tx, err := store.pool.Begin(ctx)
if err != nil {
log.Printf("write Fail2Ban event: %v", err)
return
}
defer tx.Rollback(ctx)
if _, err = tx.Exec(ctx, `INSERT INTO fail2ban_events(server_id,jail,ip,action,source) VALUES($1,$2,$3,$4,$5)`, serverID, jail, ip, action, source); err == nil {
if action == "ban" {
_, err = tx.Exec(ctx, `INSERT INTO fail2ban_ban_state(server_id,jail,ip) VALUES($1,$2,$3) ON CONFLICT DO NOTHING`, serverID, jail, ip)
} else {
_, err = tx.Exec(ctx, `DELETE FROM fail2ban_ban_state WHERE server_id=$1 AND jail=$2 AND ip=$3`, serverID, jail, ip)
}
}
if err == nil {
err = tx.Commit(ctx)
}
if err != nil {
log.Printf("write Fail2Ban event: %v", err)
}
}
func (store *Store) MetricSeries(ctx context.Context) ([]map[string]string, error) {
rows, err := store.pool.Query(ctx, "SELECT id,name FROM servers ORDER BY id LIMIT 1000")
if err != nil {

View File

@@ -5,6 +5,7 @@ import (
"encoding/json"
"fmt"
"log"
"net"
"net/http"
"net/url"
"regexp"
@@ -41,6 +42,8 @@ func (poller *Poller) Run(ctx context.Context) {
if _, err := poller.store.pool.Exec(ctx, "DELETE FROM agent_log_entries WHERE event_at < $1", time.Now().Add(-poller.logRetention)); err != nil {
log.Printf("log retention cleanup: %v", err)
}
_, _ = poller.store.pool.Exec(ctx, "DELETE FROM connection_samples WHERE sampled_at < $1", time.Now().Add(-poller.metricRetention))
_, _ = poller.store.pool.Exec(ctx, "DELETE FROM fail2ban_events WHERE event_at < $1", time.Now().Add(-poller.logRetention))
_, _ = poller.store.pool.Exec(ctx, "DELETE FROM sessions WHERE expires_at < now()")
}
}
@@ -119,13 +122,26 @@ func (poller *Poller) pollServer(ctx context.Context, server Server) {
}
}
}
type socket struct {
Protocol string `json:"protocol"`
LocalAddress string `json:"local_address"`
LocalPort int `json:"local_port"`
RemoteAddress string `json:"remote_address"`
RemotePort int `json:"remote_port"`
State string `json:"state"`
Process *string `json:"process"`
}
connections := 0
connectionRows := []socket{}
if code, payload, callErr := poller.agent.Do(ctx, server, http.MethodGet, "/v1/network/connections", nil); callErr == nil && code == 200 {
var items []json.RawMessage
if json.Unmarshal(payload, &items) == nil {
connections = len(items)
if json.Unmarshal(payload, &connectionRows) == nil {
if len(connectionRows) > 10000 {
connectionRows = connectionRows[:10000]
}
connections = len(connectionRows)
}
}
bans := poller.pollFail2Ban(ctx, server)
txDB, err := poller.store.pool.Begin(ctx)
if err != nil {
return
@@ -134,7 +150,41 @@ func (poller *Poller) pollServer(ctx context.Context, server Server) {
_, err = txDB.Exec(ctx, "UPDATE servers SET status='online',hostname=$2,last_seen=now(),updated_at=now() WHERE id=$1", server.ID, status.Hostname)
if err == nil {
_, err = txDB.Exec(ctx, `INSERT INTO metric_samples(server_id,cpu,memory,disk,rx,tx,connections,bans)
VALUES($1,$2,$3,$4,$5,$6,$7,0)`, server.ID, status.CPU, memory, disk, rx, tx, connections)
VALUES($1,$2,$3,$4,$5,$6,$7,$8)`, server.ID, status.CPU, memory, disk, rx, tx, connections, bans)
}
if err == nil {
type aggregate struct {
row socket
count int
}
grouped := map[string]aggregate{}
for _, row := range connectionRows {
if net.ParseIP(row.LocalAddress) == nil || net.ParseIP(row.RemoteAddress) == nil || row.LocalPort < 0 || row.LocalPort > 65535 || row.RemotePort < 0 || row.RemotePort > 65535 || len(row.Protocol) > 8 || len(row.State) > 32 {
continue
}
process := ""
if row.Process != nil {
process = truncateUTF8(*row.Process, 128)
}
key := fmt.Sprintf("%s\x00%s\x00%d\x00%s\x00%d\x00%s\x00%s", row.Protocol, row.LocalAddress, row.LocalPort, row.RemoteAddress, row.RemotePort, row.State, process)
entry := grouped[key]
entry.row = row
entry.row.Process = &process
entry.count++
grouped[key] = entry
}
inserted := 0
for _, entry := range grouped {
if inserted >= 2000 {
break
}
_, err = txDB.Exec(ctx, `INSERT INTO connection_samples(server_id,protocol,local_address,local_port,remote_address,remote_port,state,process,connection_count)
VALUES($1,$2,$3,$4,$5,$6,$7,$8,$9)`, server.ID, entry.row.Protocol, entry.row.LocalAddress, entry.row.LocalPort, entry.row.RemoteAddress, entry.row.RemotePort, entry.row.State, *entry.row.Process, entry.count)
if err != nil {
break
}
inserted++
}
}
if err == nil {
err = txDB.Commit(ctx)
@@ -145,6 +195,78 @@ func (poller *Poller) pollServer(ctx context.Context, server Server) {
poller.pollLogs(ctx, server)
}
func (poller *Poller) pollFail2Ban(ctx context.Context, server Server) int {
status, payload, err := poller.agent.Do(ctx, server, http.MethodGet, "/v1/fail2ban/status", nil)
if err != nil || status != http.StatusOK {
return 0
}
var response struct {
JailStatuses []struct {
Jail string `json:"jail"`
Banned []string `json:"banned_ips"`
} `json:"jail_statuses"`
}
if json.Unmarshal(payload, &response) != nil || len(response.JailStatuses) > 64 {
return 0
}
current := map[string][2]string{}
total := 0
for _, jail := range response.JailStatuses {
if !validSimpleName(jail.Jail) || len(jail.Banned) > 10000 {
continue
}
for _, ip := range jail.Banned {
if net.ParseIP(ip) != nil {
current[jail.Jail+"\x00"+ip] = [2]string{jail.Jail, ip}
total++
}
}
}
rows, err := poller.store.pool.Query(ctx, "SELECT jail,ip FROM fail2ban_ban_state WHERE server_id=$1", server.ID)
if err != nil {
return total
}
previous := map[string][2]string{}
for rows.Next() {
var jail, ip string
if rows.Scan(&jail, &ip) == nil {
previous[jail+"\x00"+ip] = [2]string{jail, ip}
}
}
rows.Close()
tx, err := poller.store.pool.Begin(ctx)
if err != nil {
return total
}
defer tx.Rollback(ctx)
for key, value := range current {
if _, found := previous[key]; !found {
_, err = tx.Exec(ctx, "INSERT INTO fail2ban_events(server_id,jail,ip,action,source) VALUES($1,$2,$3,'ban','agent')", server.ID, value[0], value[1])
if err != nil {
return total
}
}
}
for key, value := range previous {
if _, found := current[key]; !found {
_, err = tx.Exec(ctx, "INSERT INTO fail2ban_events(server_id,jail,ip,action,source) VALUES($1,$2,$3,'unban','agent')", server.ID, value[0], value[1])
if err != nil {
return total
}
}
}
if _, err = tx.Exec(ctx, "DELETE FROM fail2ban_ban_state WHERE server_id=$1", server.ID); err != nil {
return total
}
for _, value := range current {
if _, err = tx.Exec(ctx, "INSERT INTO fail2ban_ban_state(server_id,jail,ip) VALUES($1,$2,$3)", server.ID, value[0], value[1]); err != nil {
return total
}
}
_ = tx.Commit(ctx)
return total
}
func (poller *Poller) pollLogs(ctx context.Context, server Server) {
var cursor string
var since time.Time

View File

@@ -7,7 +7,7 @@ import {
} from 'lucide-react'
import { api, APIError, formatBytes, formatDuration } from './api'
import type {
AgentLogEntry, AuditEvent, FirewallStatus, Interface, JailStatus, MetricSample, Role, Server, Service,
AgentLogEntry, AuditEvent, ConnectionHistory, Fail2BanEvent, FirewallRule, FirewallStatus, Interface, JailStatus, MetricSample, Role, Server, Service,
SocketInfo, SystemStatus, User, WireGuardInterface,
} from './types'
@@ -108,14 +108,14 @@ function PageContent({page,server,servers,user}:{page:Page;server?:Server;server
switch (page) {
case 'Overview': return <Overview server={server}/>
case 'Network': return <NetworkPage server={server}/>
case 'Firewall': return <FirewallPage server={server}/>
case 'Firewall': return <FirewallPage server={server} role={user.role}/>
case 'Connections': return <ConnectionsPage server={server}/>
case 'Security': return <SecurityPage server={server}/>
case 'Fail2Ban': return <Fail2BanPage server={server} role={user.role}/>
case 'WireGuard': return <WireGuardPage server={server}/>
case 'Services': return <ServicesPage server={server} role={user.role}/>
case 'Logs': return <LogsPage server={server}/>
case 'Rate Limits': return <RateLimitsPage/>
case 'Rate Limits': return <RateLimitsPage server={server} role={user.role}/>
default: return null
}
}
@@ -160,19 +160,28 @@ function NetworkPage({server}:{server:Server}) {
<DataPanel query={routes}><Card title="Kernel routes" badge="Read only"><pre className="code-block">{JSON.stringify(routes.data,null,2)}</pre></Card></DataPanel></div>
}
function FirewallPage({server}:{server:Server}) {
const firewall = useServerData<FirewallStatus>(server,'firewall',30_000)
return <DataPanel query={firewall}><div className="stack"><div className="notice"><Shield/><div><strong>{firewall.data?.backend ?? 'Unknown'} backend</strong><span>Rules are read-only in v1. Unknown and external rules are never mutated.</span></div></div>
<Card title="Managed by VPS Control" badge={firewall.data?.management_enabled?'Enabled':'Disabled'}><EmptyLine text={`Reserved table: ${firewall.data?.managed_table ?? 'inet vps_control'}. Crash-safe privileged helper is required before writes can be enabled.`}/></Card>
<Card title="External / unmanaged rules" badge="Read only">{firewall.data?.warning&&<div className="inline-warning">{firewall.data.warning}</div>}<pre className="code-block tall">{JSON.stringify(firewall.data?.ruleset,null,2)}</pre></Card></div></DataPanel>
function FirewallPage({server,role}:{server:Server;role:Role}) {
const queryClient=useQueryClient(); const firewall=useServerData<FirewallStatus>(server,'firewall',15_000)
const add=useMutation({mutationFn:(body:unknown)=>api(`/servers/${server.id}/firewall/rules`,{method:'POST',body:JSON.stringify(body)}),onSuccess:()=>void queryClient.invalidateQueries({queryKey:['server',server.id,'firewall']})})
const remove=useMutation({mutationFn:(id:string)=>api(`/servers/${server.id}/firewall/rules/${id}`,{method:'DELETE'}),onSuccess:()=>void queryClient.invalidateQueries({queryKey:['server',server.id,'firewall']})})
const submit=(event:FormEvent<HTMLFormElement>)=>{event.preventDefault();const data=new FormData(event.currentTarget);add.mutate({interface:data.get('interface'),source:data.get('source'),protocol:data.get('protocol'),port:Number(data.get('port')),target:data.get('target'),comment:data.get('comment')})}
const rules=firewall.data?.rules??[]
return <DataPanel query={firewall}><div className="stack"><div className="notice"><Shield/><div><strong>{firewall.data?.backend??'Unknown'} · persistent {firewall.data?.persistence_enabled?'on':'off'}</strong><span>All chains are visible. VPS Control only mutates rules marked as managed in {firewall.data?.managed_chain}.</span></div></div>
{firewall.data?.warning&&<div className="inline-warning">{firewall.data.warning}</div>}
<Card title="Add managed rule" badge={firewall.data?.management_enabled?'Enabled':'Helper unavailable'}><form className="action-form wide" onSubmit={submit}><select name="interface" required>{firewall.data?.allowed_interfaces.map(value=><option key={value}>{value}</option>)}</select><select name="source" required>{firewall.data?.allowed_sources.map(value=><option key={value}>{value}</option>)}</select><select name="protocol"><option>tcp</option><option>udp</option></select><select name="port" required>{firewall.data?.allowed_ports.map(value=><option key={value}>{value}</option>)}</select><select name="target"><option>ACCEPT</option><option>DROP</option><option>REJECT</option></select><input name="comment" placeholder="control panel"/><button className="primary" disabled={role!=='administrator'||!firewall.data?.management_enabled||add.isPending}>Add rule</button>{add.error&&<small className="danger">{add.error.message}</small>}</form></Card>
<Card title="iptables rules" badge={`${rules.length} rules`}><Table headers={['Managed','Table / chain','Protocol','Source','Interface','Port','Target','Counters','Action']} rows={rules.map(rule=>[rule.managed?'Yes':'External',<code>{rule.table} / {rule.chain}</code>,rule.protocol,<code>{rule.source}</code>,rule.in_interface||'—',rule.destination_port??'—',<Pill text={rule.target||'jump'}/>,`${rule.packets} / ${formatBytes(rule.bytes)}`,rule.managed&&!rule.rate_limit?<button className="table-action" disabled={role!=='administrator'||remove.isPending} onClick={()=>remove.mutate(rule.id)}>Delete</button>:'—'])}/></Card>
</div></DataPanel>
}
function ConnectionsPage({server}:{server:Server}) {
const connections = useServerData<SocketInfo[]>(server,'connections',10_000)
const [filter,setFilter] = useState('')
const [filter,setFilter] = useState(''); const [hours,setHours]=useState(24)
const history=useServerData<ConnectionHistory>(server,`connection-history?hours=${hours}`,30_000)
const rows=(connections.data??[]).filter((item)=>`${item.protocol} ${item.remote_address} ${item.local_port} ${item.state}`.toLowerCase().includes(filter.toLowerCase()))
const states=useMemo(()=>Object.entries(rows.reduce<Record<string,number>>((all,item)=>({...all,[item.state]:(all[item.state]??0)+1}),{})).sort((a,b)=>b[1]-a[1]),[rows])
return <DataPanel query={connections}><div className="stack"><div className="summary-row">{states.slice(0,4).map(([name,count])=><Stat key={name} label={name} value={count}/>)}</div><Card title="Current connections" badge={`${rows.length} sockets`} action={<input className="filter" placeholder="Filter protocol, IP, port…" value={filter} onChange={(e)=>setFilter(e.target.value)}/>}><Table headers={['Protocol','Local','Remote','State','Process']} rows={rows.map(item=>[item.protocol.toUpperCase(),<code>{item.local_address}:{item.local_port}</code>,<code>{item.remote_address}:{item.remote_port}</code>,<Pill text={item.state}/>,item.process?`${item.process} · ${item.pid}`:'—'])}/></Card></div></DataPanel>
return <DataPanel query={connections}><div className="stack"><div className="summary-row">{states.slice(0,4).map(([name,count])=><Stat key={name} label={name} value={count}/>)}</div><Card title="Current connections" badge={`${rows.length} sockets`} action={<input className="filter" placeholder="Filter protocol, IP, port…" value={filter} onChange={(e)=>setFilter(e.target.value)}/>}><Table headers={['Protocol','Destination','Source','State','Process']} rows={rows.map(item=>[item.protocol.toUpperCase(),<code>{item.local_address}:{item.local_port}</code>,<code>{item.remote_address}:{item.remote_port}</code>,<Pill text={item.state}/>,item.process?`${item.process} · ${item.pid}`:'—'])}/></Card>
<DataPanel query={history}><Card title="Connection statistics" badge={`Last ${hours}h`} action={<select value={hours} onChange={event=>setHours(Number(event.target.value))}><option value="1">1 hour</option><option value="24">24 hours</option><option value="168">7 days</option><option value="720">30 days</option></select>}><Table headers={['Source','Destination','Protocol','Process','Observed','Peak','First / last']} rows={(history.data?.rows??[]).map(item=>[<code>{item.remote_address}</code>,<code>{item.local_address}:{item.local_port}</code>,item.protocol.toUpperCase(),item.process||'—',item.samples,item.peak,<span>{new Date(item.first_seen).toLocaleString()}<br/>{new Date(item.last_seen).toLocaleString()}</span>])}/></Card></DataPanel>
</div></DataPanel>
}
function SecurityPage({server}:{server:Server}) {
@@ -183,10 +192,15 @@ function SecurityPage({server}:{server:Server}) {
}
function Fail2BanPage({server,role}:{server:Server;role:Role}) {
const queryClient=useQueryClient(); const status=useServerData<JailStatus>(server,'fail2ban',15_000)
const queryClient=useQueryClient(); const status=useServerData<JailStatus>(server,'fail2ban',15_000); const history=useServerData<Fail2BanEvent[]>(server,'fail2ban-history?limit=500',30_000)
const mutation=useMutation({mutationFn:(input:{action:'ban'|'unban';jail:string;ip:string})=>api(`/servers/${server.id}/fail2ban/${input.action}`,{method:'POST',body:JSON.stringify(input)}),onSuccess:()=>void queryClient.invalidateQueries({queryKey:['server',server.id,'fail2ban']})})
const configure=useMutation({mutationFn:(body:unknown)=>api(`/servers/${server.id}/fail2ban/configure`,{method:'POST',body:JSON.stringify(body)}),onSuccess:()=>void queryClient.invalidateQueries({queryKey:['server',server.id,'fail2ban']})})
const submit=(event:FormEvent<HTMLFormElement>)=>{event.preventDefault();const data=new FormData(event.currentTarget);mutation.mutate({action:data.get('action') as 'ban'|'unban',jail:String(data.get('jail')),ip:String(data.get('ip'))})}
return <DataPanel query={status}><div className="split"><Card title="Daemon status" badge={status.data?.running?'Running':'Unavailable'}><div className="details"><Stat label="Installed" value={status.data?.installed?'Yes':'No'}/><Stat label="Version" value={status.data?.version??'—'}/><Stat label="Jails" value={status.data?.jails.length??0}/></div><div className="tag-list">{status.data?.jails.map(jail=><span key={jail}>{jail}</span>)}</div></Card><Card title="Manual action" badge="Audited"><form className="action-form" onSubmit={submit}><select name="action"><option value="ban">Ban</option><option value="unban">Unban</option></select><select name="jail" required>{status.data?.jails.map(jail=><option key={jail}>{jail}</option>)}</select><input name="ip" required placeholder="192.0.2.20"/><button className="primary" disabled={role==='viewer'||mutation.isPending}>Apply</button>{role==='viewer'&&<small>Operator role required.</small>}{mutation.error&&<small className="danger">{mutation.error.message}</small>}</form></Card></div></DataPanel>
const submitConfig=(event:FormEvent<HTMLFormElement>)=>{event.preventDefault();const data=new FormData(event.currentTarget);configure.mutate({jail:data.get('jail'),enabled:data.get('enabled')==='on',bantime_seconds:Number(data.get('bantime')),findtime_seconds:Number(data.get('findtime')),maxretry:Number(data.get('maxretry'))})}
return <DataPanel query={status}><div className="stack"><div className="split"><Card title="Daemon status" badge={status.data?.running?'Running':'Unavailable'}><div className="details"><Stat label="Installed" value={status.data?.installed?'Yes':'No'}/><Stat label="Version" value={status.data?.version??'—'}/><Stat label="Jails" value={status.data?.jails.length??0}/></div><Table headers={['Jail','Failed','Banned now','Banned total','IPs']} rows={(status.data?.jail_statuses??[]).map(jail=>[jail.jail,jail.currently_failed,jail.currently_banned,jail.total_banned,jail.banned_ips.join(', ')||'—'])}/></Card><Card title="Manual action" badge="Audited"><form className="action-form" onSubmit={submit}><select name="action"><option value="ban">Ban</option><option value="unban">Unban</option></select><select name="jail" required>{status.data?.jails.map(jail=><option key={jail}>{jail}</option>)}</select><input name="ip" required placeholder="192.0.2.20"/><button className="primary" disabled={role==='viewer'||mutation.isPending}>Apply</button>{mutation.error&&<small className="danger">{mutation.error.message}</small>}</form></Card></div>
<Card title="Managed jail settings" badge={status.data?.management_enabled?'Enabled':'Helper unavailable'}><form className="action-form wide" onSubmit={submitConfig}><select name="jail" required>{status.data?.manageable_jails.map(jail=><option key={jail}>{jail}</option>)}</select><label><input name="enabled" type="checkbox" defaultChecked/> Enabled</label><input name="bantime" type="number" defaultValue="3600" min="10" max="2592000"/><input name="findtime" type="number" defaultValue="600" min="10" max="86400"/><input name="maxretry" type="number" defaultValue="5" min="1" max="100"/><button className="primary" disabled={role!=='administrator'||!status.data?.management_enabled||configure.isPending}>Save</button>{configure.error&&<small className="danger">{configure.error.message}</small>}</form></Card>
<DataPanel query={history}><Card title="Restriction history" badge={`${history.data?.length??0} events`}><Table headers={['Time','Jail','IP','Action','Source']} rows={(history.data??[]).map(event=>[new Date(event.event_at).toLocaleString(),event.jail,<code>{event.ip}</code>,<Pill text={event.action}/>,event.source])}/></Card></DataPanel>
</div></DataPanel>
}
function WireGuardPage({server}:{server:Server}) {
@@ -196,8 +210,8 @@ function WireGuardPage({server}:{server:Server}) {
function ServicesPage({server,role}:{server:Server;role:Role}) {
const queryClient=useQueryClient(); const query=useServerData<Service[]>(server,'services',15_000)
const mutation=useMutation({mutationFn:(name:string)=>api(`/servers/${server.id}/services/${encodeURIComponent(name)}/restart`,{method:'POST',body:'{}'}),onSuccess:()=>void queryClient.invalidateQueries({queryKey:['server',server.id,'services']})})
return <DataPanel query={query}><Card title="Allow-listed systemd services" badge={`${query.data?.length??0} configured`}><Table headers={['State','Unit','Sub-state','PID','Memory','Action']} rows={(query.data??[]).map(item=>[<StatusDot status={item.active_state==='active'?'online':'offline'}/>,<code>{item.name}</code>,item.sub_state,item.pid||'—',formatBytes(item.memory_bytes),<button className="table-action" disabled={role==='viewer'||mutation.isPending} onClick={()=>mutation.mutate(item.name)}><ListRestart/>Restart</button>])}/></Card></DataPanel>
const mutation=useMutation({mutationFn:(input:{name:string;operation:string})=>api(`/servers/${server.id}/services/${encodeURIComponent(input.name)}/${input.operation}`,{method:'POST',body:'{}'}),onSuccess:()=>void queryClient.invalidateQueries({queryKey:['server',server.id,'services']})})
return <DataPanel query={query}><Card title="Systemd service inventory" badge={`${query.data?.length??0} units`}><Table headers={['State','Unit','Load / runtime','Boot','Description','Managed actions']} rows={(query.data??[]).map(item=>[<StatusDot status={item.active_state==='active'?'online':'offline'}/>,<code>{item.name}</code>,`${item.load_state} / ${item.sub_state}`,item.unit_file_state,item.description,item.managed?<div className="table-actions">{item.load_state==='not-found'&&item.install_available?<button className="table-action" disabled={role!=='administrator'||mutation.isPending} onClick={()=>mutation.mutate({name:item.name,operation:'install'})}>Install</button>:<><button className="table-action" disabled={role==='viewer'||mutation.isPending} onClick={()=>mutation.mutate({name:item.name,operation:item.active_state==='active'?'restart':'start'})}><ListRestart/>{item.active_state==='active'?'Restart':'Start'}</button><button className="table-action" disabled={role==='viewer'||mutation.isPending} onClick={()=>mutation.mutate({name:item.name,operation:'stop'})}>Stop</button><button className="table-action" disabled={role==='viewer'||mutation.isPending} onClick={()=>mutation.mutate({name:item.name,operation:item.unit_file_state==='enabled'?'disable':'enable'})}>{item.unit_file_state==='enabled'?'Disable boot':'Enable boot'}</button></>}</div>:'Read only'])}/></Card></DataPanel>
}
function ServersPage({servers,user}:{servers:Server[];user:User}) {
@@ -223,7 +237,13 @@ function LogsPage({server}:{server:Server}) {
])}/></Card>
</div></DataPanel>
}
function RateLimitsPage(){return <div className="notice"><Gauge/><div><strong>Policy engine is not enabled in v1</strong><span>L4 nftables policies require the crash-safe privileged helper. L7 provider configuration is planned separately; arbitrary nginx edits will not be supported.</span></div></div>}
function RateLimitsPage({server,role}:{server:Server;role:Role}){
const queryClient=useQueryClient(); const query=useServerData<FirewallRule[]>(server,'rate-limits',15_000); const firewall=useServerData<FirewallStatus>(server,'firewall',30_000)
const add=useMutation({mutationFn:(body:unknown)=>api(`/servers/${server.id}/rate-limits`,{method:'POST',body:JSON.stringify(body)}),onSuccess:()=>void queryClient.invalidateQueries({queryKey:['server',server.id,'rate-limits']})})
const remove=useMutation({mutationFn:(id:string)=>api(`/servers/${server.id}/rate-limits/${id}`,{method:'DELETE'}),onSuccess:()=>void queryClient.invalidateQueries({queryKey:['server',server.id,'rate-limits']})})
const submit=(event:FormEvent<HTMLFormElement>)=>{event.preventDefault();const data=new FormData(event.currentTarget);add.mutate({interface:data.get('interface'),source:data.get('source'),protocol:data.get('protocol'),port:Number(data.get('port')),rate_per_second:Number(data.get('rate')),burst:Number(data.get('burst')),comment:data.get('comment')})}
return <DataPanel query={query}><div className="stack"><div className="notice"><Gauge/><div><strong>L4 policy engine</strong><span>Policies use iptables hashlimit in a dedicated chain. Nginx configuration is not edited.</span></div></div><Card title="Add rate limit" badge="Per source IP"><form className="action-form wide" onSubmit={submit}><select name="interface" required>{firewall.data?.allowed_interfaces.map(value=><option key={value}>{value}</option>)}</select><select name="source" required>{firewall.data?.allowed_sources.map(value=><option key={value}>{value}</option>)}</select><select name="protocol"><option>tcp</option><option>udp</option></select><select name="port" required>{firewall.data?.allowed_ports.map(value=><option key={value}>{value}</option>)}</select><input name="rate" type="number" required min="1" defaultValue="10"/><input name="burst" type="number" required min="1" defaultValue="20"/><input name="comment" placeholder="https-new-connections"/><button className="primary" disabled={role!=='administrator'||!firewall.data?.management_enabled||add.isPending}>Create</button>{add.error&&<small className="danger">{add.error.message}</small>}</form></Card><Card title="Active policies" badge={`${query.data?.length??0}`}><Table headers={['ID','Source','Interface','Protocol / port','Counters','Action']} rows={(query.data??[]).filter(rule=>rule.target==='ACCEPT').map(rule=>[<code>{rule.id}</code>,<code>{rule.source}</code>,rule.in_interface,`${rule.protocol}/${rule.destination_port??'—'}`,`${rule.packets} / ${formatBytes(rule.bytes)}`,<button className="table-action" disabled={role!=='administrator'||remove.isPending} onClick={()=>remove.mutate(rule.id)}>Delete</button>])}/></Card></div></DataPanel>
}
function SettingsPage({user,server}:{user:User;server?:Server}){return <div className="split"><Card title="Current account" badge={user.role}><div className="details"><Stat label="Username" value={user.username}/><Stat label="Role" value={user.role}/><Stat label="Session" value="HttpOnly + CSRF"/></div></Card><Card title="Agent target" badge={server?.status??'none'}><div className="details"><Stat label="Name" value={server?.name??'—'}/><Stat label="Endpoint" value={server?.agent_endpoint??'—'}/><Stat label="Last contact" value={server?.last_seen?new Date(server.last_seen).toLocaleString():'—'}/></div></Card></div>}
function Metric({label,value,sub,level}:{label:string;value:string;sub:string;level?:number}){return <div className="metric"><span className="eyebrow">{label}</span><strong>{value}</strong><small>{sub}</small>{level!==undefined&&<div className="meter"><i style={{width:`${Math.min(100,Math.max(0,level))}%`}}/></div>}</div>}

View File

@@ -5,3 +5,4 @@
@media(max-width:1050px){.metric-grid{grid-template-columns:repeat(2,1fr)}.overview-grid,.split{grid-template-columns:1fr}.action-form{grid-template-columns:1fr 1fr}.action-form button{grid-column:2}.compact{grid-template-columns:repeat(3,1fr)}}
@media(max-width:760px){.shell{display:block}.sidebar{position:fixed;left:-250px;width:236px;transition:left .2s}.sidebar.open{left:0}.scrim{position:fixed;inset:0;background:rgba(0,0,0,.55);border:0;z-index:15}.mobile-close{display:grid;margin-left:auto}.menu-button{display:grid}.topbar{padding:0 14px}.breadcrumb{display:none}.content{padding:20px 14px}.connection{display:none}.page-header{height:auto;min-height:62px}.last-seen{display:none}.metric-grid,.compact{grid-template-columns:1fr}.metric{min-height:115px}.server-form,.action-form{grid-template-columns:1fr}.action-form button{grid-column:auto}.server-grid{grid-template-columns:1fr}.filter{width:160px}.panel-loading{grid-template-columns:1fr}.panel-loading i:nth-child(n+2){display:none}}
.log-message{display:block;min-width:260px;max-width:760px;white-space:pre-wrap;overflow-wrap:anywhere;font-family:'DM Mono',ui-monospace,monospace;color:var(--muted);line-height:1.45}
.action-form.wide{grid-template-columns:repeat(auto-fit,minmax(130px,1fr))}.action-form label{display:flex;align-items:center;gap:7px;color:var(--muted);font-size:11px}.action-form label input[type=checkbox]{width:16px;height:16px}.table-actions{display:flex;align-items:center;gap:6px}

View File

@@ -13,10 +13,15 @@ export interface SystemStatus {
}
export interface Interface { name: string; state: string; addresses: string[]; rx_bytes: number; tx_bytes: number }
export interface SocketInfo { protocol: string; local_address: string; local_port: number; remote_address: string; remote_port: number; state: string; pid?: number; process?: string }
export interface Service { name: string; active_state: string; sub_state: string; pid: number; memory_bytes?: number }
export interface JailStatus { installed: boolean; running: boolean; version?: string; jails: string[] }
export interface Service { name: string; load_state:string; active_state: string; sub_state: string; description:string; unit_file_state:string; managed:boolean; install_available:boolean }
export interface JailDetail { jail:string; currently_failed:number; total_failed:number; currently_banned:number; total_banned:number; banned_ips:string[] }
export interface JailStatus { installed: boolean; running: boolean; version?: string; jails: string[]; jail_statuses:JailDetail[]; management_enabled:boolean; manageable_jails:string[] }
export interface WireGuardInterface { name: string; public_key: string; listen_port: number; peers: Array<{public_key:string;endpoint?:string;allowed_ips:string[];latest_handshake:number;rx_bytes:number;tx_bytes:number}> }
export interface FirewallStatus { backend: string; management_enabled: boolean; managed_table: string; ruleset: unknown; warning?: string }
export interface FirewallRule { id:string; table:string; chain:string; protocol:string; source:string; destination:string; in_interface:string; out_interface:string; destination_port?:number; target:string; packets:number; bytes:number; comment:string; managed:boolean; rate_limit:boolean }
export interface FirewallStatus { backend: string; management_enabled: boolean; persistence_enabled:boolean; managed_chain: string; allowed_interfaces:string[]; allowed_sources:string[]; allowed_ports:number[]; rules:FirewallRule[]; warning?: string }
export interface AuditEvent { id: number; username: string; server_id?: string; action: string; target: string; result: string; source_ip: string; created_at: string }
export interface MetricSample { sampled_at:string; cpu:number; memory:number; disk:number; rx:number; tx:number; connections:number; bans:number }
export interface AgentLogEntry { server_id:string; timestamp:string; unit:string; priority:number; message:string; boot_id?:string; pid?:number }
export interface ConnectionHistoryRow { protocol:string; local_address:string; local_port:number; remote_address:string; process:string; samples:number; peak:number; first_seen:string; last_seen:string }
export interface ConnectionHistory { rows:ConnectionHistoryRow[]; timeline:Array<{sampled_at:string;count:number}> }
export interface Fail2BanEvent { id:number; event_at:string; jail:string; ip:string; action:'ban'|'unban'; source:string }