mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 10:52:22 +00:00
docs: review settings documentation in all seven translations
This commit is contained in:
Jonatan
@@ -0,0 +1,113 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Alterar canal de lançamento | Documentação do ProxMenux",
|
||||
"description": "Mude entre os canais Stable (main) e Beta (develop) do ProxMenux numa única janela. Bidirecional e idempotente; executa o instalador oficial do canal escolhido e normaliza o serviço Monitor.",
|
||||
"ogTitle": "Alterar canal de lançamento | Documentação do ProxMenux",
|
||||
"ogDescription": "Uma opção das Configurações para mudar entre Stable e Beta sem executar instaladores manualmente."
|
||||
},
|
||||
"header": {
|
||||
"title": "Alterar canal de lançamento",
|
||||
"description": "Uma opção única das Configurações muda entre Stable (ramo main) e Beta (ramo develop). A antiga opção unidirecional «Desativar programa beta» é substituída por um diálogo bidirecional que oferece ambos os sentidos e executa o instalador oficial do canal escolhido.",
|
||||
"section": "Configurações"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que mudou",
|
||||
"body": "Antes existiam dois procedimentos: «Desativar programa beta», visível apenas com a beta ativa, e executar novamente o instalador beta para voltar a aderir. Agora estão reunidos em <strong>Alterar canal de lançamento</strong>, sempre disponível, que mostra o canal atual e permite mudar entre Stable e Beta nos dois sentidos."
|
||||
},
|
||||
"why": {
|
||||
"heading": "Por que esta opção existe",
|
||||
"intro": "O ProxMenux é distribuído a partir de dois ramos Git:",
|
||||
"items": [
|
||||
"<strong>Stable</strong>: o ramo <code>main</code>, indicado no README e adequado à maioria dos administradores. Tem lançamentos menos frequentes e apenas alterações já validadas na beta.",
|
||||
"<strong>Beta</strong>: o ramo <code>develop</code>. Funcionalidades e compilações do Monitor mais recentes, com a etiqueta que a próxima versão estável herdará. Algumas funções podem ter falhas: ao escolher este canal participa nos testes antes do lançamento."
|
||||
],
|
||||
"outro": "Antes era necessário recordar o URL correto do instalador, copiá-lo do README e editar <code>config.json</code> manualmente se algo ficasse dessincronizado. A opção unificada realiza todo o processo numa ação guiada."
|
||||
},
|
||||
"dialog": {
|
||||
"heading": "A janela",
|
||||
"intro": "No menu principal: <strong>Configurações → Alterar canal de lançamento</strong>. Aparece um menu com duas linhas:",
|
||||
"options": [
|
||||
"<code>stable</code> — Stable (ramo main)",
|
||||
"<code>beta</code> — Beta (ramo develop)"
|
||||
],
|
||||
"behaviour": "O canal atual está pré-selecionado e é mostrado no topo. Escolher o mesmo mostra «Este canal de lançamento já está ativo»: o diálogo é idempotente. Escolher outro canal apresenta uma confirmação específica:",
|
||||
"directions": [
|
||||
"<strong>Stable → Beta:</strong> avisa que as versões beta podem conter erros ou funcionalidades incompletas.",
|
||||
"<strong>Beta → Estável:</strong> avisa que as verificações de atualização beta vão parar e o instalador estável irá reinstalar os componentes do canal estável."
|
||||
]
|
||||
},
|
||||
"confirm": {
|
||||
"heading": "O que acontece quando você confirmar",
|
||||
"items": [
|
||||
"<strong>Transfere o instalador oficial</strong> do canal de destino:<ul><li>Stable: <code>install_proxmenux.sh</code> de <code>main</code></li><li>Beta: <code>install_proxmenux_beta.sh</code> de <code>develop</code></li></ul>Verifica a existência do ficheiro e torna-o executável antes de continuar.",
|
||||
"<strong>Executa o instalador completo</strong>, o mesmo indicado no README. A deteção dos componentes, cópias de segurança, instalação de dependências e preservação do idioma seguem o procedimento oficial de instalação do canal escolhido.",
|
||||
"Ao mudar para <strong>Stable</strong>, o menu então poda quaisquer metadados beta remanescentes de <code>config.json</code>: <code>beta_program</code>, <code>beta_version</code>, <code>install_branch</code>, <code>update_available.beta*</code> são excluídos, e <code>proxmenux_monitor.status = beta_updated</code> é normalizada para <code>updated</code>. O arquivo <code>beta_version.txt</code> e qualquer instalador beta baixado são removidos.",
|
||||
"Ao mudar para Stable, a unidade systemd do Monitor é reescrita a partir do modelo Stable: remove «Beta» da descrição e <code>ExecStart</code> volta a apontar para o diretório de execução. Assim, uma nova consulta de <code>systemctl status</code> reflete o canal atual.",
|
||||
"Recarrega o menu de configuração. <em>Mostrar informações da versão</em> mostrará o novo canal."
|
||||
]
|
||||
},
|
||||
"switching": {
|
||||
"heading": "Mudando para trás e para frente",
|
||||
"intro": "Ambas as direções passam pelo mesmo instalador — elas <strong>não</strong> são fluxos de desinstalação e reinstalação de casos especiais. Cada direção simplesmente executa o próprio instalador do canal, que é projetado para ser idempotente e seguro para ser reexecutado em uma instalação existente. Consequências práticas:",
|
||||
"items": [
|
||||
"Sua configuração existente, login ProxMenux Monitor (<code>auth.json</code>), canais de notificação, registro pós-instalação, limiares personalizados — nenhum deles é tocado. O interruptor de canal só troca a árvore de scripts e o binário AppImage.",
|
||||
"Um Monitor ativo antes da mudança continua ativo depois; um que estava desativado continua desativado.",
|
||||
"ProxMenux Monitor <code>auth.json</code>, API tokens e o segredo JWT são preservados através de mudanças de canal. As sessões não são encerradas.",
|
||||
"Você pode inverter os canais quantas vezes quiser — o diálogo irá aceitá-lo toda vez e repetir o instalador. Não é necessário reiniciar o Proxmox.",
|
||||
"A mudança de canal substitui os scripts do ProxMenux e não pode ser executada no terminal do navegador do Monitor: o PTY seria encerrado durante a atualização e o diálogo ficaria bloqueado. Nesse terminal aparece antes uma mensagem com o comando oficial de uma linha do canal escolhido. Execute-o por SSH ou na consola do anfitrião Proxmox."
|
||||
]
|
||||
},
|
||||
"feedback": {
|
||||
"heading": "Comunicar problemas da beta",
|
||||
"intro": "Se algo se comporta inesperadamente enquanto você está no canal Beta, abrir um problema com contexto suficiente é o que fecha a lacuna para uma liberação estável. O relatório mais útil inclui:",
|
||||
"items": [
|
||||
"O que fizeste e o que esperavas que acontecesse.",
|
||||
"Quaisquer mensagens de erro mostradas na tela.",
|
||||
"Os registos de monitorização relevantes:"
|
||||
],
|
||||
"logsCommand": "journalctl -u proxmenux-monitor -n 50 --no-pager",
|
||||
"versionLine": "A versão atual do ProxMenux (Configurações → <link>Mostrar informações da versão</link>).",
|
||||
"issueLine": "Abra um <ghlink>problema no GitHub</ghlink> com estas informações para facilitar a correção."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manual",
|
||||
"intro": "Se preferir a shell ou automatizar a mudança de canal, o diálogo executa estes comandos:"
|
||||
},
|
||||
"unifiedCallout": {
|
||||
"title": "Por que ambas as direções são agora uma opção",
|
||||
"body": "A antiga opção «Desativar programa beta» só aparecia após a adesão à beta. Para <em>aderir</em> era necessário procurar o instalador noutro local; para <em>sair</em>, por vezes era necessário limpar os metadados <code>beta_*</code> manualmente. <strong>Alterar canal de lançamento</strong> aparece sempre, indica o canal atual e trata ambos os sentidos como uma operação executável, repetível e idempotente."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Resolução de Problemas",
|
||||
"downloadTitle": "“Não foi possível baixar o instalador”",
|
||||
"downloadBody": "O HTTPS para <code>raw.githubusercontent.com</code> falhou. Verifique a conectividade e DNS do host:",
|
||||
"downloadCmd": "curl -fsSL -o /tmp/test https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh && head -1 /tmp/test",
|
||||
"downloadOutro": "Se isso falhar fora do ProxMenux, é um problema de rede / proxy no host.",
|
||||
"errorsTitle": "“Installer terminou com erros”",
|
||||
"errorsBody": "O instalador devolveu um código de saída diferente de zero. Não existe reversão automática: alguns ficheiros ou componentes podem já ter sido alterados. Verifique a saída e o estado atual antes de repetir. Execute o instalador manualmente por SSH ou na consola do anfitrião para ver a saída completa.",
|
||||
"configTitle": "\"Não foi possível atualizar o arquivo de configuração\" após mudar para Stable",
|
||||
"configBody": "A limpeza pós-instalação dos metadados beta falhou — geralmente porque o <code>config.json</code> tem um erro de sintaxe de uma edição manual. Validar:",
|
||||
"configCmd": "jq . /usr/local/share/proxmenux/config.json",
|
||||
"configOutro": "Corrigir ou restaurar o arquivo e executar novamente a opção."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"label": "Mostrar informações da versão",
|
||||
"tail": " — confirmar que canal está activo."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings/proxmenux-monitor",
|
||||
"label": "ProxMenux Monitor",
|
||||
"tail": " — o serviço Monitor recriado durante a mudança de canal."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings",
|
||||
"label": "Visão geral das configurações",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,108 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Alterar idioma | Documentação do ProxMenux",
|
||||
"description": "Escolha entre oito idiomas para a interface do ProxMenux. Todas as instalações incluem catálogos JSON de traduções pré-gerados; o anfitrião não necessita de serviços de tradução nem de um ambiente Python. O menu é recarregado automaticamente.",
|
||||
"ogTitle": "Alterar idioma | Documentação do ProxMenux",
|
||||
"ogDescription": "Escolha um dos oito idiomas do ProxMenux nas Configurações. Disponível em todas as instalações."
|
||||
},
|
||||
"header": {
|
||||
"title": "Alterar idioma",
|
||||
"description": "Alterne a interface do ProxMenux entre oito idiomas suportados. A escolha é guardada em config.json e o menu é reiniciado no novo idioma. Todas as instalações incluem os catálogos de traduções.",
|
||||
"section": "Configurações"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que é isto?",
|
||||
"body": "Um diálogo lista os oito idiomas suportados. O ProxMenux guarda a sua escolha em <code>config.json</code> como <code>.language</code> e reinicia <code>config_menu.sh</code> para a aplicar imediatamente."
|
||||
},
|
||||
"warn": {
|
||||
"title": "Disponível em todas as instalações",
|
||||
"body": "As Configurações mostram sempre Alterar idioma. Os catálogos são instalados em <code>/usr/local/share/proxmenux/lang/</code> <em>e</em> o idioma escolhido é guardado em <code>config.json</code>. O antigo ambiente Python de tradução não é necessário."
|
||||
},
|
||||
"supported": {
|
||||
"heading": "Idiomas suportados",
|
||||
"headerCode": "Code",
|
||||
"headerLang": "Idioma",
|
||||
"headerNotes": "Notas",
|
||||
"rows": [
|
||||
{
|
||||
"code": "en",
|
||||
"lang": "Inglês",
|
||||
"notes": "Língua de origem — mais precisa"
|
||||
},
|
||||
{
|
||||
"code": "es",
|
||||
"lang": "Espanhol",
|
||||
"notes": "Catálogo JSON pré-gerado"
|
||||
},
|
||||
{
|
||||
"code": "fr",
|
||||
"lang": "Francês",
|
||||
"notes": "Catálogo JSON pré-gerado"
|
||||
},
|
||||
{
|
||||
"code": "de",
|
||||
"lang": "Alemão",
|
||||
"notes": "Catálogo JSON pré-gerado"
|
||||
},
|
||||
{
|
||||
"code": "it",
|
||||
"lang": "italiano",
|
||||
"notes": "Catálogo JSON pré-gerado"
|
||||
},
|
||||
{
|
||||
"code": "pt",
|
||||
"lang": "Português",
|
||||
"notes": "Catálogo JSON pré-gerado"
|
||||
},
|
||||
{
|
||||
"code": "sk",
|
||||
"lang": "Eslovaco",
|
||||
"notes": "Catálogo JSON pré-gerado"
|
||||
},
|
||||
{
|
||||
"code": "sv",
|
||||
"lang": "Sueco",
|
||||
"notes": "Catálogo JSON pré-gerado"
|
||||
}
|
||||
]
|
||||
},
|
||||
"englishTip": {
|
||||
"title": "Inglês é o mais preciso",
|
||||
"body": "Os textos noutros idiomas provêm dos catálogos JSON pré-gerados incluídos no ProxMenux. As traduções em falta usam o inglês; o anfitrião não faz chamadas de tradução em direto. O inglês continua a ser a referência em caso de tradução duvidosa."
|
||||
},
|
||||
"underHood": {
|
||||
"heading": "Como funciona sob o capô",
|
||||
"items": [
|
||||
"O diálogo apresenta oito códigos de idioma; escolha um.",
|
||||
"Se <code>config.json</code> existe: <code>jq --arg lang \"$new_language\" '.language = $lang''</code> atualiza o campo no local.",
|
||||
"Se <code>config.json</code> não existe: um novo é criado com o código de linguagem em um objeto de campo único.",
|
||||
"Diálogo de confirmação: <em>\"Idioma alterado para [code]\"</em>.",
|
||||
"<code>exec bash config_menu.sh</code> recarrega o menu Configurações com o novo idioma ativo."
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manual"
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Resolução de Problemas",
|
||||
"noOptionTitle": "A opção não aparece na Configuração",
|
||||
"noOptionBody": "Alterar idioma está sempre disponível nas versões atuais. Se a opção não aparecer, atualize o ProxMenux com o instalador oficial e volte a abrir as Configurações.",
|
||||
"stillEnglishTitle": "A língua mudou, mas a UI ainda mostra inglês",
|
||||
"stillEnglishBody": "O menu volta a ser executado após a alteração. Se abriu uma nova shell e iniciou outro ponto de entrada do ProxMenux, execute <code>menu</code> novamente para aplicar o novo idioma. Confirme com <code>jq -r '.language' /usr/local/share/proxmenux/config.json</code>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"label": "Mostrar informações da versão",
|
||||
"tail": " — confirma o canal de lançamento, os ficheiros de tradução e o idioma atual."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings",
|
||||
"label": "Visão geral das configurações",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,81 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Configurações do ProxMenux — Ativação do Monitor, canal de lançamento, idiomas | ProxMenux",
|
||||
"description": "Configurações do ProxMenux: serviço Monitor e reposição da palavra-passe, canal Stable/Beta, oito idiomas da interface, diagnóstico da versão e desinstalação. As opções do Monitor aparecem quando o serviço está instalado.",
|
||||
"ogTitle": "Configurações do ProxMenux — Ativação do Monitor, canal de lançamento, idiomas",
|
||||
"ogDescription": "Configure o ProxMenux: serviço Monitor, canal de lançamento, idioma, informações da versão e desinstalação.",
|
||||
"twitterTitle": "Configuração do ProxMenux",
|
||||
"twitterDescription": "Ativação do Monitor, mudança de canal de lançamento, idiomas, informações da versão e desinstalação."
|
||||
},
|
||||
"header": {
|
||||
"title": "Configurações",
|
||||
"description": "Configure o ProxMenux: ative ou desative o Monitor, reponha as credenciais, mude entre Stable e Beta nos dois sentidos, escolha um dos oito idiomas, consulte o diagnóstico da versão e desinstale. As ações do Monitor exigem o serviço instalado; a seleção de idioma está sempre disponível.",
|
||||
"section": "Configurações"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Para que serve este menu",
|
||||
"body": "Administração do próprio ProxMenux: serviço Monitor, saída do canal beta, idioma, diagnóstico da versão e desinstalação. Nenhuma opção deste menu altera as suas VMs, contentores ou armazenamento."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Abrir o menu",
|
||||
"body": "No menu principal do ProxMenux, prima <kbd>s</kbd>. As ações do Monitor aparecem se o serviço estiver instalado; as restantes configurações estão sempre disponíveis:",
|
||||
"imageAlt": "Menu Configurações do ProxMenux com ações condicionais do Monitor"
|
||||
},
|
||||
"installTypes": {
|
||||
"heading": "Uma instalação, todos os idiomas",
|
||||
"intro": "As versões atuais incluem catálogos JSON estáticos em todas as instalações. As versões antigas ofereciam modos separados com tradução e normal:",
|
||||
"headerType": "Tipo de instalação",
|
||||
"headerBundles": "O que inclui",
|
||||
"headerMenu": "Menu mostra",
|
||||
"rows": [
|
||||
{
|
||||
"type": "Instalação atual",
|
||||
"bundles": "Catálogos JSON estáticos para oito idiomas; sem ambiente Python de tradução",
|
||||
"menuRich": "<strong>Alterar idioma</strong> + Mostrar versão + Desinstalar"
|
||||
},
|
||||
{
|
||||
"type": "Modos antigos com tradução / normal",
|
||||
"bundles": "Antiga separação entre ambiente de tradução e instalação apenas em inglês",
|
||||
"menu": "Atualize com o instalador oficial para utilizar o menu unificado atual"
|
||||
}
|
||||
],
|
||||
"detectionTitle": "A seleção de idioma está sempre disponível",
|
||||
"detectionBody": "O menu já não verifica um ambiente de tradução. Todas as instalações incluem <code>/usr/local/share/proxmenux/lang/</code> e guardam o valor <code>language</code> escolhido em <code>config.json</code>."
|
||||
},
|
||||
"options": {
|
||||
"heading": "Opções do menu",
|
||||
"intro": "Estas ferramentas gerem o próprio ProxMenux. <em>Condicional</em> indica que as ações do Monitor aparecem apenas com o serviço systemd instalado. Canal de lançamento, idioma, diagnóstico da versão e desinstalação estão sempre disponíveis.",
|
||||
"list": [
|
||||
{
|
||||
"icon": "Activity",
|
||||
"href": "/docs/settings/proxmenux-monitor",
|
||||
"title": "ProxMenux Monitor",
|
||||
"description": "Ativar / desativar a unidade proxmenux-monitor.service systemd, verificar seu estado atual, e redefinir a senha de login do painel se ela foi perdida. UI Web disponível em TCP 8008.",
|
||||
"badge": "Condicional"
|
||||
},
|
||||
{
|
||||
"icon": "TestTube",
|
||||
"href": "/docs/settings/beta-program",
|
||||
"title": "Alterar canal de lançamento",
|
||||
"description": "Mude entre Stable (main) e Beta (develop) nos dois sentidos a partir de uma única janela. Executa o instalador oficial do canal escolhido; é idempotente e está sempre visível.",
|
||||
"badge": "Sempre disponível"
|
||||
},
|
||||
{
|
||||
"icon": "Info",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"title": "Mostrar informações da versão",
|
||||
"description": "Versão do ProxMenux, canal de lançamento, componentes instalados, caminhos dos ficheiros, ficheiros de tradução e idioma atual."
|
||||
},
|
||||
{
|
||||
"icon": "Trash2",
|
||||
"href": "/docs/settings/uninstall-proxmenux",
|
||||
"title": "Desinstalar ProxMenux",
|
||||
"description": "Remova ProxMenux e (opcionalmente) suas dependências. Também restaura backups /root/.bashrc e /etc/motd criados no momento da instalação."
|
||||
}
|
||||
]
|
||||
},
|
||||
"configTip": {
|
||||
"title": "Onde é guardada a configuração",
|
||||
"bodyRich": "A maior parte do estado gerido por este menu é guardada em <code>/usr/local/share/proxmenux/config.json</code>: <code>language</code>, <code>beta_program.status</code> e indicadores de instalação por componente. O estado do serviço Monitor é gerido no systemd (<code>proxmenux-monitor.service</code>), não aqui. A versão é lida de <code>/usr/local/share/proxmenux/version.txt</code>."
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,119 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "ProxMenux Monitor | Documentação do ProxMenux",
|
||||
"description": "Ativar ou desativar a unidade proxmenux-monitor.service systemd e inspecionar seu estado atual. O Monitor expõe uma interface web em TCP 8008 para monitoramento visual do hospedeiro.",
|
||||
"ogTitle": "ProxMenux Monitor | Documentação do ProxMenux",
|
||||
"ogDescription": "Ative ou desative o serviço systemd proxmenux-monitor e consulte o estado nas Configurações."
|
||||
},
|
||||
"header": {
|
||||
"title": "ProxMenux Monitor",
|
||||
"description": "Duas ações relacionadas dentro do menu Configurações: alternar a unidade proxmenux-monitor.service systemd (iniciar / parar e ativar / desativar em um clique), e visualizar seu status detalhado atual. O Monitor expõe uma interface web em TCP 8008 para monitoramento visual do hospedeiro.",
|
||||
"section": "Configurações"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que é o ProxMenux Monitor?",
|
||||
"body": "ProxMenux Monitor é um painel web integrado que oferece visibilidade em tempo real na sua infraestrutura Proxmox – acessível a partir de qualquer navegador na sua rede, sem precisar de um terminal."
|
||||
},
|
||||
"offers": {
|
||||
"heading": "O que oferece",
|
||||
"items": [
|
||||
"Monitoramento em tempo real de CPU, RAM, uso de disco e tráfego de rede.",
|
||||
"Visão geral das VMs e LXC com indicadores de status.",
|
||||
"Autenticação de login para proteger o acesso.",
|
||||
"Autenticação de dois fatores (2FA) com suporte TOTP.",
|
||||
"Suporte a proxy reversa (Nginx / Traefik).",
|
||||
"Projetado para trabalhar em desktop e dispositivos móveis."
|
||||
]
|
||||
},
|
||||
"access": {
|
||||
"heading": "Acesso",
|
||||
"intro": "Uma vez instalado, o painel está disponível em:",
|
||||
"url": "http://<your-proxmox-ip>:8008",
|
||||
"outro": "O Monitor é instalado automaticamente como parte da instalação padrão ProxMenux e é executado como um serviço systemd (<code>proxmenux-monitor.service</code>) que começa automaticamente no arranque."
|
||||
},
|
||||
"warnConditional": {
|
||||
"title": "Opções de configuração somente visíveis quando o Monitor está instalado",
|
||||
"body": "Os dois itens de menu descritos abaixo só aparecem em Configurações se <code>proxmenux-monitor.service</code> estiver registrado com systemd. Se não os vir, o Monitor não foi instalado (é opcional durante a instalação do ProxMenux). Para adicioná-lo mais tarde, reinstale o ProxMenux com a versão mais recente e escolha a opção Monitor."
|
||||
},
|
||||
"toggle": {
|
||||
"heading": "Activar / Desactivar",
|
||||
"intro": "O primeiro item de menu é uma única opção que muda entre dois estados com base em se o serviço está atualmente em execução:",
|
||||
"headerState": "Estado atual",
|
||||
"headerLabel": "Rótulo do menu apresentado",
|
||||
"headerAction": "Acção sobre a confirmação",
|
||||
"rows": [
|
||||
{
|
||||
"state": "ativo",
|
||||
"label": "Desativar ProxMenux Monitor",
|
||||
"action": "systemctl stop + disable"
|
||||
},
|
||||
{
|
||||
"state": "inativo",
|
||||
"label": "Ativar ProxMenux Monitor",
|
||||
"action": "systemctl enable + start"
|
||||
}
|
||||
],
|
||||
"outro": "Cada alteração exige confirmação sim/não. Desativar para o serviço <em>e</em> desativa o arranque automático; ativar permite o arranque automático <em>e</em> inicia imediatamente o serviço."
|
||||
},
|
||||
"status": {
|
||||
"heading": "Mostrar status do serviço do monitor",
|
||||
"intro": "O segundo item do menu é somente leitura. Ele limpa a tela, mostra o logotipo ProxMenux e o título <em>\"ProxMenux Monitor Verificação de Serviço\"</em>, em seguida, relata:",
|
||||
"items": [
|
||||
"<strong>Estatuto de serviço:</strong> ativo, inativo ou not_installed.",
|
||||
"<strong>Web UI URL</strong> (apenas quando ativo): <code>http://<host_ip>:8008</code> — derivado de <code>hostname -I | awk '''{print $1}'''</code>.",
|
||||
"<strong> Saída systemd detalhada:</strong> <code>systemctl status proxmenux-monitor.service --no-pager -l</code> — mostra linhas de log recentes, ExecStart, MainPID, etc."
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"title": "Equivalentes manuais",
|
||||
"intro": "De qualquer shell:",
|
||||
"code": "systemctl status proxmenux-monitor.service # detailed status\nsystemctl is-active proxmenux-monitor.service # one-word status\nsystemctl enable --now proxmenux-monitor.service # enable + start\nsystemctl disable --now proxmenux-monitor.service # stop + disable\njournalctl -u proxmenux-monitor.service -f # follow live logs"
|
||||
},
|
||||
"reset": {
|
||||
"heading": "Redefinir senha do ProxMenux Monitor",
|
||||
"intro": "Caminho de recuperação para o operador que perdeu a senha do painel (ou dispositivo 2FA). A opção só aparece quando o Monitor é instalado na máquina. Selecionando- o:",
|
||||
"items": [
|
||||
"Pede confirmação com um diálogo sim/não — a ação é destrutiva para as credenciais de login.",
|
||||
"Faz backup do <code>/root/.config/proxmenux-monitor/auth.json</code> existente para <code>auth.json.bak-<UTC timestamp></code> (modo <code>0600</code>) para que o estado anterior possa ser restaurado manualmente se o reset foi um erro.",
|
||||
"Para o serviço <code>proxmenux-monitor</code> para evitar conflitos entre a edição do ficheiro e um início de sessão em curso.",
|
||||
"Limpa os campos de identidade em <code>auth.json</code>: <code>enabled=false</code>, <code>configured=false</code>, esvazia <code>username</code>, <code>password_hash</code>, <code>totp_secret</code> e a matriz de códigos de backup.",
|
||||
"<strong>Preserva</strong> <code>jwt_secret</code> e os dados registados <code>api_tokens</code> / <code>revoked_tokens</code>, para que os tokens de longa duração do Home Assistant ou de outros scripts <em>continuem a permitir autenticação</em> após a reposição.",
|
||||
"Reinicia o serviço. A próxima visita ao <code>http://<host>:8008</code> mostra o assistente de configuração do primeiro lançamento para que uma nova conta de administrador possa ser criada."
|
||||
],
|
||||
"preservedTitle": "O que sobrevive ao reinício, o que não sobrevive",
|
||||
"preservedBody": "<strong>Apagados:</strong> nome de utilizador, hash da palavra-passe, segredo TOTP 2FA e códigos de recuperação. <strong>Preservados:</strong> <code>jwt_secret</code>, metadados <code>api_tokens</code> e lista <code>revoked_tokens</code>. Para invalidar também todos os tokens API e começar de novo, elimine <code>auth.json</code> manualmente em vez de utilizar esta opção. No próximo arranque, o serviço regenera o segredo JWT e os restantes dados.",
|
||||
"trustTitle": "O acesso ao host físico é a âncora de confiança",
|
||||
"trustBody": "Este caminho de reset requer shell root na máquina. Qualquer um que possa executar o comando <code>menu</code> como root já controla a caixa, então dar-lhes recuperação de senha não é uma escalada de privilégio — é consistente com como todas as outras ferramentas de administração no Proxmox funcionam. O corolário: o login do Monitor não protegerá nada de alguém que você já deixou entrar no shell Proxmox.",
|
||||
"seeAlso": "Consulte também <link>Monitor → Acesso e autenticação → Recuperar uma palavra-passe perdida</link> para o mesmo procedimento visto do painel e os detalhes sobre o cálculo dos hashes das palavras-passe e a geração do segredo JWT."
|
||||
},
|
||||
"files": {
|
||||
"heading": "Ficheiros envolvidos",
|
||||
"code": "/etc/systemd/system/proxmenux-monitor.service # systemd unit\n/root/.config/proxmenux-monitor/ # runtime config dir\n/var/log/proxmenux-auth.log # Flask app auth log\n # (read by Fail2Ban [proxmenux] jail)"
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Resolução de Problemas",
|
||||
"missingTitle": "Faltam ambas as opções de menu",
|
||||
"missingBody": "O Monitor não está registado na systemd. Confirme com <code>systemctl list-unit-files | grep proxmenux-monitor</code> — se não houver saída, reinstale o ProxMenux do instalador oficial com a versão mais recente e escolha a opção Monitor durante a instalação.",
|
||||
"unreachableTitle": "Serviço ativado, mas o URL não é acessível",
|
||||
"unreachableBody": "A saída de status Configurações lhe dá o IP. Confirmar:",
|
||||
"unreachableCmd": "ss -tlnp | grep 8008 # is anything listening?\njournalctl -u proxmenux-monitor -n 100 --no-pager # recent errors\ncurl -sI http://localhost:8008 # local reachability",
|
||||
"unreachableOutro": "Se o localhost funcionar mas o externo não funcionar, verifique o firewall do seu host (<code>pve-firewall</code> ou nftables) para TCP 8008.",
|
||||
"stopsTitle": "Ativado o serviço, mas pára alguns segundos depois",
|
||||
"stopsBody": "Normalmente deve-se a um conflito na porta 8008 ou a uma falha na verificação de dependências. O registo do sistema indica a causa: <code>journalctl -u proxmenux-monitor.service -b</code>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/security/fail2ban",
|
||||
"label": "Fail2Ban",
|
||||
"tailRich": " — a cadeia <code>[proxmenux]</code> protege o Monitor em TCP 8008."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings",
|
||||
"label": "Visão geral das configurações",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,81 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Mostrar informações da versão | Documentação do ProxMenux",
|
||||
"description": "Diagnóstico do ProxMenux apenas de leitura: versão, canal de lançamento, componentes registados em config.json, caminhos dos ficheiros, catálogos de traduções e idioma atual.",
|
||||
"ogTitle": "Mostrar informações da versão | Documentação do ProxMenux",
|
||||
"ogDescription": "Dados de diagnóstico da versão do ProxMenux, canal de lançamento, componentes, ficheiros e idioma."
|
||||
},
|
||||
"header": {
|
||||
"title": "Mostrar informações da versão",
|
||||
"description": "Diagnóstico apenas de leitura. Lê version.txt, config.json e caminhos de ficheiros conhecidos e apresenta uma caixa de texto deslocável com a versão, o canal de lançamento, os componentes instalados, a presença de ficheiros, os ficheiros de tradução e o idioma atual.",
|
||||
"section": "Configurações"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que é isto?",
|
||||
"body": "Um autodiagnóstico. Útil ao comunicar um problema (cole o conteúdo da janela no relatório de erro) ou para confirmar que uma instalação foi concluída corretamente. Não altera nada."
|
||||
},
|
||||
"reports": {
|
||||
"heading": "O que relata",
|
||||
"headerSection": "Secção",
|
||||
"headerSource": "Origem",
|
||||
"headerContent": "Conteúdo",
|
||||
"rows": [
|
||||
{
|
||||
"section": "Versão actual",
|
||||
"source": "version.txt",
|
||||
"contentRich": "Número de versão de linha única; <code>Unknown</code> se o ficheiro faltar"
|
||||
},
|
||||
{
|
||||
"section": "Canal de lançamento",
|
||||
"source": "Estado do programa beta em config.json",
|
||||
"content": "Stable (main) ou Beta (develop); versão beta, se disponível"
|
||||
},
|
||||
{
|
||||
"section": "Componentes instalados",
|
||||
"source": "config.json",
|
||||
"content": "Estado por componente (✓ instalado / criado / atualizado, ✗ ausente)"
|
||||
},
|
||||
{
|
||||
"section": "Ficheiros ProxMenux",
|
||||
"source": "verificação do sistema de ficheiros",
|
||||
"contentRich": "<code>menu</code>, <code>utils.sh</code>, <code>config.json</code>, <code>version.txt</code> presença + caminhos"
|
||||
},
|
||||
{
|
||||
"section": "Ficheiros de tradução",
|
||||
"source": "/usr/local/share/proxmenux/lang/",
|
||||
"content": "Presença do diretório lang/ incluído em todas as instalações"
|
||||
},
|
||||
{
|
||||
"section": "Língua atual",
|
||||
"source": "config.json",
|
||||
"contentRich": "Código do idioma de <code>.language</code>; usa <code>en</code> se não estiver definido"
|
||||
}
|
||||
]
|
||||
},
|
||||
"sampleHeading": "Saída da amostra",
|
||||
"manualHeading": "Equivalentes manuais",
|
||||
"troubleshoot": {
|
||||
"heading": "Resolução de Problemas",
|
||||
"unknownTitle": "A versão mostra \"Unknown\"",
|
||||
"unknownBody": "<code>/usr/local/share/proxmenux/version.txt</code> está faltando ou ilegível. Na maioria das vezes causada por uma instalação parcial. Reinstalar a partir da fonte oficial ProxMenux.",
|
||||
"noConfigTitle": "Nenhuma informação de instalação disponível",
|
||||
"noConfigBody": "<code>config.json</code> desapareceu. O script não pode enumerar componentes sem ele. Reinstalar para regenerar.",
|
||||
"wrongStatusTitle": "Um componente mostra ✗ embora tenha a certeza de o ter instalado",
|
||||
"wrongStatusBody": "Significa que o <code>config.json</code> não rastreia esse componente como instalado — pode ser um script que ainda não se registra, ou uma instalação manual que contorne o ProxMenux. O diálogo reflete o que <code>config.json</code> diz, não o que está no disco."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/settings/uninstall-proxmenux",
|
||||
"label": "Desinstalar ProxMenux",
|
||||
"tail": " — remover todos estes ficheiros."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings",
|
||||
"label": "Visão geral das configurações",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,92 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Desinstalar ProxMenux | Documentação do ProxMenux",
|
||||
"description": "Desinstalação limpa do ProxMenux com remoção opcional de jq e dialog, limpeza de ficheiros de tradução antigos e do serviço Monitor e reposição das cópias de segurança do sistema.",
|
||||
"ogTitle": "Desinstalar ProxMenux | Documentação do ProxMenux",
|
||||
"ogDescription": "Remova ProxMenux de forma limpa de um host Proxmox com limpeza de dependência opcional."
|
||||
},
|
||||
"header": {
|
||||
"title": "Desinstalar ProxMenux",
|
||||
"description": "Remove o ProxMenux do anfitrião Proxmox através de um processo interativo: confirmação, remoção opcional de dependências, limpeza do serviço ProxMenux Monitor e reposição das cópias de segurança de /root/.bashrc e /etc/motd. Apresenta uma barra de progresso durante todo o processo.",
|
||||
"section": "Configurações"
|
||||
},
|
||||
"scopeWarn": {
|
||||
"title": "Afecta apenas a instalação ProxMenux — não as suas VMs / CTs / armazenamento",
|
||||
"body": "A desinstalação remove os scripts do ProxMenux, o lançador do menu, o serviço Monitor opcional e as cópias de segurança dos ficheiros de sistema criadas pelo ProxMenux na instalação. <strong>Não altera as suas VMs, contentores, armazenamento, configuração de rede, Fail2Ban, controlador NVIDIA ou qualquer outro elemento instalado através do ProxMenux.</strong> Estes permanecem como estão."
|
||||
},
|
||||
"flow": {
|
||||
"heading": "Processo de desinstalação",
|
||||
"items": [
|
||||
"<strong>Diálogo de confirmação.</strong> Sim/não: «Tem a certeza de que pretende desinstalar o ProxMenux?»",
|
||||
"<strong>Lista de dependências a remover.</strong> Apresenta jq e dialog. Ambas as caixas estão desmarcadas por predefinição; selecione apenas dependências de que nenhuma outra aplicação necessite.",
|
||||
"<strong>A remoção apresenta uma barra de progresso.</strong> Remove qualquer ambiente de tradução antigo que tenha ficado, o lançador <code>menu</code>, a árvore <code>/usr/local/share/proxmenux/</code>, o serviço ProxMenux Monitor, se existir, e o destino de notificações registado no Proxmox VE (<code>proxmenux-webhook</code> e a respetiva regra de correspondência), bem como as dependências selecionadas. Por fim, repõe as cópias de segurança dos ficheiros de sistema (ver abaixo).",
|
||||
"<strong>Diálogo de conclusão.</strong> Lista as dependências removidas e termina."
|
||||
]
|
||||
},
|
||||
"deps": {
|
||||
"heading": "Remoção de dependência: o que é oferecido",
|
||||
"intro": "A lista apresenta jq e dialog. <strong>Nenhuma caixa está selecionada por predefinição</strong>: outras aplicações podem utilizar estes pacotes do sistema, por isso é mais seguro mantê-los.",
|
||||
"headerType": "Instalação",
|
||||
"headerOffered": "Oferecido para remoção",
|
||||
"rows": [
|
||||
{
|
||||
"type": "Versões atuais",
|
||||
"offeredRich": "<code>dialog</code>, <code>jq</code>"
|
||||
},
|
||||
{
|
||||
"type": "Instalações antigas após atualização",
|
||||
"offeredRich": "<code>dialog</code>, <code>jq</code>"
|
||||
}
|
||||
],
|
||||
"warnTitle": "Pacotes em todo o sistema — pense duas vezes",
|
||||
"warnBody": "A lista atual apresenta <code>jq</code> e <code>dialog</code>, não <code>python3</code>. Outras ferramentas podem necessitar destes pacotes do sistema. A remoção pode também eliminar pacotes dependentes ou dependências não utilizadas. Mantenha os pacotes necessários e reveja qualquer proposta de remoção antes de executar o apt manualmente."
|
||||
},
|
||||
"removed": {
|
||||
"heading": "O que é removido",
|
||||
"code": "/usr/local/bin/menu # the launcher\n/usr/local/share/proxmenux/ # everything: scripts, config, cache, version\n/opt/googletrans-env/ # leftover legacy translation environment\n/etc/systemd/system/proxmenux-monitor.service # Monitor service unit\n/root/.config/proxmenux-monitor/ # Monitor config dir\n # + dependencies you ticked in the checklist"
|
||||
},
|
||||
"restored": {
|
||||
"heading": "O que é restaurado",
|
||||
"items": [
|
||||
"Se o <code>/root/.bashrc.bak</code> existe → renomeado de volta para <code>/root/.bashrc</code> (seu bashrc original retorna).",
|
||||
"Se <code>/etc/motd.bak</code> existir, é renomeado para <code>/etc/motd</code>. Caso contrário, sed remove a linha do ProxMenux (<em>“This system is optimised by: ProxMenux”</em>) do motd existente."
|
||||
]
|
||||
},
|
||||
"othersCallout": {
|
||||
"title": "Os outros componentes instalados pelo ProxMenux são mantidos",
|
||||
"body": "Qualquer coisa ProxMenux instalada através de outros menus — Fail2Ban, Lynis, NVIDIA drivers, ajustes pós-instalação — <strong>não</strong> é tocado por este desinstalador. Cada um tem seu próprio fluxo de desinstalação dentro do respectivo menu (ou você pode remover diretamente com o apt). Veja primeiro <em>Mostrar informações da versão</em> para ver o que está registrado."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Desinstalação manual",
|
||||
"intro": "Se por alguma razão o desinstalador de menu não pode executar (por exemplo. <code>dialog</code> já em falta), a sequência manual equivalente:",
|
||||
"code": "# 1. Stop and remove the Monitor service (if installed)\nsystemctl stop proxmenux-monitor.service 2>/dev/null\nsystemctl disable proxmenux-monitor.service 2>/dev/null\nrm -f /etc/systemd/system/proxmenux-monitor.service\nrm -rf /root/.config/proxmenux-monitor\nsystemctl daemon-reload\nsystemctl reset-failed 2>/dev/null\n\n# 2. Remove a leftover legacy translation environment\nrm -rf /opt/googletrans-env\n\n# 3. Remove ProxMenux files\nrm -f /usr/local/bin/menu\nrm -rf /usr/local/share/proxmenux\n\n# 4. Restore backups\n[ -f /root/.bashrc.bak ] && mv /root/.bashrc.bak /root/.bashrc\n[ -f /etc/motd.bak ] && mv /etc/motd.bak /etc/motd \\\n || sed -i '/This system is optimised by: ProxMenux/d' /etc/motd"
|
||||
},
|
||||
"reinstall": {
|
||||
"heading": "Reinstalar mais tarde",
|
||||
"body": "Execute novamente o instalador oficial do ProxMenux. As versões atuais utilizam um único modo de instalação que inclui os oito idiomas da interface."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Resolução de Problemas",
|
||||
"hangTitle": "A desinstalação bloqueia ao remover um ambiente de tradução antigo",
|
||||
"hangBody": "As versões atuais removem um ambiente residual com <code>rm -rf /opt/googletrans-env</code>; não executam <code>pip uninstall</code>. Se este passo bloquear, examine-o noutra shell e verifique o sistema de ficheiros do anfitrião antes de repetir.",
|
||||
"aptTitle": "O apt avisa sobre pacotes ainda em utilização ao remover dependências",
|
||||
"aptBody": "Os pacotes selecionados são marcados como automáticos e passados a <code>apt-get -y --purge autoremove</code>. Isto não garante a proteção dos serviços dependentes. Deixe as dependências desmarcadas se outras ferramentas precisarem delas e reveja as remoções propostas pelo apt antes de qualquer limpeza manual.",
|
||||
"motdTitle": "MOTD ainda mostra a linha ProxMenux após desinstalar",
|
||||
"motdBody": "Pode acontecer se <code>/etc/motd.bak</code> não existia e o sed não encontrou a linha (por exemplo, porque foi alterada). Edite <code>/etc/motd</code> manualmente e remova qualquer linha do ProxMenux que tenha ficado."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"label": "Mostrar informações da versão",
|
||||
"tail": " — ver o que seria removido antes de desinstalar."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings",
|
||||
"label": "Visão geral das configurações",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user