HTTPS automático con Caddy

En esta guía se explica cómo utilizar Caddy, un servidor web potente y fácil de usar, para mejorar la configuración de tu servidor de Outline. Las funciones HTTPS automáticas y la configuración flexible de Caddy la convierten en una opción excelente para ofrecer tu servidor de Outline, especialmente cuando se usa un transporte de WebSocket.

¿Qué es Caddy?

Caddy es un servidor web de software libre conocido por su facilidad de uso, sus HTTPS automáticas y su compatibilidad con varios protocolos. Permite simplificar la configuración de servidores web y ofrece características como las siguientes:

• HTTPS automáticas: Caddy obtiene y renueva automáticamente los certificados TLS para asegurar que las conexiones sean seguras.
• Compatibilidad con HTTP/3: Caddy admite el protocolo HTTP/3 más reciente para proporcionar un tráfico web más rápido y eficiente.
• Ampliable con complementos: Caddy puede ampliarse mediante complementos para admitir diversas funciones, como los proxys inversos y el balanceo de carga.

Paso 1: Requisitos previos

• Descarga e instala xcaddy.

Paso 2: Configuración de tu dominio

Antes de empezar a usar Caddy, comprueba que el nombre de tu dominio se haya configurado correctamente de forma que dirija a la dirección IP de tu servidor.

• Configura registros A o AAAA: inicia sesión en tu proveedor de DNS y configura registros A y AAAA para que tu dominio dirija a las direcciones IPv4 e IPv6 de tu servidor, respectivamente.

• Verifica los registros DNS: verifica que tus registros DNS estén correctamente configurados mediante una búsqueda autorizada:

  curl "https://cloudflare-dns.com/dns-query?name=DOMAIN_NAME&type=A" \
    -H "accept: application/dns-json"
  

Paso 3: Desarrollo y ejecución de una compilación personalizada de Caddy

Si usas xcaddy, puedes desarrollar un binario caddy personalizado que incluya el módulo de servidores principales de Outline y otros módulos de extensiones de servidor necesarios.

xcaddy build \
  # The example uses a YAML config, so include a YAML config adapter module.
  --with github.com/iamd3vil/caddy_yaml_adapter \
  # The Outline core server module.
  --with github.com/Jigsaw-Code/outline-ss-server/outlinecaddy

Paso 4: Configuración y ejecución del servidor Caddy con Outline

Crea un archivo config.yaml con la siguiente configuración:

apps:
  http:
    servers:
      server1:
        listen:
          - ":443"
        routes:
          - match:
            - host:
              - 'DOMAIN_NAME'
            - path:
              - "/TCP_PATH"
            handle:
            - handler: websocket2layer4
              type: stream
              connection_handler: ss1
          - match:
            - host:
              - 'DOMAIN_NAME'
            - path:
              - "/UDP_PATH"
            handle:
              - handler: websocket2layer4
                type: packet
                connection_handler: ss1
  outline:
    shadowsocks:
      replay_history: 10000
    connection_handlers:
      - name: ss1
        handle:
          handler: shadowsocks
          keys:
            - id: user-1
              cipher: chacha20-ietf-poly1305
              secret: SHADOWSOCKS_SECRET

Importante: Mantén el elemento path en secreto para evitar comprobaciones. Este elemento actúa como un endpoint secreto. Se recomienda usar una ruta larga y generada de forma aleatoria.

Esta configuración se corresponde con una estrategia de Shadowsocks a través de WebSockets con un servidor web que escucha en el puerto 443, mientras se acepta el tráfico envuelto de Shadowsocks de TCP y UDP en las rutas TCP_PATH y UDP_PATH, respectivamente.

Ejecuta el servidor de Caddy ampliado con Outline usando la configuración creada:

caddy run --config config.yaml --adapter yaml --watch

Nota: En el ejemplo se usa YAML porque se lee mejor y lo pone más fácil para hacer anotaciones, pero también puedes utilizar JSON (el lenguaje de configuración nativo de Caddy). Si optas por esta última opción, puedes hacer ejecuciones sin la marca --adapter yaml y retirar la dependencia del adaptador de YAML en el paso de desarrollo y ejecución.

Puedes encontrar más configuraciones de ejemplo en nuestro repositorio de GitHub outline-ss-server/outlinecaddy.

Paso 5: Creación de una clave de acceso dinámica

Genera un archivo YAML de clave de acceso de cliente para tus usuarios utilizando el formato de configuración avanzada e incluye los endpoints de WebSocket que has definido previamente del lado del servidor:

transport:
  $type: tcpudp

  tcp:
    $type: shadowsocks

    endpoint:
      $type: websocket
      url: wss://DOMAIN_NAME/TCP_PATH
    cipher: chacha20-ietf-poly1305
    secret: SHADOWSOCKS_SECRET

  udp:
    $type: shadowsocks

    endpoint:
      $type: websocket
      url: wss://DOMAIN_NAME/UDP_PATH
    cipher: chacha20-ietf-poly1305
    secret: SHADOWSOCKS_SECRET

Después de generar el archivo YAML de la clave de acceso dinámica, debes enviárselo a tus usuarios. Puedes alojar el archivo en un servicio de alojamiento web estático o generarlo de forma dinámica. Más información sobre cómo usar claves de acceso dinámicas

Paso 6: Conexión con el cliente de Outline

Utiliza una de las aplicaciones oficiales de cliente de Outline (versiones 1.15.0 y posteriores) y añade la clave de acceso dinámica que acabas de crear como entrada de servidor. Haz clic en Conectar para empezar la tunelización a tu servidor usando la configuración de Shadowsocks a través de Websocket.

Utiliza una herramienta como IPInfo para verificar que tienes acceso a Internet mediante tu servidor de Outline.