設定リファレンス

PhanTerm では、管理作業の大部分を TUI 画面から行うことを推奨していますが、すべての基盤データは人間が読める構造化されたプレーンテキストとして永続化されます。これにより、高度なユーザーの皆様はバックアップ、バージョン管理、あるいは外部からの自動化スクリプトの作成を容易に行うことができます。

設定ファイルのパス

すべてのデータは、ユーザーのプライベートな設定ディレクトリ内に保存されます。

Windows: %APPDATA%\phanterm\
Linux/macOS: ~/.config/phanterm/

主要ファイル一覧

ファイル名	用途	フォーマット説明
`config.yaml`	グローバル設定	言語設定、アップデートのオン/オフ、並行処理の制限などの基本設定が含まれます。
`connections.yaml`	ホストリスト	お客様のサーバーの一覧です。システムキーリングに依存するパスワードなどの機密フィールドは空、または特殊な参照として表示され、それ以外の場合は強力に暗号化された AES 暗号文として保存されますのでご安心ください。
`known_hosts.yaml`	信頼された指紋データベース	これまでに検証したすべてのホストアドレス、アルゴリズムの種類、および SHA-256 指紋が記録されています。
`snippets.yaml`	コマンドスニペットライブラリ	すべてのカスタムコマンドスニペットとタグのメタデータを保存します。
`master.key`	AES フォールバックキー	[極秘] このファイルは適切に保管し、パブリックなコードリポジトリにコミットすることは絶対におやめください。

`config.yaml` のカスタマイズ

config.yaml は、アプリケーションのグローバルな動作制御を提供します。このファイルを手動で編集して、PhanTerm の動作をカスタマイズできます。ファイルが存在しない場合、PhanTerm は次回の起動時にデフォルト値を含む設定ファイルを自動的に生成します。

設定例

以下は、標準的な config.yaml の設定例です：

# インターフェースの言語設定。現在 'en' (英語) と 'zh' (中国語) のみをサポート
locale: "en"

# 自動アップデートのチャンネル：'stable' (安定版) または 'beta' (ベータ版)
update_channel: "stable"

# 起動時にアップデートを自動確認するかどうか
check_updates_on_startup: true

# Multi-Exec 並行バッチ実行の高度な設定 [Pro]
multi_exec:
  # 保存された複数のサーバーへ一時接続を開始する際の最大同時接続数（デフォルト：10、範囲：1-10）
  temp_connect_concurrency: 10

  # 各ターゲットサーバーでのコマンド実行の最大タイムアウト時間、単位は秒（デフォルト：300、つまり 5 分）
  target_timeout_seconds: 300

設定項目の説明

locale：TUI 画面の表示言語を定義します。空であるか、サポートされていない言語の場合、デフォルトの英語画面にフォールバックします。
update_channel および check_updates_on_startup：アプリケーションが新バージョンのプッシュ通知をどのように取得するかを制御します。
multi_exec：この部分は特に Multi-Exec 機能の基盤となる動作を制御します。ネットワーク環境に応じて temp_connect_concurrency を調整して並行接続の負荷を制御したり、target_timeout_seconds を増やすことで、非常に時間のかかるスクリプト（大きなファイルのパッケージ化やシステムの完全なアップグレードなど）が強制的に中断されることなく無事に完了できるようにすることができます。