MikroTik

How to Configure Auto Script on MikroTik: Complete Tutorial

O Auto Script no Mikrotik é uma funcionalidade poderosa que permite automatizar tarefas administrativas, como reinicializações programadas, atualizações de configuração e monitoramento contínuo de serviços. Com o Auto Script, você pode agendar a execução de scripts em horários específicos ou em intervalos regulares, simplificando a gestão da sua rede. Neste tutorial, você aprenderá como configurar o Auto Script no Mikrotik para automatizar processos e otimizar a administração da sua rede.

Prerequisites for Configuring Auto Script on MikroTik

Antes de começar, verifique se você possui os seguintes itens:
  • Acesso ao dispositivo Mikrotik (via Winbox ou CLI).
  • Basic knowledge of script usage on MikroTik.

1. Accessing MikroTik

Para configurar o Auto Script, você precisará acessar o seu dispositivo Mikrotik:
  • Via Winbox: Baixe e execute o Winbox. Conecte-se ao seu Mikrotik usando o endereço IP ou MAC.
  • Via CLI: Use um terminal SSH para se conectar ao Mikrotik com seu nome de usuário e senha.

2. Creating the Script on MikroTik

O primeiro passo é criar o script que você deseja automatizar. Um script pode ser usado para diversas finalidades, como configurar interfaces de rede, realizar backups ou monitorar serviços.
  1. No menu System, clique em Scripts.
  2. Clique em Add para criar um novo script.
  3. No campo Name, insira o nome do script (por exemplo, "Reiniciar_Roteador").
  4. No campo Source, insira o código do script. Aqui está um exemplo de um script simples para reiniciar o roteador:
    /system reboot
  5. Clique em OK para salvar o script.

CLI command example:

RouterOS
/system script add name="Reiniciar_Roteador" source="/system reboot"

3. Creating the Auto Script Task

Agora que você criou o script, é hora de configurar o Auto Script para executá-lo automaticamente em horários ou intervalos definidos:
  1. No menu System, clique em Scheduler.
  2. Clique em Add para criar uma nova tarefa agendada.
  3. Set the task name (for example, "Restart_Router_Daily").
  4. No campo Start Time, defina o horário em que o script será executado pela primeira vez (por exemplo, 00:00 para meia-noite).
  5. No campo Interval, defina o intervalo em que o script será repetido (por exemplo, 1d para executá-lo todos os dias).
  6. No campo On Event, insira o comando para rodar o script (por exemplo,
    RouterOS
    /system script run Reiniciar_Roteador
    ).
  7. Clique em OK para salvar a tarefa.

CLI command example to schedule the script:

RouterOS
/system scheduler add name="Reiniciar_Roteador_Dia" start-time=00:00 interval=1d on-event="/system script run Reiniciar_Roteador"

4. Testing the Auto Script

Após configurar o Auto Script, é importante testar se ele está funcionando corretamente. Para isso, você pode monitorar a execução do script e verificar se a tarefa agendada está sendo executada corretamente.
  1. Check the MikroTik log to confirm that the script ran at the scheduled time.
  2. No menu System, clique em Log e filtre as entradas para visualizar os eventos relacionados ao script agendado.
  3. Verify that the desired behavior (such as restarting the router or performing another task) was carried out correctly.

CLI command example to view the log:

RouterOS
/log print where message~"Reiniciar_Roteador"

5. Monitoring and Editing the Auto Script

Você pode monitorar e editar as tarefas do Auto Script a qualquer momento para ajustá-las conforme necessário. Se você deseja editar um script ou tarefa agendada:
  1. No menu System > Scheduler, localize a tarefa agendada.
  2. Selecione a tarefa e clique em Edit para modificar os parâmetros ou o comando do script.
  3. If necessary, change the execution time or the repeat interval.

CLI command example to edit the scheduled task:

RouterOS
/system scheduler set "Reiniciar_Roteador_Dia" start-time=02:00 interval=2d

6. Using Advanced Scripts for Automation

Para aumentar a complexidade e a funcionalidade dos scripts, você pode adicionar condições, loops e outras estruturas de controle, como:
  1. Condicionais:
    bash
    :if ( < 100000) do={/system reboot}
    Este script reinicia o Mikrotik se a memória disponível for inferior a 100 MB.
  2. Laços:
    :for i from=1 to=10 do={/interface print}
    Este script imprime informações sobre as interfaces 10 vezes.
  3. Execução de múltiplos comandos:
    /interface disable ether1 /interface enable ether2

CLI command example with conditional logic:

RouterOS
/system script add name="Verificar_Memoria" source="
<div>&nbsp;</div>
( &lt; 100000) do={/system reboot}"
/system scheduler add name="Verificar_Memoria_Auto" start-time=00:00 interval=1h on-event="/system script run Verificar_Memoria"

7. Disabling or Deleting the Auto Script

Se você precisar desabilitar ou excluir um Auto Script configurado:
  1. No menu System > Scheduler, selecione a tarefa agendada.
  2. Clique em Disable para desabilitar a execução do script ou Remove para excluí-la completamente.

CLI command example to disable a task:

RouterOS
/system scheduler set "Reiniciar_Roteador_Dia" disabled=yes

Conclusion on Auto Script Configuration on MikroTik

O Auto Script no Mikrotik é uma maneira poderosa de automatizar processos e melhorar a gestão da rede. Com a configuração adequada, você pode agendar tarefas rotineiras, como reinicializações, verificações de status e atualizações de configuração, tornando a administração da rede mais eficiente e menos propensa a erros. Gostou deste tutorial? Confira nossos outros guias sobre configuração de redes no Mikrotik e otimize sua segurança e conectividade!