ナビゲーションパネル同期
サブドメインルーティング → ナビゲーションパネルへ同期 は、有効な fn-knock アプリ入口を Sun-Panel、OneNav、Van-Nav へ一方向に公開します。送信するのは表示名、公開 URL、公開アイコン、任意のグループだけで、内部 Target、静的ファイルのサーバーパス、認証情報、fn-knock の管理権限は送信しません。
接続
- パネル種別と完全な API URL を入力します。
- 必要なアカウントや Token を入力します。TLS 検証の無効化は、管理された自己署名環境で信頼チェーンを直せない場合だけ使用します。
- fn-knock のグループを反映するか、すべてを指定カテゴリへ配置します。反映モードでは名前空間を設定でき、未分類アプリもそこへ入ります。
- 下書きを保存して接続テストを実行します。成功するまでプレビューと同期はできません。
資格情報は暗号化され、このインストールに結び付けられます。.knock バックアップを復元すると資格情報が消去され、未検証になり、自動同期も無効になります。
プレビューと適用
適用前には必ずプレビューが必要です。作成、更新、削除、変更なし、残留、競合を表示し、短時間で失効します。適用時にも元設定、リモート状態、計画ダイジェストを再確認し、変化があれば再プレビューを要求します。競合がある計画は適用できません。
同期対象は、有効な通常アプリ Host のうち、リバースプロキシと静的ファイルまたはディレクトリのレスポンスです。認証サービスと無効なマッピングは除外されます。公開 URL は現在のドメイン、トンネル、外部ポート設定から生成され、パネルから開いても既存の認証、可視性、WAF ポリシーが適用されます。静的マッピングのローカルパスが、プレビュー、リモートパネル、同期履歴へ含まれることはありません。
fn-knock は、この接続が登録したリモート項目だけを変更・削除します。同名の第三者項目は引き継ぎません。登録済み項目をパネル側で変更すると、次回同期で上書きされることがあります。
自動同期とプロバイダー差
自動同期はサブドメイン変更時と、5～1440 分の校正間隔で実行されます。失敗と復旧はイベントセンターに記録され、履歴は最大 20 件かつ 30 日です。
OneNav と Van-Nav は古い所有項目を削除できます。Sun-Panel には安定した削除・カテゴリ名変更 API がないため、残留項目は手動で整理します。接続削除時は既定でリモート内容を残し、任意のクリーンアップも所有項目だけを対象にします。Sun-Panel は関連付け解除のみです。
セキュリティとトラブルシューティング
HTTPS と最小権限の資格情報を使用してください。TLS 検証無効化は傍受リスクを高めます。
テスト成功後のプレビュー失敗では、API 基本パス、権限、同名競合を確認します。
計画が失効したら、古い計画を再送せず再プレビューします。
履歴とイベントでネットワーク、認証、クォータ、残留項目を確認します。
接続削除前にリモート入口を残すか決めてください。