marzpy

A Python library that helps you easily use Marzban's API panel

installation

pip install marzpy

requirements : requests

How To Use

frommarzpyimportMarzbanpanel=Marzban("username","password","https://example.com")
mytoken=panel.get_token()
# panel.anyfunction()

Features

• Admin
  • get token
  • get admin
  • create admin
  • modify admin
  • remove admin
  • get all admins
• Subscription
  • user subscription
  • user subscription info
• System
  • get system stats
  • get inbounds
  • get hosts
  • modify hosts
• Core
  • get core stats
  • restart core
  • get core config
  • modify core config
• User
  • add user
  • get user
  • modify user
  • remove user
  • reset user data usage
  • reset all users data usage
  • get all users
  • get user usage
• User Template
  • get all user templates
  • add user template
  • get user template
  • modify user template
  • remove user template
• Node
  • add node
  • get node
  • modify node
  • remove node
  • get all nodes
  • reconenct node
  • get all nodes usage

Thanks To

• ErfanTech 😆

Examples

Get Token

frommarzpyimportMarzbanpanel=Marzban("username","password","https://example.com")
mytoken=panel.get_token()

Get Current admin

admin=panel.get_current_admin(token=mytoken)
print(admin) #output: {'username': 'admin', 'is_sudo': True}

Create Admin

info= {'username':'test','password':'pasword','is_sudo':False}
rsault=panel.create_admin(token=mytoken,data=info)
print(result) #output: success

Modify Admin

target_admin="test"info= {'password':'newpassword','is_sudo':False}
result=panel.change_admin_password(username=target_admin,token=mytoken,data=info)
print(result) #output: success

Remove Admin

target_admin="test"result=panel.delete_admin(username=target_admin,token=mytoken)
print(result) #output: success

Get All Admins

result=panel.get_all_admins(token=mytoken)
print(result) #output: [{'username': 'test', 'is_sudo': True}, {'username': 'test1', 'is_sudo': False}]

User Subscription

subscription_url="https://sub.yourdomain.com/sub/eyJhbGciOiJIUzI8NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJNbWRDcmFaeSIsImFjY2VzcyI8InN1YnNjcmlwdGlvbiIsImlhdCI1MTY5NDk1NTkxMH0.o75ML5835SPXpVPKXcvEIUxMTwSy-4XGS9NIdWOAmXY"result=panel.get_subscription(subscription_url)
print(result) #output: Configs

User Subscription info

subscription_url="https://sub.yourdomain.com/sub/eyJhbGciOiJIUzI8NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJNbWRDcmFaeSIsImFjY2VzcyI8InN1YnNjcmlwdGlvbiIsImlhdCI1MTY5NDk1NTkxMH0.o75ML5835SPXpVPKXcvEIUxMTwSy-4XGS9NIdWOAmXY"result=panel.get_subscription_info(subscription_url)
print(result) #output: User information (usage,links,inbounds,....)

Get System Stats

result=panel.get_system_stats(token=mytoken)
print(result) #output: system stats Memory & CPU usage ...

Get Inbounds

result=panel.get_inbounds(token=mytoken)
print(result) #output: list of inbounds

Get Hosts

result=panel.get_hosts(token=mytoken)
print(result) #output: list of hosts

Modify Hosts

hosts= {
"VMess TCP": [
{
"remark": "somename",
"address": "someaddress",
"port": 0,
"sni": "somesni",
"host": "somehost",
"security": "inbound_default",
"alpn": "",
"fingerprint": ""
}
]
}
# **Backup first**result=panel.modify_hosts(token=mytoken,data=hosts)
print(result) #output: hosts

Get Core Stats

result=panel.get_xray_core(token=mytoken)
print(result)
#output: {'version': '1.8.1', 'started': True, 'logs_websocket': '/api/core/logs'}

Restart Core

result=panel.restart_xray_core(token=mytoken)
print(result)
#output: success

Get Core Config

result=panel.get_xray_config(token=mytoken)
print(result) #output: your xray core config

Modify Core Config

new_config={"your config"}
result=panel.modify_xray_config(token=mytoken,config=new_config)
print(result) #output: success

Add User

frommarzpy.api.userimportUseruser=User(
username="Mewhrzad",
proxies={
"vmess": {"id": "35e7e39c-7d5c-1f4b-8b71-508e4f37ff53"},
"vless": {"id": "35e7e39c-7d5c-1f4b-8b71-508e4f37ff53"},
},
inbounds={"vmess": ["VMess TCP"], "vless": ["VLESS TCP REALITY"]},
expire=0,
data_limit=0,
data_limit_reset_strategy="no_reset",
)
result=panel.add_user(user=user, token=token) #return new User objectprint(result.username) #-> Mewhrzad, #user.proxies, #user.inbounds, #user.expire, #user.data_limit, #userdata_limit_reset_strategy, #user.status, #user.used_traffic, #user.lifetime_used_traffic, #user.created_at, #user.links, #user.subscription_url, #user.excluded_inbounds

Get User

result=panel.get_user("Mewhrzad",token=mytoken) #return User objectprint(result.subscription_url)

Modify User

new_user=User(
username="test",
proxies={
"vmess": {"id": "35e4e39c-7d5c-4f4b-8b71-558e4f37ff53"},
"vless": {"id": "35e4e39c-7d5c-4f4b-8b71-558e4f37ff53"},
},
inbounds={"vmess": ["VMess TCP"], "vless": ["VLESS TCP REALITY"]},
expire=0,
data_limit=0,
data_limit_reset_strategy="no_reset",
status="active",
)
result=panel.modify_user("Mewhrzad", token=mytoken, user=new_user)
print(result.subscription_url) #output: modified user object

Remove User

result=panel.delete_user("test", token=mytoken)
print(result) #output: success

Reset User Data Usage

result=panel.reset_user_traffic("test", token=mytoken)
print(result) #output: success

Reset All Users Data Usage

result=panel.reset_all_users_traffic(token=mytoken)
print(result) #output: success

Get All Users

result=panel.get_all_users(token=mytoken) #return list of usersforuserinresult:
print(user.username) 

Get User Usage

result=panel.get_user_usage("mewhrzad",token=mytoken)
print(result) #output: [{'node_id': None, 'node_name': 'MTN', 'used_traffic': 0}, #{'node_id': 1, 'node_name': 'MCI', 'used_traffic': 0}]

Get All User Templates

result=panel.get_all_templates(token=mytoken) #return template list objectfortemplateinresult:
print(template.name)

Add User Template

frommarzpy.api.templateimportTemplatetemp=Template(
name="new_template",
inbounds={"vmess": ["VMESS TCP"], "vless": ["VLESS TCP REALITY"]},
data_limit=0,
expire_duration=0,
username_prefix=None,
username_suffix=None,
)
result=panel.add_template(token=mytoken, template=temp) # return new Template objectprint(result.name) #output: new_template

Get User Template

template_id=11result=panel.get_template_by_id(token=mytoken, id=template_id) # return Template objectprint(result.name) #output: new_template

Modify User Template

frommarzpy.api.templateimportTemplatetemp=Template(
name="new_template2",
inbounds={"vmess": ["VMESS TCP"], "vless": ["VLESS TCP REALITY"]},
data_limit=0,
expire_duration=0,
username_prefix=None,
username_suffix=None,
)
result=panel.modify_template_by_id(
id=1, token=mytoken, template=temp) # return Modified Template objectprint(result.name) #output: new_template2

Remove User Template

result=panel.delete_template_by_id(id=1, token=mytoken)
print(result) #output: success

Add Node

frommarzpy.api.nodeimportNodemy_node=Node(
name="somename",
address="test.example.com",
port=62050,
api_port=62051,
certificate="your_cert",
id=4,
xray_version="1.8.1",
status="connected",
message="string",
)
result=panel.add_node(token=mytoken, node=my_node) # return new Node objectprint(result.address)

Get Node

result=panel.get_node_by_id(id=1, token=mytoken) # return exist Node objectprint(result.address) #output: address of node 1

Modify Node

frommarzpy.api.nodeimportNodemy_node=Node(
name="somename",
address="test.example.com",
port=62050,
api_port=62051,
certificate="your_cert",
id=4,
xray_version="1.8.1",
status="connected",
message="string",
)
result=panel.modify_node_by_id(id=1, token=mytoken,node=my_node) # return modified Node objectprint(result.address) #output:test.example.com

Remove Node

result=panel.delete_node(id=1, token=mytoken)
print(result) #output: success

Get All Nodes

result=panel.get_all_nodes(token=mytoken) # return List of Node objectfornodeinresult:
print(node.address)

Reconenct Node

result=panel.reconnect_node(id=1,token=mytoken)
print(result) #output: success

Get Node Usage

result=panel.get_nodes_usage(token=mytoken)
fornodeinresult:
print(node)
#output:{'node_id': 1, 'node_name': 'N1', 'uplink': 1000000000000, 'downlink': 1000000000000}# {'node_id': 2, 'node_name': 'N2', 'uplink': 1000000000000, 'downlink': 1000000000000}