システム
管理者向けの技術セクションです。主なタブ: アップデート、ジオ/クロークDB、JavaScript、ウォーターマーク。ここではQubixのバージョンを更新し、ジオ/クロークのデータベースを管理し、保護用の制限を設定します。
アップデート
このタブは現在のバージョンを表示し、システムを希望のリリースに更新できます。
上部には2つのバージョンカードがあります。
- qubixd binary — Qubix実行ファイルのバージョン（ビルド、ビルド日、データスキーマバージョン）。
- live container — 実行中のコンテナのバージョン（タグとイメージ、アップデーターのバージョン）。
バイナリのバージョンがコンテナのタグと一致しない場合、警告が表示されます: 通常これは、コンテナが標準のアップデートフローの外で起動されたことを意味し、次回のアップデートでそれが上書きされます。
アップデートの実行方法
- アップデートを実行ブロックで、ターゲットバージョンを入力します — 例えば
1.1.2、または最新版ならlatest。
- アップデートをクリックします。
- 進捗を見守ります: システムは新しいイメージをプルし、古いバージョンを停止し、新しいものを起動してそのヘルスをチェックします。フェーズはリストとして表示され、完了すると詳細なログを展開できます。
新しいバージョンのヘルスチェックが失敗した場合、Qubixは前のコンテナに自動でロールバックします — 手動で何かする必要はありません。
アップデートの進行中は、サーバーを再起動したり、コンテナを手動で停止したりしないでください。自動ロールバックは通常のヘルスチェック失敗のためだけに設計されています。ロールバックも失敗した場合（極めて稀なケース）、サーバー上での管理者による手動介入が必要になります。
ホストリソース
バージョンカードの下に、Qubixはサーバーのリソースのライブスナップショットを表示します。これはバックグラウンドで収集され、自動的に更新されるため、ページには現在の状態が反映されます。
- ディスク空き容量 — データを保存するディスクの空き容量。
- 空きメモリ — サーバーの利用可能なRAM。
- Qubix プロセスメモリ — Qubixプロセス自体が占有するRAM量。Qubixがメモリを消費しているのか、サーバー上の別のプロセスが消費しているのかを判別するのに役立ちます。
- スワップ — Qubixプロセスが使用するスワップ量。通常はゼロです。目立つ値が表示されている場合、サーバーのRAMが不足してディスクへのページングが始まっており、全体的な動作が遅くなります。
- CPU 負荷 — コア数に対する過去5分間のプロセッサ平均負荷。
サーバーが実際に計測できる項目のみが表示されます。一部の環境では特定のメトリクスが利用できず、非表示になる場合があります。
リソースアラート
Qubixはこれらの数値を表示するだけでなく、自律的に監視し、問題が発生した際にはTelegramアラートを技術チャンネルへ送信します。
- ディスク容量が少なくなっている場合（残量が極めて少なくなった際にはより緊急のアラートを別途送信）；
- 利用可能なメモリが少なくなっている場合（こちらも別途クリティカルアラートあり）；
- Qubixプロセスがスワップを使用し始めた場合；
- プロセッサの負荷が高い状態が続いている場合。
これにより、このページを開かなくても、インスタンスが停止する前に問題を把握できます。ノイズを避けるため、一時的なスパイクではアラートは発生せず、同じ警告が頻繁に繰り返されることもありません。メトリクスが正常に戻ると、Qubixは復旧メッセージを送信します。
技術チャンネルは管理者が接続 → Telegramで設定します。設定されていない場合、アラートの送信先がありません。
Qubixプロセスはスワップで動作すべきではありません。スワップにゼロ以外の値が表示された場合（またはスワップアラートを受信した場合）、サーバーのメモリが不足しています — RAMを増設してください。スワップで動作すると、全体的な動作が著しく遅くなります。
ジオ/クロークDB
検出とクローキングに使用されるジオとクロークのデータベースです。このタブには2つの更新モードがあります。
- 自動更新 — データベースはスケジュールに従ってライセンスサーバーからプルされます。更新間隔フィールド（時間単位）で頻度を設定します。
- 手動更新 — スケジューラはオフ。データベースは今すぐ更新ボタンでのみ更新されます。
その下に — データベースの状態（各データベースの現在の状態とサイズ）と更新履歴 — 時刻、データベース、ステータス、トリガー（スケジュールまたは手動）、サイズ、メッセージ付きの更新実行のログ。
JavaScript
ユーザースクリプトの制限です。これらの設定はその場で変更され、すべてのスクリプトに一度に適用されます。いくつかのブロックにグループ化されています。
- Fetch — スクリプトからのアウトバウンドHTTPリクエストのルール:
- ホスト許可リスト — 許可されたアドレスのリスト、1行に1つ。リストが空の場合、スクリプトからのアウトバウンドリクエストは無効になります。
- デフォルトタイムアウトと最大タイムアウト — リクエストのデフォルトおよび許可される最大のタイムアウト（ミリ秒）。
- 最大ボディ — 最大レスポンスサイズ（バイト）。
- 実行ごとの最大呼び出し数 — スクリプトの1回の実行で許可されるアウトバウンドリクエストの数。
- ランタイム — スクリプトの最大実行時間: 1つのスクリプトの最大実行時間（ミリ秒）。
- SQL — スクリプトからのデータクエリの制限: 実行あたりのクエリ数、クエリあたりの行数、タイムアウト。クエリは読み取り専用で、スクリプト所有者の権限内で実行されます。
- メモリ — メモリ制限。近日提供予定で、まだ利用できません。
編集後、保存をクリックします。
許可リスト内のアスタリスク * は、スクリプトが内部のものを含む任意のアドレスに到達できるようにします。意図的に使ってください — それは管理者の責任です。
透かし
透かし除去ツールの制限です。アップロードされる画像のサイズの上限を設定します — これはサーバーをメモリ過負荷から保護します。制限を超える画像は、処理される前に拒否されます。
- 最大メガピクセル — 最大の画像面積（幅×高さ）。
- 最大辺 — いずれかの辺の最大の長さ（ピクセル）。
編集後、保存をクリックします。各フィールドの下には推奨値のヒントがあります。
