Linux Ninja: Server Mastery

01. File System Ninja

graph LR Root("/") --> User("~/home/ubuntu") User --> Projects("📂 proyectos/") subgraph "Active Zones" Projects --> Banda("banda-live") Projects --> Batuta("batuta-live") Projects --> Galeria("galeria-live") end Root --> Var("/var/www/") Var --> Html("html/") Html --> Static("📂 _static (Ninja Portal)") style Projects fill:#F87316,stroke:#333,color:black style Static fill:#00F2FF,stroke:#333,color:black

> `ls -lah` (The Truth)

Muestra TODO, incluyendo ocultos y tamaños humanos.

ls -lah | grep ".env"

> `cat` (Quick Peek)

Lectura rápida sin editor. Ideal para comprobar configs.

cat .env | grep DB_PASSWORD

> `tail -f` (The Pulse)

Ver los logs en tiempo real mientras usas la App.

tail -f storage/logs/laravel.log

02. Permissions (Gatekeeper)

La causa #1 de "No funciona".

`chmod +x`	Hacer ejecutable (scripts)
`chmod 775`	Correcto (User/Group Write)
`chmod 777`	⚠️ PELIGRO (Todo el mundo escribe)
`chown`	Cambiar dueño (ubuntu:ubuntu)

03. Search & Destroy

> `find` (The Hunter)

Encuentra archivos gigantes comiendo disco.

find . -size +100M

> `grep` (The Detective)

Busca texto DENTRO de los archivos.

grep -r "error" storage/logs/

04. Artisan Blacksmith

Herramientas específicas de Laravel para forjar código.

> Mantenimiento

php artisan optimize:clear

Borra cachés rebeldes. Úsalo cuando cambies el .env.

> Base de Datos

php artisan migrate:status

Consulta qué migraciones faltan.

> Tinker (REPL)

php artisan tinker

Consola interactiva PHP. Prueba modelos: User::first();

05. Docker Ops

`docker exec` (Infiltration)

docker exec -it [container_name] sh

Entra en Matrix para ejecutar comandos internos.

`docker system prune -a` (Cleanup)

docker system prune -a

Recupera espacio borrando imágenes no usadas.

06. Troubleshooting Logic

graph TD Start(Site is Down 502/Error) --> Step1{Check Google Shield} Step1 -->|Shield Error?| FixShield(Fix Nginx Proxy Manager) Step1 -->|Shield OK?| Step2{Check Tunnel} Step2 -->|Tunnel Down?| FixTS(Restart Tailscale) Step2 -->|Tunnel OK?| Step3{Check Oracle Container} Step3 -->|Container Stopped?| Up(docker-compose up -d) Step3 -->|Container Running?| Logs(docker-compose logs -f) Logs -->|DB Connection?| FixEnv(Check .env DB_HOST) Logs -->|PHP Crash?| FixCode(Check Laravel Code) style Start fill:#F80000,stroke:#333,color:white,rx:10 style Logs fill:#F87316,stroke:#333,color:white,rx:10

07. Emergency Cheatsheet (Oh Sh*t)

🔥 Git Permissions Loop

Problema: Git dice que el archivo cambió solo por permisos.

git update-index --chmod=+x script.sh

🔥 Detached HEAD

Problema: Estás en el limbo tras un checkout.

git branch save-me
git checkout main
git merge save-me

🔥 n8n Login Loop

Problema: No puedes entrar a n8n por error de proxy.

Añade a docker-compose: N8N_PROXY_HOPS=1