diff options
Diffstat (limited to 'content/articles/tutoriais/librecmc.html~')
| -rw-r--r-- | content/articles/tutoriais/librecmc.html~ | 1272 |
1 files changed, 1272 insertions, 0 deletions
diff --git a/content/articles/tutoriais/librecmc.html~ b/content/articles/tutoriais/librecmc.html~ new file mode 100644 index 0000000..a7ef7fc --- /dev/null +++ b/content/articles/tutoriais/librecmc.html~ @@ -0,0 +1,1272 @@ +<html> + <head> + <title>Librecmc - Guia de introdução</title> + <meta name="tags" content="brigada digital, tutorial, software livre, sistemas, librecmc, roteador" /> + <meta name="date" content="2025-07-16 10:00" /> + <meta name="category" content="Tutoriais" /> + <meta name="author" content="Bio" /> + <meta name="slug" content="librecmc" /> + <meta name="summary" content="Guia de utilização do sistema operacional livre LibreCMC GNU/Linux para roteadores." /> + <meta name="status" content="published" /> + </head> + <body class="features"> + <section class="indice"> + <h1>Índice</h1> + <ul> + <li><a href="#introducao">Introdução</a></li> + <li><a href="#instalacao">Instalação</a></li> + <li><a href="#luci-web-interface-de-configuracao">LuCi - web interface de configuração</a></li> + <ul> + <li><a href="#luci-acesso">Acesso</a></li> + <ul> + <li><a href="#luci-primeiro-acesso">Primeiro acesso</a></li> + <li><a href="#luci-senha">Definição de senha</a></li> + </ul> + <li><a href="#luci-configuracao-sistema">Configuração de Sistema</a></li> + <ul> + <li><a href="#luci-configuracao-sistema-sistema">Sistema</a></li> + <li><a href="#luci-configuracao-sistema-configuracoes-gerais">Configurações gerais</a></li> + <li><a href="#luci-configuracao-administracao-sistema">Administração de sistema</a></li> + <li><a href="#luci-configuracao-copia-seguranca-gravar-firmware">Cópia de segurança/gravar firmware</a></li> + <ul> + <li><a href="#luci-hard-reset">Hard Reset do roteador</a></li> + <li><a href="#luci-configuracao-copia-seguranca-gravar-firmware-atualizacao-firmware">Atualização do firmware</a></li> + </ul> + <li><a href="#luci-configuracao-gerenciador-pacotes">Gerenciador de pacotes</a></li> + </ul> + <li><a href="#luci-rede">Rede</a></li> + <ul> + <li><a href="#luci-rede-interfaces">Interfaces</a></li> + <li><a href="#luci-rede-sem-fio-wi-fi">Rede sem fio - Wi-fi</a></li> + </ul> + </ul> + <li><a href="#ssh-acesso">Acesso por SSH</a></li> + <ul> + <li><a href="#configuracao-acesso-ssh">Configuração de acesso SSH</a></li> + <li><a href="#acesso-ssh-terminal">Acesso SSH</a></li> + </ul> + <li><a href="#uci">UCI - Interface de Configurção Unificada</a></li> + <ul> + <li><a href="#uci-principios-comuns">Princípios comuns</a></li> + <li><a href="#uci-arquivos-configuracao">Arquivos de configuração</a></li> + <li><a href="#uci-sintaxe-configuracao">Sintaxe de configuração</a></li> + <li><a href="#uci-utilitario-linha-comando">Utilitário de linha de comando</a></li> + <ul> + <li><a href="#uci-uso">Uso</a></li> + <li><a href="#uci-uso-exemplos">Exemplos</a></li> + </ul> + <li><a href="#configuracao-nao-uci">Configuração não tratada por UCI</a></li> + <ul> + <li><a href="#arquivos-configuracao-nao-uci">Arquivos de configuração não UCI</a></li> + </ul> + </ul> + <li><a href="#gerenciador-pacotes-opkg">Gerenciador de pacotes opkg</a></li> + <li><a href="#router-hard-reset">Roteador hard reset</a></li> + <ul> + <li><a href="#router-hard-reset-fisico">Hard reset físico</a></li> + <li><a href="#router-hard-reset-ssh">Hard reset pelo SSH</a></li> + </ul> + <li><a href="#bibliografia">Bibliografia</a></li> + </ul> + </section> + <section class="features"> + <h1><a href="#introducao" name="introducao" title="Introdução">Introdução<a/> <a href="#banner" title="Topo da página">^</a></h1> + <figure class="image img"> + <img + src="/images/sistemas/librecmc.png" + title="Logo da distribuição para embarcados GNU/Linux LibreCMC" + alt="logo da distribuição para embarcados GNU/Linux LibreCMC" /> + <figcaption>Logo da distribuição GNU/Linux LibreCMC</figcaption> + </figure> + <p> + O <a href="https://librecmc.org/" title="Site LibreCMC">LibreCMC GNU/Linux-libre</a> é uma distribuição do sistema operacional Gnu/Linux dedicada a embarcados, especialmente roteadores, mas podendo ser utilizada de maneira geral, <a href="https://www.gnu.org/distros/free-distros.html"/> certificada pela Fundação de Software Livre</a> como em conformidade com as <a href="https://www.gnu.org/distros/free-system-distribution-guidelines.pt-br.html">Diretrizes para Distribuições de Sistemas Livres (GNU FSDG)</a>. + </p> + </section> + <section class="features"> + <h1><a href="#instalacao" name="instalacao" title="Instalação">Instalação<a/> <a href="#banner" title="Topo da página">^</a></h1> + <p> + O processo de instalação do LibreCMC não é muito complicado, mas exige atenção para não fazer seu dispositivo ficar inutilizável. Para a instalação, tenha em mente a <a href="https://gogs.librecmc.org/libreCMC/libreCMC/wiki/Supported_Hardware">lista oficial de modelos suportados</a>. A instalação consiste em gravar a imagem do LibreCMC de fábrica específica do dispositivo através da página de atualização do firmware proprietário, geralmente na seção de <i>administração do sistema</i>. + </p> + <p> + Também é possível construir uma imagem LibreCMC você mesmo para algum firmware suportado. O sistema de construção é simples, basta seguir a <a href=" https://gogs.librecmc.org/libreCMC/libreCMC/wiki/How_To_Build_libreCMC" target="_blank" title="Documentação para compilação">documentação de compilação</a>. + </p> + <p><b>Caso queira, podemos fazer a instalação para você, enquanto nos ajuda a manter as atividades da Brigada</b>. Entre em nossa <a href="/pages/equipamentos.html" name="pagina-equipamentos" title="Página de equipamentos produzidos pela Brigada Digital">página de equipamentos</a> e veja como pedir um dispositivo com LibreCMC. + </p> + <figure class="image img"> + <img + src="/images/equipamentos/tp-link-wdr4300-librecmc.png" + title="TP-Link WDR4300" + alt="Reteador TP-Link TL-WDR4300"/> + <figcaption>Roteador TP-Link TL-WDR4300</figcaption> + </figure> + </section> + <section class="features"> + <h1><a href="#luci-web-interface-de-configuracao" name="luci-web-interface-de-configuracao" title="LuCi - Web interface de configuração">LuCi - Web interface de configuração</a> <a href="#banner" title="Topo da página">^</a></h1> + <p> + LuCi é a interface web de configuração de roteadores usada por LibreCMC. Desenvolvida com a poderosa, eficiente e leve linguagem de programação de script <a href="https://lua.org/" title="Site do linguagem de programação Lua">Lua</a>, de origem brasileira e bastante popular. + </p> + <figure class="image img"> + <img + srcset="/images/librecmc/librecmc-luci-condicao-geral-visao-geral-configuracao-senha_480x.png 480w, + /images/librecmc/librecmc-luci-condicao-geral-visao-geral-configuracao-senha_720x.png 720w, + /images/librecmc/librecmc-luci-condicao-geral-visao-geral-configuracao-senha_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-condicao-geral-visao-geral-configuracao-senha_1024x.png" + title="LuCi - web interface de configuração usada por LibreCMC" + alt="LuCi - web interface de configuração"/> + <figcaption>LuCi - web interface de configuração usada por LibreCMC</figcaption> + </figure> + <h2><a href="#luci-acesso" name="acesso" title="Acesso">Acesso</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + Para acessar LuCi, conecte seu computador (ou outro dispositivo) ao roteador e, pelo navegador, entre no endereço <i>https://192.168.10.1</i>, padrão do gateway. Sempre entre com as credenciais através de conexão criptografada (https) para não correr o risco de algum cliente malicioso pegar as suas credenciais. + </p> + <h3><a href="#luci-primeiro-acesso" name="luci-primeiro-acesso" title="Como fazer o priiero acesso de Luci">Primeiro acesso</a> <a href="#banner" title="Topo da página">^</a></h3> + <p> + Caso seja o primeiro acesso, o usuário administrativo padrão é <i>root</i> e não existe senha, bastando apenas executar o botão <i>Entrar</i>. + </p> + <figure class="image img"> + <img + srcset="/images/librecmc/librecmc-luci-acesso_480x.png 480w, + /images/librecmc/librecmc-luci-acesso_720x.png 720w, + /images/librecmc/librecmc-luci-acesso_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-acesso_1024x.png" + title="LuCi web-interface - acesso" + alt="LuCi web interface - acesso"/> + <figcaption>LuCi web interface - acesso</figcaption> + </figure> + <h4><a href="#luci-senha" name="luci-senha" title="Página de definição de senha">Definição de senha</a> <a href="#banner" title="Topo da página">^</a></h4> + <p> + Na página inicial, defina uma senha executando o botão <i>Ir para a configuração de senha</i>. Ou pelo menu princial <i>Sistema > Administração</i>, aba <i>Senha do Roteador</i>. + </p> + <figure class="image img"> + <img + srcset="/images/librecmc/librecmc-luci-condicao-geral-visao-geral-configuracao-senha_480x.png 480w, /images/librecmc/librecmc-luci-condicao-geral-visao-geral-configuracao-senha_720x.png 720w, /images/librecmc/librecmc-luci-condicao-geral-visao-geral-configuracao-senha_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-condicao-geral-visao-geral-configuracao-senha_1024x.png" + title="LuCi web-interface - definição de senha" + alt="LuCi web interface - acesso"/> + <figcaption>Definição de senha</figcaption> + <p> + Insira sua senha nos campos indicados e execute o botão <i>Salvar</i>. + </p> + <img + srcset="/images/librecmc/librecmc-luci-sistema-administracao-senha-roteador_480x.png 480w, /images/librecmc/librecmc-luci-sistema-administracao-senha-roteador_720x.png 720w, /images/librecmc/librecmc-luci-sistema-administracao-senha-roteador_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-sistema-administracao-senha-roteador_1024x.png" + title="LuCi web-interface - Senha do Roteador" + alt="LuCi web interface - Senha do Rotador"/> + <figcaption>LuCi web interface - Sistema > Adminstração > Senha do Roteador</figcaption> + </figure> + <h2><a href="#luci-configuracao-sistema" name="configuracao-sistema" title="Configuração de sistema">Configuração de sistema</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + As configurações dos aspectos básicos do seu equipamento, como nome do dispositivo, fuso horário, atualiação, backup, etc. está localizado no menu superior denominado <i>Sistema</i>. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-sistema_480x.png 480w, /images/librecmc/librecmc-luci-sistema_720x.png 720w, /images/librecmc/librecmc-luci-sistema_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-sistema_1024x.png" + title="LuCi web-interface - menu Sistema" + alt="LuCi web interface - menu Sistema"/> + <figcaption>LuCi web interface - Menu Sistema</figcaption> + </figure> + <h3><a href="#luci-configuracao-sistema-sistema" name="configuracao-sistema-sistema" title="Luci - Configuração de sistema">Sistema</a> <a href="#banner" title="Topo da página">^</a></h3> + <p> + Página localizada no menu <i>Sistema > Sistema</i>, onde está a configuração do nome do dispositivo, fuso horário, serviço de NTP e etc. A página é subdividida em abas apresentadas abaixo. + </p> + <h4>Configurações gerais</h4> + <p> + Nessa aba defina o <i>Nome do equipamento</i> e <i>Fuso horário</i> correto e execute o botão <i>Salvar & Aplicar</i> ou <i>Salvar</i>. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-sistema-sistema-configuracoes-gerais_480x.png 480w, /images/librecmc/librecmc-luci-sistema-sistema-configuracoes-gerais_720x.png 720w, /images/librecmc/librecmc-luci-sistema-sistema-configuracoes-gerais_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-sistema-sistema-configuracoes-gerais_1024x.png" + title="LuCi web-interface - página Sistema, aba Configurações gerais" + alt="LuCi web interface - página Sistema, aba Configurações gerais"/> + <figcaption>LuCi web interface - página Sistema, aba Configurações gerais</figcaption> + </figure> + <h4>Sincronização de horário</h4> + <p> + Na Aba <i>Sincronização de horário</i> marque a caixa <i>Ativar o cliente NTP</i> e defina os <i>Candidatos a servidor NTP</i> para os sevidores de sua preferêcia. Nós sugerimos os servidores brasileiro do Nic.BR: <i>a.ntp.br</i>, <i>b.ntp.br</i> e <i>c.ntp.br</i>. Insira o candidato a servidor e execute o botão <i>+</i>. Após inserir todos os servidores NTP, execute o botão <i>Salvar & Aplicar</i> ou <i>Salvar</i>. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-sistema-sistema-sincronizacao-horario_480x.png 480w, /images/librecmc/librecmc-luci-sistema-sistema-sincronizacao-horario_720x.png 720w, /images/librecmc/librecmc-luci-sistema-sistema-sincronizacao-horario_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-sistema-sistema-sincronizacao-horario_1024x.png" + title="LuCi web-interface - página Sistema, aba Sincronização do horário" + alt="LuCi web interface - página Sistema, aba Sincronização do horário"/> + <figcaption>LuCi web interface - página Sistema, aba Configurações gerais</figcaption> + </figure> + <h3><a href="#luci-configuracao-administracao-sistema" name="luci-configuracao-administracao-sistema" title="Administração de sistema">Administração de sistema</a> <a href="#banner" title="Topo da página">^</a></h3> + <p> + Na página de Administração, localizada no menu <i>Sistema > Administração</i>, estão as configurações de acesso ao LibreCMC como, por exemplo, configuração de senha, acesso SSH e HTTP(s). Após qualquer modificação na configuração lembre-se de executar o botão <i>Salvar & Aplicar</i>. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-sistema-administracao-senha-roteador_480x.png 480w, /images/librecmc/librecmc-luci-sistema-administracao-senha-roteador_720x.png 720w, /images/librecmc/librecmc-luci-sistema-administracao-senha-roteador_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-sistema-administracao-senha-roteador_1024x.png" + title="LuCi web-interface - Senha do Roteador" + alt="LuCi web interface - Senha do Rotador"/> + <figcaption>LuCi web interface - Sistema > Adminstração > Senha do Roteador</figcaption> + </figure> + <h3><a href="#luci-configuracao-copia-seguranca-gravar-firmware" name="luci-configuracao-copia-seguranca-gravar-firmware" title="Cópia de segurança/gravar firmware">Cópia de segurança/gravar firmware</a> <a href="#banner" title="Topo da página">^</a></h3> + <p> + Essa página, localizada em <i>Sistema > Cópia de Segurança/Gravar Firmware</i>, contém funções de backup e restauração da configuração e das partições do sistema, bem como atualização do firmware. É muito importante manter uma cópia de segurança das partições do LibreCMC, bem como, após configurar o LibreCMC, fazer uma cópia das configurações do sistema para restaurar, caso precise resetar o sistema para as configurações padrões e restaurá-las após. + </p> + <figure class="image img"> + <img + srcset="/images/librecmc/librecmc-luci-sistema-copia-seguranca_480x.png 480w, + /images/librecmc/librecmc-luci-sistema-copia-seguranca_720x.png 720w, + /images/librecmc/librecmc-luci-sistema-copia-seguranca_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-sistema-copia-seguranca_1024x.png" + title="LuCi web-interface - página Cópia de Segurança/Gravar Firmware" + alt="LuCi web interface - página Cópia de Segurança/Gravar Firmware"/> + <figcaption>LuCi web interface - Sistema > Cópia de Segurança/Gravar Firmware</figcaption> + </figure> + <h4><a href="#luci-hard-reset" name="luci-hard-reset" title="Harf reset do roteador">Hard reset do roteador</a> <a href="#banner">^</a></h4> + <p> + A seção <i>Restauração</i> da página <i>Cópia de Segurança/Grava Firmware</i> é destinada a fazer o hard reset do roteador. Para tanto, execute o botão <i>Restaure as configurações iniciais</i>. + </p> + <p> + Após, se desejar, restaure as configurações através do arquivo de backup das configurações. + </p> + <h4><a href="#luci-configuracao-copia-seguranca-gravar-firmware-atualizacao-firmware" name="luci-configuracao-copia-seguranca-gravar-firmware-atualizacao-firmware" title="Atualização do firmware">Atualização do firmware</a> <a href="#banner">^</a></h4> + <p> + Diferentemente de firmwares proprietários, o LibreCMC lança novas versões com frequência. Então, é possível manter o roteador atualizado com LibreCMC. + </p> + <p> + Essa seção da página <i>Cópia de Segurança/Grava Firmware</i> é destinada a fazer instalação de imagens do firmware de fábrica ou de atualizações compatíveis com <i>sysupgrade</i>. Faça o <a href="https://gogs.librecmc.org/libreCMC/libreCMC/wiki/Releases" title="Página de releases do LibreCMC">download da imagem do seu dispositivo</a> e do seu arquivo de verificação de integridade <i>sha256sums</i> ou faça a construção você mesmo. As imagens são nomeadas da seguinte forma: + </p> + <p> + <i>librecmc-$BUILD_TARGET-generic-$TARGET_PROFILE-$VERSION-$FS_TYPE-factory.bin</i> e <i>librecmc-$BUILD_TARGET-generic-$TARGET_PROFILE-$VERSION-$FS_TYPE-sysupgrade.bin</i> + </p> + <p> + Sendo $BUILD_TARGET = target (ex. ar71xx), $TARGET_PROFILE = dispositivo, $VERSION = versão do dispositivo. + </p> + <p> + A image cujo nome termina com <i>factory.bin</i> faz uma instalação limpa, geralmente utilizada para instalação à partir do firmware proprietário, enquanto a imagem com nome terminando com <i>sysupgrade.bin</i> faz uma instalação mantendo a configuração, geralmente utilizada para instalação de atualizações. + </p> + <p> + Faça a verificação da integridade das imagens com o comando sha256sum. Se o seu sistema operacional é Gnu/Linux, no terminal execute o comando a seguir: + </p> + <code> + sha256sum --ignore-missing -c sha256sums + </code> + <p> + Se a imagem estiver íntegra, a saída do comando será <i>ok</i>. + </p> + <p> + Execute o botão <i>Imagem</i> e selecione a imagem desejada para gravação e, após, execute o botão <i>Gravar imagem</i>. O processo deve demorar alguns minutos até a conclusão. Não deslique o dispositivo até que esteja concluído. + </p> + <h3><a href="#luci-configuracao-gerenciador-pacotes" name="luci-configuracao-gerenciador-pacotes" title="Gerenciador de pacotes">Gerenciador de pacotes</a> <a href="#banner">^</a></h3> + <p> + Essa página, localizada em <i>Sistema > Software</i>, gerencia os pacotes do LibreCMC. Faça a atualização da lista de pacotes executando o botão <i>Atualizar lista</i>. A Página contém abas com a lista de pacotes <i>Disponível</i>, <i>Instalado</i> e <i>Atualizações</i>. Antes de instalar qualquer pacote é importante considerar o <i>Espaço livre</i> do dispositivo e <i>Tamanho</i> do pacote. Para instalar, basta executar o botão <i>Instalar</i> + </p> + <figure class="image img"> + <img + srcset="/images/librecmc/librecmc-luci-sistema-software_480x.png 480w, + /images/librecmc/librecmc-luci-sistema-software_720x.png 720w, + /images/librecmc/librecmc-luci-sistema-software_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-sistema-software_1024x.png" + title="LuCi web-interface - Sotware" + alt="LuCi web interface - Software"/> + <figcaption>LuCi web interface - Sistema > Sotware</figcaption> + </figure> + <h2><a href="#luci-rede" name="rede" title="Acesso">Rede</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + Esse menu contém as configurações das interfaces Lan e Wan do roteador, da rede sem fio, roteamento, DHCP, DNS e Firewall. Após qualquer alteração nessas configurações, execute o botão <i>Salvar & Aplicar</i>. + </p> + <figure class="image img"> + <img + srcset="/images/librecmc/librecmc-luci-rede_480x.png 480w, + /images/librecmc/librecmc-luci-rede_720x.png 720w, + /images/librecmc/librecmc-luci-rede_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-rede_1024x.png" + title="LuCi web-interface - menu Rede" + alt="LuCi web interface - menu Rede"/> + <figcaption>LuCi web interface - menu Rede</figcaption> + </figure> + <h3><a href="#luci-rede-interfaces" name="luci-rede-interfaces" title="Interfaces de rede">Interfaces</a> <a href="#banner" title="Topo da página">^</a></h3> + <p> + Localizada no menu <i>Rede > Interfaces</i>, a página contém as configurações das interfaces LAN (rede local) e WAN (rede pública). As configurações dessas interfaces é acessada executando seu respectivo <i>botão Editar</i>. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-rede-interfaces_480x.png 480w, /images/librecmc/librecmc-luci-rede-interfaces_720x.png 720w, /images/librecmc/librecmc-luci-rede-interfaces_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-rede-interfaces_1024x.png" + title="LuCi web-interface - página Interfaces" + alt="LuCi web interface - página Interfaces"/> + <figcaption>LuCi web interface - Página Interfaces</figcaption> + </figure> + <h4>LAN</h4> + <p> + Executando o botão <i>Editar</i> da interface LAN (rede local). Uma caixa será aberta contendo as configurações da LAN. Na aba <i>Configurações gerais</i>, a configuração <i>Endereço IPv4</i> define o endereço gateway do dispositivo, bem como a faixa de endereço IP local utilizada para atribuir automaticamente, através do protocolo DHCP, endereços IP aos dispotivos conectados. Além dela, a configuração <i>Máscara de rede IPv4</i> para definir a sub-rede. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-rede-interfaces-lan_480x.png 480w, /images/librecmc/librecmc-luci-rede-interfaces-lan_720x.png 720w, /images/librecmc/librecmc-luci-rede-interfaces-lan_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-rede-interfaces-lan_1024x.png" + title="LuCi web-interface - página Lan" + alt="LuCi web interface - Página Lan"/> + <figcaption>LuCi web interface - Página Lan</figcaption> + </figure> + <h4>WAN</h4> + <p> + Para modificar a interface WAN (rede pública), execute o <i>botão Editar</i> da interface. Uma caixa com as configurações da interface WAN será aberta. Na aba <i>Configurações gerais</i> defina seu <i>Protocolo</i>. As opções são: <i>Cliente DHCP</i>, <i>Cliente DHCPv6</i>, <i>Não gerenciado</i>, <i>PPP</i>, <i>PPPoE</i>, <i>Ponte por retransmissão</i> e <i>Endereço estático</i>. As opções mais utilizadas pelos provedores de internet (IPS) são <i>Cliente DHCP</i>, <i>PPPoE</i> e <i>Endereço estático</i>. Se não sabe o protocolo correto para conectar o LibreCMC à rede pública, entre em contato com o seu ISP e peça auxílio. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-rede-interfaces-wan_480x.png 480w, /images/librecmc/librecmc-luci-rede-interfaces-wan_720x.png 720w, /images/librecmc/librecmc-luci-rede-interfaces-wan_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-rede-interfaces-wan_1024x.png" + title="LuCi web-interface - Caixa Interfaces wan, aba Configurações Gerais" + alt="LuCi web interface - Caixa Interfaces wan, aba Configurações Gerais"/> + <figcaption>LuCi web interface - Caixa Interfaces wan, aba Configurações Gerais</figcaption> + </figure> + <h3><a href="#luci-rede-sem-fio-wi-fi" name="luci-rede-sem-fio-wi-fi" title="Rede sem fio Wi-fi">Rede sem fio - Wi-Fi</a> <a href="#banner">^</a></h3> + <p> + Para ativar/desativar e configurar a rede sem fio Wi-Fi de 2.4GHz e 5GHz, entre na página <i>Rede sem fio</i> localizada no meu <i>Rede</i>. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-menu-rede-sem-fio_480x.png 480w, /images/librecmc/librecmc-luci-menu-rede-sem-fio_720x.png 720w, /images/librecmc/librecmc-luci-menu-rede-sem-fio_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-menu-rede-sem-fio_1024x.png" + title="LuCi web-interface - Menu Rede sem fio" + alt="LuCi web interface - Menu Rede sem fio"/> + <figcaption>LuCi web interface - Menu Rede sem fio</figcaption> + </figure> + <h4>Configuração</h4> + <p> + Na seção <i>Visão Geral da Rede sem Fio</i> é possível ativar/desativar as interfaces de rede sem fio (2.4GHz e/ou 5GHz) executando o botão <i>Ativar</i> ou <i>Desativar</i>. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-rede-sem-fio_480x.png 480w, /images/librecmc/librecmc-luci-rede-sem-fio_720x.png 720w, /images/librecmc/librecmc-luci-rede-sem-fio_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-rede-sem-fio_1024x.png" + title="LuCi web-interface - Menu Rede sem fio" + alt="LuCi web interface - Menu Rede sem fio"/> + <figcaption>Página de configuração da rede sem fio Wi-Fi</figcaption> + </figure> + <p> + Para realizar a configuração execute o botão <i>Editar</i> da respectiva interface de rede sem fio (2.4GHz e/ou 5GHz). A janela de configuração será aberta. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-rede-sem-fio-configuracao-1_480x.png 480w, /images/librecmc/librecmc-luci-rede-sem-fio-configuracao-1_720x.png 720w, /images/librecmc/librecmc-luci-rede-sem-fio-configuracao-1_1024x.png" + src="/images/librecmc/librecmc-luci-rede-sem-fio-configuracao-1_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + title="LuCi web-interface - janela de configuração da rede sem fio" + alt="LuCi web interface - janela de configuração da rede sem fio"/> + <figcaption>LuCi web interface - janela de configuração da rede sem fio</figcaption> + </figure> + <p>Na seção <i>Configuração da interface</i>, defina o <i>Modo</i>, sendo Ponto de Acesso (AP) utilizado para acesso à rede interna e internet via Wi-Fi (outros modos possíveis são Cliente, Ad-Hoc, Monitor, etc); e o <i>ESSID</i> para o nome de rede Wi-Fi desejado.</p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-rede-sem-fio-configuracao-2-2_480x.png 480w, /images/librecmc/librecmc-luci-rede-sem-fio-configuracao-2-2_720x.png 720w, /images/librecmc/librecmc-luci-rede-sem-fio-configuracao-2-2_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-rede-sem-fio-configuracao-2-2_1024x.png" + title="LuCi web-interface - janela de configuração da rede sem fio" + alt="LuCi web interface - janela de configuração da rede sem fio"/> + <figcaption>LuCi web interface - janela de configuração da rede sem fio</figcaption> + </figure> + <p> + Na aba <i>Segurança da Rede sem Fio</i> escolha a chave de criptografia de conexão dos clientes. Sendo possíveis as chaves OWE (rede aberta), WPA-PSK, WPA2-PSK e WAP3-SAE com possibilidade de combinações de chaves. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-luci-rede-sem-fio-configuracao-2-2-seguranca-da-rede_480x.png 480w, /images/librecmc/librecmc-luci-rede-sem-fio-configuracao-2-2-seguranca-da-rede_720x.png 720w, /images/librecmc/librecmc-luci-rede-sem-fio-configuracao-2-2-seguranca-da-rede_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-rede-sem-fio-configuracao-2-2-seguranca-da-rede_1024x.png" + title="LuCi web-interface - janela de configuração da rede sem fio" + alt="LuCi web interface - janela de configuração da rede sem fio"/> + <figcaption>LuCi web interface - janela de configuração da rede sem fio</figcaption> + </figure> + </section> + <section class="features"> + <h1><a href="#acesso-ssh" name="ssh" title="Acesso por ssh">Acesso por SSH</a> <a href="#banner" title="Topo da página">^</a></h1> + <p> + LibreCMC também pode ser acessado por SSH para realização de configuração e manutenção. Isso torna possível, por exemplo, instalar LibreCMC sem a interface web de configuração Luci instalado, liberando espaço para a instalação de programas. + </p> + <figure class="image img"> + <img srcset="/images/librecmc/librecmc-ssh-acesso_480x.png 480w, /images/librecmc/librecmc-ssh-acesso_720x.png 720w, /images/librecmc/librecmc-ssh-acesso_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-ssh-acesso_1024x.png" + title="Acesso por SSH" + alt="Acesso por SSH"/> + <figcaption>Acesso por SSH</figcaption> + </figure> + <h2><a href="#configuracao-acesso-ssh" name="configuracao-acesso-ssh" title="Acesso">Configuração do acesso SSH</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + O acesso por SSH é realizado através do programa Dropbear, um serviço de SSH muito leve, dedicado a embarcados, mas também usado em initramfs para acesso a máquinas antes mesmo do kernel ser carregado. + </p> + <p> + Na interface web Luci, a página de configuração do acesso por SSH está localizada em <i>Sistema > Administração</i> Aba <i>Acesso SSH</i>. Por questões de segurança remova a autenticação por senha e configure a autenticação por chave SSH na aba <i>Chaves SSH</i> adicionando sua chave pública SSH à configuração. + </p> + <figure class="image img"> + <img + srcset="/images/librecmc/librecmc-luci-ssh-servico_480x.png 480w, + /images/librecmc/librecmc-luci-ssh-servico_720x.png 720w, + /images/librecmc/librecmc-luci-ssh-servico_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-ssh-servico_1024x.png" + title="Configuração SSH pela web interface Luci" + alt="Configuração SSH pela web interface Luci"/> + <figcaption>Configuração SSH pela web interface Luci</figcaption> + </figure> + <p> + Se o seu sistema operacional é Gnu/Linux, sua chave pública geralmente é localizada em <i>~/.ssh/id_rsa.pub</i>. Você pode simplesmente arrastar o arquivo do seu gerenciador de arquivos para o local indicado na janela da interface Luci ou copiar e colar o conteúdo da chave pública. + </p> + <figure class="image img"> + <img + srcset="/images/librecmc/librecmc-luci-ssh-chaves_480x.png 480w, + /images/librecmc/librecmc-luci-ssh-chaves_720x.png 720w, + /images/librecmc/librecmc-luci-ssh-chaves_1024x.png" + sizes="(width <= 600px) 480px, (width <= 1024px) 720px" + src="/images/librecmc/librecmc-luci-ssh-chaves_1024x.png" + title="Configuração de chaves SSH pela web interface Luci" + alt="Configuração de chaves SSH pela web interface Luci"/> + <figcaption>Configuração de chaves SSH pela web interface Luci</figcaption> + </figure> + <h2><a href="#acesso-ssh-terminal" name="acesso-ssh-terminal" title="Acesso">Acesso SSH</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + Para acessar o LibreCMC pelo SSH basta executar o comando no terminal: + </p> + <code> + ssh root@192.168.10.1 + </code> + <h2><a href="#atualização-firmware-ssh" name="atualização-firmware-ssh" title="Acesso">Atualização do firmware</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + Diferentemente de firmwares proprietários, o LibreCMC lança novas versões com frequência. Então, é possível manter o roteador atualizado com LibreCMC. O firmware pode ser atualizado tanto pela interface web Luci quanto pelo shell através do acesso SSH. Aqui trataremos do procedimento de atualização pelo shell. + </p> + <p> + Essa seção da página <i>Cópia de Segurança/Grava Firmware</i> é destinada a fazer instalação de imagens do firmware de fábrica ou de atualizações compatíveis com <i>sysupgrade</i>. Faça o <a href="https://gogs.librecmc.org/libreCMC/libreCMC/wiki/Releases" title="Página de releases do LibreCMC">download da imagem do seu dispositivo</a> e do seu arquivo de verificação de integridade <i>sha256sums</i> ou faça a construção você mesmo. As imagens são nomeadas da seguinte forma: + </p> + <p> + <i>librecmc-$BUILD_TARGET-generic-$TARGET_PROFILE-$VERSION-$FS_TYPE-factory.bin</i> e <i>librecmc-$BUILD_TARGET-generic-$TARGET_PROFILE-$VERSION-$FS_TYPE-sysupgrade.bin</i> + </p> + <p> + Sendo $BUILD_TARGET = target (ex. ar71xx), $TARGET_PROFILE = dispositivo, $VERSION = versão do dispositivo. + </p> + <p> + A image cujo nome termina com <i>factory.bin</i> faz uma instalação limpa, geralmente utilizada para instalação à partir do firmware proprietário, enquanto a imagem com nome terminando com <i>sysupgrade.bin</i> faz uma instalação mantendo a configuração, geralmente utilizada para instalação de atualizações. + </p> + <code> + scp librecmc-$BUILD_TARGET-generic-$TARGET_PROFILE-$VERSION-$FS_TYPE-sysupgrade.bin sha256sums root@192.168.1.1:/tmp + </code> + <p> + Acesse o roteador pelo SSH: + </p> + <code> + ssh root@192.168.10.1:/tmp + </code> + <p> + Faça a verificação da integridade das imagens executando o comando sha256sum no arquivo sha256sums: + </p> + <code> + sha256sum --ignore-missing -c sha256sums + </code> + <p> + Se o resultado for <i>OK</i>, a imagem está íntegra e você pode fazer a atualização com segurança. + </p> + <p>O processo de gração/atualização do novo firmware é demorado, então espere até que tudo esteja finalizado, senão você corre o risco de fazer tijolo do seu roteador. Faça a atualização executando o seguinte comando:</p> + <code> + sysupgrade -v /tmp/librecmc-$BUILD_TARGET-generic-$TARGET_PROFILE-$VERSION-$FS_TYPE-sysupgrade.bin + </code> + </section> + <section class="features"> + <h1><a name="uci"><a href="#uci" title="UCI">UCI - Interface de Configuração Unificada</a><a/> <a href="#banner" title="Topo da página">^</a></h1> + <p> + UCI é um sistema para centralizar a configuração dos serviços do LibreCMC. É a principal interface de configuração do sistema, incluindo a configuração principal de interface de rede, configurações sem fio, funcionalidade de registro e configuração de acesso remoto. + </p> + <p> + Muitos pacotes no repositório LibreCMC são compatíveis com o sistema UCI. As aplicações são feitas compatíveis simplesmente escrevendo o arquivo de configuração original (que é lido pelo programa) de acordo com as configurações escolhidas no arquivo UCI correspondente. Isso é feito ao executar os scripts de inicialização em <i>/etc/init.d/</i>. Assim, ao iniciar um daemon com tal script de inicialização compatível com UCI, você deve estar ciente de que o arquivo de configuração original do programa é substituído. Por exemplo, no caso do Samba/CIFS, o arquivo <i>/etc/samba/smb.conf</i> é substituído com configurações UCI do arquivo de configuração do UCI <i>/etc/config/samba</i> ao executar <i>/etc/init.d/samba</i> start. Além disso, o arquivo de configuração do aplicativo é frequentemente armazenado em RAM em vez de em flash, porque ele não precisa ser armazenado em memória não volátil e é reescrito após cada mudança, com base no arquivo UCI. Existem maneiras de desativar o UCI caso você queira ajustar as configurações no arquivo de configuração original não disponível através do UCI, em cifs.server você pode ver como desativar UCI para samba, por exemplo. + </p> + <p> + Para aqueles programas não compatíveis com UCI, existe uma lista conveniente de alguns <a href="#configuracao-nao-uci" title="Arquivos de Configuração não UCI">arquivos de configuração não-UCI</a> que você pode querer atender. Note que, para a maioria dos programas de terceiros, você deve consultar a própria documentação do programa. + </p> + <h2><a href="#uci-principios-comuns" name="uci-principios-comuns" title="Princípios da configuração UCI">Princípios comuns</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + A configuração central do LibreCMC está dividida em vários arquivos localizados no diretório <i>/etc/config/</i>. Cada arquivo se relaciona aproximadamente com a parte do sistema que ele configura. <strong>Você pode editar os arquivos de configuração com um editor de texto</strong> ou <strong>modificá-los com o programa utilitário de linha de comando UCI</strong>. Arquivos de configuração UCI também são modificáveis através de várias APIs de programação (como Shell, Lua e C), que também é como interfaces web como LuCI fazem alterações nos arquivos UCI. + </p> + <p> + Como exemplo de modificação da configuração do UCI, suponha que você queira alterar o endereço IP do dispositivo do padrão 192.168.1.1 para 192.168.2.1. Para fazer isso, usando qualquer editor de texto, como vi, altere a linha: + </p> + <code> + option ipaddr 192.168.1.1 + </code> + <p> + No arquivo /etc/config/network para: + </p> + <code> + option ipaddr 192.168.2.1 + </code> + <p> + Em seguida, commit as configurações executando + </p> + <code> + /etc/init.d/network restart + </code> + <p> + Neste caso, lembre-se que você tem que fazer login novamente usando o SSH como o dispositivo está agora acessível em seu novo endereço IP. + </p> + <h2><a href="#uci-arquivos-configuracao" name="uci-arquivos-configuracao" title="Arquivos de configuração UCI">Arquivos de configuração UCI</a> <a href="#banner" title="Topo da página">^</a></h2> + <table> + <tr> + <th style="text-align: left">Arquivo</th> + <th style="text-align: left">Descrição</th> + </tr> + <tr> + <td style="text-align: left"><strong>Básicas</strong></td> + <td></td> + </tr> + <tr> + <td>/etc/config/dhcp</td> + <td>Dnsmasq e odhcpd configuração: DNS, DHCP, DHCPv6 </td> + </tr> + <tr> + <td>/etc/config/dropbear</td> + <td>SSH configurações</td> + </tr> + <tr> + <td>/etc/config/firewall</td> + <td>NAT, filtro de pacotes, encaminhamento de porta, etc. </td> + </tr> + <tr> + <td>/etc/config/network</td> + <td>Configuração switch, rotas</td> + </tr> + <tr> + <td>/etc/config/system</td> + <td>Conjunto de configurações de sistema, NTP, RNG, Watchcat</td> + </tr> + <tr> + <td>/etc/config/wireless</td> + <td>Configurações da rede Wi-Fi</td> + </tr> + <tr> + <td style="text-align: left"><strong>Rede IPv6</strong></td> + <td></td> + </tr> + <tr> + <td>/etc/config/ahcpd</td> + <td>Configuração do servidor de encaminhamento Ad-Hoc, protocolo (AHCP)</td> + </tr> + <tr> + <td>/etc/config/dhcp6c</td> + <td>Cliente WIDE-DHCPv6 </td> + </tr> + <tr> + <td>/etc/config/dhcp6s</td> + <td>Servidor DHCPv6</td> + </tr> + <tr> + <td>/etc/config/gw6c</td> + <td>Configuração do cliente GW6c</td> + </tr> + <tr> + <td style="text-align: left"><strong>Outros</strong></td> + <td></td> + </tr> + <tr> + <td>/etc/config/acme</td> + <td>Configuração do certificado via ACME</td> + </tr> + <tr> + <td>/etc/config/babeld</td> + <td>Configuração babeld</td> + </tr> + <tr> + <td>/etc/config/bbstored</td> + <td>Configuração do servidor BoxBackup</td> + </tr> + <tr> + <td>/etc/config/cloudflared</td> + <td>Configuração do tunel Cloudflare</td> + </tr> + <tr> + <td>/etc/config/ddns</td> + <td>Configuração de DNS dinâmico (ddns-scripts) </td> + </tr> + <tr> + <td>/etc/config/dnscrypt-proxy</td> + <td>Configuração do DNSCrypt</td> + </tr> + <tr> + <td>/etc/config/dockerd</td> + <td>Configuração do motor Docker CE</td> + </tr> + <tr> + <td>/etc/config/emailrelay</td> + <td>E-MailRelay: servidor simples de SMTP e proxy com suport POP. Package emailrelay</td> + </tr> + <tr> + <td>/etc/config/etherwake</td> + <td>Wake-on-Lan: etherwake</td> + </tr> + <tr> + <td>/etc/config/freifunk_p2pblock</td> + <td>Usa iptables layer7-, ipp2p- e recentes módulos de bloqueio de tráfego p2p/filesharing</td> + </tr> + <tr> + <td>/etc/config/fstab</td> + <td>Configuração de pontos de montagem e swap</td> + </tr> + <tr> + <td>/etc/config/hd-idle</td> + <td>Outro servidor de discos</td> + </tr> + <tr> + <td>/etc/config/httpd</td> + <td>Configuração de servidor Web (Busybox httpd, deprecated)</td> + </tr> + <tr> + <td>/etc/config/ipset-dns</td> + <td>Configuração ipset-dns</td> + </tr> + <tr> + <td>/etc/config/kadnode</td> + <td>KadNode p2p DNS</td> + </tr> + <tr> + <td>/etc/config/luci</td> + <td>Configurações básicas da interface web de configuração LibreCMC LuCI</td> + </tr> + <tr> + <td>/etc/config/luci_statistics</td> + <td>Configuração de obtenção de estatística de pacotes</td> + </tr> + <tr> + <td>/etc/config/mini_snmpd</td> + <td>Configuração do servidor mini_snmpd</td> + </tr> + <tr> + <td>/etc/config/minidlna</td> + <td>Configuração do servidor de mídia MiniDLNA</td> + </tr> + <tr> + <td>/etc/config/mjpg-streamer</td> + <td>Aplicação de Streaming para webcams compatíveis com Linux-UVC</td> + </tr> + <tr> + <td>/etc/config/mountd</td> + <td>Servidor automount LibreCMC</td> + </tr> + <tr> + <td>/etc/config/mroute</td> + <td>Configuraão de arquivos para múltiplas rotas WAN</td> + </tr> + <tr> + <td>/etc/config/multiwan</td> + <td>Configuração simples de multi WAN</td> + </tr> + <tr> + <td>/etc/config/mwan3</td> + <td>Configurção Multi-WAN com load balancing and mais</td> + </tr> + <tr> + <td>/etc/config/nodogsplash</td> + <td>Configurção nodogsplash</td> + </tr> + <tr> + <td>/etc/config/ntpclient</td> + <td>Sincronização de tempo através de cliente ntp</td> + </tr> + <tr> + <td>/etc/config/nut_server</td> + <td>Controle da UPS (Uninterruptible Power Supply) e/ou completilhamento com outros hosts</td> + </tr> + <tr> + <td>/etc/config/nut_monitor</td> + <td>Monitoramento de UPS (Uninterruptible Power Supply) de um remote host ou local nut-server</td> + </tr> + <tr> + <td>/etc/config/nut_cgi</td> + <td>Web UI para NUT (visto somente em UCI)</td> + </tr> + <tr> + <td>/etc/config/p910nd</td> + <td>Configuração para serviço de impressão non-spooling p910nd.server</td> + </tr> + <tr> + <td>/etc/config/pure-ftpd</td> + <td>Configuração do serviço Pure-FTPd</td> + </tr> + <tr> + <td>/etc/config/qos</td> + <td>Implementação do Quality of Service para upload</td> + </tr> + <tr> + <td>/etc/config/racoon</td> + <td>Serviço racoon IPsec</td> + </tr> + <tr> + <td>/etc/config/samba</td> + <td>Configuração para o Microsoft file e serviço de impressão</td> + </tr> + <tr> + <td>/etc/config/snmpd</td> + <td>Configuração SNMPd</td> + </tr> + <tr> + <td>/etc/config/sqm</td> + <td>Configuração SQM</td> + </tr> + <tr> + <td>/etc/config/sshtunnel</td> + <td>Configuração para o pacote sshtunnel</td> + </tr> + <tr> + <td>/etc/config/stund</td> + <td>Configuração para o seriço STUN</td> + </tr> + <tr> + <td>/etc/config/tinc</td> + <td>Configuração do pacore tinc</td> + <tr> + <tr> + <td>/etc/config/tor</td> + <td>Configuração Tor</td> + </tr> + <tr> + <td>/etc/config/tor-hs</td> + <td>Configuração de serviços ocultos por Tor</td> + </tr> + <tr> + <td>/etc/config/transmission</td> + <td>Configuração BitTorrent</td> + </tr> + <tr> + <td>/etc/config/uhttpd</td> + <td>Configurações do Web server (uHTTPd)</td> + </tr> + <tr> + <td>/etc/config/upnpd</td> + <td>Configuração do serviço miniupnpd UPnP</td> + </tr> + <tr> + <td>/etc/config/users</td> + <td>Banco de dados de usuários para diferentes serviços</td> + </tr> + <tr> + <td>/etc/config/ushare</td> + <td>Configurações do serviço uShare UPnP</td> + </tr> + <tr> + <td>/etc/config/vblade</td> + <td>vblade userspace AOE target</td> + </tr> + <tr> + <td>/etc/config/vnstat</td> + <td>Configurações do gerenciador de download vnstat</td> + </tr> + <tr> + <td>/etc/config/wifitoggle</td> + <td>Configuração do botão Toggle WiFi</td> + </tr> + <tr> + <td>/etc/config/wol</td> + <td>Wake-on-Lan: wol</td> + </tr> + <tr> + <td>/etc/config/znc</td> + <td>Configuração do serviço ZNC bouncer (IRC)</td> + </tr> + </table> + <h2><a href="#uci-sintaxe-configuracao" name="uci-sintaxe-configuracao" title="Sintaxe dos arquivos de configuração UCI">Sintaxe dos arquivos de configuração</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + Os arquivos de configuração UCI geralmente consistem em uma ou mais instruções de configuração, chamadas seções com uma ou mais instruções de opção definindo os valores reais. + </p> + <p> + A # começa comentários da maneira usual. Especificamente, se uma linha contém um # fora de uma string literal, ele e todos os caracteres após ele na linha são considerados um comentário e ignorados. + </p> + <p> + Abaixo está um exemplo de um arquivo de configuração simples: + </p> + <code> + <pre> +package 'example' + +config 'example' 'test' + option 'string' 'some value' + option 'boolean' '1' + list 'collection' 'first item' + list 'collection' 'second item' + </pre> + </code> + <ul style="list-style-type:disc; padding-left:5%;"> + <li> + A configuração do pacote 'exemplo' define o início de uma seção com nome de 'teste'. Também pode ser chamado de seções anônimas com apenas um tipo, mas sem identificador de nome. O tipo é importante para que os programas de processamento decidam como tratar as opções fechadas. + </li> + <li> + A opção 'string' 'algum valor' e 'boolean' '1' linhas definem valores simples dentro da seção. Observe que não há diferenças sintáticas entre as opções texto e booleano. Por convenção, as opções booleanas podem ter um dos valores '0', 'não', 'off', 'falso' ou 'desactivado' para especificar um valor falso ou '1', 'sim', 'on', 'true' ou ' habilitado' para especificar um valor verdadeiro. + </li> + <li> + Nas linhas começando com uma palavra-chave lista uma opção com múltiplos valores é definida. Todas as declarações de lista que compartilham o mesmo nome, coleção em nosso exemplo, serão combinadas em uma única lista de valores com a mesma ordem que no arquivo de configuração. + </li> + <li> + A indentação da opção e instruções de lista é uma convenção para melhorar a legibilidade do arquivo de configuração, mas não é sintaticamente necessária. + </li> + <li> + Se uma opção estiver ausente e não for necessária, o valor padrão é assumido. Se estiver ausente e necessário, pode desencadear um erro na aplicação ou outro comportamento indesejado. + </li> + <li> + Uma forma de desativar uma seção de configuração, que não tem uma opção habilitada para ser desabilitada, é renomear o identificador de seção de configuração (ou tipo, neste exemplo de caso) para um valor não reconhecido pelos processos que usam esses valores. Normalmente, um identificador_desativado como tipo/identificador de seção de configuração é suficiente. + </li> + </ul> + <p> + Normalmente você não precisa anexar identificadores ou valores nas citações. As citações só são necessárias se o valor fechado contiver espaços ou abas. Também é legal usar aspas em vez de cotações simples ao digitar opções de configuração. + </p> + <p> + Todos os exemplos abaixo são sintaxe UCI válida: + </p> + <code> + <pre> +option example value +option example "value" +option 'example' value +option 'example' "value" +option "example" 'value' + </pre> + </code> + <p> + É importante saber que identificadores UCI e nomes de arquivos de configuração podem conter apenas os caracteres a-z, 0-9 e _. Por exemplo, não são permitidos hífens (-). Os valores de opção podem conter qualquer caractere (enquanto forem devidamente citados). + </p> + <h2><a href="#uci-utilitario-linha-comando" name="uci-utilitario-linha-comando" title="Utilitário de linha de comando UCI">Utilitário de linha de comando UCI</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + <strong>Para ajustar as configurações, normalmente se muda os arquivos de configuração UCI diretamente</strong>. No entanto, para fins de script, toda a configuração do UCI também pode ser lida e alterada usando o utilitário de linha de comando <i>uci</i>. Para desenvolvedores que necessitam de processamento automático da configuração UCI, é, portanto, redundante, imprudente e ineficiente usar awk e grep para processar os arquivos de configuração do LibreCMC. O utilitário <i>uci</i> oferece toda a funcionalidade no que diz respeito a modificar e processar UCI. + </p> + <p> + Abaixo está o uso, bem como alguns exemplos úteis de como usar este utilitário poderoso. + </p> + <p> + <i>Ao usar uci para escrever arquivos de configuração, os arquivos são sempre reescritos em comandos inteiros e os comandos não reconhecidos são omitidos. Isso significa que quaisquer linhas estranhas no arquivo são excluídas, como comentários. Se você tem arquivos de configuração UCI que você mesmo editou e deseja preservar seus próprios comentários e linhas em branco, você não deve usar o utilitário linha de comando, mas editar os arquivos normalmente. Note que alguns arquivos, como o arquivo de configuração uHTPd, já contêm muitos comentários quando o aplicativo é instalado pela primeira vez. Além disso, note que algumas aplicações como LuCI também usam o utilitário uci e, assim, podem reescrever arquivos de configuração UCI.</i> + </p> + <p> + Quando existem várias seções do mesmo tipo em uma configuração, UCI suporta referências tipo array para elas. Se existem 8 servidores NTP definidos em /etc/config/system, UCI permitirá que você refira suas seções como system.@timeserver[0] para o primeiro ou system.@timeserver[7] para o último. Você também pode usar índices negativos, como system.@timeserver[-1]. “-1” significa o último, “-2” significa o segundo a último, e assim por diante. Isto é muito útil ao adicionar novas regras ao fim de uma lista. Veja os exemplos abaixo. + </p> + <h3><a href="#uci-uso" name="uci-uso" title="Uso do utilitário de linha de comando UCI">Uso</a> <a href="#banner" title="Topo da página">^</a></h3> + <p> + UCI segue a seguinte sintaxe de linha de comando: + </p> + <code> + Usage: uci [<options>] <command> [<arguments>] + </code> + <p> + A seguir tabela de comandos: + </p> + <table> + <tr> + <th>Comando</th> + <th>Alvo</th> + <th>Descrição</th> + </tr> + <tr> + <td>commit</td> + <td>[<config>]</td> + <td>Grava as alterações do ficheiro de configuração indicado, ou se não for indicado nenhum, todos os ficheiros de configuração, para o sistema de ficheiros. Todos os comandos "uci set", "uci add", "uci rename" e "uci delete" são encenados em um local temporário e escritos para flash imediatamente com "uci commit". Isso não é necessário depois de editar arquivos de configuração com um editor de texto, mas para scripts, GUIs e outros programas trabalhando diretamente com arquivos UCI.</td> + </tr> + <tr> + <td>batch</td> + <td>-</td> + <td>Executa um script UCI de várias linhas que é tipicamente envolvido em uma sintaxe de documento aqui.</td> + </tr> + <tr> + <td>export</td> + <td>[<config>]</td> + <td>Exporta a configuração em um formato legível por máquina. É usado internamente para avaliar arquivos de configuração como scripts shell.</td> + </tr> + <tr> + <td>import</td> + <td>[<config>]</td> + <td>Importa arquivos de configuração na sintaxe UCI.</td> + </tr> + <tr> + <td>changes</td> + <td>[<config>]</td> + <td>Lista as alterações encenadas para o ficheiro de configuração indicado ou, se não for indicado, todos os ficheiros de configuração.</td> + </tr> + <tr> + <td>add</td> + <td><config> <section-type></td> + <td>Adicionar uma secção anónima do tipo de secção à configuração indicada.</td> + </tr> + <tr> + <td>add_list</td> + <td><config>.<section>.<option>=<string></td> + <td>Adicionar o texto indicado a uma opção de lista existente.</td> + </tr> + <tr> + <td>del_list</td> + <td><config>.<section>.<option>=<string></td> + <td>Remover o texto fornecido de uma opção de lista existente.</td> + </tr> + <tr> + <td>show</td> + <td>[<config>[.<section>[.<option>]]]</td> + <td>Mostra a opção, secção ou configuração indicada na notação compactada.</td> + </tr> + <tr> + <td>get</td> + <td><config>.<section>[.<option>]</td> + <td>Obter o valor da opção indicada ou o tipo da secção indicada.</td> + </tr> + <tr> + <td>set</td> + <td><config>.<section>[.<option>]=<value></td> + <td>Defina o valor da opção indicada, ou adicione uma nova seção com o tipo definido para o valor indicado.</td> + </tr> + <tr> + <td>delete</td> + <td><config>.<section>[.<option>]</td> + <td>Apagar a secção ou opção indicada.</td> + </tr> + <tr> + <td>rename</td> + <td><config>.<section>[.<option>]=<name></td> + <td>Renomeie a opção ou seção indicada para o nome dado.</td> + </tr> + <tr> + <td>revert</td> + <td><config>[.<section>[.<option>]]</td> + <td>Reverter a opção indicada, seção ou arquivo de configuração.</td> + </tr> + <tr> + <td>reorder</td> + <td><config>.<section>=<position></td> + <td>Mova uma secção para outra posição.</td> + </tr> + </table> + <h3><a href="#uci-uso-exemplos" name="uci-uso-exemplos" title="Exemplos de uso de UCI">Exemplos</a> <a href="#banner" title="Topo da página">^</a></h3> + <h3>Exemplos</h3> + <h4>Configurando um valor</h4> + <p> + Se queremos alterar a porta de escuta do servidor web uHTPd de 80 para 8080, alteramos a configuração em /etc/config/uhttpd: + </p> + <code> + <pre> +uci set uhttpd.main.listen_http='8080' +uci commit uhttpd +/etc/init.d/uhttpd restart + </pre> + </code> + <p> + Feito, agora o arquivo de configuração é atualizado e uHTTPd escuta na porta 8080. + </p> + <h4>Exportar uma configuração inteira</h4> + <code> + uci export configuration_name + </code> + <p> + As configurações comumente disponíveis são: defaults, dnsmasq, dropbear, firewall, fstab, net, qos, samba, system, wireless. + </p> + <h4>Mostrando uma configuração</h4> + <code> + uci show configuration_name + </code> + <code> + <pre> +# uci show system +system.@system[0]=system +system.@system[0].hostname='LibreCMC' +system.@system[0].timezone='UTC' +system.ntp=timeserver +system.ntp.server='0.openwrt.pool.ntp.org' '1.openwrt.pool.ntp.org' '2.openwrt.pool.ntp.org' '3.openwrt.pool.ntp.org' +system.ntp.enabled='1' +system.ntp.enable_server='0' + </pre> + </code> + <h4>Mostrar apenas o valor de uma opção</h4> + <code> + uci get httpd.@httpd[0].port + </code> + <h4>Adicionar um item a uma lista</h4> + <code> + uci add_list system.ntp.server='0.de.pool.ntp.org' + </code> + <h4>Substituir uma lista completamente</h4> + <code> + <pre> +uci delete system.ntp.server +uci add_list system.ntp.server='0.de.pool.ntp.org' +uci add_list system.ntp.server='1.de.pool.ntp.org' +uci add_list system.ntp.server='2.de.pool.ntp.org' + </pre> + </code> + <h4>Adicionando uma seção com nome à configuração</h4> + <p> + Para adicionar uma seção nomeada de um determinado tipo, deve ser usada a forma sem opção do comando uci set. + </p> + <code> + <pre> +touch /etc/config/example +uci set example.this_name=blah +uci set example.this_name.xxx=yyy +uci set example.other_name=blah +uci set example.other_name.yyy=zzz +uci commit example + </pre> + </code> + <code> + uci show example + </code> + <code> + <pre> +example.this_name=blah +example.this_name.xxx=yyy +example.other_name=blah +example.other_name.yyy=zzz + </pre> + </code> + <code> + cat /etc/config/example + </code> + <code> + <pre> +config blah 'this_name' + option xxx 'yyy' + +config blah 'other_name' + option yyy 'zzz' + </pre> + </code> + <h4>Salvando valores modificados de uma única configuração</h4> + <code> + <pre> +uci commit configuration_name +reload_config + </pre> + </code> + <h2><a href="#configuracao-nao-uci" name="configuracao-nao-uci" title="Configuração do sistema não tratada pelo UCI">Configuração de sistema não tratada por UCI</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + Muitas coisas podem (e, portanto, devem ser) configuradas com <i>uci</i> através de qualquer uma de suas interfaces. Esta página se preocupa com tudo o que está embutido no LibreCMC que não pode ser configurado com UCI. Note que a maioria das aplicações de terceiros, instaladas com opkg ou de outra forma, normalmente também têm seus próprios métodos de configuração. Usuários experientes com distribuição GNU/Linux saberão tudo isso de cor. Para iniciantes isso deve ser útil. + </p> + <h3><a href="#arquivos-configuracao-nao-uci" name="arquivos-configuracao-nao-uci" title="Arquivos de configuração não tratada pelo UCI">Arquivos de configuração não UCI</a> <a href="#banner" title="Topo da página">^</a></h3> + <table> + <tr> + <th>Configuração</th> + <th>Descripção</th> + </tr> + <tr> + <td>/etc/banner</td> + <td>Banner recepção de Login.</td> + </tr> + <tr> + <td>/etc/crontabs</td> + <td>Cron</td> + <tr> + <tr> + <td>/etc/dnsmasq.conf</td> + <td>Dnsmasq</td> + </tr> + <tr> + <td>/etc/ethers</td> + <td>See: Dnsmasq</td> + </tr> + <tr> + <td>/etc/firewall.user</td> + <td>Firewall</td> + </tr> + <tr> + <td>/etc/apcupsd/apcupsd.conf</td> + <td></td> + </tr> + <tr> + <td>/etc/fstab</td> + <td>Um link simbólico para /tmp/fstab que está sendo criado e configurado pelo UCI em /etc/config/fstab.</td> + </tr> + <tr> + <td>/etc/fw_env.config</td> + <td></td> + <tr> + <tr> + <td>/etc/group</td> + <td>Este é um arquivo ASCII que define os grupos aos quais os usuários pertencem.</td> + <tr> + <tr> + <td>/etc/hosts</td> + <td>Dnsmasq</td> + </tr> + <tr> + <td>/etc/hosts.allow</td> + <td></td> + </tr> + <tr> + <td>/etc/hosts.deny</td> + <td></td> + </tr> + <tr> + <td>/etc/hotplug.d</td> + <td>Hotplug</td> + </tr> + <tr> + <td>/etc/init.d/rcS</td> + <td>Executado por init a cada início.</td> + </tr> + <tr> + <td>/etc/inittab</td> + <td>Exemplos inittab</td> + </tr> + <tr> + <td>/etc/iproute2/rt_tables</td> + <td>Configuração de tabelas de roteamento: iproute2</td> + </tr> + <tr> + <td>/etc/mtab</td> + <td>filesystems, flash.layout, procfs, sysfs, devpts</td> + </tr> + <tr> + <td>/etc/opkg.conf</td> + <td>Opkg</td> + </tr> + <tr> + <td>/etc/passwd</td> + <td></td> + </tr> + <tr> + <td>/etc/preinit</td> + <td>Em LibreCMC o Kernel é executado pelo bootloader com a opção init=/etc/preinit (em vez do init=/sbin/init usual). Assim, o Kernel executa /etc/preinit. Process.boot</td> + </tr> + <tr> + <td>/etc/profile</td> + <td></td> + </tr> + <tr> + <td>/etc/protocols</td> + <td></td> + </tr> + <tr> + <td>/etc/rc.common</td> + <td>Parte do Shebang (Unix) de muitos scripts shell em /etc/init.d. Verifica os scripts iniciais por erros. Por exemplo, desde R27797 verifica se “start” e “stop” são definidos.</td> + </tr> + <tr> + <td>/etc/rc.local</td> + <td>Este ficheiro é executado pelo /etc/rc.d/S95done em cada arranque. Você deve tratar este arquivo como um script de shell.</td> + </tr> + <tr> + <td>/etc/resolv.conf</td> + <td>Um link simbólico para /tmp/resolv.conf.</td> + </tr> + <tr> + <td>/etc/services</td> + <td></td> + </tr> + <tr> + <td>/etc/shells</td> + <td></td> + </tr> + <tr> + <td>/etc/sysctl.conf</td> + <td>/etc/sysctl.conf é chamado de cada inicialização por /etc/rc.d/S99sysctl.</td> + </tr> + <tr> + <td>/etc/sysupgrade.conf</td> + <td>Este arquivo contém arquivos e diretórios que devem ser preservados durante uma atualização. Sysupgrade</td> + </tr> + <tr> + <td>/etc/TZ</td> + <td>Um link simbólico para /tmp/TZ que está sendo criado e configurado com UCI em /etc/config/system</td> + </tr> + </table> + </section> + <section class="features"> + <h1><a href="#gerenciador-pacotes-opkg" name="gerenciador-pacotes-opkg" title="Gereciador de pacotes">Gerenciador de pacotes opkg</a> <a href="#banner" title="Topo da página">^</a></h1> + <p> + O gerenciador de pacotes do LibreCMC é chamado pelo comando <i>opkg</i> e por meio dele é possível instalar pacotes do seu repositório. Atualmente o repositório contém 2417 pacotes para serem instalados, sendo limitado apenas pelos recursos do seu dispositivo. A seguir comandos mais utilizados. + </p> + <h3>Comandos de manipulação de pacotes</h3> + <p> + Abaixo sequência de comando para obter informações sobre os pacotes. + </p> + <p> + Atualização do repositório: + </p> + <code> + opkg update + </code> + <p> + Atualizar pacote: + </p> + <code> + opkg upgrade <pacote> + </code> + <p> + <strong><i>**nunca atualize muitos bacotes ao mesmo tempo, pois existe change real de bricar o aparelho**</i></strong> + </p> + <p> + Remove pacote: + </p> + <code> + opkg remove <pacote> + </code> + <h3>Comandos para obter informações</h3> + <p> + Abaixo comando para obter informações sobre os pacotes. + </p> + <p> + Listar pacotes disponíveis: + </p> + <code> + opkg list + </code> + <p> + Listar pacotes instalados: + </p> + <code> + opkg list-installed + </code> + <p> + listar pacotes com atualizações: + </p> + <code> + opkg list-upgradable + </code> + <p> + Procurar pacotes a partir do nome ou descrição: + </p> + <code> + opkg find <pacote> + </code> + <p> + Procurar pacotes que tem o arquivo: + </p> + <code> + opkg search <arquivo> + </code> + <p> + Informmação sobre o pacote: + </p> + <code> + opkg info <pacote> + </code> + </section> + <section class="features"> + <h1><a href="#router-hard-reset" name="router-hard-reset" title="router-hard-reset">Router hard reset</a> <a href="#banner" title="Topo da página">^</a></h1> + <h2><a href="#router-hard-reset-fisico" name="router-hard-reset-fisico" title="Hard reset físico">Router hard reset físico</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + Segure o botão de <i>reiniciar</i> até o LED SYS piscar mais rápido. Solte o botão de <i>reiniciar</i> e espere até que o roteador reinicie. + </p> + <h2><a href="#router-hard-reset-ssh" name="router-hard-reset-ssh" title="Hard reset pelo SSH">Router hard reset pelo</a> <a href="#banner" title="Topo da página">^</a></h2> + <p> + Se conecte ao roteador por SSH e execute o comando <i>firstboot</i>: + </p> + <code> + <pre> +ssh root@192.168.10.1 +firstboot + </pre> + </code> + <p> + Também é possível realizar o hard reset pela interface de configuração LuCi. + </p> + </section> + <section class="features"> + <h1><a name="bibliografia"><a href="#bibliografia" title="Bibliografia">Bibliografia</a><a/> <a href="#banner" title="Topo da página">^</a></h1> + <ul> + <li>Página do projeto LibreCMC - <a href="https://librecmc.org/" name="site-do-projeto-librecmc" title="Site do projeto LibreCMC">https://librecmc.org</a></li> + <li>Página da documentação openwrt sobre a interface Luci - <a href="https://openwrt.org/docs/guide-user/luci/start" name="documentacao-luci-openwrt" title="Documentação do projeto openwrt sobre o interface Luci">https://openwrt.org/docs/guide-user/luci/start</a></li> + <li>Wiki do projeto Luci - <a href="https://github.com/openwrt/luci/wiki" name="projto-luci-wiki" title="Wiki do projeto Luci">https://github.com/openwrt/luci/wiki</a></li> + <li>Wiki do projeto OpenWRT para configuração completa - <a href="https://openwrt.org/docs/guide-user/start" name="projeto-openwrt-wiki" title="Wiki do projeto OpenWRT">https://openwrt.org/docs/guide-user/start</a></li> + </ul> + </section> + </body> +</html> |