Recupere a senha de administrador do Nextcloud perdida com o OCC

O bloqueio de acesso à interface web do Nextcloud não impede que um administrador do servidor altere a senha de uma conta local. Se você tiver acesso ao shell do servidor, execute o occ user:resetpasswordcomando integrado do Nextcloud como o usuário do servidor web e, em seguida, faça login com o mesmo nome de usuário e a nova senha. O comando funciona tanto para contas de administrador quanto para usuários comuns; "admin" é apenas um exemplo de nome de usuário.

Os comandos abaixo seguem o Manual de Administração do Nextcloud 35, verificado em 10 de outubro de 2026. Substitua o caminho de instalação, o usuário HTTP, o executável do PHP e o nome de usuário de exemplo pelos valores usados ​​pelo seu servidor.

Redefina a senha interativamente

1. Localize a instalação do Nextcloud e a conta do servidor web.

Conecte-se ao host com uma conta que possa usar o shell e elevar privilégios. Localize o diretório que contém o occscript. Um caminho comum no Ubuntu ou Debian é /var/www/nextcloud`/usr/local/bin`; algumas instalações empacotadas, em contêineres ou hospedadas usam um local diferente. O comando deve ser executado no contexto da instalação do Nextcloud e como o usuário HTTP para que a propriedade do arquivo permaneça consistente.

No Debian ou Ubuntu, esse usuário geralmente é `/usr/local/bin` www-data. Consulte a documentação do Nextcloud apachepara Fedora ou CentOS, httppara Arch e wwwrunpara openSUSE. Use sua conta real do servidor web, não necessariamente a conta Linux que você usa para fazer login.

2. Execute o comando de redefinição de senha do OCC

Use este comando em uma instalação típica do Debian ou Ubuntu, substituindo o nome de usuário correto, se necessário admin:

sudo -u www-data php /var/www/nextcloud/occ user:resetpassword admin

O Nextcloud solicita uma nova senha e pede que você a digite novamente. A senha não é inserida no comando do shell, o que evita que ela fique registrada no histórico do shell. Quando o comando informar que a senha foi redefinida com sucesso, tente fazer login na web com esse nome de usuário e a nova senha. Não inclua colchetes angulares em torno do nome de usuário ao substituí-lo.

A documentação oficial também mostra isso sudo -E -u www-data. A -Eopção preserva as variáveis ​​de ambiente; ela não é necessária para a redefinição interativa usual, a menos que sua instalação exija configurações de ambiente específicas. Execute occcom a versão do PHP CLI configurada para o seu servidor web. Se o phpexecutável padrão for incompatível, chame explicitamente o binário PHP correspondente.

Se você não tiver certeza de qual conta redefinir,

O nome de login é o nome de usuário do Nextcloud da conta, não necessariamente o nome de exibição ou o endereço de e-mail. Se você tiver outra conta de administrador, use a página Usuários para confirmar o nome de login em questão. Na linha de comando, um administrador pode listar as contas com:

sudo -u www-data php /var/www/nextcloud/occ user:list

Substitua www-datao caminho do OCC conforme necessário. A saída pode incluir várias contas de usuário, portanto, evite compartilhá-la publicamente se contiver informações de identificação. Para instalações muito grandes, o comando oferece suporte a opções como limites e deslocamentos; verifique a occ help user:listsaída atual para obter a sintaxe disponível em sua versão.

Se você ainda tiver acesso a outro administrador do Nextcloud, pedir a ele para redefinir sua senha nas configurações de Usuários é uma opção mais simples. O link de redefinição na página de login é outra opção, somente se um endereço de e-mail válido tiver sido salvo anteriormente em sua página Pessoal e o servidor puder enviar e-mails. O OCC é útil quando nenhuma dessas opções estiver disponível, mas houver acesso ao shell.

Lidar com problemas comuns na linha de comando

“Não foi possível abrir o arquivo de entrada” ou “occ não encontrado”

O comando está apontando para o diretório de instalação errado. Altere o caminho para o occscript correto. Você também pode acessar o diretório de instalação e executar o comando abreviado sudo -u www-data php occ user:resetpassword admin. Não execute um script com nome semelhante a partir de uma instância diferente do Nextcloud no mesmo servidor.

Erros de permissão, cache ou PHP

Confirme se você usou a conta HTTP e a mesma versão do PHP CLI esperada pela instalação. A documentação do OCC do Nextcloud observa que o APCu está desativado por padrão no modo de linha de comando do PHP; se o OCC informar que o APCu está indisponível, habilite-o apc.enable_clipara a configuração correta da CLI ou siga a --define apc.enable_cli=1invocação documentada. Não altere as configurações do PHP na web indiscriminadamente apenas para corrigir um erro específico da CLI.

A conta utiliza um provedor de identidade externo.

Algumas instalações autenticam contas por meio de LDAP, SAML ou outro provedor de identidade externo. Nesse caso, o provedor pode ser a autoridade para a senha, e uma redefinição do OCC usando os dados da conta local do Nextcloud pode não alterar as credenciais usadas no login. Redefina a senha por meio do processo aprovado pelo provedor de identidade ou verifique se o backend configurado suporta alterações de senha antes de usar o OCC. Este comando se aplica à senha da conta do Nextcloud e não redefine as credenciais do próprio provedor de identidade.

Você executa o Nextcloud em um contêiner ou hospedagem gerenciada.

Execute o OCC no contêiner da aplicação ou através do shell suportado pelo provedor, e não em um host não relacionado. Os nomes dos contêineres, caminhos de instalação, comandos PHP e usuários de serviço variam de acordo com a implantação; portanto, não copie um comando Docker escrito para outra imagem sem consultar a documentação correspondente. A hospedagem gerenciada pode restringir o acesso ao shell; utilize o painel de controle ou solicite o método de recuperação documentado pelo provedor caso não consiga executar o OCC.

Verifique se você recuperou o acesso.

Verifique se o OCC exibiu uma mensagem de sucesso. Em seguida, abra o URL usual do Nextcloud em uma janela anônima do navegador e faça login com o nome de usuário e a nova senha corretos. Uma janela anônima ajuda a distinguir um problema com a senha de uma sessão antiga ou página de login em cache. Após o login, confirme se a conta ainda possui acesso de administrador e se você consegue acessar as configurações de administração. Se o login ainda falhar, verifique novamente o nome de usuário, o sistema de autenticação, o log do servidor e se o OCC foi executado na instância correta; repetir a redefinição na cópia incorreta não corrigirá o servidor ativo.

Referências oficiais

Deixar um comentário

Transfira dados do Nextcloud para um disco rígido externo sem comprometer o armazenamento.

Transfira dados do Nextcloud para um disco rígido externo sem comprometer o armazenamento.

Mova com segurança um diretório de dados do Nextcloud no Linux para uma unidade externa usando uma montagem UUID persistente, modo de manutenção, uma cópia verificada e o link simbólico do caminho original.

Erro no banco de dados do Nextcloud após uma atualização: o que verificar primeiro

Restaure o acesso ao Nextcloud após uma atualização, diagnosticando erros de SQL, verificando a conectividade do banco de dados e concluindo com segurança as migrações interrompidas.

Recupere a senha de administrador do Nextcloud perdida com o OCC

Utilize o comando OCC do Nextcloud para redefinir a senha de um administrador a partir do shell do servidor, com orientações sobre nomes de usuário, permissões e provedores de login externos.

Adicione o cabeçalho HSTS no endpoint HTTPS que serve o Nextcloud.

Elimine o aviso HSTS do Nextcloud configurando o cabeçalho no Apache, NGINX ou no seu proxy TLS e, em seguida, verifique a resposta HTTPS pública com segurança.

Solução de problemas de instalações do aplicativo Nextcloud que relatam falta de internet

Solução de problemas de instalações do aplicativo Nextcloud que relatam falta de internet

Rastreie falhas de instalação na App Store até problemas de DNS, HTTPS, proxy, TLS ou configuração no próprio servidor Nextcloud.

Controle os picos de uso da CPU no Nextcloud Preview com uma fila agendada.

Transfira a criação de miniaturas para uma programação em segundo plano controlada, reduza os tamanhos de pré-visualização não utilizados e verifique a fila sem sobrecarregar seu servidor Nextcloud.

Obtenha a sincronização do Nextcloud Desktop e supere a fase de "Processando arquivos".

Identifique o arquivo, a regra de exclusão, o problema de conexão ou o estado do banco de dados do cliente que está impedindo a sincronização do Nextcloud e, em seguida, verifique se os uploads e downloads estão sendo realizados com segurança.

Elimine o aviso do cache OP do Nextcloud ajustando o limite correto.

Localize o limite do OPcache do PHP que está causando o aviso do Nextcloud, atualize a configuração correta do PHP na web, reinicie com segurança e verifique o resultado.

Conectando o Nextcloud ao CODE Docker: Configuração e vantagens e desvantagens

Conectando o Nextcloud ao CODE Docker: Configuração e vantagens e desvantagens

Compare o código integrado e o baseado em Docker e, em seguida, conecte o Collabora Online ao Nextcloud por meio de um proxy reverso HTTPS seguro.

Crie um cluster Nextcloud resiliente com Galera.

Planeje uma implementação confiável de alta disponibilidade do Nextcloud com armazenamento compartilhado, bloqueio Redis, roteamento MariaDB com reconhecimento de quorum e verificações práticas de failover.