10 · Troubleshooting

Los fallos más frecuentes, con su causa y solución. Guárdatelo: viniendo de Windows, el 90% de las dudas caen en esta lista.

Comandos de diagnóstico rápido

# Estado general del sistema
uptime
free -h
df -h
lsblk -f

# Servicios caídos
systemctl --failed

# Logs recientes con errores
journalctl -p 3 -xb

# Procesos y recursos
htop

# Consumo del journal
journalctl --disk-usage

Errores de servicios

Síntoma: servicio en failed

Diagnóstico:

systemctl status mi-servicio
journalctl -u mi-servicio -n 50

Causas más comunes:

Síntoma: "command not found" al arrancar el script, pero a mano funciona

Systemd arranca con un PATH mínimo. Los comandos del usuario no están disponibles.

Solución: usa rutas absolutas en el script (/usr/bin/echo) o define Environment=PATH=/usr/local/sbin:/usr/local/bin:/usr/bin dentro del [Service].

Errores de pacman

Conflicting files

Un archivo que iba a instalar el paquete ya existe fuera de pacman. El mensaje te dice qué archivo. Muévelo o bórralo y reintenta.

invalid or corrupted package / error de firma

sudo pacman -Scc                # limpiar caché
sudo pacman -Sy archlinux-keyring   # refrescar llavero
sudo pacman -Syu                # volver a intentar

Sistema roto tras actualización

En CachyOS tienes snapshots con Btrfs configurados. Reinicia, entra al menú de arranque y selecciona un snapshot anterior al desastre. Luego actualiza de nuevo con más calma.

Errores de NTFS

Disco monta solo lectura (ro)

Windows lo dejó "sucio" por Fast Startup o Hibernación.

  1. En Windows, Panel de control → Opciones de energía → desactivar Inicio rápido.
  2. Apaga Windows desde Apagar (no reinicies desde hibernar).
  3. Vuelve a CachyOS y monta.

Como alternativa, si no puedes volver a Windows:

sudo pacman -S ntfs-3g
sudo ntfsfix /dev/sda1

Advertencia: ntfsfix no repara todo, solo limpia el flag.

mount: wrong fs type, bad option, bad superblock

Revisa el UUID: sudo blkid. Comprueba que el fstab tiene el mismo UUID exacto (sin espacios, sin comillas mal puestas).

El sistema no arranca tras editar fstab

  1. Arranca con un USB live o desde un snapshot.
  2. Monta la raíz y edita /etc/fstab. Añade nofail a las líneas conflictivas.
  3. Alternativamente, restaura desde /etc/fstab.bak que hiciste antes.

Permisos

Permission denied al ejecutar script

chmod +x script.sh
./script.sh

"Operation not permitted" con sudo

Algunos archivos tienen el atributo immutable. Revísalo con lsattr archivo. Si tiene una i:

sudo chattr -i archivo

Red

Sin conexión tras suspender

sudo systemctl restart NetworkManager

Si es recurrente, revisa los logs:

journalctl -u NetworkManager -b | tail -50

Espacio en disco

"No space left on device" pero df -h no lo muestra

Puede haber inodos agotados:

df -i

O archivos borrados aún abiertos por un proceso:

sudo lsof | grep deleted

Limpiar espacio rápido

# Caché de pacman
sudo pacman -Sc

# Logs de systemd
sudo journalctl --vacuum-time=7d
sudo journalctl --vacuum-size=200M

# Papelera
rm -rf ~/.local/share/Trash/files/*

# Caché de tu usuario (yay/paru)
paru -Sc

Comandos de emergencia

# ¿Qué está ocupando el disco?
sudo du -h --max-depth=1 / 2>/dev/null | sort -h
ncdu                          # interfaz interactiva, instalar con pacman

# ¿Qué proceso está usando el puerto 8000?
sudo ss -tlnp | grep :8000

# ¿Qué tarda más en arrancar?
systemd-analyze
systemd-analyze blame | head -20

# Estado del hardware
inxi -Fxz                     # instalar: sudo pacman -S inxi

Regla de oro

Ante cualquier error: lee el mensaje completo. Linux es mucho más explícito que Windows. El 80% de los fallos se resuelven leyendo las 5 primeras líneas del error. Y siempre: journalctl es tu Visor de Eventos.
Anterior← Limpieza