.env, Artisan y Terminal
Edite el archivo .env directamente en el navegador en Sitios → .env. Use Ctrl/Cmd+S para guardar.
Instalación en un servidor nuevo
La forma recomendada para arrancar un nuevo servidor Herne es el instalador unificado:
curl -fsSL https://raw.githubusercontent.com/fklavyenet/herne/main/install.sh | sudo bash
Instala la pila de núcleo, escribe el entorno de panel, crea el primer administrador, instala reglas de sudoers, configura nginx, y puede instalar opcionalmente la pila de correo también.
Editor de .env
Vaya a Sitios → .env para editar el archivo de entorno para su aplicación directamente en el navegador. El editor lee y escribe {deploy_path}/.env.
- Pulsa
Ctrl+S(oCmd+Sen macOS) para guardar. - El archivo se escribe de forma atómica y recibe los permisos
640. - Haz clic en Load from .env.example para cargar los valores del archivo de ejemplo si existe.
- Haz clic en Apply Redis defaults para cargar los valores de caché, sesión, cola y conexión que Herne prepara para Redis.
Después de editar .env, ejecutar optimize:clear o reconstruir los caches pertinentes del corredor Artisan para que la aplicación lea los nuevos valores.
Ejecutor de Artisan
Ejecute cualquier comando php artisan desde Sitios → Artisan. Los metacaracteres de shell se eliminan por seguridad. Ve a Sitios → Artisan e introduce un comando sin el prefijo php artisan:
migrate --force
queue:restart
storage:link
key:generate
Por seguridad se eliminan los metacaracteres del intérprete de comandos (&, |, ;, `, $(...), > y <). El resultado se muestra en la misma página.
La página es especialmente útil para acciones comunes de seguimiento como key:generate, storage:link, migraciones y reconstrucción de caché después de la edición .env.
Seguridad de APP_KEY
Las aplicaciones de Laravel necesitan un vacío APP_KEY. Quick Install lo protege y lo genera como parte del flujo de instalación. Para aplicaciones desplegadas manualmente, ejecute:
key:generate
optimize:clear
No cambies APP_KEY en una aplicación de producción existente si desconoces el efecto en las cookies cifradas, las sesiones y los datos cifrados almacenados.
Comando de migración del dominio canónico
Los administradores pueden promover un dominio temporal del sitio al dominio de producción real con el comando canónico de migración. Ejecutar una carrera seca primero:
herne:sites:canonicalize-domain fklavye.webblocksui.com fklavye.net --www-alias --move-files --backup --dry-run
Aplica los cambios solo después de revisar el plan:
herne:sites:canonicalize-domain fklavye.webblocksui.com fklavye.net --www-alias --move-files --backup --force
El comando actualiza el dominio del sitio, slug, alias, metadatos de aplicaciones, URL/nombre ambiental, ruta activa, ruta de copia de seguridad retirada, y configuración Nginx. No debe dejar el antiguo dominio como alias o server_name.
Terminal web
El terminal web (Sitios → Terminal) ejecuta comandos como usuario aislado dentro del directorio de proyecto web_root del sitio. Ir a Sitios → Terminal. Los comandos se ejecutan como un usuario de shell aislado (shell_domainslug) dentro del directorio del proyecto web_rootdel sitio.
Restricciones de seguridad
Las redirecciones de salida (>, >>), la sustitución de comandos ($(), comillas inversas) y las tuberías están bloqueadas en el terminal. Los siguientes están bloqueados:
- Redirección de salida:
>,>> - Sustitución de comandos:
$(...), comillas invertidas - Canalización:
|
La Terminal web tiene un límite de 30 segundos por comando. Las operaciones largas, como ejecutar composer install por primera vez, pueden agotarlo. En ese caso usa Despliegue con el paso de Composer habilitado.
Registros del servidor
Abre Sitios → Registros → Registros del servidor para revisar la salida más reciente del servidor web de este sitio.
- Alterna entre los registros de acceso de Nginx, de errores de Nginx y de PHP-FPM.
- Las 200 líneas más recientes se muestran primero.
- Usa Actualizar para volver a cargar el archivo activo.
- Usa Vaciar para truncar el archivo seleccionado si los permisos del servidor lo permiten.
- La pestaña de PHP-FPM está restringida a administradores.