TgXUIMgr - Telegramで管理する3XUIパネルマネージャー

Tool
TgXUIMgr - Telegramで管理する3XUIパネルマネージャー

TgXUIMgr - Telegramで管理する3XUIパネルマネージャー

TgXUIMgrは、Telegramボットを通じて複数の3XUI（3x-ui）パネルを一元管理できるPython製ツールです。サーバーの状態監視やトラフィック管理、Xrayコアの状態確認が可能で、WebブラウザやTelegramの双方から情報を取得できます。さらに、パネルのオフライン自動通知やユーザートラフィックの月次リセットなどの自動化機能も備え、役割ベースの権限管理で安全かつ効率的な運用を実現します。

https://github.com/GeQainZz/TgXUIMgr

概要

TgXUIMgrは、Telegramのチャットインターフェイスを用いて3XUIパネルの管理を簡素化するPythonベースのツールです。複数の3x-uiパネルを単一のTelegramボットに統合し、サーバーの状態やトラフィック、Xrayコアの稼働状況をリアルタイムで監視可能。さらに、Webブラウザからもアクセスできるため、ユーザーは多様な方法で情報を取得できます。パネルのオフライン検知や入場ノードの期限切れ通知、月次のユーザートラフィックリセットなどの自動化機能を備え、役割ごとの権限管理によりセキュリティ面にも配慮しています。Dockerコンテナでの簡単デプロイも提供し、運用負荷を大幅に軽減します。

GitHub

リポジトリの統計情報

  • スター数: 6
  • フォーク数: 0
  • ウォッチャー数: 6
  • コミット数: 11
  • ファイル数: 14
  • メインの言語: Python

主な特徴

  • 複数の3XUIパネルを一つのTelegramボットで集中管理可能
  • サーバー状態、トラフィック、Xrayコアのリアルタイム監視
  • TelegramとWebブラウザの双方からの情報照会をサポート
  • パネルオフライン通知や入場ノード期限切れ自動通知などの自動化機能
  • 役割ベースの権限管理（管理者と一般ユーザーの区別）

技術的なポイント

TgXUIMgrはPythonで実装されており、Telegram Bot APIを活用してユーザーとの双方向コミュニケーションを実現しています。複数の3XUIパネルの情報を一元的に管理・監視するため、各パネルのAPIやログ情報を定期的に取得し、サーバーのCPU負荷、メモリ使用率、通信トラフィック、及びXrayコアの稼働状況をリアルタイムに収集。これにより、ユーザーはTelegram上で直感的に状況を把握できます。

また、Webブラウザからのアクセスも可能で、Telegramを使わないユーザーにも柔軟な情報取得手段を提供。DockerとDocker Composeによるコンテナ化により、依存関係の構築や環境設定が簡便で、わずか数ステップで環境構築が完了します。これにより多くのユーザーが容易に導入できる点が大きな魅力です。

さらに、通知機能も充実しており、3XUIパネルがオフラインになると自動的にアラートをTelegramで送信。入場ノードの有効期限切れも自動で検知し、管理者へリマインダーを発信します。月次のユーザートラフィックリセットも自動スケジュールで行い、運用の手間を大幅に削減しています。

セキュリティ面では、役割ベースのアクセス制御（RBAC）を導入し、管理者と一般ユーザーで権限を区別。これにより、誤操作や不正アクセスのリスクを軽減し、安全に運用可能です。以上の点から、TgXUIMgrは3XUIパネルの運用を効率化し、運用負荷軽減とセキュリティ強化を両立した実用的なツールと言えます。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: git管理除外ファイル設定
  • .idea: 開発環境用設定ディレクトリ（JetBrains製IDE）
  • Dockerfile: Dockerコンテナ構築用ファイル
  • MANUAL.md: 操作マニュアル
  • README.md: プロジェクト概要と導入手順
  • app/: アプリケーションの主要コード群（推定）
  • config/: 設定ファイル群（推定）
  • scripts/: 補助スクリプト（推定）

その他合計14ファイルで構成されており、Docker環境での迅速なデプロイと柔軟な設定変更が可能な構成となっています。

まとめ

Telegramで簡単かつ安全に3XUIパネルを一元管理できる実用的ツール。

リポジトリ情報：