Files
3m-ui/docs/users-limits.md
T

1.4 KiB
Raw Blame History

User limits: IP and subscription pulls

Panel fields on each ProxyUser (Users page / API).

IP limit (ip_limit)

Value Meaning
0 Unlimited concurrent source IPs
N ≥ 1 At most N distinct client source IPs online at once

How it works: the traffic collector polls Mihomo connections about every 5 seconds. Connections that cannot be attributed to a user are ignored. When a user exceeds N source IPs, excess IPs’ connections are closed (not blocked at handshake time).

Subscription pull limit (sub_pull_limit)

Value Meaning
0 Unlimited successful subscription fetches
N ≥ 1 At most N successful pulls per rolling 24 hours

Exceeded → HTTP 429 with Retry-After and JSON error: subscription pull limit reached (per 24h).

HTML subscription pages and client downloads both count.

  • User CRUD: ip_limit, sub_pull_limit on create/update
  • Subscription: public /api/v1/client/sub/{token} (and aliases)

Quick create (one-click)

Panel Users → Quick create (or POST /api/v1/users/quick):

  • Username optional (u + random if empty)
  • Password and UUID auto-generated; returned once in the response / UI dialog
  • Optional bind all local nodes

Full form create remains POST /api/v1/users. OpenAPI: GET /api/v1/openapi.yaml.