Flatnet

NAT-free container networking for WSL2 + Podman.

What is Flatnet?

Flatnet は 3 つのコンポーネントを提供します：

1. CNI Plugin — Podman 用ネットワークプラグイン（WSL2 側）
2. Gateway — Host Windows 側の窓口（OpenResty）
3. CLI — システム管理ツール

これにより、WSL2 + Podman 環境の多段 NAT 問題を解消し、社内 LAN からコンテナへフラットに到達できます。

Before: 社内LAN → Windows → WSL2 → コンテナ（3段NAT）
After:  社内LAN → Gateway → コンテナ（フラット）

Quick Start

CLI のインストール

curl -fsSL https://raw.githubusercontent.com/khayashi4337/flatnet/master/scripts/install-cli.sh | bash

基本的な使い方

flatnet status    # システム状態を確認
flatnet doctor    # 診断を実行
flatnet ps        # コンテナ一覧
flatnet logs      # ログを確認

詳細は CLI ドキュメント を参照。

Architecture

• System Context - システム全体の文脈
• Container Diagram - コンテナ構成

Features

Phase	概要	状態
Phase 1	Gateway 基盤 - OpenResty で NAT 地獄を解消	完了
Phase 2	CNI Plugin - コンテナ管理の自動化	完了
Phase 3	マルチホスト - 複数ホスト間通信	完了
Phase 4	本番運用準備 - 監視・セキュリティ	完了
Phase 5	CLI Tool - システム管理ツール	完了

詳細は ロードマップ を参照。

Tech Stack

• CNI Plugin: Rust
• Gateway: OpenResty (Nginx + Lua)
• CLI: Rust
• Container Runtime: Podman
• Monitoring: Prometheus, Grafana, Loki

Documentation

• CLI チュートリアル - 使い方を学ぶ
• CLI リファレンス - コマンド一覧
• トラブルシューティング - 問題解決

License

MIT