marzban-cli
CLI for Marzban proxy panel administration
TLDR
List the administrators
$ marzban cli admin list
Create an administrator$ marzban cli admin create --username [username]
Change an administrator's details$ marzban cli admin update --username [username]
Delete an administrator$ marzban cli admin delete --username [username]
Import the administrator defined in the environment file$ marzban cli admin import-from-env
List the users$ marzban cli user list
Move a user to a different administrator$ marzban cli user set-owner --username [username] --owner [owner]
Print a user's subscription link$ marzban cli subscription get-link --username [username]
Generate the client configuration in a chosen format$ marzban cli subscription get-config --username [username] --format [v2ray]
Print the shell completion script$ marzban cli completion show [bash]
Install shell completion$ marzban cli completion install [bash]
SYNOPSIS
marzban cli [OPTIONS] COMMAND [ARGS]...
DESCRIPTION
marzban cli is the command-line interface for [Marzban](https://github.com/Gozargah/Marzban), an open-source proxy management panel built around Xray. It manages administrators, users, and subscription payloads without using the web UI.Admin passwords can be supplied non-interactively via `MARZBANADMINPASSWORD`. `admin import-from-env` creates a sudo admin from `SUDOUSERNAME`/`SUDOPASSWORD` and attaches unowned users to it.
PARAMETERS
admin
Manage panel administrators (`create`, `delete`, `list`, `update`, `import-from-env`)user
Manage users (`list`, `set-owner`)subscription
Subscription helpers (`get-config`, `get-link`)completion
Generate or install shell completion scriptsadmin create -u username
Create an admin; optional `--sudo`, `-tg`/`--telegram-id`, `-dc`/`--discord-webhook`user list
List users; filter with `-u`, `-s`/`--search`, `--status`, `--admin`/`--owner`subscription get-config -u username -f {v2ray|clash}
Generate subscription config; optional `-o`/`--output` and `--base64`subscription get-link -u username
Print subscription URL (requires `XRAYSUBSCRIPTIONURL_PREFIX`)
CAVEATS
Requires a working Marzban installation and database access (typically run on the panel host). `subscription get-link` needs `XRAYSUBSCRIPTIONURL_PREFIX` set correctly. `admin update` is interactive only.
HISTORY
Part of Marzban, a Python-based multi-protocol proxy panel by Gozargah.
