Como instalar Netbox, ferramenta grátis para documentar sua rede


Netbox é um aplicativo web de código aberto projetado para ajudar a gerenciar e documentar redes de computadores. Concebido inicialmente pela equipe de engenharia de rede da DigitalOcean , o NetBox foi desenvolvido especificamente para atender às necessidades dos engenheiros de rede e infraestrutura. Abrange os seguintes aspectos de gerenciamento de rede:

Gerenciamento de endereço IP (IPAM) – redes e endereços IP, VRFs e VLANs

  • Racks de equipamentos – organizados por grupo e local
  • Dispositivos – Tipos de dispositivos e onde estão instalados
  • Conexões – Rede, console e conexões de energia entre dispositivos
  • Virtualização – máquinas virtuais e clusters
  • Circuitos de dados – circuitos e provedores de comunicações de longa distância
  • Segredos – armazenamento criptografado de credenciais confidenciais

Requisitos:
Como de costume vou realizar a instalação no Debian 10 limpo (sem pacotes extras)
Vire root da forma correta, colocando após os su o “-“.

Instale os pacotes que serão requisitos.

Vire o usuário postgres, para poder criar nosso banco de dados.

Entre no terminal de comandos do postgres

Não esqueça de alterar a senha.

Verifique ser o serviço redis esta respondendo.

Deve retornar : PONG
Retorne ao usuario root

Atualize o pip

Agora vamos baixar o projeto NetBox. Verifique em https://github.com/netbox-community/netbox/releases não existe uma nova versão.
Entre em tmp (diretório temporário do linux que após um reboot é apagado) em seguida fizemos o download, extraímos, movemos para o diretório correto bem como ajustamos permissões do diretório que faremos upload de arquivos.

Execute o comando abaixo para gerar nossa SECRET KEY que iremos usar em seguida.

Ex.:

Copie o arquivo de configuração exemplo para ajustar com suas infomações

Localize as linhas como exemplo abaixo e altere os valores.

Instalaremos os pacotes do py requeiridos.

Vamos a instalção do bichão!

Crie seu usuário para o acesso web:

Vamos preparar nosso serviço web

Caso você não queira ter certificado e nem vai usar um domínio pode pular esta parte…
Vou instalar o letsencrypt para gerar nosso certificado (pode preencher como quiser as perguntas). Caso queira instalar com um certificado “privado/invalido” veja aqui.

Crie um script para renomar o certificado automaticamente

Adicione:

Altere as permissões para executa-lo e adicione o scrip ao cron para ser rodado todo dia 1º do mês.

Removemos o arquivo defautl do nosso servidor web (nginx), e iremos criar um novo, estou usando um domínio, caso esteja utilizando com IP privado apenas coloque um underline ou sei próprio IP.

Ajuste o diretório do seu certificado.

Ou a versão simplificada sem certificado, usando o seu endereço IP, se ainda assim deseja só usar o domínios basta colocar no lugar no IP.

Remova assinatura do nginx (ninguém precisa saber a versão!)

Verifique se seu arquivo de configuração do nginx está correto:

Crie o atalho do arquivo de configuração dentro do diretório enabled para que o mesmo seja carregado ao restart o nginx.

Agora acesse seu domínios “https://netbox.remontti.com.br/” ou “https://ip/” e entre com sua senha criada anteriormente.

🙂

PLUGINs

Netbox Topology Views

https://github.com/mattieserver/netbox-topology-views

Netbox QR Code

https://github.com/k01ek/netbox-qrcode

Adicione:

Copiamos os arquivos empacotados estáticos e reiniciamos o supervisor (netbox).

COMO ATUALIZAR PARA FUTURAS VERSÕES

Procure pela ultima atualização: https://github.com/netbox-community/netbox/releases, e copie a url da versão tar.gz, no exemplo estou atualizando para versão 2.10.8, então preste atenção no nome dos diretórios.
Vou baixar e extrair:

Copie os arquivos de configuração para a versão mais nova, preste atenção nos nomes de diretórios que contém a versãi no ex. “2.10.8” para a versão que esteja atualizando.

Copie os arquivos que você enviou, exemplo fotos etc.

Além disso, certifique-se de copiar ou vincular quaisquer scripts e relatórios personalizados que você fez.

Renomeia o antigo diretório (Não vamos remover, pois se der ruim basta volta-lo)

Movemos nosso diretório atualizado para /opt/netbox.

Finalizamos copiando os arquivos empacotados estáticos e reiniciamos o supervisor (netbox).

Espero que tenha gostado!

Se quiser fazer uma doação para o café ficarei muito feliz pelo seu reconhecimento!

Participe do canal no telegram para ficar atualizado sempre que publicar um novo tutorial.

Se não puder doar pode deixar seu agradecimento nos comentário também ficarei feliz em saber que ajudei. Se tiver qualquer pergunta deixe-a também. Se preferir entrar em Contato clique aqui.

Fonte:
https://netbox.readthedocs.io/en/stable/installation

Rudimar Remontti

Trabalho atualmente como Gerente de Redes em um Provedor de Internet no Rio Grande do Sul.

Você pode gostar...

14 Resultados

  1. Fábio Sosnoski disse:

    Instalei em uma VM só pra testar a ferramenta, sem certificado, sem erros durante o processo, inclusive os plugins. Mas após o primeiro login ele dá um erro 403 e quer um certificado…

  2. Felipe Victor disse:

    Não estou conseguindo instalar os pacotes está dando os seguintes erros:

    apt install vim net-tools wget redis-server supervisor\
    > postgresql-contrib postgresql libpq-dev gcc\
    > python-minimal python3 python3-pip python3-venv\
    > python3-dev build-essential libxml2-dev libxslt1-dev\
    > libffi-dev libssl-dev zlib1g-dev graphviz\
    > nginx redis python3-setuptools
    Lendo listas de pacotes… Pronto
    Construindo árvore de dependências
    Lendo informação de estado… Pronto
    E: Impossível encontrar o pacote supervisorpostgresql-contrib
    E: Impossível encontrar o pacote gccpython-minimal
    E: Impossível encontrar o pacote python3-venvpython3-dev
    E: Impossível encontrar o pacote libxslt1-devlibffi-dev
    E: Impossível encontrar o pacote graphviznginx

  3. Eder Cas disse:

    No comando para gerar a SECRET_KEY gera esse erro:

  4. Antenor Valentim disse:

    Parabens Pelo Tutorial….. Tudo 100%…. Muito Obrigado mesmo, agora com a chegada do IPv6… vai ser de grande valia.

  5. Albuquerque disse:

    Boa noite!

    Parabéns pelo excelente material para estudos e aplicação desta ferramenta.

    Minha dúvida mesmo seguindo tutorial arrisca apresentou o seguinte erro. Alguém poderia me ajudar . Abaixo os erros.
    root@srv-netbox:/opt/netbox/netbox# python3 manage.py migrate
    Traceback (most recent call last):
    File “manage.py”, line 10, in
    execute_from_command_line(sys.argv)
    File “/usr/local/lib/python3.7/dist-packages/django/core/management/__init__.py”, line 401, in execute_from_command_line
    utility.execute()
    File “/usr/local/lib/python3.7/dist-packages/django/core/management/__init__.py”, line 395, in execute
    self.fetch_command(subcommand).run_from_argv(self.argv)
    File “/usr/local/lib/python3.7/dist-packages/django/core/management/base.py”, line 330, in run_from_argv
    self.execute(*args, **cmd_options)
    File “/usr/local/lib/python3.7/dist-packages/django/core/management/base.py”, line 371, in execute
    output = self.handle(*args, **options)
    File “/usr/local/lib/python3.7/dist-packages/django/core/management/base.py”, line 82, in wrapped
    saved_locale = translation.get_language()
    File “/usr/local/lib/python3.7/dist-packages/django/utils/translation/__init__.py”, line 254, in get_language
    return _trans.get_language()
    File “/usr/local/lib/python3.7/dist-packages/django/utils/translation/__init__.py”, line 57, in __getattr__
    if settings.USE_I18N:
    File “/usr/local/lib/python3.7/dist-packages/django/conf/__init__.py”, line 82, in __getattr__
    self._setup(name)
    File “/usr/local/lib/python3.7/dist-packages/django/conf/__init__.py”, line 69, in _setup
    self._wrapped = Settings(settings_module)
    File “/usr/local/lib/python3.7/dist-packages/django/conf/__init__.py”, line 189, in __init__
    raise ImproperlyConfigured(“The SECRET_KEY setting must not be empty.”)
    django.core.exceptions.ImproperlyConfigured: The SECRET_KEY setting must not be empty.

  6. Claudio P. Costa - IndioX disse:

    Mano vc ouviu eu falando alto aqui em casa kkkk!
    Essa semana tava seguindo uns artigos defasados e comentei “pô no Remontti poderia ter um artigo resumindo a instalação… ” tive que refazer a instalação e seguir a doc oficial pois tinha mudanças nas releases mais recente… qdo terminei e coloquei no ar, no dia seguinte vc me publica o artigo! kkkk

  7. ANDRE CARLOS GROTH disse:

    Parabéns pelo conteúdo, vou usar pra documentar a rede na empresa.

  8. Delvan disse:

    Uma dúvida…
    Qual seria a melhor opção? phpIPAM ou Netbox?

  9. Rafael Barboza disse:

    Muito bom Rudimar!
    Já utilizo a algum tempo, realmente salva quando não se tem nada.
    Uma pergunta, tentei por algumas vezes adicionar os Plugins Netbox-QRcode e Netbox-Topology-Viewer e sempre dão erro. Existe algum segredo para tal?

  1. 5 de abril de 2022

    […] Como instalar Netbox, ferramenta grátis para documentar sua … […]

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *