Referencia de configuración

Aunque PhanTerm recomienda realizar la gran mayoría del trabajo de gestión a través de su interfaz TUI, todos los datos subyacentes se conservan utilizando texto plano estructurado legible por humanos. Esto facilita a los usuarios avanzados hacer copias de seguridad, usar control de versiones o incluso escribir scripts automatizados externos.

Rutas de archivos de configuración

Todos los datos se almacenan en el directorio de configuración privado del usuario.

Windows: %APPDATA%\phanterm\
Linux/macOS: ~/.config/phanterm/

Lista de archivos principales

Nombre de archivo	Propósito	Descripción del formato
`config.yaml`	Preferencias globales	Contiene configuraciones básicas como región de idioma, interruptor de actualizaciones y límite de concurrencia.
`connections.yaml`	Lista de hosts	El inventario de tus servidores. Los campos confidenciales, como las contraseñas, se mostrarán vacíos o con referencias especiales si dependen del llavero del sistema; de lo contrario, almacenarán el texto encriptado mediante un cifrado robusto AES.
`known_hosts.yaml`	Biblioteca de huellas digitales de confianza	Registra todas las direcciones de host, tipos de algoritmos y huellas digitales SHA-256 que has verificado en el pasado.
`snippets.yaml`	Biblioteca de fragmentos de comandos	Almacena todos los fragmentos de comandos personalizados y los metadatos de las etiquetas.
`master.key`	Clave de respaldo AES	[Alto Secreto] Por favor, guarda este archivo con cuidado y nunca lo incluyas en ningún repositorio de código público.

Personalización de `config.yaml`

config.yaml proporciona el control del comportamiento global de la aplicación. Puedes editar este archivo manualmente para personalizar el comportamiento de PhanTerm. Si el archivo no existe, PhanTerm generará automáticamente un archivo de configuración con valores predeterminados la próxima vez que se inicie.

Configuración de ejemplo

A continuación se muestra una versión de ejemplo típica de config.yaml:

# Configuración del idioma de la interfaz, actualmente admite 'en' (Inglés) y 'zh' (Chino)
locale: "en"

# Canal de actualización automática: 'stable' (versión estable) o 'beta' (versión beta)
update_channel: "stable"

# Comprobar automáticamente actualizaciones al iniciar
check_updates_on_startup: true

# Configuración avanzada de ejecución por lotes paralela Multi-Exec [Pro]
multi_exec:
  # Concurrencia máxima al iniciar conexiones temporales a múltiples servidores guardados (Predeterminado: 10, rango: 1-10)
  temp_connect_concurrency: 10

  # Tiempo de espera máximo para la ejecución de comandos en cada servidor objetivo, en segundos (Predeterminado: 300, equivalente a 5 minutos)
  target_timeout_seconds: 300

Explicación de parámetros configurables

locale: Define el idioma en el que se muestra la interfaz TUI. Si está vacío o el idioma no es compatible, utilizará la interfaz en inglés por defecto.
update_channel y check_updates_on_startup: Controlan cómo la aplicación obtiene las notificaciones de nuevas versiones.
multi_exec: Esta sección se utiliza específicamente para controlar el comportamiento subyacente de la función Multi-Exec. Puedes ajustar temp_connect_concurrency de acuerdo a tu entorno de red para controlar la carga en la creación de conexiones paralelas, o aumentar target_timeout_seconds para permitir que algunos scripts que toman mucho tiempo (como empaquetar archivos grandes o actualizaciones completas del sistema) se completen con éxito sin ser interrumpidos forzosamente.