システム要件
インターネットカフェ、ゲーミングセンター、eスポーツアリーナにHandyCafeをインストールする前に、ハードウェアとネットワークが以下の要件を満たしていることを確認してください。
サーバーPCの要件
サーバーは管理ステーションです。HandyCafe Serverを実行してカフェ全体を監視・制御するPCです。
| コンポーネント | 最小 | 推奨 |
|---|---|---|
| OS | Windows 10以降（64ビット）、macOS 12 Monterey以降、Linux（64ビット） | Windows 10/11（64ビット）、macOS 12以降、Linux（64ビット） |
| プロセッサ | デュアルコア 2.0 GHz | クアッドコア 2.5 GHz以上 |
| RAM | 4 GB | 8 GB以上 |
| ディスク空き容量 | 500 MB（アプリケーション） | 2 GB以上（録画とスクリーンショット含む） |
| ディスプレイ | 1280 x 720 | 1920 x 1080以上 |
| ネットワーク | 100 Mbps Ethernet | ギガビットEthernet |
注: リモートデスクトップでセッション録画を使用する場合、MP4録画用の追加ディスク容量を確保してください（品質に応じて1時間あたり約50～200 MB）。
Linux注: HandyCafeはLinux上でWebKit2GTKを使用するTauri v2で構築されています。アプリケーション実行前に
libwebkit2gtk-4.1ランタイムパッケージをインストールする必要があります。Ubuntu 22.04以降、Fedora 38以降、同等バージョンのWebKit2GTKを提供するその他のディストリビューションに対応しています。
クライアントPCの要件
各顧客用PCはHandyCafe Clientを実行し、ローカルネットワーク経由でサーバーに接続します。
| コンポーネント | 最小 | 推奨 |
|---|---|---|
| OS | Windows 10以降（64ビット）、macOS 12 Monterey以降、Linux（64ビット） | Windows 10/11（64ビット）、macOS 12以降、Linux（64ビット） |
| プロセッサ | デュアルコア 1.5 GHz | クアッドコア 2.0 GHz以上 |
| RAM | 2 GB | 4 GB以上 |
| ディスク空き容量 | 200 MB | 500 MB以上 |
| ネットワーク | 100 Mbps Ethernet | ギガビットEthernet |
注: これらはHandyCafe Clientソフトウェアのみの要件です。顧客が使用するゲームやアプリケーションには追加のリソースが必要です。
ネットワーク要件
すべてのPC（サーバーとクライアント）は同一ローカルネットワーク（LAN）上にある必要があります。
必要なポート
| ポート | プロトコル | 方向 | 用途 |
|---|---|---|---|
| 5001 | TCP | サーバー: インバウンド、クライアント: アウトバウンド | コマンドとレスポンスの通信 |
| 5002 | TCP | 双方向 | ファイル転送 |
| 5003 | TCP | サーバー: インバウンド、クライアント: アウトバウンド | リモート管理制御チャネル |
| 5004 | UDP | 双方向 | 画面ストリーミング（リモートデスクトップ） |
重要: これらはデフォルトポートです。ネットワーク設定で変更可能です。サーバーのポートを変更した場合、クライアントの設定も更新してください。
ファイアウォール設定
- Windows ファイアウォール: HandyCafeはインストール時にファイアウォールルールの自動追加を試みます。自動設定に失敗した場合、上記ポートのインバウンドルールを手動で追加してください。
- macOS ファイアウォール: システム設定 > ネットワーク > ファイアウォールを開き、HandyCafeの受信接続を許可してください。
- Linux (iptables / ufw):
ufwを使用する場合はsudo ufw allow 5001:5004/tcpとsudo ufw allow 5004/udpを実行してください。 - サードパーティファイアウォール: サーバーPCのHandyCafeサーバーバイナリとクライアントPCのHandyCafeクライアントバイナリの例外を追加してください。
- ルーター/スイッチ: LANのみの運用では特別な設定は不要です。VLANがある場合、サーバーとすべてのクライアントが同じVLAN上にあるか、ルーティングが必要なポートを許可していることを確認してください。
クライアントディスカバリー
HandyCafeはローカルネットワーク上の自動クライアントディスカバリーにmDNS（マルチキャストDNS）を使用します。これには以下が必要です。
- すべてのPCが同じサブネットにあること
- マルチキャストトラフィックがスイッチやルーターでブロックされていないこと
- mDNSが機能しない場合（サブネット間など）、クライアントはサーバーのIPアドレスを手動入力して接続可能
帯域幅の目安
| 機能 | おおよその帯域幅 |
|---|---|
| 通常運用（クライアントごと） | 1 Kbps未満 |
| リモートデスクトップストリーミング | 350～25,000 Kbps（設定可能） |
| ファイル同期転送 | ネットワーク速度に依存 |
| スクリーンショットキャプチャ | スクリーンショットあたり約100 KB |
20～50台のPCを持つ一般的なカフェでは、標準的な100 Mbps LANで十分です。複数のPCに対して同時にリモートデスクトップを頻繁に使用する場合はギガビットEthernetを推奨します。
コンソールの要件
ゲーミングコンソール（PlayStation、Xboxなど）を管理する場合、コンソールはサーバーと同じネットワーク上にある必要があります。各コンソールはMACアドレスで識別され、コンソール設定で手動登録します。