📋 FAQ
💡 Por que Docker?
Entendemos que o Docker pode não ser a preferência de todos; No entanto, essa abordagem é central para o design e a eficiência operacional do nosso projeto. Vemos o compromisso do projeto com o Docker como um aspecto fundamental e incentivamos aqueles que procuram diferentes métodos de implantação para explorar alternativas orientadas pela comunidade.
P: Como faço para personalizar o logotipo e a marca?
UM:Você pode personalizar o tema, o logotipo e a marca com nossoLicença corporativa, que desbloqueia recursos corporativos exclusivos.
Para obter mais detalhes sobre soluções corporativas e personalizações de marca, entre em contato com nossa equipe de vendas em: 📧contato@nullcore.ai
P: Por que me pediram para se inscrever? Para onde meus dados estão sendo enviados?
UM:Exigimos que você se inscreva para se tornar o usuário administrador para obter segurança aprimorada. Isso garante que, se o webui aberto estiver exposto ao acesso externo, seus dados permanecerão seguros. É importante observar que tudo é mantido local. Não coletamos seus dados. Quando você se inscreve, todas as informações permanecem dentro do seu servidor e nunca sai do seu dispositivo. Sua privacidade e segurança são nossas principais prioridades, garantindo que seus dados permaneçam sob seu controle o tempo todo.
P: Por que meu contêiner do Docker não pode conectar -se aos serviços no host usandolocalhost
UM:Dentro de um recipiente do docker,localhostrefere -se ao próprio contêiner, não à máquina host. Essa distinção é crucial para a rede. Para estabelecer uma conexão do seu contêiner a serviços em execução no host, você deve usar o nome DNShost.docker.internalem vez delocalhost. Este nome DNS é especialmente reconhecido pelo Docker para facilitar essas conexões, tratando efetivamente o hospedeiro como uma entidade acessível de dentro do contêiner, ignorando assim o usuallocalhostLimitação do escopo.
P: Como faço para tornar os serviços do meu host acessíveis a contêineres do Docker?
UM:Para tornar os serviços em execução no host acessível aos contêineres do Docker, configure esses serviços para ouvir em todas as interfaces de rede, usando o endereço IP0.0.0.0, em vez de127.0.0.1que é limitado alocalhostapenas. Essa configuração permite que os serviços aceitem conexões de qualquer endereço IP, incluindo contêineres do Docker. É importante estar ciente das implicações de segurança dessa configuração, especialmente ao operar em ambientes com potencial acesso externo. A implementação de medidas de segurança apropriadas, como firewalls e autenticação, pode ajudar a mitigar os riscos.
P: Por que minha atualização aberta do Webui? Eu retirei/reiniciei o contêiner e nada mudou.
UM:A atualização do Nullcore requer mais do que apenas puxar a nova imagem do Docker. Eis por que suas atualizações podem não estar aparecendo e como garantir que elas se saquem:
- Atualizando a imagem do Docker: O comando
docker pull ghcr.io/open-webui/open-webui:mainAtualiza a imagem do Docker, mas não o contêiner em execução ou seus dados. - Dados persistentes em volumes do docker: Os volumes do docker armazenam dados de forma independente de ciclos de vida do contêiner, preservando seus dados (como históricos de bate -papo) por meio de atualizações.
- Aplicando a atualização: Verifique se sua atualização entra em vigor removendo o contêiner existente (que não exclui o volume) e criando um novo com a imagem atualizada e o volume existente anexado.
Esse processo atualiza o aplicativo, mantendo seus dados seguros.
P: Espere, por que eu excluiria meu contêiner? Não vou perder meus dados?
UM:É uma preocupação comum, mas excluir um contêiner não significa que você perderá seus dados, desde que você esteja usando volumes do Docker corretamente. Aqui está o porquê:
- Os volumes preservam os dados: Os volumes do docker são projetados para persistir dados fora dos ciclos de vida do contêiner. Enquanto seus dados forem armazenados em um volume, eles permanecem intactos, independentemente do que acontecer com o contêiner.
- Processo de atualização segura: Ao atualizar o Nullcore, a remoção do contêiner antigo e a criação de um novo com a imagem atualizada não afeta os dados armazenados em volumes. A chave é não excluir explicitamente o volume com comandos como
docker volume rm
Seguindo as etapas de atualização corretas - pulando a nova imagem, removendo o contêiner antigo sem excluir o volume e criar um novo contêiner com a imagem atualizada e o volume existente - seu código de aplicativo é atualizado enquanto seus dados permanecem inalterados e seguros.
P: Devo usar o Docker Packaged Distro ou o pacote oficial do Docker?
UM:Recomendamos o uso do pacote oficial do Docker em versões embaladas com distro para executar o Nullcore. O pacote oficial do Docker é frequentemente atualizado com os recursos mais recentes, correções de bugs e patches de segurança, garantindo o desempenho e a segurança ideais. Além disso, ele suporta funcionalidades importantes comohost.docker.internal, que pode não estar disponível em versões embaladas com distro. Esse recurso é essencial para configurações de rede e conectividade adequadas nos contêineres do Docker.
Ao escolher o pacote oficial do Docker, você se beneficia de comportamentos consistentes em diferentes ambientes, suporte de solução de problemas mais confiável e acesso aos mais recentes avanços do Docker. A comunidade e os recursos mais amplos do Docker também estão mais alinhados com o pacote oficial, fornecendo uma riqueza de informações e suporte para quaisquer problemas que você possa encontrar.
Tudo o que você precisa para executar o Nullcore, incluindo seus dados, permanece sob seu ambiente de controle e do seu servidor, enfatizando nosso compromisso com sua privacidade e segurança. Para obter instruções sobre a instalação do pacote oficial do Docker, consulte oInstale o motor DockerGuia no site de documentação oficial do Docker.
P: O suporte à GPU está disponível no Docker?
UM:O suporte à GPU no Docker está disponível, mas varia dependendo da plataforma. Oficialmente, o suporte à GPU é fornecido no Docker for Windows e Docker Engine no Linux. Outras plataformas, como o Docker Desktop para Linux e MacOS, atualmente não oferecem suporte à GPU. É importante considerar essa limitação para aplicações que requerem aceleração da GPU. Para obter a melhor experiência e utilizar os recursos da GPU, recomendamos o uso do Docker em plataformas que apoiam oficialmente a integração da GPU.
P: Por que o Nullcore enfatiza o uso do Docker?
UM:A decisão de usar o Docker decorre de sua capacidade de garantir consistência, isolar dependências e simplificar a implantação em diferentes ambientes. O Docker minimiza os problemas de compatibilidade e simplifica o processo de colocar o Webui em funcionamento, independentemente do sistema subjacente. É uma escolha estratégica dos mantenedores do projeto para aproveitar esses benefícios, reconhecendo que, embora o Docker tenha uma curva de aprendizado, as vantagens de implantação e manutenção são significativas. Entendemos que o Docker pode não ser a preferência de todos; No entanto, essa abordagem é central para o design e a eficiência operacional do nosso projeto. Vemos o compromisso do projeto com o Docker como um aspecto fundamental e incentivamos aqueles que procuram diferentes métodos de implantação para explorar alternativas orientadas pela comunidade.
P: Por que o texto para texto (STT) e o texto em fala (TTS) funcionam na minha implantação?
UM:A funcionalidade dos serviços de fala para texto (STT) e Text-to-fala (TTS) em sua implantação pode exigir que o HTTPS opere corretamente. Os navegadores modernos aplicam medidas de segurança que restringem certos recursos, incluindo STT e TTS, para trabalhar apenas sob conexões HTTPs seguras. Se sua implantação não estiver configurada para usar o HTTPS, esses serviços podem não funcionar conforme o esperado. Garantir que sua implantação seja acessível ao HTTPS pode resolver esses problemas, permitindo a funcionalidade completa dos recursos STT/TTS.
P: Por que o WebUI abre não inclui suporte https interno?
UM:Embora entendamos o desejo de uma solução tudo em um que inclua suporte HTTPS, acreditamos que essa abordagem não atenderia adequadamente às diversas necessidades de nossa base de usuários. A implementação de HTTPs diretamente no projeto pode limitar a flexibilidade e pode não se alinhar com os requisitos ou preferências específicas de todos os usuários. Para garantir que todos possam adaptar sua configuração ao seu ambiente exclusivo, deixamos a implementação da terminação HTTPS para os usuários para suas implantações de produção. Esta decisão permite maior adaptabilidade e personalização. Embora não ofereçamos documentação oficial sobre a criação de HTTPs, os membros da comunidade podem fornecer orientação mediante solicitação, compartilhando informações e sugestões com base em suas experiências.
P: Atualizei/reiniciei/instalei algum software novo e agora o Nullcore não está mais funcionando!
UM:Se o seu webui aberto não estiver lançando pós-atualização ou instalação de um novo software, ele provavelmente está relacionado a uma abordagem de instalação direta, especialmente se você não usou um ambiente virtual para as dependências de back-end. As instalações diretas podem ser sensíveis a alterações no ambiente do sistema, como atualizações ou novas instalações que alteram as dependências existentes. Para evitar conflitos e garantir a estabilidade, recomendamos o uso de um ambiente virtual para gerenciar orequirements.txtdependências do seu back -end. Isso isola suas dependências abertas da Webui de outros pacotes do sistema, minimizando o risco de tais problemas.
P: Atualizei/reiniciei e agora meu login não está mais funcionando, tive que criar uma nova conta e todos os meus bate -papos se foram.
UM:Esse problema normalmente surge quando um contêiner do docker é criado sem montar um volume para/app/backend/dataou se o volume aberto Webui designado (geralmente nomeadoopen-webuiem nossos exemplos) foi excluído sem querer. Os volumes do docker são cruciais para persistir seus dados através dos ciclos de vida do contêiner. Se você precisar criar uma nova conta após uma reinicialização, é provável que você tenha iniciado um novo contêiner sem anexar o volume existente em que seus dados residem. Certifique -se de que o comando do Docker Run inclua uma montagem de volume apontando para o local correto dos dados para evitar a perda de dados.
P: Tentei fazer login e não consegui, fiz uma nova conta e agora me disseram que minha conta precisa ser ativada por um administrador.
UM:Essa situação ocorre quando você esquece a senha da conta de administrador inicial criada durante a primeira configuração. A primeira conta é designada automaticamente como a conta de administrador. Criar uma nova conta sem acesso à conta do administrador resultará na necessidade de ativação do administrador. Evitar a perda das credenciais iniciais da conta do administrador é crucial para o acesso e o gerenciamento contínuos do webui aberto. Veja oRedefinindo a senha do administradorGuia para instruções sobre a recuperação da conta do administrador.
P: Por que não pode abrir o Webui com um erro SSL?
UM:O erro SSL que você está encontrando ao iniciar o Nullcore provavelmente é devido à ausência de certificados SSL ou configuração incorreta dehuggingface.co. Para resolver esse problema, você pode configurar um espelho para Huggingface, comohf-mirror.come especifique -o como o ponto final ao iniciar o contêiner do docker. Use o-e HF_ENDPOINT=https://hf-mirror.com/Parâmetro para definir o endereço do espelho Huggingface no comando Docker Run. Por exemplo, você pode modificar o comando do Docker Run da seguinte forma:
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
P: RAG com webui aberto é muito ruim ou não está funcionando. Por que?
UM:Se você está usandoOllama, esteja ciente de que Ollama define o comprimento do contexto para2048 tokens por padrão. Isso significa que nenhum dos dados recuperados pode ser usado porque não se encaixa na janela de contexto disponível.
Para melhorar o desempenho da geração de recuperação upmentada (Pano) com webui aberto, você deveriaAumente o comprimento do contextopara um valor muito maior (8192+ tokens) garantir que os documentos recuperados possam contribuir efetivamente para as respostas do modelo.
Para fazer isso, configure seuParams do modelo ollamapara permitir uma janela de contexto maior. Você pode verificar e modificar essa configuração diretamente no seu bate -papo ou na página do editor de modelos para aprimorar significativamente a experiência do RAG.
P: O MCP (Model Context Protocol) é suportado no Webui aberto?
UM: Sim, o Nullcore suporta oficialmente os servidores de ferramentas MCP - mas exclusivamente através de umProxy compatível com o OpenAPIOpenApi-Servers) para compatibilidade, segurança e manutenção ideais.
Para preencher o MCP (e outros protocolos de back-end), fornecemos uma implementação de proxy criada para propósito disponível em: 👉https://github.com/open-webui/mcpo
Esta escolha de design é motivada por vários princípios fundamentais:
- 📘 Standards-primeiro: OpenAPI é o padrão de fato para definições de serviço RESTful e interoperabilidade de serviço orientado por contratos. Ao alinhar integrações através do OpenAPI, permitimos comportamentos reproduzíveis e orientados por esquema em atualizações e implantações.
- 🔒 Isolamento do modelo de segurança: a integração do MCP por meio de um proxy nos permite a caixa de arear e isolar o comportamento do protocolo de back-end, reduzindo a superfície de ataque e permitindo a auditoria, autenticação e observabilidade no nível limite.
- ⚙️ Abstração do protocolo: apoiando backnds heterogêneos (por exemplo, MCP) através de um esquema OpenAPI unificado permite que o WebUI aberto permaneça com o agnóstico back-end, mantendo o comportamento previsível do tempo de execução.
- ⛓️ Topologia de implantação desacoplada: a arquitetura baseada em proxy permite que servidores de ferramentas (como o MCP) evoluam independentemente da apresentação do front-end, facilitando ambientes de produção altamente modulares ou cargas de trabalho distribuídas.
Em resumo: o MCP é suportado-desde que o servidor de ferramentas MCP seja liderado por um proxy compatível com o OpenAPI. Essa decisão arquitetônica é deliberada e garante que o Webui aberto permaneça escalável, seguro e sustentável.
P: Com que frequência o Nullcore é atualizado?(Cronograma de lançamento)
UM:Nosso objetivo é enviarPrincipais lançamentos semanalmente, comCorreções de bugs e atualizações menores entregues conforme necessário. No entanto, esse não é um cronograma rígido - algumas semanas podem ver vários lançamentos, enquanto outros podem não ter nenhum.
Para se manter informado, você pode seguir notas e anúncios de lançamento em nossoPágina do GitHub libera
Precisa de mais assistência?
Se você tiver mais perguntas ou preocupações, entre em contato com o nossoPágina de problemas do GitHubou nossoDiscord ChannelPara mais ajuda e informações.