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=failedPode 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á
enabledoudisabledno arranque. - Active:
active (running),inactive (dead)oufailed, 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
- restart para o serviço e volta a arrancá-lo, cortando todas as ligações geridas pelo processo.
- 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.
- reload-or-restart recarrega quando a unidade o suporta e reinicia quando não suporta.
- enable --now ativa o serviço no arranque e arranca-o de imediato. O
enablesimples não arranca nada até ao próximo arranque do sistema. - 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 -ldaemon-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-pageris-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 systemctl | Telemóvel (iOS/Android) | Computador |
|---|---|---|
Sair do paginador ou de journalctl -f | Requer Ctrl e Esc, que o teclado do sistema esconde | Ctrl e Esc sempre no teclado físico |
| Percorrer registos longos | PgUp/PgDn só se o cliente os disponibilizar | Teclas físicas PgUp/PgDn |
| Ligação durante um reinício demorado | Passar do wifi para dados móveis corta o SSH; o Mosh mantém a sessão | Rede normalmente estável |
Editar um ficheiro .service | Editor no terminal, ou SFTP para descarregar e carregar | Editor 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.