大容量の写真や動画のアップロードに合わせてリバースプロキシのタイムアウトを設定する方法

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

許容する最も遅い正当なアップロードを基準に、余裕を持たせてプロキシのタイムアウトを設定し、アプリケーションと上流のプロキシにもそれ以上に寛容な設定を適用します。アップロードの失敗をすべて、タイムアウトを無制限にすることで解決しようとしないでください。

大きな写真や動画は、同じアプリが通常どおり動作していても、リクエスト本文、上流での処理、または応答が異なる上限に達して失敗することがあります。まずステータスコード、経過時間、ファイルサイズ、プロキシログを記録してください。これらの情報から、本文サイズによる拒否、アイドルタイムアウト、バックエンドのタイムアウト、クライアント切断を区別できます。

アップロードが終了する段階を特定する

既知のファイルを1つ使って再試行し、転送中、進捗バーが100パーセントに達した後、またはサーバーでメディアを処理している間の、どの時点で失敗するかを記録します。各段階で関係する接続とタイムアウトは異なります。

毎回同じバイト数で失敗する場合は、本文サイズの上限が原因と考えられます。同じアイドル時間の経過後に失敗する場合は、タイムアウトが原因と考えられます。アップロード完了後にゲートウェイエラーが発生する場合は、プロキシからアプリケーションへの待機時間、またはアプリケーション独自の処理上限が原因と考えられます。

プロキシのアクセスログとエラーログをアプリケーションログと併せて確認します。先にクライアントが接続を閉じていた場合、プロキシのタイムアウトだけを延ばしても解決しません。モバイル端末のバックグラウンド動作、VPNの安定性、ブラウザーのリクエスト経路を確認してください。

妥当なタイムアウト予算を測定する

受け付ける最大ファイルサイズを、サポートする最も遅い上流レートで割って転送時間を見積もり、TLS、バッファリング、スループットの変動を考慮した余裕を加えます。これを正当な処理に対する上限として使い、遅い接続をすべて永遠に開いたままにする保証とは考えないでください。

合計時間とアイドル時間を区別します。たとえば、NGINXのプロキシのタイムアウトを設定する個別のディレクティブのように、連続する処理の間隔を測定し、応答全体の所要時間は測定しないものがあります。

サービス拒否攻撃のリスクにも留意してください。接続の持続時間を大幅に延ばす前に、認証とレート制限でアップロードエンドポイントへのアクセスを制限し、プロキシの管理インターフェースを公開しないでください。

過剰に調整せず、すべての層を合わせる

リクエスト本文のサイズ上限を、アプリケーションがサポートする最大サイズ以上に設定してください。そのうえで、失敗する段階に応じて、クライアント本文の読み込み、アップストリームへの接続、アップストリームからの読み込み、アップストリームへの送信の各タイムアウトを調整してください。

外側にCDN、トンネル、ロードバランサー、またはより短い変更不可の上限を持つ2つ目のリバースプロキシがないか確認してください。有効な上限は経路上で最も小さい値になるため、内側のプロキシだけを変更しても、目に見える効果が得られないことがあります。

アプリケーションのURLとプロキシのルートを記録しておきましょう。ZimaSpaceのネットワーク共有でImmichを利用する方法のガイドは、アップロードパスのエラーとストレージマウントの遅延や停止を切り分けるのに役立ちます。

低速、大容量、中断されたアップロードを再テストする

失敗したファイルの元データを、元と同じ場所から同じネットワーク速度でアップロードしてください。完了し、アプリケーションでインデックスが作成され、ファイルを再生または表示できることが成功の条件です。HTTP成功コードが返るだけでは不十分です。

接続速度をサポートされている最低速度まで落としてテストを繰り返してください。次に、アップロードを意図的に中断します。一時ファイルや不完全なデータベースレコードが、アプリケーションの動作に応じて削除されることを確認してください。

ログにバックエンドのクラッシュ、ストレージエラー、または外部プロバイダーによる固定上限が示されている場合は、タイムアウトの延長をやめてください。過剰な値を元に戻し、問題が発生している層を修正したうえで、実測した負荷を安定して処理できる最小限のタイムアウトを維持してください。

よくある質問

すべてのプロキシタイムアウトに同じ値を設定すべきですか?いいえ。接続確立、クライアントからのリクエスト本文の読み込み、アップストリームの応答待ち、ダウンストリームへの送信は、それぞれ異なる処理段階を保護します。

小さな写真はアップロードできるのに、動画は失敗するのはなぜですか?動画のサイズが上限を超えている、アイドル状態の制限時間を超えている、またはサーバー側の処理に時間がかかっている可能性があります。ログと失敗するまでの時間から、原因を特定できます。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.