ダッシュボードとシステム更新
ダッシュボード には、ゲートウェイのトラフィック、セキュリティブロック、DDNS、トンネルの状態が集約されます。トラフィックが発生しているか、最近明らかな異常が起きていないかをすばやく確認するための画面です。リクエストログ、長期監視、アップストリームサービス自身の稼働確認の代わりにはなりません。
ダッシュボードの見方
画面上部では 15分、1時間、6時間、24時間、7日間 のいずれかを選択できます。この範囲は総受信量 / 総送信量、セキュリティの傾向、ネットワークトラフィックのグラフに反映されます。リアルタイム受信、リアルタイム送信、現在のオンライン数は、その時点の状態を示します。
主な領域は次のとおりです。
| 領域 | 内容 |
|---|---|
| リアルタイムおよび総トラフィック | 現在の送受信速度と、選択範囲内の総受信量・総送信量 |
| セキュリティブロック | ログイン失敗、スキャナーのブロックリスト件数、WAF の検知・ブロックイベントと傾向 |
| アクセス経路の状態 | DDNS プロバイダー、最終アドレス、更新範囲、最終チェック、追加ドメインの状態 |
| トンネルの入口 | リバースプロキシモードでの FRP / Cloudflared の実行状態、デフォルトトンネル、PID |
| ネットワークトラフィックの傾向 | 選択した時間範囲内の受信・送信時系列 |
「アクセス経路の状態」モジュールは システム設定 → 機能 で非表示にできます。トンネル領域が表示されるのは、リバースプロキシモードで、現在のプラットフォームが FRP または Cloudflared に対応している場合だけです。
問題を調べるときは、次の順に確認します。
- マッピングを追加した後に外部からアクセスし、オンライン数、リアルタイム速度、トラフィックグラフのいずれかが変化することを確認します。
- セキュリティブロックが増えた場合は、イベントセンター、スキャナーのブロックリスト、WAF ログで具体的な送信元を確認します。
- DDNS が更新されない場合は、DDNS 画面で最終チェック、IP の取得元、更新ログを照合します。
- トンネルが停止中と表示される場合は、対応するカードからトンネル画面を開き、プロセスの状態とログを確認します。
- 特定のドメインだけに問題がある場合は、その Host のマッピング、証明書、アクセスポリシー、アップストリームの転送先を確認します。
ローカルホストや LAN 内のトラフィックだけでは、公開入口が有効だとは確認できません。認証、リバースプロキシ、トンネルが関係する場合は、モバイル回線など実際の外部経路から再テストしてください。
管理画面のテーマカラー
ダッシュボード右上では、デフォルト、エルメスオレンジ、プルシアンブルー、ダイナミックホワイト のいずれかを選択できます。管理画面全体のテーマカラーとして保存され、ライト / ダーク表示の切り替えとは独立しています。認証ページやアップストリームアプリの外観には影響しません。
デプロイ方式ごとに異なる更新方法
画面の場所は バージョンとアップデート です。どのデプロイ方式でも現在のバージョン、最新バージョン、確認結果、リリースノートが表示されます。管理画面の読み込み後は、サイドバーにも現在のバージョンが表示され、更新が定期的に確認されます。新しいバージョンが見つかるとページ上部に通知が表示され、更新画面でリリースノートを確認できます。通知から Web 上でインストールできるのは fnOS ネイティブ FPK だけです。Synology DSM 7 SPK は DSM パッケージセンター、Windows ネイティブ版は独立した fn-knock Windows 管理アプリ からインストールし、Web の更新画面では実行しません。
| デプロイ方式 | 更新画面でできること | 実際の更新方法 |
|---|---|---|
| fnOS ネイティブ FPK | 確認、ダウンロード、検証、ワンクリックインストール | 画面からワンクリック更新を実行。アプリが再起動します |
| Docker Compose | バージョン確認とリリースノートの表示 | リリースイメージを pull し、コンテナを再作成 |
| OpenWrt | バージョン確認とリリースノートの表示 | ファームウェアのパッケージ形式とアーキテクチャに合う .ipk または .apk をインストール |
| Linux（systemd / OpenRC） | バージョン確認とリリースノートの表示 | sudo knock update を実行 |
| Synology DSM 7 SPK | バージョン確認とリリースノートの表示 | アーキテクチャに合う SPK をダウンロードし、DSM パッケージセンターから手動更新 |
| Windows x86_64 | バージョン確認とリリースノートの表示 | fn-knock Windows 管理アプリ またはシステムトレイのメニューから確認してインストール |
Docker、OpenWrt、Synology の更新画面から FPK をインストールしないでください。これらの環境では、アプリ内アップデートが非対応と表示されます。Windows でも Web の更新画面からインストールせず、デスクトップ管理アプリを使用してください。
fnOS ネイティブ FPK の更新
バージョンとアップデート で新しいバージョンを確認します。アップデートが見つかると、機器のアーキテクチャに合う FPK とチェックサムファイルをダウンロードし、fnOS アプリセンターからインストールしてアプリを再起動します。ダウンロード、検証、インストールの進行状況が表示されます。インストール中は画面を閉じないでください。
アップデート中は、管理画面とゲートウェイが短時間利用できなくなります。開始前に設定バックアップをエクスポートしてください。完了後は fnOS デスクトップからアプリを開き直し、バージョン番号、認証設定、ゲートウェイ入口がすべて正常に戻っていることを確認します。
Docker Compose の更新
デプロイディレクトリで次のコマンドを実行します。
cd /opt/fn-knock
docker compose pull
docker compose up -d
docker compose ps.env の FN_KNOCK_IMAGE にバージョンタグを固定している場合は、先に目的のバージョンへ変更します。イメージはデータバックアップではありません。更新前に fn_knock_gateway と fn_knock_data の 2 つの永続ボリュームをバックアップしてください。
Linux の更新
一般的な Linux インストールでは、次のコマンドを使用します。
sudo knock updateこのコマンドはローカルと公開済みのバージョンを比較し、リリースパッケージをダウンロードして検証した後、バージョンディレクトリへデプロイします。同じバージョンでも確認後に再インストールできます。新しいバージョンのヘルスチェックに失敗すると、元のプログラム、サービススクリプト、起動状態が復元されます。保持されている以前のバージョンへ戻す場合は sudo knock rollback を実行します。更新前には /etc/fn-knock と /var/lib/fn-knock もバックアップしてください。
OpenWrt の更新
ファームウェアのパッケージマネージャーと対象アーキテクチャに合う新しいパッケージを選び、次のコマンドを実行します。
# opkg ファームウェア
opkg install --force-reinstall /tmp/fn-knock_*.ipk
# apk ファームウェア
apk add --allow-untrusted /tmp/fn-knock_*.apk
/etc/init.d/fn-knock status/tmp に複数のバージョンがある場合は、ワイルドカードではなく完全なファイル名を指定してください。
ローカル .apk での --allow-untrusted は、信頼できるリリース元から取得したパッケージにだけ使用してください。アップグレード時には /etc/config/fn-knock、/etc/fn-knock/gateway、/var/lib/fn-knock が保持されますが、事前にバックアップしておく必要があります。
Synology DSM 7 SPK の更新
バージョンとアップデート でバージョンとリリースノートを確認し、Synology の機種とアーキテクチャに合う SPK をダウンロードします。その後 DSM パッケージセンターから手動で更新してください。Web 画面が DSM に代わってパッケージをインストールまたは再起動することはありません。
更新前にアプリバックアップをエクスポートします。パッケージデータは /var/packages/fn-knock-synology/var にあります。更新後は DSM デスクトップのパッケージ入口から開き直し、バージョン、認証設定、ゲートウェイへのアクセスが復旧していることを確認してください。
Windows x86_64 の更新
fn-knock Windows 管理アプリ を開いて「更新を確認」をクリックするか、システムトレイのメニューから同じ操作を実行します。管理アプリは Windows インストーラーのダウンロード元、ファイルサイズ、SHA-256 を確認してからインストーラーを起動します。Web 画面の バージョンとアップデート は、バージョンとリリースノートの表示だけに使用します。
インストーラーはサービスを一時停止します。新しいバージョンが準備完了チェックで起動できなかった場合は、以前のプログラムと実行データを復元します。ただし、これはバックアップの代わりではありません。更新前にアプリバックアップをエクスポートしてください。Windows でアンインストールまたはアップグレードした後も %ProgramData%\FnKnock は残り、設定、SQLite、証明書などの機密データが含まれます。
更新後に毎回確認すること
- 管理入口へログインでき、現在のバージョンが正しいこと。
- ゲートウェイのドメインまたはポートへ、実際の外部ネットワークからアクセスできること。
- 現在のモード、証明書、マッピング、認証ルールが引き続き想定どおりであること。
- 使用中の FRP、Cloudflared、その他の前段リバースプロキシが再接続されていること。
- イベントセンター、リクエストログ、WAF ログに新しいレコードが引き続き生成されていること。
fn-knock の更新は、ホスト OS の更新やバックアップの代わりにはなりません。公開ゲートウェイ、証明書、DNS、サービスにはそれぞれ独立した障害要因があるため、更新後に個別に検証してください。
関連ドキュメント：