systemctl é a ferramenta do systemd para controlar serviços Linux e, por SSH, funciona exatamente como numa consola local. systemctl status mostra o estado e os registos recentes, e restart para e volta a arrancar um serviço. enable --now arranca-o e ativa-o no arranque do sistema, daemon-reload recarrega os ficheiros de unidade editados e is-active devolve um estado fácil de usar em scripts.

Comandos essenciais do systemctl para gerir um serviço por SSH

sudo systemctl start nginx arranca o serviço e sudo systemctl stop nginx para-o. Consultas como status, is-active e is-enabled funcionam sem sudo, embora um utilizador sem privilégios possa não ver as linhas de registo. Estes comandos cobrem quase todo o trabalho diário com uma unidade:

systemctl status nginx
sudo systemctl start nginx
sudo systemctl stop nginx
sudo systemctl restart nginx
sudo systemctl reload nginx
sudo systemctl enable --now nginx
sudo systemctl disable --now nginx
sudo systemctl daemon-reload
systemctl is-active nginx
systemctl is-enabled nginx
systemctl list-units --type=service --state=failed

Pode omitir o sufixo .service do nome da unidade. Confirme, no entanto, o nome do próprio servidor SSH: no Debian e no Ubuntu a unidade chama-se normalmente ssh, enquanto outras distribuições usam sshd. Todos os subcomandos e opções estão documentados na página de manual do systemctl.

systemctl status: ler o estado de um serviço remoto

systemctl status nginx reúne em poucas linhas o que precisa para um diagnóstico:

  • Loaded: o caminho do ficheiro de unidade e se está enabled ou disabled no arranque.
  • Active: active (running), inactive (dead) ou failed, e quando mudou pela última vez.
  • Main PID e a árvore de processos: que processos pertencem ao serviço.
  • Linhas recentes do journal: quando um serviço não consegue arrancar, o erro costuma estar aqui.

Quando a saída é maior do que o ecrã, status abre um paginador do qual se sai com q. A opção --no-pager dispensa o paginador e -l (ou --full) impede que as linhas sejam truncadas. Se essas linhas não bastarem, journalctl -u nginx -n 50 --no-pager dá mais contexto. journalctl -u nginx -f segue o registo em tempo real até premir Ctrl+C. Os filtros por tempo e prioridade estão na página de manual do journalctl.

systemctl restart, reload e enable --now: quando usar cada um

  1. restart para o serviço e volta a arrancá-lo, cortando todas as ligações geridas pelo processo.
  2. reload pede ao serviço que volte a ler a configuração sem parar. Só funciona se a unidade definir como; caso contrário, devolve um erro.
  3. reload-or-restart recarrega quando a unidade o suporta e reinicia quando não suporta.
  4. enable --now ativa o serviço no arranque e arranca-o de imediato. O enable simples não arranca nada até ao próximo arranque do sistema.
  5. disable --now faz o contrário: retira o serviço do arranque e para-o.

Antes de reiniciar o servidor SSH através do qual está ligado, valide a configuração com sudo sshd -t. O comando mostra qualquer erro de sintaxe e termina com um código diferente de zero. Mantenha uma segunda sessão aberta até confirmar que consegue voltar a entrar pela porta TCP 22 ou pela porta que utilizar.

systemctl daemon-reload depois de editar um ficheiro .service

sudo systemctl daemon-reload faz com que o systemd volte a ler os ficheiros de unidade. Sem ele, as alterações a um ficheiro .service não são aplicadas, e status avisa que a unidade mudou no disco. A sequência habitual é esta:

sudo nano /etc/systemd/system/myapp.service
sudo systemctl daemon-reload
sudo systemctl restart myapp
systemctl status myapp --no-pager -l

daemon-reload não reinicia nenhum serviço; apenas recarrega a configuração do gestor. É o restart seguinte que faz o processo correr com a nova definição.

systemctl is-active em scripts e verificações rápidas

systemctl is-active mostra o estado da unidade (active, inactive, failed…) e termina com o código 0 apenas quando a unidade está ativa. Isso permite usá-lo diretamente em condicionais. Com --quiet não imprime nada e só conta o código de saída:

systemctl is-active --quiet nginx && echo 'nginx OK' || sudo systemctl restart nginx
systemctl is-failed --quiet myapp && journalctl -u myapp -n 20 --no-pager

is-enabled segue a mesma lógica para o estado no arranque. is-failed deteta unidades que falharam, que também aparecem em systemctl list-units --type=service --state=failed.

systemctl no telemóvel versus no computador: o que muda

systemctl comporta-se da mesma forma em qualquer cliente SSH. No telemóvel, as diferenças vêm do acesso às teclas e da estabilidade da ligação:

Tarefa com systemctlTelemóvel (iOS/Android)Computador
Sair do paginador ou de journalctl -fRequer Ctrl e Esc, que o teclado do sistema escondeCtrl e Esc sempre no teclado físico
Percorrer registos longosPgUp/PgDn só se o cliente os disponibilizarTeclas físicas PgUp/PgDn
Ligação durante um reinício demoradoPassar do wifi para dados móveis corta o SSH; o Mosh mantém a sessãoRede normalmente estável
Editar um ficheiro .serviceEditor no terminal, ou SFTP para descarregar e carregarEditor local ou remoto

O termi1, um terminal móvel SSH e Mosh, acrescenta um teclado próprio com Esc, Ctrl, Tab, setas e uma camada fn com PgUp/PgDn, Home e End. O Mosh mantém a sessão ativa quando passa do wifi para dados móveis, e o tmux conserva o que deixou a correr. O SFTP integrado permite consultar um ficheiro .service sem sair da sessão. A IA escreve o comando no prompt sem premir Enter, e o modo «Review» nunca o executa. Nas ligações marcadas como produção, o Production Guard garante que nada recebe Enter automaticamente. Também retém tudo o que pare ou altere algo, como systemctl stop, antes de chegar ao prompt. Pode obter o termi1 na App Store ou no Google Play.

Perguntas frequentes

Qual é a diferença entre systemctl restart e systemctl reload?

systemctl restart para o serviço e volta a arrancá-lo, cortando as ligações geridas pelo seu processo. systemctl reload apenas pede ao serviço que volte a ler a configuração sem parar. Só funciona quando a unidade define uma ação de reload; reload-or-restart escolhe automaticamente a opção certa.

Quando preciso de executar systemctl daemon-reload?

Precisa de executar systemctl daemon-reload depois de criar, editar ou eliminar um ficheiro de unidade, por exemplo em /etc/systemd/system. Recarrega a configuração do systemd sem reiniciar nenhum serviço, por isso continua a precisar de um restart para que o processo aplique as alterações.

Reiniciar o serviço ssh com systemctl corta a minha sessão SSH?

Reiniciar o serviço ssh com systemctl normalmente mantém as sessões abertas a funcionar, porque cada ligação tem o seu próprio processo. O risco está nas novas ligações: se a configuração tiver erros, o serviço não volta a arrancar. Valide primeiro com sudo sshd -t e mantenha uma segunda sessão aberta.

Como verifico num script se um serviço systemd está ativo?

Um script verifica se um serviço systemd está ativo com systemctl is-active --quiet name. O comando termina com o código 0 quando a unidade está ativa e com outro código caso contrário, sem imprimir nada. Pode encadeá-lo com && ou ||, ou usá-lo dentro de um if.