Tutoriais de VPS
Tarefas na VPS: cron, systemd timer, logs e backups seguros
Configure cron e timers systemd com fusos, caminhos, logs e locks explícitos. Gerencie execuções perdidas, alertas e falhas e agende backups, rotação, contêineres e WordPress.

Backups de bancos, retenção de logs, sincronização e renovação de certificados precisam de um agendador observável. Linux costuma oferecer cron e timers do systemd. Este guia trata da configuração; para uma tarefa existente que falha, consulte a lista de diagnóstico.
| Necessidade | cron | systemd timer |
|---|---|---|
| Configuração | Uma linha de horário | Serviço e timer |
| Sintaxe | Cinco campos | Expressões de calendário ou monotônicas |
| Logs | Redirecionamento ou e-mail configurado | Saída do serviço no journal |
| Execuções perdidas | Normalmente ignoradas | Pode recuperar uma com Persistent=true |
| Sobreposição | Exige lock compartilhado | Não inicia outra instância do mesmo serviço ativo |
| Dependências | Geridas pelo trabalho | Ordem/requisitos como After= e Requires= |
| Precisão | Minutos, sem garantia de tempo real | Janela padrão geralmente de um minuto |
| Contêineres | Exige processo agendador | Exige ambiente systemd apropriado |
- Trabalhos periódicos simples: cron costuma bastar.
- Journal, dependências e recuperação de horários: considere timer.
- Máquinas frequentemente desligadas:
Persistent=trueajuda em eventos de calendário conforme a configuração. - Contêineres: use o host com
docker exec, agendador da aplicação ou contêiner dedicado ao trabalho.
Escolha pela confiabilidade necessária. cron dentro de um contêiner gerenciado é possível, mas exige desenhar processos, sinais e logs.
┌─── 分钟 (0-59)
│ ┌─── 小时 (0-23)
│ │ ┌─── 日期 (1-31)
│ │ │ ┌─── 月份 (1-12)
│ │ │ │ ┌─── 星期 (0-7,0 和 7 都是周日)
│ │ │ │ │
* * * * * 要执行的命令
São minuto 0–59, hora 0–23, dia do mês 1–31, mês 1–12 e dia semanal 0–7; 0 e 7 normalmente representam domingo. Em crontab de usuário, depois vem o comando.
| Expressão | Horário no fuso do agendador |
|---|---|
0 3 * * * | Todo dia às 03:00 |
*/15 * * * * | A cada 15 minutos |
0 */6 * * * | 00:00, 06:00, 12:00 e 18:00 |
30 2 * * 0 | Domingo às 02:30 |
0 4 1 * * | Dia 1 às 04:00 |
0 9-18 * * 1-5 | A cada hora de 09:00 a 18:00, dias úteis |
15 2 * * 1,3,5 | Segunda, quarta e sexta às 02:15 |
Atalhos comuns:
@daily /srv/scripts/backup.sh # 等于 0 0 * * *
@hourly /srv/scripts/sync.sh # 等于 0 * * * *
@weekly /srv/scripts/cleanup.sh # 等于 0 0 * * 0
@reboot /srv/scripts/startup.sh # 开机后执行一次
@reboot é um disparo de inicialização, não um supervisor nem garantia de dependências. O comportamento ao reiniciar o daemon varia por implementação. Para manter uma aplicação ativa, use serviço; veja systemd.
No cron de estilo Vixie, com ambos os campos restritos, basta um deles corresponder:
0 0 13 * 5 # 每月 13 号执行,「或者」每周五执行
A linha ilustrativa não tem comando e não é uma entrada completa executável. Para exigir dia 13 e sexta-feira, teste o dia semanal no trabalho:
0 0 13 * * [ "$(date +\%u)" = "5" ] && /srv/scripts/task.sh
O escape \% é necessário no crontab. Confira a semântica do seu agendador antes de generalizar para qualquer sistema semelhante.
% sem escape termina o segmento de comando e transforma o restante em entrada padrão. Este exemplo é intencionalmente errado:
# ❌ 错误:% 被当成换行符,命令会被截断
0 3 * * * tar czf /backup/$(date +%F).tar.gz /srv/app
Use \%:
# ✅ 正确
0 3 * * * tar czf /backup/$(date +\%F).tar.gz /srv/app
É geralmente mais claro guardar a lógica em um script e agendá-lo. % no script não exige escape específico de cron. Aspas do shell, sozinhas, não removem essa interpretação.
cron não carrega seu shell SSH interativo. PATH pode ser /usr/bin:/bin, gerando command not found embora funcione no terminal.
# 1. 脚本里用绝对路径(最稳)
/usr/bin/docker compose -f /srv/app/compose.yml up -d
# 2. crontab 顶部设 PATH
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
0 3 * * * docker compose -f /srv/app/compose.yml up -d
# 3. 脚本开头 source 环境(依赖 shell 配置,最不稳)
Use caminhos absolutos verificados; which docker ou command -v docker localizam o executável. Definir PATH também é possível. Carregar perfis interativos é frágil, especialmente com nvm/pyenv. Defina diretório de trabalho e variáveis necessárias e leia segredos de uma fonte protegida.
Algumas instalações enviam saída por e-mail se houver transporte configurado; sem ele, ela pode ser descartada ou registrada como não entregável. E-mail local pode acumular em /var/mail/.
# ✅ 正常输出和错误都写进日志
0 3 * * * /srv/scripts/backup.sh >> /var/log/backup.log 2>&1
# 只要错误,成功时不记
0 3 * * * /srv/scripts/backup.sh > /dev/null
# ❌ 全部丢弃 —— 出错了你永远不知道
0 3 * * * /srv/scripts/backup.sh > /dev/null 2>&1
Coloque 2>&1 depois de >> para stderr seguir o stdout já redirecionado. 2>&1 >> file copia primeiro o destino antigo e deixa erros em outro lugar. Guardar só erros pode ser intencional; descartar tudo esconde falhas. Confira permissão de escrita e rotação.
crontab -e # 编辑当前用户的
crontab -l # 查看
crontab -r # 删除全部(危险,没有二次确认)
sudo crontab -e # 编辑 root 的
sudo crontab -u www-data -e # 编辑指定用户的
crontab -r pode apagar a tabela inteira sem a confirmação esperada. Salve antes com crontab -l > ~/crontab.bak. crontab -e e sudo crontab -e editam usuários distintos.
Arquivos de sistema usam outro formato:
# /etc/cron.d/backup —— 注意这里多一个「用户」字段
0 3 * * * root /srv/scripts/backup.sh >> /var/log/backup.log 2>&1
Em /etc/cron.d/, acrescente usuário após o horário; em crontab -e, não. Confira propriedade root, nomes aceitos e newline final exigidos pela implementação.
.service define o trabalho; .timer define o disparo. Serviço de exemplo em /etc/systemd/system/backup.service:
[Unit]
Description=Daily backup job
After=network-online.target
Wants=network-online.target
[Service]
Type=oneshot
User=root
ExecStart=/srv/scripts/backup.sh
Use o mínimo de privilégios. A ordem de rede só ajuda se o serviço apropriado de espera participa; dependências reais ainda precisam de tentativas limitadas.
Timer em /etc/systemd/system/backup.timer:
[Unit]
Description=Run backup daily at 3am
[Timer]
OnCalendar=*-*-* 03:00:00
Persistent=true
RandomizedDelaySec=300
[Install]
WantedBy=timers.target
Ative:
sudo systemctl daemon-reload
sudo systemctl enable --now backup.timer
Habilite .timer, não .service como trabalho de boot. O nome correspondente normalmente seleciona o serviço; Unit= pode escolher outro.
A notação original 星期 年-月-日 时:分:秒 significa dia semanal, ano-mês-dia e hora:minuto:segundo; o dia semanal é opcional.
| Expressão | Significado |
|---|---|
*-*-* 03:00:00 | Diário às 03:00 |
*-*-* *:00:00 | A cada hora |
*-*-* *:00/15:00 | A cada 15 minutos |
Mon *-*-* 02:30:00 | Segunda às 02:30 |
*-*-01 04:00:00 | Dia 1 às 04:00 |
Mon..Fri *-*-* 09:00:00 | Dias úteis às 09:00 |
*-01,04,07,10-01 00:00:00 | Primeiro dia de cada trimestre |
| Atalho | Expressão equivalente |
|---|---|
minutely | *-*-* *:*:00 |
hourly | *-*-* *:00:00 |
daily | *-*-* 00:00:00 |
weekly | Mon *-*-* 00:00:00 |
monthly | *-*-01 00:00:00 |
yearly | *-01-01 00:00:00 |
quarterly | *-01,04,07,10-01 00:00:00 |
Valide os próximos horários:
systemd-analyze calendar "Mon..Fri *-*-* 09:00:00" --iterations=3
Confira fuso e horário de verão quando aplicável: expressão válida pode representar a hora de negócio errada.
Persistent=trueregistra estado de disparos de calendário. Pode recuperar uma execução perdida ao ativar, não reproduzir cada intervalo omitido. O atraso aleatório pode se aplicar.RandomizedDelaySec=300acrescenta até 300 segundos para distribuir carga.AccuracySec=geralmente tem janela padrão de um minuto para agrupar despertares. É possível reduzi-la:
[Timer]
OnCalendar=*-*-* 03:00:00
AccuracySec=1s
AccuracySec=1s não garante tempo real: carga, sincronização do relógio e outros atrasos continuam importantes.
# 列出所有定时器,包括下次触发时间和上次执行时间
systemctl list-timers --all
# 只看某一个
systemctl list-timers backup.timer
# 看执行日志(这是 systemd timer 最大的好处)
journalctl -u backup.service -n 50 --no-pager
# 手动触发一次测试(不用等到点)
sudo systemctl start backup.service
systemctl list-timers mostra NEXT e LAST, mas horário de disparo não comprova sucesso. Confira saída e status do serviço. Iniciar manualmente executa trabalho real; teste com entradas apropriadas.
#!/usr/bin/env bash
set -euo pipefail
-eencerra em certos erros não tratados, com exceções de condição/contexto.-urejeita variáveis indevidamente não definidas.-o pipefailfaz falha de uma etapa afetar o status do pipeline.
Sem tratamento correto, mysqldump falha e gzip cria um arquivo comprimido vazio aparentemente válido. Essas opções ajudam, mas não substituem verificações, traps e restauração. O exemplo usa Bash; nem todo /bin/sh suporta pipefail.
# ❌ 依赖当前目录和 PATH
cd app && ./backup.sh
# ✅
cd /srv/app || exit 1
/usr/bin/mysqldump ...
Reticências são marcadores, não argumentos executáveis. Defina conta, credenciais, destino e permissões reais.
Dois rsync escrevendo no mesmo destino podem conflitar. No cron use um flock compartilhado:
*/5 * * * * /usr/bin/flock -n /tmp/sync.lock /srv/scripts/sync.sh
-n encerra quando não obtém o lock. Prefira caminho protegido próprio a arquivo previsível em /tmp compartilhado. Todos os pontos de entrada devem respeitar o mesmo lock. Ele depende de descritores abertos, não da existência do arquivo; descendentes que herdam descritores podem mantê-lo.
Um timer não inicia outra cópia do mesmo serviço ativo. Não coloque o trabalho em background e encerre cedo, nem suponha exclusão entre serviços distintos. Um disparo ignorado não é necessariamente enfileirado.
log() { echo "[$(date '+%F %T')] $*"; }
log "backup started"
# ... 实际工作
log "backup finished, size=$(du -h "$DEST" | cut -f1)"
Defina DEST e diferencie tentativa de início de conclusão correta. Registre duração e resultados sem segredos.
Ilustração de webhook do original:
#!/usr/bin/env bash
set -euo pipefail
notify_fail() {
curl -fsS -X POST "https://your-webhook-url" \
-d "text=backup.sh 失败,主机 $(hostname),退出码 $?" || true
}
trap notify_fail ERR
# ... 实际工作
Em trap ... ERR, capture o status original antes de hostname, curl e outros comandos e preserve-o ao encerrar. Considere set -E quando precisa herdar ERR e entenda suas exceções. Defina timeouts de conexão/total e codifique corretamente o payload. || true impede a notificação de substituir o erro original; não deve esconder falha do backup.
Use Telegram, Slack, ferramenta regional ou outro webhook explicitamente configurado conforme suas operações. Um monitor como healthchecks.io também detecta ausência dos sinais esperados, incluindo trabalho que nunca disparou. Proteja essas URLs como credenciais.
#!/usr/bin/env bash
# /srv/scripts/backup-db.sh
set -euo pipefail
DEST=/srv/backups
KEEP_DAYS=14
STAMP=$(date +%F-%H%M)
mkdir -p "$DEST"
# --single-transaction 避免锁表
/usr/bin/mysqldump --single-transaction --quick \
--databases myapp \
| gzip > "$DEST/myapp-$STAMP.sql.gz"
# 校验产物不是空的
[ -s "$DEST/myapp-$STAMP.sql.gz" ] || { echo "backup is empty!"; exit 1; }
# 清理超过保留期的旧备份
find "$DEST" -name 'myapp-*.sql.gz' -mtime +$KEEP_DAYS -delete
30 3 * * * /srv/scripts/backup-db.sh >> /var/log/backup-db.log 2>&1
Configure credenciais protegidas. --single-transaction ajuda com tabelas transacionais compatíveis, não garante todos os engines nem alterações simultâneas de esquema. [ -s ... ] só verifica tamanho comprimido não zero: um gzip vazio pode passar. Preserve status do pipeline, valide com gzip -t, inspecione o dump e restaure antes de excluir backups bons. Falha de permissões do mysqldump deve parar a limpeza.
O exemplo retém arquivos de 14 dias pela idade de modificação; confira arredondamento do find e limite caminho/padrão. Guarde cópia externa criptografada usando transferência de arquivos e teste recuperação. Cópias locais ajudam alguns erros, mas não sobrevivem à perda do host/conta.
# 每周日清理 30 天前的日志
0 4 * * 0 find /var/log/myapp -name '*.log' -mtime +30 -delete
Confira a seleção antes de apagar logs com a idade de 30 dias indicada. Evite apagar indiscriminadamente arquivos ainda abertos pelo serviço.
# /etc/logrotate.d/myapp
/var/log/myapp/*.log {
daily
rotate 14
compress
delaycompress
missingok
notifempty
create 0640 www-data adm
}
logrotate comprime e mantém gerações. Confira usuário/grupo e reabertura do log pela aplicação. Verifique o agendador existente antes de duplicar. Logs Docker exigem política própria; veja disco usado pelo Docker.
systemctl list-timers | grep certbot
sudo certbot renew --dry-run
Muitos pacotes Certbot instalam timer ou cron, mas nomes e método variam entre pacote/snap/contêiner. Confira antes de criar outro. renew --dry-run usa serviço de testes e hooks podem ter comportamento específico; monitore também o vencimento real. Veja renovação.
Pelo host:
0 3 * * * /usr/bin/docker exec myapp-container /app/scripts/task.sh >> /var/log/task.log 2>&1
Confira nome, caminho, prontidão e status de saída. docker compose run --rm permite um contêiner de trabalho único. Agendador interno também é possível se ciclo de vida, logs e sobreposição forem geridos deliberadamente.
Como localizar um horário perdido?
# cron 的执行记录
grep CRON /var/log/syslog | tail -20
# 或者(RHEL 系)
sudo journalctl -u crond -n 30
# systemd timer
systemctl list-timers --all
journalctl -u backup.service -n 50
Nomes cron/crond e logs variam. Relacione disparo, usuário e saída do script; veja diagnóstico.
Por que difere várias horas?
timedatectl # 看当前时区
sudo timedatectl set-timezone Asia/Shanghai
O comando original escolhe Asia/Shanghai: é exemplo regional, não o fuso exigido ao leitor internacional. Selecione seu fuso IANA ou UTC e recalcule horários. Confira suporte de fuso por agenda e mudanças sazonais aplicáveis. sudo systemctl restart cron pode ser necessário em algumas implementações após mudar o fuso; revise daemon e trabalhos ativos antes. Veja sincronização do relógio.
A cada 30 segundos?
# 用 sleep 错开(粗糙但能用)
* * * * * /srv/scripts/task.sh
* * * * * sleep 30; /srv/scripts/task.sh
Duas entradas com sleep são aproximadas e precisam de lock compartilhado. Um timer pode usar OnUnitActiveSec=30s com AccuracySec=1s e um disparo inicial. Para intervalo após conclusão, considere OnUnitInactiveSec. Um serviço permanente pode ser mais adequado.
Se durar mais que o intervalo? cron pode iniciar outra cópia sem flock. O timer não duplica o serviço ativo; monitore duração e horários ignorados.
Como pausar?
# cron:注释掉那一行
crontab -e
# systemd
sudo systemctl stop backup.timer # 停止(重启后会恢复)
sudo systemctl disable backup.timer # 彻底禁用
Parar o timer não encerra trabalho já ativo. disable impede ativação automática, mas não para timer ativo sem --now. Confira timer e serviço.
Agendador real para WordPress? wp-cron depende de requisições e pode atrasar sem tráfego. Você pode substituí-lo deliberadamente:
// wp-config.php
define('DISABLE_WP_CRON', true);
*/5 * * * * /usr/bin/curl -fsS "https://example.com/wp-cron.php?doing_wp_cron" > /dev/null
Use a URL real e valide chamada e logs de falha antes de desligar o disparo por visita. Uma agenda WP-CLI protegida é alternativa. Veja desempenho WordPress.
Várias máquinas? Versione scripts e definições sem segredos e importe o arquivo certo com crontab file. Gestão de configuração ajuda ao crescer. Não publique credenciais e tokens de monitoramento.
Precisa de root? Use permissões mínimas. Uma conta pode copiar seus arquivos; escrever em /var/log ou gerir serviços pode exigir privilégios delegados limitados. Veja segurança VPS.
- Teste como usuário real;
bash -x script.shpode expor segredos no rastreamento. - Caminhos e diretório de trabalho explícitos.
- Revise
set -euo pipefaile verificações de falha. - Guarde saída em vez de descartar tudo com
> /dev/null 2>&1. - Logs com rotação e limites.
-
flockou desenho apropriado de lock/unidade. - Fuso e relógio conferidos com
timedatectl. - Confira
systemctl list-timerse observe um ciclo real. - Detecte falhas e execuções ausentes.
- Restaure um backup representativo.