Skip to content

Commit 476152b

Browse files
committed
docs: explain what the device limit counts (IP + HWID) in READMEs
The plan/user device limit is one number enforced two ways — concurrent unique source IPs (always, fleet-wide) and, with HWID binding on, distinct installs. Clarify both READMEs and cross-reference the client bot's split IP/HWID lines.
1 parent b4b5e14 commit 476152b

2 files changed

Lines changed: 41 additions & 24 deletions

File tree

README-RU.md

Lines changed: 20 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -226,25 +226,33 @@ rospanel node status # локальный статус
226226
#### 👤 Пользователи
227227

228228
Лимиты трафика и срок с авто-отключением и авто-сбросом квоты (день/неделя/месяц/год),
229-
**лимит устройств** по уникальным IP и **лимит скорости**. Учёт трафика через Xray Stats, онлайн-статус,
229+
**лимит устройств** (что именно он считает — см. *Привязка устройств* ниже) и **лимит скорости**. Учёт трафика через Xray Stats, онлайн-статус,
230230
список подключений; истёкших можно авто-удалять. Поиск и фильтры не тормозят на сотнях
231231
юзеров, а **групповые операции** (вкл/выкл/сброс/продление/удаление) идут одной
232232
перезагрузкой Xray. Дашборд — CPU / RAM / swap / диск и VPN-трафик в реальном времени. **Карта
233233
подключений** показывает, откуда подключаются клиенты — уникальные IP по странам,
234234
определяются по той же базе geoip, по которой маршрутизирует Xray (без внешних сервисов и
235235
без отдельной загрузки).
236236

237-
**Привязка устройств (HWID).** Клиенты, поддерживающие стандарт заголовков подписки (Happ,
238-
v2RayTun), присылают идентификатор установки; панель привязывает его к аккаунту при первом
239-
запросе и считает в лимите устройств. Когда слоты кончились, НОВОЕ устройство подписку не
240-
получает, а уже привязанные продолжают обновляться — проверка и вставка идут одной
241-
транзакцией, так что два клиента не займут последний слот одновременно. Список устройств
242-
виден в карточке пользователя и **на странице подписки**, где владелец сам отвязывает лишнее
243-
вместо письма в поддержку; молчащее устройство освобождает слот по TTL, а смена ссылки
244-
подписки отвязывает все. По умолчанию выключено (*Настройки → Подписки*); после включения
245-
клиент, который **не** присылает идентификатор, подписку не получает вовсе — лимит, который
246-
обходится сменой приложения, лимитом не является, — но есть переключатель обслуживать и
247-
таких (считая по IP, как раньше), если часть пользователей сидит на них.
237+
**Лимит устройств — что он считает.** Лимит устройств у пользователя (или заданный его тарифом) —
238+
**одно число, которое принуждается двумя способами**. Само по себе оно ограничивает **одновременные
239+
уникальные IP-адреса**: если юзер подключается с большего числа разных адресов, чем лимит, за окно
240+
онлайна — его отрубает от туннелей, пока он не станет ≤ лимита; считается **по всем серверам**
241+
(мастер и ноды), а не по каждому отдельно. `0` — без лимита по IP.
242+
243+
**Привязка устройств (HWID).** Включите — и **то же число** ограничивает ещё и число разных
244+
**установок**. Клиенты, поддерживающие стандарт заголовков подписки (Happ, v2RayTun), присылают
245+
идентификатор установки; панель привязывает его к аккаунту при первом запросе и считает в лимите.
246+
Когда слоты кончились, НОВАЯ установка подписку не получает, а уже привязанные продолжают
247+
обновляться — проверка и вставка идут одной транзакцией, так что два клиента не займут последний
248+
слот одновременно. (Если личный лимит юзера `0`, для HWID берётся общий панельный fallback-лимит.)
249+
Список устройств виден в карточке пользователя, в **клиентском боте** (отдельными строками *по IP* и
250+
*по HWID*, когда действуют оба) и **на странице подписки**, где владелец сам отвязывает лишнее вместо
251+
письма в поддержку; молчащее устройство освобождает слот по TTL, а смена ссылки подписки отвязывает
252+
все. По умолчанию выключено (*Настройки → Подписки*); после включения клиент, который **не** присылает
253+
идентификатор, подписку не получает вовсе — лимит, который обходится сменой приложения, лимитом не
254+
является, — но есть переключатель обслуживать и таких (считая по IP, как раньше), если часть
255+
пользователей сидит на них.
248256

249257
**Лимит скорости.** Персональный потолок в кбит/с — вручную или из тарифа. У Xray нет
250258
ограничения полосы на пользователя, поэтому лимит применяется уровнем ниже: планировщиком

README.md

Lines changed: 21 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -224,24 +224,33 @@ no domain and no DNS**.
224224
#### 👤 Users
225225

226226
Traffic and time limits with auto-disable and quota auto-reset (day/week/month/year), a
227-
**device limit** by unique IP and a per-user **speed cap**. Traffic accounting via Xray Stats, online status, connection
227+
**device limit** (see *Device binding* below for exactly what it counts) and a per-user
228+
**speed cap**. Traffic accounting via Xray Stats, online status, connection
228229
list; expired users can be auto-deleted. Search and filters stay fast with hundreds of users,
229230
and **bulk operations** (enable/disable/reset/extend/delete) go through a single Xray reload.
230231
The dashboard shows CPU / RAM / swap / disk and VPN traffic in real time. A **connection
231232
map** breaks down where clients connect from — distinct source IPs per country, resolved
232233
from the same geoip database Xray routes with (no external service, no extra download).
233234

234-
**Device binding (HWID).** Clients that follow the subscription-header convention (Happ,
235-
v2RayTun) send a stable install id; the panel binds it to the account on first fetch and
236-
counts it against the device limit. Once the limit is full a NEW device is refused the
237-
subscription while the bound ones keep updating — the check and the insert are one
238-
transaction, so two clients cannot both take the last slot. The devices are listed in the
239-
user card and **on the subscription page**, where the owner can release one themselves
240-
instead of writing to support; an idle device frees its slot after a configurable TTL, and
241-
rotating the subscription link releases them all. Off by default (*Settings →
242-
Subscriptions*); once on, a client that sends **no** id gets no subscription at all — a cap
243-
you can dodge by switching to a quieter app is not a cap — with a switch to serve those
244-
clients anyway (counted by address, as before) if some of your users are on them.
235+
**The device limit — what it counts.** A user's device limit (or the one their plan sets) is
236+
a **single number enforced two ways**. On its own it caps **concurrent unique source IPs**: a
237+
user connecting from more distinct addresses than the limit within the online window is
238+
dropped from the tunnels until they fall back under it — counted across **every server**
239+
(master and nodes), not per-server. `0` means no IP cap.
240+
241+
**Device binding (HWID).** Turn this on and the **same number** also caps distinct **installs**.
242+
Clients that follow the subscription-header convention (Happ, v2RayTun) send a stable install
243+
id; the panel binds it to the account on first fetch and counts it against the limit. Once the
244+
limit is full a NEW install is refused the subscription while the bound ones keep updating — the
245+
check and the insert are one transaction, so two clients cannot both take the last slot. (When a
246+
user's own limit is `0`, HWID uses a panel-wide fallback limit instead.) The devices are listed
247+
in the user card, in the **client bot** (as separate *by IP* and *by HWID* lines when both apply),
248+
and **on the subscription page**, where the owner can release one themselves instead of writing to
249+
support; an idle device frees its slot after a configurable TTL, and rotating the subscription
250+
link releases them all. Off by default (*Settings → Subscriptions*); once on, a client that sends
251+
**no** id gets no subscription at all — a cap you can dodge by switching to a quieter app is not a
252+
cap — with a switch to serve those clients anyway (counted by address, as before) if some of your
253+
users are on them.
245254

246255
**Speed limit.** A per-user cap in kbit/s, set by hand or by the tariff. Xray has no
247256
per-user bandwidth limit, so it is enforced below it — the kernel's own scheduler (HTB),

0 commit comments

Comments
 (0)