NMLinux v1.2.9 - 日本語解説文書

NMLinux は、Python および PySide6（Qt 6） でゼロから再実装された Linux 向けのオープンソース・ネットワーク管理ツールの独立したプロジェクトです。NETworkManager（作者：BornToBeRoot）のコンセプトに触発され、システム管理者やパワーユーザーが Linux デスクトップ上で必要とする一般的なネットワークツールを単一の統合されたグラフィカルインターフェースで提供することを目的としています。

注釈: NMLinux は、Red Hat/GNOME 社製のシステムデモンド

NetworkManager

（/usr/bin/NetworkManager）とは関係ありません。名称の由来は Windows 向けの同名ツールの「NETworkManager」にあります。

スクリーンショット機能

バージョン履歴詳細

v1.2.9 — 2026 年 5 月 30 日

• VNC 機能追加:
  • VNC コネクションプロフィールを管理する新モジュール。SSH/RDP と同様、グループ/サブグループをサポート。

  • vncviewer

    （TigerVNC）を起動し、macOS ARD 認証もネイティブ対応。
  • パスワードは一切保存せず。インストール検出機能付き。
• 「ツールとサービス」セクション: アプリ依存サードパーティツールおよび API のリスト追加。
• 国際化（i18n）の進展: ハードコードフランス語から 4 ユーザー言語（FR/EN/ES/DE）へ翻訳。23 つのナビゲーションヒントを追加。トポロジー図、接続、サブネットなどのラベル修正。

v1.2.8 — 2026 年 5 月 30 日

• リモートデスクトップ (RDP) 機能追加:
  • Windows RDP コネクションプロフィール管理モジュールの追加。

  • xfreerdp

    を外部プロセスとして起動し、グループ/サブグループをサポート。
  • パスワードは接続時のみ求められ、一切保存されません。
  • ホスト名、ポート、ユーザー名、ドメイン、解像度、画面全面表示などの設定可能。

v1.2.7 — 2026 年 5 月 26 日

• 内蔵 Lucide アイコン:
  • MIT ライセンスの 21 つの SVG アイコンをバンドルし、

    QSvgRenderer

    を使用してレンダリング。
  • システムアイコンテーマ（Breeze, Adwaita など）に依存しないため、環境に適応。

v1.2.6 — 2026 年 5 月 24 日

• GNOME / Adwaita 互換性向上:
  • KDE 以外でもアイコン表示が安定。「main.py」で

    gsettings

    を通じて GTK テーマを自動検出・適用。
  • Wi-Fi、MTR など複数機能のフォールバックチェーン拡張。
• NixOS / KDE 互換性向上:
  • Breeze 6.x SVGZ 対応。Nix ウラッパー経由で Qt のレンダリング環境を整備。
  • アイコンサイズ判定ロジックの改善（22px→24px など）。

v1.2.5 — 2026 年 5 月 23 日

• MTR:
  • 内蔵マイ・トレースルート機能の実装。

    mtr --report

    出力をリアルタイム解析。
  • Loss %, RTT（最後・平均・最良・最悪・ジッター）を含むライブテーブル表示。
  • 損失状況による色分け、連続モード、CSV/TXT エクスポート対応。
• スピードテスト:
  • curl と Cloudflare を使用した、外部ツール不要なスループット測定（DL/UL/Ping）。
  • 履歴グラフ表示（最大 5 回の試行分保持）。
• ファイアウォール表示:
  • Root 権限なしで

    /etc/nftables.conf

    および

    /etc/iptables/*.rules

    の読み込みが可能。

  • pkexec nft list ruleset

    を用いたライブルールセット表示機能。
• UI 改善: ナビゲーションエントリーに**「?」バッジ**追加。ホバー時にツールヒントを表示。

v1.2.0 — 2026 年 5 月 22 日

• テーマ適応: ライト/ダークモードのフルサポート。「is_dark()」などの新しいコア機能導入。
• サブネットマスク表示: CIDR プレフィスから自動的に点線小数形式（例：255.255.255.0）を導出・表示。
• 帯域幅モニター改善: 不安定な自動開始を「明確な開始/停止ボタン」に置き換え。
• CSV/TXT エクスポート: Nmap およびトレースルート完了時に即時実行ボタンが表示。

v1.1.1 — 2026 年 5 月 16 日

• SSH 端末の完全再実装:

  pyte

  (VT100/xterm) と

  QPainter

  を使用。
  • スクロールバック（2000 ライン）、カーソル 깜빡임、256 色対応。
• 視覚的トレースルート:
  • ワールドマップ（Natural Earth）、Live 位置情報、ズーム/パン機能。
• 帯域幅モニター強化: 各インタフェースごとのリアルタイムスループット表示、60 秒スライディンググラフ。
• ウェイクオンLAN (WoL): 純粋な Python マジックパケット生成。永続的なホストブック（JSON）機能。
• IP スキャナー: DNS/mDNS/NetBIOS を含むホスト名解決、MAC アドレス、ベンダー情報の表示。

v1.0.0 — 2026 年 5 月 14 日

• 初の公開リリース（13 モジュール搭載：ダッシュボード、インタフェース、Wi-Fi、サブネット計算機、DNS ルックアップ、PING モニター、IP スキャナー、ポートスキャナー、Nmap、Whois、SNMP、SNTP/NTP、SSH）。

機能一覧

nmcli

dig

snmpwalk/snmpget

xfreerdp

vncviewer

nmap -sn

システム要件

必須システムツール

大部分は標準 Linux に搭載されています。ディストリビューションに応じたインストールコマンドを参照してください。

Arch / EndeavourOS

sudo pacman -S iproute2 networkmanager bind-tools nmap whois net-snmp iputils mtr curl

Debian / Ubuntu

sudo apt install iproute2 network-manager dnsutils nmap whois snmp mtr-tiny curl

Fedora

sudo dnf install iproute NetworkManager bind-utils nmap whois net-snmp-utils mtr curl

オプションツール一覧

freerdp

freerdp2-x11

freerdp

tigervnc

tigervnc-viewer

tigervnc

nm-connection-editor

traceroute

Python 依存関係

• Python 3.11 以上
• PySide6 6.6 以上
• ptyprocess 0.7 以上
• pyte 0.8 以上 (

  pip install pyte

  または

  sudo pacman -S python-pyte

  )

インストール方法

オプション 1 — Arch Linux / Manjaro / EndeavourOS (AUR)

すべての依存関係（PySide6, ptyprocess, pyte など）が AUR パッケージ内で自動的に解決されます。

オプション 2 — ウィール (Wheel) [全ディストリビューション向け]

最新のリリースから

.whl

pip install nmlinux-1.2.9-py3-none-any.whl
nmlinux

オプション 3 — ソースコードからのビルド

git clone https://github.com/thongor77/nmlinux.git
cd nmlinux
pip install PySide6 ptyprocess pyte
python3 -m nmlinux.main

オプション 4 — デスクトップエントリの設定 (KDE / GNOME など)

アプリケーションランチャーに表示させるため、

.desktop

cp data/nmlinux.desktop ~/.local/share/applications/
update-desktop-database ~/.local/share/applications/

• 必要に応じて

  Exec=

  パスを変更してください。

実行方法

以下いずれかのコマンドを実行してください：

./nmlinux.sh
# または、pip install 後:
nmlinux
# または直接モジュールから:
python3 -m nmlinux.main

プロジェクト構造

以下の階層構成でソースコードが配置されています。

• nmlinux/ (メインディレクトリ)
  • core/ (コア機能とデータ管理)

    • i18n.py

      : 翻訳システム（fr/en/es/de）、

      tr(key)

      関数

    • icons.py

      : アイコンマネージャ（QSvgRenderer を使用した Lucide SVG）

    • settings.py

      : アプリ設定（AppSettings データクラス、JSON 永続化）

    • ssh.py

      : SSH 接続管理クラス (

      SshConnection

      ,

      SshStore

      )

    • rdp.py

      : RDP 接続管理クラス (

      RdpConnection

      ,

      RdpStore

      )

    • vnc.py

      : VNC 接続管理クラス (

      VncConnection

      ,

      VncStore

      )

    • terminal.py

      : SSH ターミナルバックエンド（QThread + PTY）

    • cli_bar.py

      : CLI 対応バーのシングルトンクラス
  • pages/ (各機能ページ)

    • about.py

      : 概要・クレジット情報

    • bandwidth.py

      : バンド幅モニター（スライディンググラフ）

    • connection_manager.py

      : 接続マネージャー

    • dashboard.py

      : ダッシュボード表示

    • dns.py

      ,

      firewall.py

      ,

      interfaces.py

      : それぞれの機能実装

    • ip_scanner.py

      ,

      mtr.py

      ,

      nmap_scan.py

      : スキャン系ツール

    • ping.py

      ,

      port_scanner.py

      : ピング/ポートスキャナ

    • rdp.py

      ,

      ssh.py

      ,

      vnc.py

      : リモート接続マネージャ

    • snmp.py

      ,

      sntp.py

      : SNMP/NTP クライアント

    • speedtest.py

      : スピードテスト（curl + Cloudflare）

    • subnet.py

      : サブネット計算機

    • topology.py

      : トポロジーマップ（インタラクティブグラフ）

    • traceroute.py

      : 視覚的トレースルート

    • whois.py

      ,

      wifi.py

      ,

      wol.py

      : それぞれの機能実装
  • assets/ (リソースファイル)

    • icons/

      : バンドルされた Lucide SVG アイコン群 (#60a5fa)

    • world.geojson

      : 各国境界データ（Natural Earth 110m）

  • window.py

    : メインウィンドウ構成（サイドバー + QStackedWidget）

  • main.py

    : アプリケーションのエントリポイント

デスクトップ環境互換性

v1.2.7 以降、NMLinux はQSvgRendererを使用して 21 つのバンドルされた Lucide SVG アイコンをレンダリングします。これにより、アプリはシステムアイコンテーマ（Breeze, Adwaita など）に依存する必要がなくなり、KDE、GNOME、XFCE などあらゆるデスクトップ環境で正しく表示されます。Qt スタイルも自動適応します。

制限事項と注意点

• Linux 専用:

  nmcli

  、

  ip

  、

  dig

  、

  ping

  およびサードパーティツール（Subprocess）への依存があります。
• root/polkit の必要性:
  • 特権レベルが必要なツール（一部の Nmap モード、生ソケットなど）は

    sudo

    を使用して手動で実行する必要があります。
  • アプリ自体は root/polkit との統合を持っていません。
• SSH エージェント: パスワード認証およびキーベース認証はサポートしていますが、エージェントフォワーディングはまだ実装されていません。

クレジットと謝辞

• BornToBeRoot: NETworkManager の着想、機能、および UX デザインへの参考資料を提供。
• Anthropic (Claude Code): プロジェクト構築を支援した AI アシスタント。
• 著者: ビジョンの提示、テストの実施、方向性の決定を担当。

ライセンス

GPL-2.0 （LICENSE ファイル参照）

免責事項: このプロジェクトは独立した再実装であり、NETworkManager のコードは一切使用または翻訳されていません。