### Install MTProxyMax using One-Line Installer

Source: https://context7.com/samnet-dev/mtproxymax/llms.txt

Installs MTProxyMax using a convenient one-line bash script that guides the user through an interactive setup wizard. This method is recommended for quick and easy deployment.

```bash
sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/SamNet-dev/MTProxyMax/main/install.sh)"
```

--------------------------------

### mtproxymax Replication Setup and Status

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands for setting up and managing replication between mtproxymax instances. Includes commands to initiate setup, check status, trigger syncs, view logs, test connectivity, and promote a slave to master. It relies on a master generating a sync script and a systemd timer for periodic synchronization.

```bash
mtproxymax replication setup
mtproxymax replication status
mtproxymax replication sync
mtproxymax replication logs
mtproxymax replication test
mtproxymax replication promote
```

--------------------------------

### Install MTProxyMax Manually

Source: https://context7.com/samnet-dev/mtproxymax/llms.txt

Provides instructions for manually installing MTProxyMax by downloading the script, making it executable, and running the install command. This method offers more control over the installation process.

```bash
curl -fsSL https://raw.githubusercontent.com/SamNet-dev/MTProxyMax/main/mtproxymax.sh -o mtproxymax
chmod +x mtproxymax
sudo ./mtproxymax install
```

--------------------------------

### Manage Proxy Lifecycle

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands to control the installation, status, and execution state of the proxy service.

```bash
mtproxymax install
mtproxymax uninstall
mtproxymax start
mtproxymax stop
mtproxymax restart
mtproxymax status
mtproxymax menu
```

--------------------------------

### mtproxymax Ad-Tag Monetization Setup

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Command to set up ad-tag monetization. Requires a hex value obtained from MTProxyBot. This feature enables users to see a pinned channel, allowing the proxy owner to earn revenue.

```bash
mtproxymax adtag set <hex_from_MTProxyBot>
```

--------------------------------

### mtproxymax Proxy Chaining (Upstream Routing)

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Demonstrates how to configure upstream routing for traffic through intermediate servers using SOCKS5, SOCKS4, or direct routing. Supports authentication and weight-based load balancing. Hostnames are resolved by the engine. Example configurations show routing percentages and credentials.

```bash
# Route 20% through Cloudflare WARP
mtproxymax upstream add warp socks5 127.0.0.1:40000 - - 20

# Route through a backup VPS
mtproxymax upstream add backup socks5 203.0.113.50:1080 user pass 80

# Hostnames are supported (resolved by the engine)
mtproxymax upstream add remote socks5 my-proxy.example.com:1080 user pass 50
```

--------------------------------

### Manage MTProxyMax Proxy Lifecycle

Source: https://context7.com/samnet-dev/mtproxymax/llms.txt

Commands to control the lifecycle of the MTProxyMax Docker container, including starting, stopping, and restarting the proxy service. It also includes commands to check the proxy's current status.

```bash
sudo mtproxymax start
sudo mtproxymax stop
sudo mtproxymax restart
mtproxymax status
```

--------------------------------

### Get MTProxyMax Status in JSON Format

Source: https://context7.com/samnet-dev/mtproxymax/llms.txt

Retrieves the current status of the MTProxyMax proxy in JSON format, which is useful for integration with monitoring tools like Grafana or Zabbix. This provides structured data about the proxy's health and performance.

```bash
mtproxymax status --json
```

--------------------------------

### Manage Replication

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands for setting up and maintaining master-slave replication between proxy instances.

```bash
mtproxymax replication setup
mtproxymax replication status
mtproxymax replication add <host> [port] [label]
mtproxymax replication remove <host_or_label>
mtproxymax replication list
mtproxymax replication enable
mtproxymax replication disable
mtproxymax replication sync
mtproxymax replication test [host]
mtproxymax replication logs
mtproxymax replication reset
mtproxymax replication promote
```

--------------------------------

### Engine and Update Management

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands to manage the proxy engine version, rebuild images, and check for software updates.

```bash
mtproxymax engine status
mtproxymax engine rebuild
mtproxymax rebuild
mtproxymax update
```

--------------------------------

### Monitoring and Diagnostics

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands to view traffic statistics, engine metrics, logs, and perform health checks.

```bash
mtproxymax traffic
mtproxymax metrics
mtproxymax metrics live [seconds]
mtproxymax logs
mtproxymax health
```

--------------------------------

### mtproxymax Engine Management and Updates

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands for managing the mtproxymax engine, including checking the current version, forcing a rebuild of the engine Docker image, or rebuilding from source. Updates are typically delivered via `mtproxymax update`, with fallbacks to source compilation if pre-built images are unavailable.

```bash
mtproxymax engine status
mtproxymax engine rebuild
mtproxymax rebuild
```

--------------------------------

### mtproxymax Real-Time Traffic Monitoring

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands to monitor real-time traffic and connection statistics. Provides per-user breakdowns of uploaded/downloaded bytes and active connections. Cumulative tracking is maintained across restarts. Metrics are exposed for Prometheus.

```bash
mtproxymax traffic
mtproxymax status
```

--------------------------------

### Security and Routing

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands to manage geoblocking, upstream routing, and SNI policies.

```bash
mtproxymax geoblock add <CC>
mtproxymax geoblock remove <CC>
mtproxymax geoblock list
mtproxymax upstream list
mtproxymax upstream add <name> <type> <host:port> [user] [pass] [weight]
mtproxymax upstream remove <name>
mtproxymax upstream test <name>
mtproxymax sni-policy [mask|drop]
```

--------------------------------

### Configure Proxy Settings

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands to modify core proxy settings such as ports, IP addresses, domains, and ad-tags.

```bash
mtproxymax port [get|<number>]
mtproxymax ip [get|auto|<address>]
mtproxymax domain [get|clear|<host>]
mtproxymax adtag set <hex>
mtproxymax adtag remove
```

--------------------------------

### Replication Management

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands to manage master-slave replication, including status checks, manual synchronization, and failover promotion.

```APIDOC
## POST /replication/sync

### Description
Triggers an immediate synchronization of configuration from the Master node to all Slave nodes.

### Method
POST

### Endpoint
mtproxymax replication sync

### Response
#### Success Response (200)
- **status** (string) - Confirmation of sync initiation.
```

--------------------------------

### Manage User Secrets

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands to manage user access, including adding, removing, rotating keys, and setting traffic limits.

```bash
mtproxymax secret add <label>
mtproxymax secret remove <label>
mtproxymax secret list
mtproxymax secret rotate <label>
mtproxymax secret enable <label>
mtproxymax secret disable <label>
mtproxymax secret link [label]
mtproxymax secret qr [label]
mtproxymax secret setlimit <label> <type> <value>
mtproxymax secret setlimits <label> <conns> <ips> <quota> [expires]
mtproxymax secret reset-traffic <label|all>
```

--------------------------------

### Manage MTProxyMax User Secrets

Source: https://context7.com/samnet-dev/mtproxymax/llms.txt

Commands for managing individual user secrets, including adding, removing, listing, rotating, enabling, and disabling them. This allows for granular control over user access to the proxy.

```bash
sudo mtproxymax secret add <username>
sudo mtproxymax secret add-batch <user1> <user2> ...
sudo mtproxymax secret remove <username>
sudo mtproxymax secret remove-batch <user1> <user2> ...
mtproxymax secret list
mtproxymax secret link <username>
mtproxymax secret qr <username>
sudo mtproxymax secret rotate <username>
sudo mtproxymax secret disable <username>
```

--------------------------------

### Traffic Monitoring

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Retrieve real-time metrics and per-user traffic statistics.

```APIDOC
## GET /traffic

### Description
Returns a per-user breakdown of uploaded and downloaded bytes.

### Method
GET

### Endpoint
mtproxymax traffic

### Response
#### Success Response (200)
- **stats** (object) - Dictionary containing user IDs and their respective traffic metrics.
```

--------------------------------

### Upstream Routing

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Manage proxy chaining and upstream routing configurations using weight-based load balancing.

```APIDOC
## POST /upstream/add

### Description
Adds a new upstream proxy server for traffic routing with specific weight.

### Method
POST

### Endpoint
mtproxymax upstream add <name> <type> <address> <user> <pass> <weight>

### Parameters
#### Request Body
- **name** (string) - Required - Identifier for the upstream.
- **type** (string) - Required - Protocol (socks5, socks4, direct).
- **address** (string) - Required - IP or hostname:port.
- **weight** (int) - Required - Traffic distribution percentage.
```

--------------------------------

### mtproxymax Geo-Blocking Configuration

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands for configuring geo-blocking to block traffic from specific countries. Uses IP-level CIDR blocklists enforced via iptables, ensuring traffic is dropped before reaching the proxy. Includes commands to add blocks and list currently blocked countries.

```bash
mtproxymax geoblock add ir
mtproxymax geoblock add cn
mtproxymax geoblock list
```

--------------------------------

### Telegram Bot Integration

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Commands to configure and manage the integrated Telegram bot for notifications and status updates.

```bash
mtproxymax telegram setup
mtproxymax telegram status
mtproxymax telegram test
mtproxymax telegram disable
mtproxymax telegram remove
```

--------------------------------

### Geo-Blocking

Source: https://github.com/samnet-dev/mtproxymax/blob/main/README.md

Enforce IP-level CIDR blocklists to restrict traffic from specific countries.

```APIDOC
## POST /geoblock/add

### Description
Adds a country code to the blocklist, dropping traffic at the iptables level.

### Method
POST

### Endpoint
mtproxymax geoblock add <country_code>

### Parameters
#### Path Parameters
- **country_code** (string) - Required - ISO country code (e.g., 'ir', 'cn').
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.