mbp — マルチプロトコル転送・プロキシとPVE管理ツール

DevOps

概要

mbp はシェルスクリプト主体の軽量ツールセットで、TCP/UDP/HTTP(S)/SOCKS5 によるフォワーディングやプロキシ機能を提供すると同時に、Proxmox VE(PVE)が提供する LXC コンテナや QEMU 仮想マシンの簡易的な管理操作を行えることを目指しています。インストールはワンライナー(wget → bash)で完了し、最小限の準備でネットワーク転送や仮想環境の操作を始められる点が特徴です。README には初期ユーザ名・パスワードやバグ報告先(Telegram)が記載されています(300字程度)。

GitHub

リポジトリの統計情報

  • スター数: 4
  • フォーク数: 0
  • ウォッチャー数: 4
  • コミット数: 5
  • ファイル数: 2
  • メインの言語: Shell

主な特徴

  • TCP/UDP/HTTP(S)/SOCKS5 の転送およびプロキシ構成をサポート(README に明記)
  • Proxmox VE 上の LXC と QEMU の管理機能を備える(PVE 連携)
  • ワンライナーでインストール可能な install.sh(bash <(wget -qO- …))
  • シェルスクリプト中心で軽量、サーバ上で手早く導入できる設計

技術的なポイント

mbp は主にシェルで記述された小規模リポジトリで、ネットワークのプロキシ/転送機能と PVE の仮想環境管理を組み合わせたユニークな用途を持ちます。ネットワーク側は TCP/UDP/HTTP(S)/SOCKS5 を扱うため、実装上は socat、iptables/nftables、ssh トンネル、あるいは既存のプロキシ実装(tinyproxy, squid, redsocks など)をラップする形になっている可能性が高いです。PVE 連携については、Proxmox VE の API(REST)や pvesh コマンドを curl や認証トークンで叩く方式が一般的で、mbp も同様にシンプルな CLI 呼び出しで VM/LXC の起動・停止やコンテナ操作を行う構成が想定されます。

install.sh によるワンライナーインストールは導入の手軽さを提供しますが、同時にセキュリティ上の注意が必要です。README にデフォルトのユーザ名(mlkmbp)とパスワード(www.mlkmbp.com)が明記されているため、導入直後は必ずパスワード変更や不要サービスの無効化を行うべきです。また、wget → bash の実行はスクリプト内容を確認せずに実行しがちなので、運用環境ではローカルにダウンロードして内容を精査してから実行することを推奨します。

拡張や改善のポイントとしては、設定ファイルの分離(環境変数および外部設定ファイル)、systemd などでのサービス化、TLS 証明書の管理(HTTP/S のため)、PVE API のトークン管理や RBAC を考慮した認証強化が挙げられます。ログ出力と監視(rsyslog/ journald 連携)を整備すれば実運用での信頼性が向上します。シェル実装ゆえの可読性・メンテナンス性の観点から、将来的には一部機能を Python や Go に移行して API 呼び出しや並列処理を安定化させる選択肢も考えられます。(700字程度)

プロジェクトの構成

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

  • README.md: file
  • install.sh: file

まとめ

軽量で導入が速いが初期設定と認証の見直しが必須です(50字程度)。

リポジトリ情報:

READMEの抜粋:

mbp

TCP, UDP, HTTP/S, SOCKS5 forwarding or proxy, and can also manage LXC and QEMU provided by PVE

一键安装

bash <(wget -qO- https://raw.githubusercontent.com/mlkmbp/mbp/main/install.sh)

安装后请更改默认用户名和密码

用户名:mlkmbp 密码:www.mlkmbp.com

bug反馈

https://t.me/mlkmbp