Tutoriales de VPS
Tareas en una VPS: cron, systemd timer, registros y copias seguras
Configura horarios cron y temporizadores systemd con zonas, rutas, registros y bloqueos explícitos. Gestiona ejecuciones perdidas, alertas y fallos, y programa copias, rotación, contenedores y WordPress.

Copias de bases de datos, retención de registros, sincronización y renovación de certificados necesitan un programador observable. Linux suele ofrecer cron y temporizadores systemd. Esta guía trata la configuración; para una tarea existente que falla, consulta la lista de diagnóstico.
| Necesidad | cron | systemd timer |
|---|---|---|
| Configuración | Una línea de horario | Servicio y temporizador |
| Sintaxis | Cinco campos | Expresiones de calendario o monotónicas |
| Registros | Redirección o correo configurado | Salida del servicio en journal |
| Ejecuciones perdidas | Normalmente se omiten | Puede recuperar una con Persistent=true |
| Solapamiento | Necesita bloqueo compartido | No inicia otra instancia del mismo servicio activo |
| Dependencias | Las gestiona el trabajo | Orden/requisitos como After= y Requires= |
| Precisión | Minutos, sin garantía de tiempo real | Ventana predeterminada normalmente de un minuto |
| Contenedores | Requiere proceso programador | Requiere un entorno systemd adecuado |
- Tareas periódicas sencillas: cron suele bastar.
- Journal, dependencias o recuperación de horarios: considera un timer.
- Equipos apagados con frecuencia:
Persistent=trueayuda con eventos de calendario según su configuración. - Contenedores: usa el host con
docker exec, un programador de la aplicación o un contenedor de trabajo dedicado.
Elige según fiabilidad, no por llamar «moderno» a un sistema. cron dentro de un contenedor gestionado es posible, pero exige diseñar procesos, señales y registros.
┌─── 分钟 (0-59)
│ ┌─── 小时 (0-23)
│ │ ┌─── 日期 (1-31)
│ │ │ ┌─── 月份 (1-12)
│ │ │ │ ┌─── 星期 (0-7,0 和 7 都是周日)
│ │ │ │ │
* * * * * 要执行的命令
Son minuto 0–59, hora 0–23, día del mes 1–31, mes 1–12 y día semanal 0–7; 0 y 7 normalmente representan domingo. En una tabla de usuario sigue el comando.
| Expresión | Horario según la zona del programador |
|---|---|
0 3 * * * | Cada día a las 03:00 |
*/15 * * * * | Cada 15 minutos |
0 */6 * * * | 00:00, 06:00, 12:00 y 18:00 |
30 2 * * 0 | Domingo a las 02:30 |
0 4 1 * * | Día 1 a las 04:00 |
0 9-18 * * 1-5 | Cada hora de 09:00 a 18:00, laborables |
15 2 * * 1,3,5 | Lunes, miércoles y viernes a las 02:15 |
Atajos habituales:
@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 es un disparador de arranque, no un supervisor ni una garantía de dependencias. El comportamiento al reiniciar el daemon cambia según implementación. Para mantener aplicaciones funcionando utiliza un servicio; consulta systemd.
En cron de estilo Vixie, cuando ambos campos están restringidos, basta que coincida uno:
0 0 13 * 5 # 每月 13 号执行,「或者」每周五执行
Esa línea ilustrativa no incluye comando y no es una entrada ejecutable completa. Para exigir día 13 y viernes, compruébalo en el trabajo:
0 0 13 * * [ "$(date +\%u)" = "5" ] && /srv/scripts/task.sh
En crontab necesita el escape \%. Verifica la semántica de tu programador antes de aplicarla a cualquier sistema parecido a cron.
% sin escapar termina el segmento del comando y convierte el texto posterior en entrada estándar. Este ejemplo es intencionadamente incorrecto:
# ❌ 错误:% 被当成换行符,命令会被截断
0 3 * * * tar czf /backup/$(date +%F).tar.gz /srv/app
Utiliza \%:
# ✅ 正确
0 3 * * * tar czf /backup/$(date +\%F).tar.gz /srv/app
Suele ser más claro guardar la lógica en un script y programarlo. % dentro del script no necesita escape específico de cron. Las comillas de shell por sí solas no eliminan esa interpretación.
cron no carga tu shell SSH interactiva. PATH puede ser /usr/bin:/bin, causando command not found aunque funcione en la 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 配置,最不稳)
Usa rutas absolutas verificadas; which docker o command -v docker localizan el ejecutable. También puedes definir PATH. Cargar perfiles interactivos es frágil, especialmente con nvm/pyenv. Establece directorio de trabajo y variables necesarias, y lee secretos de una fuente protegida.
Algunas instalaciones envían salida por correo si hay transporte configurado; sin él puede descartarse o registrarse como no entregable. El correo local puede acumularse en /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
2>&1 debe ir después de >> para copiar la salida ya redirigida. 2>&1 >> file conserva primero el destino antiguo y deja los errores en otro lugar. Guardar solo errores puede ser deliberado; descartar todo oculta fallos. Comprueba escritura del usuario y rotación.
crontab -e # 编辑当前用户的
crontab -l # 查看
crontab -r # 删除全部(危险,没有二次确认)
sudo crontab -e # 编辑 root 的
sudo crontab -u www-data -e # 编辑指定用户的
crontab -r puede borrar toda la tabla sin la confirmación esperada. Guarda antes con crontab -l > ~/crontab.bak. crontab -e y sudo crontab -e editan usuarios distintos.
Las tablas de sistema tienen otro formato:
# /etc/cron.d/backup —— 注意这里多一个「用户」字段
0 3 * * * root /srv/scripts/backup.sh >> /var/log/backup.log 2>&1
En /etc/cron.d/ se añade usuario después del horario; mediante crontab -e no. Revisa propietario root, convenciones de nombres y salto de línea final exigidos por tu implementación.
.service define el trabajo; .timer cuándo se dispara. Servicio de ejemplo en /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
Utiliza mínimos privilegios. El orden de red solo ayuda si participa el servicio apropiado de espera de red; las dependencias reales necesitan reintentos limitados.
Temporizador en /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
Activa:
sudo systemctl daemon-reload
sudo systemctl enable --now backup.timer
Habilita .timer, no .service como trabajo de arranque. El nombre emparejado suele seleccionar el servicio; Unit= puede elegir otro.
La notación original 星期 年-月-日 时:分:秒 significa día semanal, año-mes-día y hora:minuto:segundo; el día semanal es opcional.
| Expresión | Significado |
|---|---|
*-*-* 03:00:00 | Diario a las 03:00 |
*-*-* *:00:00 | Cada hora |
*-*-* *:00/15:00 | Cada 15 minutos |
Mon *-*-* 02:30:00 | Lunes a las 02:30 |
*-*-01 04:00:00 | Día 1 a las 04:00 |
Mon..Fri *-*-* 09:00:00 | Laborables a las 09:00 |
*-01,04,07,10-01 00:00:00 | Primer día de cada trimestre |
| Atajo | Expresión 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 |
Valida los siguientes horarios:
systemd-analyze calendar "Mon..Fri *-*-* 09:00:00" --iterations=3
Comprueba zona y cambio de hora estacional: una expresión válida puede representar la hora de negocio equivocada.
Persistent=trueguarda el estado de disparadores de calendario. Puede recuperar una ejecución perdida al activar, no repetir cada intervalo omitido. Puede aplicarse el retraso aleatorio.RandomizedDelaySec=300añade hasta 300 segundos para repartir la carga.AccuracySec=suele tener una ventana inicial de un minuto para agrupar despertares. Puedes reducirla:
[Timer]
OnCalendar=*-*-* 03:00:00
AccuracySec=1s
AccuracySec=1s no garantiza tiempo real: carga, sincronización del reloj y otros retrasos siguen importando.
# 列出所有定时器,包括下次触发时间和上次执行时间
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 muestra NEXT y LAST, pero una fecha de disparo no prueba éxito del trabajo. Revisa salida y estado del servicio. Iniciar manualmente ejecuta el trabajo real; prueba con datos apropiados.
#!/usr/bin/env bash
set -euo pipefail
-etermina ante ciertos fallos no gestionados, con excepciones de contexto y condiciones.-urechaza variables no definidas involuntariamente.-o pipefailhace que falle una tubería si falla una etapa.
Sin ello, mysqldump puede fallar y gzip crear un archivo comprimido vacío que parece válido. Estas opciones ayudan, pero no sustituyen comprobaciones, traps y restauración. El ejemplo usa Bash; no todos los /bin/sh admiten pipefail.
# ❌ 依赖当前目录和 PATH
cd app && ./backup.sh
# ✅
cd /srv/app || exit 1
/usr/bin/mysqldump ...
Los puntos suspensivos son marcadores, no argumentos ejecutables. Define cuenta, credenciales, destino y permisos reales.
Dos rsync escribiendo el mismo destino pueden interferir. En cron usa un flock compartido:
*/5 * * * * /usr/bin/flock -n /tmp/sync.lock /srv/scripts/sync.sh
-n termina si no obtiene el bloqueo. Prefiere una ruta protegida propia a un nombre previsible en /tmp compartido. Todos los puntos de entrada deben usar el mismo bloqueo. Depende de descriptores abiertos, no de la existencia del archivo; procesos descendientes pueden mantenerlo si heredan esos descriptores.
Un timer no inicia otra copia del mismo servicio activo. No mandes el trabajo al segundo plano y termines enseguida, ni supongas exclusión entre servicios distintos. Un disparo omitido no se encola necesariamente.
log() { echo "[$(date '+%F %T')] $*"; }
log "backup started"
# ... 实际工作
log "backup finished, size=$(du -h "$DEST" | cut -f1)"
Define DEST y diferencia inicio intentado de finalización correcta. Registra duración y resultados sin secretos.
Ilustración de webhook del 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
# ... 实际工作
En trap ... ERR, captura primero el código de fallo antes de hostname, curl u otros comandos y consérvalo al terminar. Considera set -E cuando necesites heredar ERR y comprende sus excepciones. Limita tiempos de conexión/total y codifica correctamente el mensaje. || true impide que el fallo de la notificación sustituya al fallo original; no debe ocultar el del backup.
Usa Telegram, Slack, una herramienta regional u otro webhook expresamente configurado según tus operaciones. Un monitor como healthchecks.io detecta también ausencia de señales esperadas, incluso si el trabajo nunca se disparó. Protege sus URLs como credenciales.
#!/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
Configura credenciales protegidas. --single-transaction ayuda con tablas transaccionales compatibles; no garantiza todos los motores ni cambios de esquema simultáneos. [ -s ... ] solo comprueba tamaño comprimido no nulo: un gzip vacío puede pasar. Conserva el estado de la tubería, verifica con gzip -t, inspecciona el volcado y restaura antes de retirar copias buenas. Un fallo de permisos de mysqldump debe detener la limpieza.
El ejemplo retiene archivos de 14 días según antigüedad de modificación; revisa redondeo de find y limita ruta/patrón. Guarda copia externa cifrada mediante transferencia de archivos y prueba recuperación. Copias locales ayudan con ciertos errores, pero no sobreviven pérdida del host o cuenta.
# 每周日清理 30 天前的日志
0 4 * * 0 find /var/log/myapp -name '*.log' -mtime +30 -delete
Revisa los archivos seleccionados antes de borrar logs con la antigüedad de 30 días indicada. No borres indiscriminadamente un archivo abierto por el servicio.
# /etc/logrotate.d/myapp
/var/log/myapp/*.log {
daily
rotate 14
compress
delaycompress
missingok
notifempty
create 0640 www-data adm
}
logrotate comprime y conserva generaciones. Comprueba usuario/grupo y reapertura del log por la aplicación. Verifica el programador ya instalado antes de duplicarlo. Los logs Docker necesitan política propia; consulta uso de disco Docker.
systemctl list-timers | grep certbot
sudo certbot renew --dry-run
Muchos paquetes Certbot instalan timer o cron, pero nombres y método dependen de paquete/snap/contenedor. Compruébalo antes de duplicar. renew --dry-run prueba contra un servicio de pruebas y los hooks pueden comportarse de forma específica; monitoriza también el vencimiento real. Consulta renovación.
Desde el host:
0 3 * * * /usr/bin/docker exec myapp-container /app/scripts/task.sh >> /var/log/task.log 2>&1
Verifica nombre, ruta, disponibilidad y código de retorno. docker compose run --rm permite un contenedor de un solo trabajo. Un programador interno también es posible si gestionas ciclo de vida, registros y solapamiento.
¿Cómo localizar un horario 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
Nombres cron/crond y registros varían. Relaciona disparo, usuario y salida del script; consulta diagnóstico.
¿Por qué difiere varias horas?
timedatectl # 看当前时区
sudo timedatectl set-timezone Asia/Shanghai
El comando original establece Asia/Shanghai: es un ejemplo regional, no la zona exigida a lectores internacionales. Elige tu zona IANA o UTC y recalcula horarios. Verifica soporte de zona por tabla y cambios estacionales. sudo systemctl restart cron puede ser necesario en ciertas implementaciones tras cambiar la zona; revisa daemon y trabajos activos. Consulta sincronización del reloj.
¿Cada 30 segundos?
# 用 sleep 错开(粗糙但能用)
* * * * * /srv/scripts/task.sh
* * * * * sleep 30; /srv/scripts/task.sh
Dos entradas con sleep son aproximadas y necesitan bloqueo compartido. Un timer puede usar OnUnitActiveSec=30s con AccuracySec=1s y un disparo inicial. Para intervalo desde la finalización, considera OnUnitInactiveSec. Una aplicación permanente puede encajar mejor.
¿Si tarda más que el intervalo? cron puede lanzar otra copia sin flock. El timer no duplica su servicio activo; vigila duración y horarios omitidos.
¿Cómo detener temporalmente?
# cron:注释掉那一行
crontab -e
# systemd
sudo systemctl stop backup.timer # 停止(重启后会恢复)
sudo systemctl disable backup.timer # 彻底禁用
Parar el timer no termina un trabajo que ya corre. disable evita activación automática, pero no para un timer activo sin --now. Comprueba ambos servicios.
¿Programador real para WordPress? wp-cron depende de solicitudes y puede retrasarse sin tráfico. Puedes sustituirlo 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
Usa la URL real y verifica invocación y registro de fallos antes de desactivar el disparo web. WP-CLI protegido es otra alternativa. Consulta rendimiento WordPress.
¿Varias máquinas? Versiona scripts y definiciones sin secretos, e importa el archivo correcto con crontab file. Con más equipos, ayuda la gestión de configuración. No publiques credenciales ni tokens de monitorización.
¿Hace falta root? Utiliza mínimos permisos. Una cuenta puede copiar sus propios archivos; escribir en /var/log o gestionar servicios puede requerir privilegios delegados limitados. Consulta seguridad VPS.
- Prueba como usuario real;
bash -x script.shpuede revelar secretos al trazar. - Rutas y directorio de trabajo explícitos.
- Revisa
set -euo pipefaily controles de fallo. - Guarda salida en vez de descartar todo con
> /dev/null 2>&1. - Registros rotados y limitados.
-
flocko bloqueo/unidad apropiados. - Zona y reloj comprobados con
timedatectl. - Revisa
systemctl list-timersy observa un ciclo real. - Detecta fallos y ausencia de ejecuciones.
- Restaura una copia representativa.