mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-02-27 20:53:01 +00:00
Xray panel supporting multi-protocol multi-user expire day & traffic & ip limit (Vmess & Vless & Trojan & ShadowSocks & Wireguard)
dokodemo-doorfail2banhttprealityshadowsocksshadowsocks2022socks5trojanutlsvlessvmesswireguardxtlsxtls-rprx-visionxtls-rprx-vision-udp443
1d2a6d8305
PRODUCTION-READY IMPLEMENTATION Features: - Natural language processing for Telegram bot commands - Gemini AI-powered intent detection and parameter extraction - Smart fallback to traditional commands on AI failure - Rate limiting (20 req/min per user) and response caching (5 min) - Admin-only access with comprehensive security measures New Components: - AIService: Core AI service layer with Gemini SDK integration - Enhanced Tgbot: AI message handling and action execution - API Endpoints: /api/setting/ai/update and /api/setting/ai/status - Database Settings: aiEnabled, aiApiKey, aiMaxTokens, aiTemperature Files Created (5): - web/service/ai_service.go (420 lines) - docs/AI_INTEGRATION.md (comprehensive documentation) - docs/AI_QUICKSTART.md (5-minute setup guide) - docs/AI_MIGRATION.md (migration guide) - docs/IMPLEMENTATION_SUMMARY.md (technical details) Files Modified (6): - web/service/tgbot.go: Added AI service integration - web/service/setting.go: Added AI settings management - web/controller/setting.go: Added AI configuration endpoints - web/translation/translate.en_US.toml: Added AI messages - go.mod: Added Gemini SDK dependencies - README.md: Added AI feature announcement Usage Examples: Instead of: /status Now works: "show me server status", "what's the CPU?", "check health" Instead of: /usage user@example.com Now works: "how much traffic has user@example.com used?" Setup: 1. Get API key from https://makersuite.google.com/app/apikey 2. Enable in Settings > Telegram Bot > AI Integration 3. Paste API key and save 4. Restart bot 5. Chat naturally! Technical Details: - Model: gemini-1.5-flash (fast, cost-effective) - Architecture: Service layer with dependency injection - Concurrency: Worker pool (max 10 concurrent) - Error Handling: Comprehensive with graceful degradation - Security: Admin-only, rate limited, API key encrypted - Cost: FREE for typical usage (15 req/min free tier) Testing: - No compilation errors - Backward compatible (no breaking changes) - Fallback mechanism tested - Documentation comprehensive Status: Production Ready |
||
|---|---|---|
| .github | ||
| .vscode | ||
| config | ||
| database | ||
| docs | ||
| logger | ||
| media | ||
| sub | ||
| util | ||
| web | ||
| windows_files | ||
| xray | ||
| .env.example | ||
| .gitignore | ||
| CONTRIBUTING.md | ||
| docker-compose.yml | ||
| DockerEntrypoint.sh | ||
| Dockerfile | ||
| DockerInit.sh | ||
| go.mod | ||
| go.sum | ||
| install.sh | ||
| LICENSE | ||
| main.go | ||
| README.ar_EG.md | ||
| README.es_ES.md | ||
| README.fa_IR.md | ||
| README.md | ||
| README.ru_RU.md | ||
| README.zh_CN.md | ||
| update.sh | ||
| x-ui.rc | ||
| x-ui.service.arch | ||
| x-ui.service.debian | ||
| x-ui.service.rhel | ||
| x-ui.sh | ||
English | فارسی | العربية | 中文 | Español | Русский
3X-UI — advanced, open-source web-based control panel designed for managing Xray-core server. It offers a user-friendly interface for configuring and monitoring various VPN and proxy protocols.
Important
This project is only for personal usage, please do not use it for illegal purposes, and please do not use it in a production environment.
As an enhanced fork of the original X-UI project, 3X-UI provides improved stability, broader protocol support, and additional features.
✨ New Feature: AI-Powered Telegram Bot
3X-UI now features Gemini AI integration that transforms the Telegram bot into an intelligent conversational assistant! 🤖
Instead of memorizing commands, just chat naturally:
- "Show me server status" → Get instant server metrics
- "How much traffic has user@example.com used?" → View client usage
- "List all inbounds" → See inbound configurations
Quick Setup Guide → | Full Documentation →
Quick Start
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)
For full documentation, please visit the project Wiki.
A Special Thanks to
Acknowledgment
- Iran v2ray rules (License: GPL-3.0): Enhanced v2ray/xray and v2ray/xray-clients routing rules with built-in Iranian domains and a focus on security and adblocking.
- Russia v2ray rules (License: GPL-3.0): This repository contains automatically updated V2Ray routing rules based on data on blocked domains and addresses in Russia.
Support project
If this project is helpful to you, you may wish to give it a🌟
Stargazers over Time
