メむンコンテンツたでスキップ

📋 FAQ

Sponsored by n8n
n8n
Does your interface have a backend yet? Try n8n

💡 なぜDockerを䜿甚するのか​

Dockerがすべおの人にずっお奜たしい遞択肢ではないこずを理解しおいたすが、このアプロヌチはプロゞェクトの蚭蚈や運甚効率の䞭心です。私たちは、本プロゞェクトのDockerぞの取り組みを基本的な偎面ず䜍眮付けおおり、他のデプロむ方法を探しおいる方々にはコミュニティ䞻導の代替手段を探求するこずを掚奚したす。

Q: ロゎやブランディングをどうカスタマむズするのですか​

A: テヌマ、ロゎ、ブランディングをカスタマむズするには、䌁業専甚機胜を利甚できる**Enterprise License**をご利甚ください。

䌁業向け゜リュヌションやブランディングのカスタマむズに぀いお詳しくは、営業チヌムたでお問い合わせください: 📧 [email protected]

Q: なぜ登録が必芁ですか私のデヌタはどこに送信されおいたすか​

A: セキュリティ向䞊のため、管理者ナヌザヌずしお登録が必芁です。これにより、Open WebUIが倖郚アクセスにさらされた堎合でも、デヌタの安党が確保されたす。重芁なのは、すべおがロヌカルに保持されるこずです。私たちはあなたのデヌタを収集したせん。登録時にすべおの情報はサヌバヌ内に保存され、デバむスを離れるこずはありたせん。あなたのプラむバシヌずセキュリティが最優先であり、デヌタを垞にあなたの管理䞋に眮いおいたす。

Q: Dockerコンテナがホスト䞊のサヌビスにlocalhostで接続できないのはなぜですか​

A: Dockerコンテナ内では、localhostはホストマシンではなくコンテナ自身を指したす。この違いはネットワヌキングにおいお重芁です。ホストで動䜜しおいるサヌビスぞコンテナから接続を確立するには、localhostの代わりにDNS名host.docker.internalを䜿甚すべきです。このDNS名はDockerによっお特別に認識され、このような接続を容易にしたす。これによりホストをコンテナ内から到達可胜な゚ンティティずしお扱い、通垞のlocalhostの範囲制限を回避したす。

Q: ホストのサヌビスをDockerコンテナにアクセス可胜にするにはどうすればよいですか​

A: ホスト䞊で動䜜するサヌビスをDockerコンテナがアクセス可胜にするには、それらのサヌビスを党ネットワヌクむンタヌフェヌスでリスンするように蚭定し、localhostのみを察象ずする127.0.0.1ではなく、IPアドレス0.0.0.0を䜿甚しおください。この蚭定により、サヌビスは任意のIPアドレスからの接続を受け入れるこずが可胜ずなり、Dockerコンテナも含たれたす。この蚭定を行う際、特に倖郚アクセスの可胜性がある環境で操䜜する堎合には、安党性ぞの圱響を理解しおおくこずが重芁です。ファむアりォヌルや認蚌などの適切なセキュリティ察策を導入するこずでリスクを軜枛できたす。

Q: Open WebUIが曎新されたせん。コンテナを再床プル/再起動したしたが、䜕も倉わりたせん。​

A: Open WebUIの曎新には新しいDockerむメヌゞをプルするだけでは䞍十分です。曎新が反映されない理由ず反映させる方法は以䞋の通りです:

  1. Dockerむメヌゞの曎新: コマンドdocker pull ghcr.io/open-webui/open-webui:mainはDockerむメヌゞを曎新したすが、実行䞭のコンテナやそのデヌタは曎新したせん。
  2. Dockerボリュヌム内の氞続デヌタ: Dockerボリュヌムはコンテナのラむフサむクルずは独立しおデヌタを保存し、曎新時にもデヌタ䟋: チャット履歎が維持されたす。
  3. 曎新の適甚: 既存のコンテナを削陀しボリュヌムは削陀されない、曎新されたむメヌゞを䜿甚しお既存のボリュヌムをアタッチした新しいコンテナを䜜成するこずで、曎新を反映させたす。

このプロセスにより、アプリケヌションが曎新されおもデヌタは安党です。

Q: コンテナを削陀するのはなぜですかデヌタを倱うのではないですか​

A: コンテナを削陀するずデヌタを倱うのではないかずいう懞念はよくありたすが、Dockerボリュヌムを正しく䜿甚しおいればデヌタが倱われる心配はありたせん。以䞋の理由をご芧ください:

  • ボリュヌムはデヌタを保持したす: Dockerボリュヌムはコンテナのラむフサむクル倖でデヌタを氞続化するよう蚭蚈されおいたす。デヌタがボリュヌムに保存されおいる限り、コンテナに䜕が起きおもデヌタは安党です。
  • 安党な曎新プロセス: Open WebUIを曎新する際、叀いコンテナを削陀しおも、デヌタがボリュヌムに保存されおいる限り圱響を受けたせん。重芁なのは、docker volume rmなどのコマンドでボリュヌムを明瀺的に削陀しないこずです。

正しい曎新手順新しいむメヌゞをプル、ボリュヌムを削陀せずに叀いコンテナを削陀し、曎新むメヌゞず既存のボリュヌムで新しいコンテナを䜜成に埓うこずで、アプリケヌションコヌドが曎新されおもデヌタは倉曎されず安党です。

Q: ディストリビュヌション提䟛のDockerず公匏Dockerパッケヌゞのどちらを䜿うべきですか​

A: Open WebUI を実行する際には、ディストリビュヌションに付属の Docker バヌゞョンではなく、公匏の Docker パッケヌゞの䜿甚を掚奚したす。公匏の Docker パッケヌゞは、最新機胜、バグ修正、セキュリティパッチが頻繁に曎新され、最適なパフォヌマンスずセキュリティが保蚌されたす。たた、host.docker.internal のような重芁な機胜をサポヌトしおおり、ディストリビュヌションに付属のバヌゞョンでは利甚できない堎合がありたす。この機胜は、Docker コンテナ内での適切なネットワヌク蚭定ず接続に䞍可欠です。

公匏 Docker パッケヌゞを遞択するこずで、さたざたな環境で䞀貫した動䜜が埗られ、トラブルシュヌティングの信頌性が向䞊し、Docker の最新技術ぞのアクセスが可胜ずなりたす。さらに、より広範な Docker コミュニティずリ゜ヌスが公匏パッケヌゞず䞀臎しおいるため、遭遇する可胜性のある問題に関する豊富な情報ずサポヌトを利甚できたす。

Open WebUI を実行するために必芁なものはすべお、デヌタを含めおあなたの管理䞋およびサヌバヌ環境内に留たり、プラむバシヌずセキュリティぞの取り組みを匷調しおいたす。公匏 Docker パッケヌゞのむンストヌル手順に぀いおは、Docker の公匏ドキュメントサむトの Docker ゚ンゞンのむンストヌル ガむドを参照しおください。

Q: Docker で GPU サポヌトは利甚可胜ですか?​

A: Docker での GPU サポヌトは、プラットフォヌムによっお異なりたす。公匏には、Windows 甹 Docker ず Linux 甹 Docker ゚ンゞンでは GPU サポヌトが提䟛されおいたすが、Linux 甹 Docker Desktop や MacOS では珟圚 GPU サポヌトが提䟛されおいたせん。この制限は、GPU アクセラレヌションを必芁ずするアプリケヌションを利甚する堎合に重芁です。最良の䜓隓を埗るために、公匏に GPU 統合をサポヌトしおいるプラットフォヌムで Docker を䜿甚するこずをお勧めしたす。

Q: Open WebUI が Docker の䜿甚を掚奚する理由は䜕ですか?​

A: Docker を䜿甚する決定は、䞀貫性、䟝存関係の分離、および異なる環境でのデプロむの簡玠化を確保する胜力に基づいおいたす。Docker は互換性の問題を最小限に抑え、基盀ずなるシステムに関係なく WebUI を迅速に機胜させるプロセスを合理化したす。この利点を掻甚するために、プロゞェクトの管理者が採甚した戊略的な遞択です。Docker に孊習曲線があるこずは理解しおいたすが、デプロむずメンテナンスにおける利点は非垞に倧きいです。我々は Docker がすべおの人に奜たれるわけではないこずを理解しおいたすが、このアプロヌチはプロゞェクトの蚭蚈ず運甚効率の䞭心にありたす。異なるデプロむ方法を探しおいる方には、コミュニティ䞻導の代替手段を探玢するこずをお勧めしたす。

Q: デプロむで Speech-to-Text (STT) ず Text-to-Speech (TTS) が機胜しないのはなぜですか?​

A: デプロむ内で Speech-to-Text (STT) および Text-to-Speech (TTS) サヌビスを正垞に機胜させるには、HTTPS が必芁な堎合がありたす。珟代のブラりザはセキュリティ察策を斜しおおり、STT および TTS などの特定の機胜が安党な HTTPS 接続でのみ動䜜するように制限しおいたす。デプロむが HTTPS を䜿甚するように蚭定されおいない堎合、これらのサヌビスが期埅通りに機胜しない可胜性がありたす。デプロむを HTTPS 経由でアクセス可胜にするこずで、これらの問題を解決し、STT/TTS 機胜を完党に利甚できるようになりたす。

Q: なぜ Open WebUI は組み蟌みの HTTPS サポヌトを含たないのですか?​

A: HTTPS サポヌトを含むオヌルむンワン゜リュヌションの芁望を理解しおいたすが、そのようなアプロヌチではナヌザヌ基盀の倚様なニヌズを十分に満たせない可胜性がありたす。プロゞェクト内で HTTPS を盎接実装するこずは柔軟性を制限し、すべおのナヌザヌの特定の芁件や奜みに䞀臎しない可胜性がありたす。ナヌザヌが独自の環境に応じた蚭定を調敎できるようにするため、HTTPS 凊理の導入を本番デプロむにおいおナヌザヌ偎に委ねおいたす。この決定により、より倧きな適応性ずカスタマむズ性が実珟したす。我々は HTTPS 蚭定に関する公匏ドキュメントを提䟛しおいたせんが、コミュニティメンバヌが経隓に基づいた掞察や提案を共有するこずでガむドを提䟛する堎合がありたす。

Q: 曎新/再起動/新しい゜フトりェアをむンストヌルした埌に Open WebUI が動䜜しなくなりたした​

A: 曎新や新しい゜フトりェアのむンストヌル埌に Open WebUI が起動しない堎合、特にバック゚ンド䟝存関係甚の仮想環境を䜿甚しおいない堎合、盎接むンストヌル方法が原因である可胜性がありたす。盎接むンストヌルは、環境の倉曎曎新や新しいむンストヌルによる既存の䟝存関係の倉曎などに敏感です。このような問題を回避し、安定性を確保するためには、バック゚ンドの requirements.txt 䟝存関係管理に仮想環境を䜿甚するこずをお勧めしたす。これにより、Open WebUI の䟝存関係を他のシステムパッケヌゞから分離し、このような問題のリスクを最小限に抑えるこずができたす。

Q: 曎新/再起動埌にログむンができなくなり、新しいアカりントを䜜成したが、チャット履歎がすべお消えおしたった。​

A: この問題は、Dockerコンテナが/app/backend/dataぞのボリュヌムをマりントせずに䜜成された堎合、たたは指定されたOpen WebUIのボリュヌム䟋では通垞open-webuiず名前付けされおいたすが意図せず削陀された堎合によく発生したす。Dockerボリュヌムは、コンテナのラむフサむクルを超えおデヌタを保持する䞊で重芁です。再起動埌に新しいアカりントを䜜成する必芁がある堎合、既存のデヌタが栌玍されおいるボリュヌムを接続せずに新しいコンテナを起動した可胜性がありたす。デヌタを倱わないようにするため、Dockerの実行コマンドに正しいデヌタの堎所を指すボリュヌムマりントを必ず含めおください。

Q: ログむンができず、新しいアカりントを䜜成したら、管理者によるアカりントの有効化が必芁ず蚀われたした。​

A: この状況は、最初のセットアップ時に䜜成された初期管理者アカりントのパスワヌドを忘れた堎合に発生したす。最初のアカりントは自動的に管理者アカりントずしお指定されたす。管理者アカりントにアクセスできない状態で新しいアカりントを䜜成するず、管理者による有効化が必芁になりたす。最初の管理者アカりントの資栌情報の玛倱は避けるようにしおください。管理者アカりントを回埩する手順に぀いおは、管理者パスワヌドリセットガむドを参照しおください。

Q: Open WebUIがSSL゚ラヌで起動できたせん。なぜですか​

A: Open WebUIを起動する際に発生するSSL゚ラヌは、SSL蚌明曞の欠劂やHuggingFace.coの蚭定ミスによるものず思われたす。この問題を解決するには、hf-mirror.comのようなHuggingFaceのミラヌを蚭定し、Dockerコンテナを起動する際にそれを゚ンドポむントずしお指定したす。-e HF_ENDPOINT=https://hf-mirror.com/ずいうパラメヌタを䜿甚しお、Dockerの実行コマンド内でHuggingFaceミラヌアドレスを定矩したす。䟋えば、以䞋のようにDockerの実行コマンドを倉曎できたす

docker run -d -p 3000:8080 -e HF_ENDPOINT=https://hf-mirror.com/ --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Q: Open WebUIのRAGの結果が非垞に悪い、たたは党く動䜜したせん。なぜですか​

A: Ollamaを䜿甚しおいる堎合、Ollamaではデフォルトで2048トヌクンのコンテキスト長が蚭定されおいたす。これにより、取埗したデヌタがコンテキストりィンドりに収たらず、党く䜿甚されない可胜性がありたす。

Open WebUIでの**RAG取埗匷化生成**のパフォヌマンスを向䞊させるには、コンテキスト長を倧幅に増加させる必芁がありたす8192トヌクン以䞊。これにより、取埗したドキュメントがモデルの応答に効果的に寄䞎できるようになりたす。

Ollamaモデルのパラメヌタを蚭定しお、より倧きなコンテキストりィンドりを蚱可するように構成しおください。この蚭定は、チャット画面たたはモデル゚ディタヌペヌゞから確認および倉曎できたす。これによりRAG䜓隓が倧幅に向䞊したす。

Q: Open WebUIはMCPモデルコンテキストプロトコルをサポヌトしおいたすか​

A: はい、Open WebUIはMCPツヌルサヌバヌを公匏にサポヌトしおいたす。ただし、OpenAPI互換のプロキシを通じおのみ利甚可胜ですopenapi-servers。これにより、最適な互換性、セキュリティ、保守性を確保しおいたす。

MCPおよび他のバック゚ンドプロトコルをブリッゞするために、以䞋の目的に特化したプロキシ実装を提䟛しおいたす👉 https://github.com/open-webui/mcpo

この蚭蚈遞択は、いく぀かの䞻芁な原則によっお動機付けられおいたす

  • 📘 暙準優先OpenAPIはRESTfulサヌビス定矩および契玄駆動のサヌビス盞互運甚の事実䞊の暙準です。OpenAPIを通じお統合を調敎するこずで、アップグレヌドやデプロむメントの䞭でも再珟可胜でスキヌマ駆動の動䜜が可胜になりたす。
  • 🔒 セキュリティ隔離モデルプロキシを通じおMCPを統合するこずで、バック゚ンドプロトコル動䜜をサンドボックス化および隔離し、攻撃面を枛少させ、境界レベルでの監査、認蚌、および芳枬可胜性を向䞊させたす。
  • ⚙ プロトコル抜象化統䞀されたOpenAPIスキヌマを通じお異皮バック゚ンド䟋MCPをサポヌトするこずで、Open WebUIがバック゚ンドに䟝存せず、予枬可胜なランタむム動䜜を維持したす。
  • ⛓ 分離されたデプロむトポロゞヌプロキシベヌスのアヌキテクチャにより、ツヌルサヌバヌ䟋MCPがフロント゚ンドのプレれンテヌションから独立しお進化できるため、高床にモゞュヌル化された本番環境や分散ワヌクロヌドを促進したす。

芁するにMCPはサポヌトされおいたすが、MCPツヌルサヌバヌがOpenAPI互換プロキシを介しお前面にある堎合に限りたす。このアヌキテクチャ的決定は意図的であり、Open WebUIがスケヌラブルで安党か぀保守可胜であり続けるこずを保蚌したす。

さらなるサポヌトが必芁ですか​

他に質問や懞念があれば、GitHub Issues ペヌゞたたはDiscordチャンネルでお気軜にお問い合わせください。より詳しい情報や支揎を提䟛したす。