Docs/ Operaciones/ Administrador de archivos

Administrador de archivos

Explora y administra archivos dentro de tus contenedores con un explorador visual de archivos. Visualiza, edita, sube y descarga archivos sin abrir una terminal.

Explorar archivos del contenedor

El administrador de archivos proporciona una interfaz visual al sistema de archivos dentro de cualquier contenedor en ejecución. Accede a él desde la página de detalle del servicio haciendo clic en la pestaña Archivos.

  1. Navega a tu servicio dentro de su stack.
  2. Haz clic en la pestaña Archivos.
  3. El explorador de archivos se abre en el directorio raíz del contenedor (/).
File manager main view -- showing a directory listing with file names, sizes, modification dates, and permission indicators

La lista de archivos muestra la siguiente información para cada entrada:

  • Nombre -- Nombre del archivo o directorio, con íconos que distinguen archivos de carpetas.
  • Tamaño -- Tamaño del archivo en formato legible (KB, MB, GB).
  • Modificado -- Marca de tiempo de la última modificación.
  • Permisos -- Permisos Unix mostrados como cadena (por ejemplo, rwxr-xr-x).
  • Propietario -- Propietario y grupo del archivo.

Haz clic en el nombre de cualquier directorio para entrar en él. La ruta de migas de pan en la parte superior muestra tu ubicación actual y te permite saltar a cualquier directorio padre.

Breadcrumb navigation -- showing path segments / > app > src > routes with each segment clickable

También puedes escribir una ruta directamente en la barra de ruta para saltar a un directorio específico. Presiona Enter para navegar.

Tip
Rutas comunes para revisar: /app (código de la aplicación), /var/log (registros), /etc (configuración) y /tmp (archivos temporales).

Ver contenido de archivos

Haz clic en cualquier archivo para abrirlo en el visor integrado. El visor admite resaltado de sintaxis para tipos de archivos comunes:

  • Archivos de código fuente (JavaScript, Python, Ruby, Go, Rust, PHP, etc.)
  • Archivos de configuración (JSON, YAML, TOML, INI, XML)
  • Texto plano y archivos de registro
  • Scripts de shell
  • Dockerfiles y archivos docker-compose
File viewer -- showing a package.json file with syntax highlighting and line numbers
Note
Los archivos binarios (imágenes, binarios compilados, archivos comprimidos) no se pueden mostrar en el visor. Puedes descargarlos en su lugar.

Editar archivos

El administrador de archivos incluye un editor integrado para hacer cambios rápidos en archivos. Haz clic en el botón Editar al ver un archivo para cambiar al modo de edición.

  1. Abre un archivo en el visor.
  2. Haz clic en Editar en la esquina superior derecha.
  3. Realiza tus cambios en el editor.
  4. Haz clic en Guardar para escribir los cambios en el contenedor.
File editor -- showing an editable text area with syntax highlighting, a Save button, and a Discard button
Warning
Las ediciones de archivos se escriben directamente en el sistema de archivos del contenedor. Si el archivo no está en un volumen montado, los cambios se perderán cuando el contenedor se reinicie o se redespliegue. Para cambios permanentes, actualiza tu código fuente y redespliega.

Subir archivos

Sube archivos desde tu máquina local al contenedor. Esto es útil para transferir archivos de configuración, certificados, archivos de datos o recursos.

  1. Navega al directorio de destino en el administrador de archivos.
  2. Haz clic en el botón Subir.
  3. Selecciona uno o más archivos de tu máquina (o arrástralos y suéltalos en la lista de archivos).
  4. Los archivos se suben y aparecen en el directorio.
File upload dialog -- showing a drag-and-drop zone and a file picker button with upload progress indicators
Note
El tamaño máximo de carga es 100 MB por archivo. Para archivos más grandes, usa la Terminal con wget o curl para descargar archivos directamente en el contenedor.

Descargar archivos

Descarga archivos del contenedor a tu máquina local. Haz clic derecho en un archivo (o usa el menú de acciones) y selecciona Descargar.

También puedes descargar directorios completos como un archivo .tar.gz. Esto es útil para descargar directorios de registros, archivos de respaldo o datos de la aplicación.

File context menu -- showing options for Download, Rename, Copy path, and Delete

Permisos de archivos

El administrador de archivos muestra los permisos Unix de cada archivo y directorio. Puedes modificar los permisos a través del panel de propiedades:

  1. Haz clic derecho en un archivo y selecciona Propiedades.
  2. Ve o modifica el modo de permisos (por ejemplo, 644, 755).
  3. Haz clic en Aplicar para actualizar los permisos.
Common permission patterns
644  - Owner read/write, group/others read-only (files)
755  - Owner full, group/others read+execute (directories, scripts)
600  - Owner read/write only (private keys, secrets)
777  - Full access for everyone (avoid this in production)

Archivos persistentes vs. efímeros

Es fundamental entender qué archivos persisten a través de los reinicios del contenedor:

Tipo¿Sobrevive al reinicio?Ejemplos
Volúmenes montadosDatos de base de datos, archivos subidos, configuración persistente
Sistema de archivos del contenedorNoCódigo de la aplicación, archivos temporales, registros (a menos que estén montados en volumen)
Tip
En el administrador de archivos, los directorios respaldados por un volumen están marcados con un ícono de volumen. Esto facilita distinguir qué rutas persistirán entre reinicios.