{"id":26167528,"url":"https://github.com/mexenon/xarneshin","last_synced_at":"2025-04-14T17:43:47.987Z","repository":{"id":278943398,"uuid":"937145671","full_name":"MeXenon/Xarneshin","owner":"MeXenon","description":"Xarneshin - Marzneshin Core Manager","archived":false,"fork":false,"pushed_at":"2025-03-04T11:33:31.000Z","size":2291,"stargazers_count":53,"open_issues_count":1,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-14T17:43:43.089Z","etag":null,"topics":["bash","dashboard","html","marzneshin","python3","templates","xary","xray-core","xray-panel"],"latest_commit_sha":null,"homepage":"https://t.me/XenonNet","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MeXenon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-22T12:54:24.000Z","updated_at":"2025-04-08T09:42:09.000Z","dependencies_parsed_at":"2025-02-22T18:23:37.779Z","dependency_job_id":"201ad88f-b152-4be0-adf7-6e0111178013","html_url":"https://github.com/MeXenon/Xarneshin","commit_stats":null,"previous_names":["mexenon/xarneshin"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MeXenon%2FXarneshin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MeXenon%2FXarneshin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MeXenon%2FXarneshin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MeXenon%2FXarneshin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MeXenon","download_url":"https://codeload.github.com/MeXenon/Xarneshin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248930123,"owners_count":21184959,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","dashboard","html","marzneshin","python3","templates","xary","xray-core","xray-panel"],"created_at":"2025-03-11T17:38:38.719Z","updated_at":"2025-04-14T17:43:47.966Z","avatar_url":"https://github.com/MeXenon.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"/README.md\"\u003e\u003cimg src=\"https://flagicons.lipis.dev/flags/4x3/gb.svg\" alt=\"English\" width=\"20\"/\u003e English\u003c/a\u003e | \u003ca href=\"/README_FA.md\"\u003e\u003cimg src=\"https://flagicons.lipis.dev/flags/4x3/ir.svg\" alt=\"فارسی\" width=\"20\"/\u003e فارسی\u003c/a\u003e\n\u003cbr\u003e\u003cbr\u003e\n\n\u003cdiv style=\"display: flex; justify-content: center; align-items: center; gap: 10px; max-width: 100%;\"\u003e\n    \u003cimg src=\"https://github.com/MeXenon/Xarneshin/blob/main/Preview/main.jpg\" alt=\"Main Preview\" style=\"width: 350px; height: auto; border-radius: 10px;\"\u003e\n    \u003cimg src=\"https://github.com/MeXenon/Xarneshin/blob/main/Preview/other.jpg\" alt=\"Other Preview\" style=\"width: 350px; height: auto; border-radius: 10px;\"\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003cdiv style=\"display: flex; justify-content: center;\"\u003e\n    \u003cimg src=\"https://github.com/MeXenon/Xarneshin/blob/main/Preview/CLI.png\" alt=\"CLI Preview\" style=\"width: 400px; height: auto; border-radius: 10px;\"\u003e\n\u003c/div\u003e\n\n# Xarneshin - Xenon Xray Manager\n\n**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.\n\n---\n\n## ✨ Features\n\n- **Web Interface**: A responsive, Tailwind CSS-powered dashboard with a futuristic design for managing Xray nodes, inbounds, outbounds, DNS, balancers, and more.\n- **CLI Tool**: A robust command-line interface (`xarneshin`) for quick management tasks, including port changes, HTTPS setup, geo file updates, and service control.\n- **Dynamic Configuration**: Load and manage Xray settings dynamically via `ports.json`.\n- **Advanced DNS Management**: Configure DNS servers with fine-grained control over query strategies, fallback options, and custom presets.\n- **Core Version Switching**: Easily switch between Xray core versions with real-time progress updates.\n- **System Monitoring**: Overview dashboard with real-time CPU, RAM, disk, and network stats.\n- **HTTPS Support**: Secure your Flask app with custom SSL certificates and domain configuration.\n- **Integration**: Designed to work seamlessly with Marzneshin's API for node management.\n\n---\n\n## 📢 Support Us!\n\nLove Xarneshin? Join our community and stay updated with the latest features and updates!  \n- **Telegram**: [t.me/XenonNet](https://t.me/XenonNet) - Join our channel for news, support, and discussions.  \n- **GitHub**: Star this repository and contribute to make Xarneshin even better!  \n\nYour support keeps this project alive—thank you! 🚀\n\n---\n\n## 📦 Installation\n\nEverything 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:\n\n### Prerequisites\n\n- Python 3.6+\n- Marzneshin installed and running.\n\n### Steps\n\nRun this single command to clone the repository and set up Xarneshin:\n\n``` bash\ngit clone https://github.com/MeXenon/Xarneshin.git ~/Xenon.xray \u0026\u0026 cd ~/Xenon.xray \u0026\u0026 chmod +x install.sh \u0026\u0026 sudo ./install.sh\n```\n- The command will:\n  - Clone the repository to `~/Xenon.xray`.\n  - Navigate to the directory.\n  - Make `install.sh` executable.\n\n3. **Verify Installation**  \n   After the script completes, check the service status:\n\n   sudo systemctl status xarneshin.service\n\n   Access the web interface at `http://\u003cyour-server-ip\u003e:\u003cflask-port\u003e` (e.g., `http://192.168.1.100:42689`).\n\n**🔑NOTE: the Username and password of xarneshin is the same with marzneshin.**\n \n4. **(Optional) Enable HTTPS**  \n   Use the CLI to configure HTTPS with your domain and certificates:\n\n   xarneshin\n   \n   **Select option 7: Configure HTTPS Settings**\n\n---\n\n## 🚀 Usage\n\n### Web Interface\n- **Login**: Use your Marzneshin admin credentials to access the dashboard.\n- **Manage Nodes**: View and configure Xray settings, including inbounds, outbounds, DNS, and routing rules.\n- **Change Core**: Switch Xray versions directly from the interface (local node only).\n\n### CLI Tool\nRun\n``` bash \nxarneshin\n```\nin your terminal to access the command-line interface:\n\nxarneshin\n\n**Available Commands:**\n- `status`: Show service status and uptime.\n- `change-ports`: Modify Flask or panel ports.\n- `update-geofiles`: Download geoip/geosite files.\n- `restart`: Restart the Xarneshin service.\n- `show-address`: Display the access URL.\n- `uninstall`: Remove Xarneshin from your system.\n\nFor detailed options, run\n```bash\nxarneshin --help\n```\n---\n\n## 🙏 Acknowledgments\n\n- [Marzneshin](https://github.com/marzneshin/marzneshin) - The backbone proxy management system.\n- [MeXenon](https://github.com/MeXenon) | [MeArgon telegram](https://t.me/MeArgon) - Lead developer and visionary behind Xarneshin.\n- [XenonNet](https://github.com/XenonNet) - Sponsoring\n---\n\n**Built with ❤️ by the Xenon Team**  \nJoin us on [Telegram](https://t.me/XenonNet) and let’s make proxy management awesome together!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmexenon%2Fxarneshin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmexenon%2Fxarneshin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmexenon%2Fxarneshin/lists"}