# Usando o Modo de Segurança para solucionar problemas com temas e plugins

**URL:** https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504
**Category:** Site Management
**Tags:** how-to
**Created:** [Novembro 28, 2016, 11:33pm UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504 "2016-11-28T23:33:58Z")
**Posts on this page:** 10
**Page:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [Novembro 28, 2016, 11:33pm UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504/1 "2016-11-28T23:33:59Z")

</div>

> :bookmark: Este guia explica como usar o Modo Seguro do Discourse para solucionar problemas com temas e plugins.
> 
> :person_raising_hand: Nível de usuário necessário: Todos os usuários

O Discourse oferece um “Modo Seguro de JavaScript” que permite a qualquer usuário isolar a causa raiz de problemas de JavaScript causados por plugins, temas ou componentes de tema. Este recurso é particularmente útil para solucionar problemas no seu site Discourse.

## Acessando o Modo Seguro

Para acessar o Modo Seguro, siga estas etapas:

1. Abra uma nova aba do navegador.

2. Insira a seguinte URL na barra de endereços, substituindo `[your-site-name](http://discourse.example.com)` pelo domínio real do seu site Discourse:

3. Clique no botão ‘Entrar no Modo Seguro’:  

## Opções do Modo Seguro

Ao entrar no Modo Seguro, você pode selecionar as seguintes opções:

- Desativar temas e componentes de tema
- Desativar personalizações de plugins não oficiais no lado do cliente
- Desativar todas as personalizações de plugins no lado do cliente
- Fazer com que avisos de depreciação do JavaScript gerem um erro

Por padrão, as três primeiras opções estão selecionadas. A opção de erros de depreciação está desmarcada por padrão e é principalmente útil para desenvolvedores de plugins e temas que testam a compatibilidade com futuras atualizações do Discourse. Você pode entrar no Modo Seguro várias vezes com diferentes combinações para isolar o componente específico que está causando problemas no seu site.

## Usando o Modo Seguro

1. Selecione as opções desejadas na página do Modo Seguro.
2. Clique em “Entrar no Modo Seguro” para aplicar suas seleções.
3. Você verá um banner indicando que o Modo Seguro está ativado.
4. Navegue pelo seu site para verificar se o problema persiste com os componentes selecionados desativados.

## Saindo do Modo Seguro

Para sair do Modo Seguro, basta fechar a aba do seu navegador.

## Observações importantes

Ao compartilhar um link do Modo Seguro para o seu site, esteja ciente de que ele precisa ser aberto em uma nova aba ou adicionado diretamente à barra de endereços; caso contrário, pode não funcionar corretamente.

> :warning: O Modo Seguro atualmente desativa apenas as partes de JavaScript dos plugins. Para desativar a parte do servidor de um plugin, você deve reconstruir seu contêiner com o plugin comentado.

## Solução de problemas

Se você não conseguir carregar a página inicial de seleção do Modo Seguro, tente visitar a seguinte URL, que ignorará a página e carregará o Modo Seguro diretamente:

```plaintext
https://discourse.example.com/?safe_mode=no_themes,no_plugins

```

Por exemplo: [https://try.discourse.org/?safe\_mode=no\_themes,no\_plugins](https://try.discourse.org/?safe_mode=no_themes,no_plugins)

Os valores disponíveis do parâmetro de consulta `safe_mode` são: `no_themes`, `no_unofficial_plugins`, `no_plugins` e `deprecation_errors`. Estes podem ser combinados com vírgulas.

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [Fevereiro 7, 2024, 9:27pm UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504/24 "2024-02-07T21:27:29Z")

</div>

> [@sam](#):
>
> [Discourse Meta](https://meta.discourse.org/safe-mode)

> [@sam](#):
>
> Example: [Discourse Meta - The Official Support Forum for Discourse](https://meta.discourse.org/?safe_mode=no_themes%2Cno_plugins)

De alguma forma, para mim esses links só funcionam quando eu os abro em uma nova aba ou janela. O primeiro leva à página de erro e o segundo à página inicial. Mas o banner do modo de segurança não aparece. O segundo pode causar problemas quando você envia um link para um usuário para que ele tente o modo de segurança. Se eles apenas clicarem no link, eles ainda usarão o site sem o modo de segurança.

Talvez essa informação deva ser adicionada ao #how-to.

---

<div class="post-metadata">

### Author: ![Ed\_S](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ed_s/32/134015_2.png) [@Ed\_S](https://meta.discourse.org/u/Ed_S)
#### Post date: [Fevereiro 7, 2024, 10:14pm UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504/25 "2024-02-07T22:14:43Z")

</div>

Boa observação - ambos os links estão quebrados. O primeiro precisa de um ? e o segundo precisa de uma vírgula em vez de %2C

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [Fevereiro 7, 2024, 10:22pm UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504/26 "2024-02-07T22:22:23Z")

</div>

> [@Ed\_S](#):
>
> O primeiro precisa de um ?

Onde ele precisa de um “?”?  
Você poderia compartilhar o link como exemplo?

---

<div class="post-metadata">

### Author: ![Ed\_S](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ed_s/32/134015_2.png) [@Ed\_S](https://meta.discourse.org/u/Ed_S)
#### Post date: [Fevereiro 7, 2024, 10:39pm UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504/27 "2024-02-07T22:39:48Z")

</div>

Ah, desculpe, parece que errei na primeira: a navegação interna falha, mas para uma nova janela funciona.  
[Discourse Meta](https://meta.discourse.org/safe-mode)

E também errei na outra! [Discourse Meta - The Official Support Forum for Discourse](https://meta.discourse.org/?safe_mode=no_themes,no_plugins)  
não funciona como navegação na mesma página.

Meu erro: algo está quebrado, mas não são os URLs.

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [Fevereiro 7, 2024, 11:06pm UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504/30 "2024-02-07T23:06:55Z")

</div>

Acho que é porque ele está tentando abri-los no local. Em vez de discutir com ele, eu os troquei por [try.discourse.org](http://try.discourse.org). :slight_smile:

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [Fevereiro 7, 2024, 11:41pm UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504/31 "2024-02-07T23:41:52Z")

</div>

Eu acho que, de alguma forma, os administradores ainda deveriam ser informados de que compartilhar esses links pode facilmente ser um problema.

Por exemplo, eu reporto um problema no meta. Você poderia perguntar: “Você poderia tentar [https://meta.discourse.org/safe-mode](https://meta.discourse.org/safe-mode)?” Então eu diria que o link não funciona.  
Ou, pior ainda: você quer especificar que eu desabilite apenas os temas, então você me pede para tentar [https://meta.discourse.org/?safe\_mode=no\_themes](https://meta.discourse.org/?safe_mode=no_themes). Meu problema ainda existe. Como você tem certeza de que eu realmente usei o modo seguro? Como usuário, eu acho que funcionou porque algo aconteceu quando cliquei no link.

Depois que postei aqui, você sabe disso. Mas como outros administradores sabem que eles precisam prestar atenção que isso pode ser um problema?

---

<div class="post-metadata">

### Author: ![Arkshine](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/arkshine/32/298682_2.png) [@Arkshine](https://meta.discourse.org/u/Arkshine)
#### Post date: [Fevereiro 8, 2024, 12:15am UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504/32 "2024-02-08T00:15:15Z")

</div>

Estou me perguntando, devido à natureza desta página inicial segura exibida (que substitui todo o conteúdo), se uma exceção deveria ser feita para abrir este link em uma nova aba.

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [Fevereiro 8, 2024, 12:14pm UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504/33 "2024-02-08T12:14:59Z")

</div>

Adicionei uma nota e também uma captura de tela de uma bem-sucedida. Como isso parece?

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [Maio 10, 2024, 8:51pm UTC](https://meta.discourse.org/t/using-safe-mode-to-troubleshoot-issues-with-themes-and-plugins/53504/34 "2024-05-10T20:51:53Z")

</div>

3 posts foram divididos em um novo tópico: [O modo seguro deve ser desativado por padrão para usuários não administradores?](https://meta.discourse.org/t/should-safe-mode-be-default-off-for-non-staff-users/307592)
