rustix3

Unofficial Rust client for the 3x-ui panel API (Xray-core).
Provides typed models and high-level methods for common panel operations.

Note: Some 3x-ui endpoints expect certain nested structures to be sent as JSON strings (e.g., inbound settings). The client models handle these specifics transparently.

Implemented endpoints

• ✅ login

• ✅ Inbounds

• ✅ Inbound

• ✅ Client traffics with email

• ✅ Client traffics with id

• ✅ TG Send backup to admin

• ✅ Client IP address

• ✅ Add inbound

• ✅ Add client to inbound

• ✅ Update inbound

• ✅ Update client

• ✅ Clear client IP address

• ✅ Reset traffics of all inbound

• ✅ Reset traffics of all clients in an inbound

• ✅ Reset client traffics

• ✅ Delete client

• ✅ Delete inbound

• ✅ Delete depleted clients

• ✅ Online clients

• ❌ Import inbounds

• ✅ Last online

• ❌ del Client By Email

• ✅ Server status

• ✅ Server get DB

• ✅ get Xray Version

• ✅ get Config Json

• ✅ cpu History

• ✅ get New UUID

• ✅ get New X25519 Cert

• ✅ get New mldsa65

• ✅ get New mlkem768

• ✅ get New Vless Enc

• ✅ stop Xray Service

• ✅ restart Xray Service

• ✅ install Xray version

• ✅ update Geofile

• ❌ updateGeofile/{fileName}

• ❌ logs/{count}

• ❌ xraylogs/{count}

• ✅ importDB

• ❌ get New Ech Cert

Installation

Use the Git dependency directly:

[dependencies]
rustix3 = { git = "https://github.com/Xaneets/rustix3", branch = "main" }

Quick start

use rustix3::client::Client;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let base_url = "http://127.0.0.1:2053/";
    let username = "admin";
    let password = "admin";

    let client = Client::new(username, password, base_url).await?;

    // Example: list inbounds
    let inbounds = client.get_inbounds_list().await?;
    println!("{:#?}", inbounds);

    Ok(())
}