よくある問題
Kanera でのデプロイメントの問題は通常、コードではなく構成です。ドメインが間違ったサービスを指している、Cookie 設定がパブリック URL と一致しない、またはデプロイ間で変更されたシークレットです。
新しいデプロイメントを順番に実行します
これまで機能したことのない展開の場合は、症状に飛びつくのではなく、次のことを順番に確認してください。
- 必要な環境変数が存在することを確認します。参照 環境ファイルを設定する.
- PostgreSQL と Valkey が正常であることを確認します。
- API とワーカーのログを確認します。
- 公衆衛生エンドポイントが応答することを確認します。参照 導入を確認する.
- リバースプロキシルーティングと信頼できるパブリック URL を確認します。参照 サービスとルーティング.
- SMTP、ストレージ、バックアップ構成を個別にテストします。
各ステップはその上のステップに依存するため、ステップ 4 での失敗は、ステップ 2 が完了する前にデバッグする価値はほとんどありません。
症状とチェック項目
| 問題 | 何を確認するか |
|---|---|
| ユーザーはログイン後にサインアウトされます。 | 確認する COOKIE_SECURE=true, COOKIE_DOMAIN、そして WEB_ORIGIN パブリック HTTPS ドメインと一致します。 |
| デプロイ後に全員がサインアウトされました。 | JWT_SECRET 変わりました。以前の値に戻します。 |
| 認証コードは、登録されているすべてのユーザーに対して機能しなくなりました。 | MFA_ENCRYPTION_KEY 変わりました。以前の値に戻します。 |
/api/health Web ドメインで失敗します。 | へのドメイン ルートを確認します。 web 港でのサービス 80、直接ではありません api. |
| パブリック API が応答しません。 | ドメインのルートを確認します public-api 港で 3001. |
| MCP は応答しません。 | ドメインのルートを確認します mcp 港で 3002, MCP_SERVER_PUBLIC_URL 公共の場で指摘する /mcp URL、および KANERA_PUBLIC_API_URL です http://public-api:3001 内部構成。 |
| MCP は正常ですが、すべての OAuth リクエストが失敗します。 | 確認する MCP_PUBLIC_URL まさに大衆です /mcp リソースと MCP_INTERNAL_SECRET 同じ非 JWT 値です。 public-api そして mcp。再接続は、読み取り/書き込みポリシーの更新後ではなく、古い非バインド トークンの移行後にのみ必要です。 |
| レート制限は全員に同時に影響します。 | 確認する API_TRUST_PROXY=true そして PUBLIC_API_TRUST_PROXY=true 信頼できるプロキシの背後で動作する場合。 |
| 電子メール認証によりユーザーがブロックされます。 | 休暇を取る EMAIL_VERIFICATION_ENABLED=false SMTPが動作するまで。 |
| メールが一向に届きません。 | SMTP 値とワーカー ログを確認します。電子メールは次の方法で送信されます。 worker APIではなくサービスです。 |
| 再デプロイ後にアップロードが消えます。 | 確認する kanera_uploads 永続的であるか、S3 互換ストレージを構成します。 |
| 添付ファイルが開かなくなりました。 | MEDIA_SIGNING_SECRET 変更され、既存の署名付き URL が無効になります。 |
| デプロイ後にチャット宛先または個人 Webhook が機能しなくなりました。 | SECRETS_ENCRYPTION_KEY 変更されたため、保存された資格情報を復号化できなくなります。以前の値に戻します。 |
| ブラウザプッシュを有効にすることはできません。 | HTTPS を確認し、組織管理者が組織プッシュを有効にしていることを確認します。参照 電子メールと通知. |
| ユーザーは内部ネットワーク上に ntfy または Gotify アドレスを保存できません。 | プライベート受信機は次の場合を除き拒否されます。 KANERA_ALLOW_PRIVATE_NOTIFICATION_DESTINATIONS=true. |
導入リファレンス
実装に基づいたデプロイメントリファレンスは次のとおりです。 デプロイ.md.
導入ではなくアプリ内部の問題 (サインイン、権限、通知、統合、アップロード) については、次から始めます。 トラブルシューティング.
助けを求めてください
導入の問題を報告する場合は、次のことを含めてください。
- やろうとしていたこと、および使用したページまたはコントロール。
- 期待したことと、その代わりに何が起こったのか。
- シークレットが削除された関連サービス ログ。
- デプロイメントが新しいか、以前に動作していたか。
- ブラウザとオペレーティング システムのバージョン (該当する場合)。
電子メール こんにちは@kanera.app サポートのため、または GitHub の問題を開く 再現可能なソフトウェアまたはドキュメントの問題の場合。パスワード、API キー、トークン、顧客データ、プライベート添付ファイルは決して含めないでください。