Skip to content

feat: add per-inbound user and traffic statistics - #48

Open
slashfast wants to merge 3 commits into
remnawave:mainfrom
slashfast:feature/inbound-tag-uuid-tracking
Open

slashfast wants to merge 3 commits into
remnawave:mainfrom
slashfast:feature/inbound-tag-uuid-tracking

Conversation

@slashfast

Copy link
Copy Markdown

Онлайн и трафик по инбаунду — нода

TL;DR

PR адаптирует ноду к отдельному email для каждого инбаунда.

Это нодовая часть к remnawave/backend#218. Раньше один пользователь имел одинаковый email во всех инбаундах:

userId

Теперь бэкенд панели для каждого инбаунда использует отдельный email:

userId@inboundUuid

Основная логика нод от формата email не зависит: нода получает email от панели и передаёт его в Xray как есть. Но два места сравнивали email с userId напрямую, и с новым форматом они перестали работать. PR исправляет эти два места.

Изменения

Torrent blocker: whitelist пользователей

Torrent blocker сверяет email из Xray webhook со списком игнорируемых пользователей. Список содержит userId, а email теперь имеет вид userId@inboundUuid. Поэтому пользователи из whitelist блокировались.

isUserIgnored теперь проверяет и email целиком, и userId, извлечённый из email по формату userId@inboundUuid 8741c5f8.

Изменение: torrent-blocker.state.ts.

Сброс сессий при смене credentials

Когда у пользователя меняется vlessUuid (prevVlessUuid в hashData), нода запрашивает его online IP и закрывает соединения через DropConnectionsEvent.

Раньше IP запрашивались только для email первого инбаунда в запросе. С per-inbound email сессии на остальных инбаундах не закрывались.

Теперь IP собираются по всем email из запроса 03a61c8f.

Изменение: handler.service.ts.

Переиспользованные паттерны

Online IP запрашиваются существующим getUserIps, соединения закрываются существующим DropConnectionsEvent. Новые API ноды и новые зависимости не добавлены.

Разбор email по формату userId@inboundUuid совпадает с helper'ом на стороне бэкенда: client-email.ts.

Совместимость

Изменение сохраняет совместимость со старым форматом email: plain userId в torrent blocker проверяется как раньше, а при смене credentials запрос с одним инбаундом обрабатывается так же, как до PR.

Миграционной логики для identities старого формата в PR нет: после рестарта ноды панель заново заполняет Xray пользователями с новыми email.

Нода с этим PR работает и с текущей панелью, и с панелью из backend#218.

Ветка основана на актуальном main (3.4.1).

Проверка

Локально проверено:

  • production build (Docker-образ из docker/Dockerfile);
  • tsc --noEmit;
  • форматирование изменённых файлов (oxfmt --check);
  • lint изменённых файлов (oxlint);
  • git diff --check.

Отсебятина

Изменение небольшое, но без него после backend#218 ломаются whitelist torrent blocker и сброс сессий при смене credentials.

Обсуждение на форуме.

@greptile-apps

greptile-apps Bot commented Sep 26, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerConfidence Score: 4/5

[Medium risk] Changes user identification logic in traffic filtering.

The PR should not merge until the torrent-blocker ignore matcher handles supported string user IDs.

Findings

  1. P1 Nonnumeric users lose whitelist protection ▶
  2. P2 Serial lookups delay credential rotation ▶

Summary

The PR adapts torrent-blocker ignore matching and credential-rotation connection cleanup to per-inbound usernames.

  • The ignore matcher still assumes numeric user IDs, leaving valid string IDs unprotected.
  • Serial online-IP lookups can delay rotations across multiple inbounds.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  A[Per-inbound email] --> B[Torrent ignore lookup]
  B --> C[Allow or block IP]
  D[Credential rotation] --> E[Look up IPs for each username]
  E --> F[Drop connections]
  F --> G[Replace Xray users]
Loading

Reviews (1) · Last reviewed commit: "fix(handler): drop all inbound sessions ..."

Comment thread src/modules/handler/handler.service.ts Resolved
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant