Una configuración básica de proxy inverso solo requiere tres decisiones, y esta guía te ayuda con cada una: el nombre de host, la ruta y el backend. Una búsqueda de proxy http puede referirse a un proxy directo o inverso; aquí planeas y verificas un servidor que administras tú mismo. El agente nunca decide por ti qué host o ruta es la correcta. Escribe lo que le pides, muestra cada cambio como un diff y reporta el resultado real de cada comando, para que veas el efecto de cada decisión antes de la siguiente. Sigue los cuatro pasos siguientes en orden y trata el plan de enrutamiento como el documento que tú y el agente siguen desde el primer comando hasta la última solicitud.
Inicia Segment Route y abre la carpeta de trabajo que contiene tus archivos de configuración y rutas. Las herramientas de archivos funcionan en esta carpeta, por lo que una carpeta limpia con solo los archivos relevantes para este dominio mantiene los diffs cortos y los resultados de búsqueda legibles. Si tus archivos en vivo están en un servidor que posees, cópialos primero en la carpeta, o elige el entorno SSH para los comandos y mantén el plan en la carpeta.
Pide al agente que escriba routing-plan.txt con tus rutas, tus redirecciones y el código de estado que esperas para cada una. El plan es texto plano, puedes editarlo y es la lista contra la que comparas los resultados reales al final. Asigna una expectativa para cada ruta y cada redirección, para que ninguna regla quede sin verificación. Mantén el archivo corto y legible.
Aprueba el diff para cada regla, luego deja que Shell ejecute tu comando de prueba de configuración antes de cualquier recarga. En modo Ask first, el agente se detiene antes de cada cambio, y la tarjeta de la prueba muestra el código de salida real y la salida completa. Nunca recargues antes de que la prueba haya pasado, y mantén la copia de seguridad del archivo anterior hasta que se confirme el nuevo comportamiento.
Solicita cada dirección con tu comando de solicitud, lee el código de estado y la cabecera Location, y compáralos con tu plan. Si un valor difiere, restaura la copia de seguridad, recarga y cambia una regla nuevamente. Repite hasta que cada expectativa en el plan coincida con el resultado, luego guarda el plan final como un registro de lo que la configuración debería hacer.
.3 archivosroutes.confcargadorouting-plan.txtguardadoyour request commandregistrado# routing plan for my own domain
# one line per rule, written before any change
route 1: host app, path /api, goes to service api
route 2: host app, path /, goes to service web
route 3: host admin, path /, goes to service admin
redirect 1: old page to new page, code 301
redirect 2: www host to bare host, code 301
redirect 3: http to https, code 301
# status to expect after the change
expect 1: app path /api answers with a success code
expect 2: old page answers 301 and gives the new address
# keep the old configuration file as a backup
# end of routing planCada línea es una regla o una expectativa. Escrito primero, el plan te da algo con lo que comparar los códigos de estado reales después de cada cambio, y un cambio que rompa una expectativa es fácil de detectar. Los hosts, las rutas y los servicios son solo ejemplos; reemplázalos con los tuyos y mantén el plan junto a la configuración que describe. La palabra redirect con un código es suficiente para que el agente sepa qué escribir.
Esta guía de autoalojamiento con un servidor de proxy inverso frente a tus servicios comienza buscando dónde viven las reglas. list_dir muestra la carpeta de trabajo, glob enumera los archivos que parecen listas de rutas, y grep los busca por las palabras route y redirect. El resultado es una lista corta con nombres de archivos y números de línea. Nada cambia aún. Selecciona el archivo que contiene las reglas para tu propio dominio, ábrelo con read_file y solicita cada dirección con tu comando de solicitud para anotar el código de estado actual. Revisa la lista en modo Plan only si quieres que el agente proponga el orden de trabajo primero, y guarda las notas junto a tu plan de enrutamiento para que los primeros códigos de estado queden registrados.
Cambia una regla a la vez, porque un diff pequeño es fácil de juzgar. edit_file lee el archivo, propone la nueva línea y muestra un diff con las líneas añadidas y eliminadas. Cuando surge una pregunta sobre una regla de redirección de subdominio, el agente muestra la regla junto al código que debería devolver, y tú decides. En modo Ask first, nada se guarda hasta que aceptes. Auto-run guardaría de inmediato, así que úsalo solo en archivos que puedas restaurar. Guarda el archivo antiguo como copia de seguridad, acepta el diff y pasa al siguiente paso. Rechaza el diff si una línea te sorprende y pide un cambio más pequeño.
Una recarga con un archivo roto puede dejar fuera de servicio un sitio que funciona, así que prueba primero. Shell ejecuta tu comando de prueba de configuración, y el éxito se juzga por el código de salida real: un código que pasa significa que el archivo se analizó correctamente, cualquier otro significa que te quedas con la configuración antigua. La tarjeta se expande para mostrar la salida completa, incluyendo el número de línea de un error. Corrígelo con otro diff pequeño. Después de una prueba exitosa, recarga, solicita la dirección nuevamente y compara los códigos de estado http de la ejecución anterior y la nueva. Revisa la salida tú mismo, ya que una prueba que pasa dice solo que la sintaxis es válida y no que la ruta sea correcta.
Los códigos de estado se agrupan por su primer dígito: 2xx éxito, 3xx redirección, 4xx error del cliente, 5xx error del servidor. Para un proxy, 502 significa una respuesta inválida del backend, 503 significa que el servicio no está disponible, 504 significa que el backend tardó demasiado en responder, y 404 significa no encontrado. http_get obtiene una página de tu propio servicio, y tu comando de solicitud muestra la nueva dirección de una redirección. Si un código difiere de tu plan, restaura el archivo de copia de seguridad, recarga y prueba nuevamente. Luego cambia el plan o la regla y repite, una regla por ronda. Un plan de enrutamiento corto y un archivo de copia de seguridad son todo el retroceso que necesitas.
