Xarneshin

KO | EN

gitlite — search

#javascript #python #typescript #golang #android #rust #deep-learning #kubernetes #awesome-list #vue #security #mcp #ios #openai

(★ 69)

Xarneshin - Marzneshin Core Manager

Xarneshin Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<a href="/README.md"><img src="https://flagicons.lipis.dev/flags/4x3/gb.svg" alt="English" width="20"/> English</a> | <a href="/README_FA.md"><img src="https://flagicons.lipis.dev/flags/4x3/ir.svg" alt="فارسی" width="20"/> فارسی</a>
<br><br>

<br>

# Xarneshin - Xenon Xray Manager

**Xarneshin** is a powerful, futuristic Flask-based web interface and CLI tool designed to manage Xray configurations seamlessly alongside the [Marzneshin](https://github.com/marzneshin/marzneshin) proxy management system. Built with a sleek, modern UI and packed with advanced features, Xarneshin empowers users to configure, monitor, and optimize Xray instances with ease.

---

## ✨ Features

- **Web Interface**: A responsive, Tailwind CSS-powered dashboard with a futuristic design for managing Xray nodes, inbounds, outbounds, DNS, balancers, and more.
- **CLI Tool**: A robust command-line interface (`xarneshin`) for quick management tasks, including port changes, HTTPS setup, geo file updates, and service control.
- **Dynamic Configuration**: Load and manage Xray settings dynamically via `ports.json`.
- **Advanced DNS Management**: Configure DNS servers with fine-grained control over query strategies, fallback options, and custom presets.
- **Core Version Switching**: Easily switch between Xray core versions with real-time progress updates.
- **System Monitoring**: Overview dashboard with real-time CPU, RAM, disk, and network stats.
- **HTTPS Support**: Secure your Flask app with custom SSL certificates and domain configuration.
- **Integration**: Designed to work seamlessly with Marzneshin's API for node management.

---

## 📢 Support Us!

Love Xarneshin? Join our community and stay updated with the latest features and updates!  
- **Telegram**: [t.me/XenonNet](https://t.me/XenonNet) - Join our channel for news, support, and discussions.  
- **GitHub**: Star this repository and contribute to make Xarneshin even better!

Your support keeps this project alive—thank you! 🚀

---

## 📦 Installation

Everything is handled by the `install.sh` script—no manual installation or running is required after executing it with the proper permissions. Follow this single command:

### Prerequisites

- Python 3.6+
- Marzneshin installed and running.

### Steps

Run this single command to clone the repository and set up Xarneshin:

``` bash
git clone https://github.com/MeXenon/Xarneshin.git ~/Xenon.xray && cd ~/Xenon.xray && chmod +x install.sh && sudo ./install.sh
```
- The command will:
  - Clone the repository to `~/Xenon.xray`.
  - Navigate to the directory.
  - Make `install.sh` executable.

3. **Verify Installation**  
   After the script completes, check the service status:

sudo systemctl status xarneshin.service

Access the web interface at `http://<your-server-ip>:<flask-port>` (e.g., `http://192.168.1.100:42689`).

**🔑NOTE: the Username and password of xarneshin is the same with marzneshin.**
 
4. **(Optional) Enable HTTPS**  
   Use the CLI to configure HTTPS with your domain and certificates:

xarneshin
   
   **Select option 7: Configure HTTPS Settings**

---

## 🚀 Usage

### Web Interface
- **Login**: Use your Marzneshin admin credentials to access the dashboard.
- **Manage Nodes**: View and configure Xray settings, including inbounds, outbounds, DNS, and routing rules.
- **Change Core**: Switch Xray versions directly from the interface (local node only).

### CLI Tool
Run
``` bash 
xarneshin
```
in your terminal to access the command-line interface:

xarneshin

**Available Commands:**
- `status`: Show service status and uptime.
- `change-ports`: Modify Flask or panel ports.
- `update-geofiles`: Download geoip/geosite files.
- `restart`: Restart the Xarneshin service.
- `show-address`: Display the access URL.
- `uninstall`: Remove Xarneshin from your system.

For detailed options, run
```bash
xarneshin --help
```
---

## 🙏 Acknowledgments

- [Marzneshin](https://github.com/marzneshin/marzneshin) - The backbone proxy management system.
- [MeXenon](https://github.com/MeXenon) | [MeArgon telegram](https://t.me/MeArgon) - Lead developer and visionary behind Xarneshin.
- [XenonNet](https://github.com/XenonNet) - Sponsoring
---

**Built with ❤️ by the Xenon Team**  
Join us on [Telegram](https://t.me/XenonNet) and let’s make proxy management awesome together!

Xarneshin

Xarneshin Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Xarneshin

Xarneshin Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README