Cómo alojar aplicaciones FastAPI en Square Cloud

1. Requisitos previos

Cuenta en Square Cloud: Crea tu cuenta vía Página de Registro (correo o GitHub).
Plan Activo: Es necesario un plan de pago para alojar. Consulta los precios aquí.

2. Configuración de Red

Para que tu API sea accesible externamente, el webserver debe estar configurado para operar en el puerto 80. A diferencia de los entornos locales (donde usamos 8000), Square Cloud utiliza el puerto 80 para el enrutamiento público.

Ejemplo de estructura de código (`app/main.py`)

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"status": "online", "framework": "FastAPI"}

3. Realizando el Deploy

Limpieza del proyecto: Elimina carpetas de caché como __pycache__ o carpetas de entornos virtuales (.venv).
Compresión: Crea un archivo .zip que contenga la carpeta de tu código (ej.: app/) y el archivo requirements.txt.
Upload: En el Dashboard de Square Cloud, sube el archivo .zip.
Publicación Web: Durante el envío, localiza y marca la opción "Publicar en la Web".
Subdominio: Define el nombre de tu subdominio gratuito (ej.: mi-api.squareweb.app).
Comando de inicio para producción: FastAPI ahora cuenta con un comando CLI integrado que facilita la ejecución en producción, garantizando que el servidor utilice los workers de forma eficiente y escuche en el puerto correcto.

En el momento del envío o en tu archivo squarecloud.app, define el comando de inicio como:

python -m fastapi run app/main.py --port 80

run: Comando optimizado para ejecución en producción.
app/main.py: La ruta al archivo donde está tu instancia FastAPI.
--port 80: Define el puerto obligatorio para el funcionamiento en Square Cloud.

5. Dominios personalizados (Plan Standard+)

Si utilizas el plan Standard o superior, puedes configurar un dominio profesional (ej.: api.tudominio.com):

La configuración se hace en la pestaña Network del Dashboard.
El SSL (HTTPS) se genera automáticamente, garantizando que tu API sea segura por defecto.

6. Consejos de rendimiento

Validación automática: FastAPI utiliza Pydantic para la validación de datos. Asegúrate de definir los schemas para ganar rendimiento en la serialización de JSON.
Variables de entorno: Usa la pestaña ENV en el Dashboard para gestionar claves de seguridad y conexiones de base de datos, accediendo a ellas vía os.getenv().
Monitoreo: Sigue los logs en tiempo real desde el Dashboard para verificar la carga de los workers del servidor.

Actualizado el: 13/06/2026

¿Este artículo te resultó útil?

¡Gracias!