Estructura inicial funcional con documentación en el README.md de la FastAPI

This commit is contained in:
2026-09-25 11:20:50 -03:00
parent edc71742fa
commit 774e227642
2710 changed files with 1012769 additions and 0 deletions

37
deploy/apache.conf Normal file
View File

@@ -0,0 +1,37 @@
# Apache de la .10 (Admin) como proxy hacia la API en la .34.
# Para Apache en openSUSE Leap 15 (paquete apache2).
#
# 1) Habilitar los módulos:
# sudo a2enmod proxy proxy_http headers
# Guardar este archivo en /etc/apache2/vhosts.d/api-archivos.conf
#
# 2) Pegar el bloque <Location> dentro del VirtualHost donde ya corre el Admin
# (así comparten dominio y certificado SSL), o usar el VirtualHost completo de abajo.
#
# 3) En el .env de la API:
# PUBLIC_BASE_URL=https://midominio.com/api
# DOWNLOAD_MODE=direct
#
# 4) sudo systemctl reload apache2 y probar: https://midominio.com/api/salud
<VirtualHost *:80>
ServerName midominio.com
# En producción usar 443 con SSL (certificados con certbot / Let's Encrypt)
ProxyPreserveHost On
ProxyTimeout 120
<Location "/api/">
ProxyPass "http://192.168.0.34:8000/"
ProxyPassReverse "http://192.168.0.34:8000/"
# Apache agrega X-Forwarded-For solo; esto indica si vino por http o https
RequestHeader set X-Forwarded-Proto "expr=%{REQUEST_SCHEME}"
</Location>
ErrorLog "logs/api_archivos_error.log"
CustomLog "logs/api_archivos_access.log" combined
</VirtualHost>
# Importante: la API tiene que arrancar con --proxy-headers --forwarded-allow-ips <IP de la .10>
# (ya lo hace deploy/linux/api-archivos.service). Sin eso, los logs registran la IP de Apache
# (127.0.0.1) en vez de la IP real del usuario.

35
deploy/nginx.conf Normal file
View File

@@ -0,0 +1,35 @@
# ALTERNATIVA a apache.conf: usar solo si no tienen Apache o si el volumen de
# descargas crece mucho (Nginx entrega los archivos con X-Accel-Redirect).
# Nginx debe correr en el host (no en el contenedor) y leer la misma carpeta que la API.
# Requiere DOWNLOAD_MODE=nginx en el .env
server {
listen 80;
server_name midominio.com;
# En producción: listen 443 ssl; + certificados (Let's Encrypt / certbot)
client_max_body_size 1m;
# Toda la API pasa a FastAPI (uvicorn)
location /api/ {
proxy_pass http://127.0.0.1:8000/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
# Ubicación INTERNA: el navegador no puede entrar directo.
# Solo se usa cuando FastAPI responde con X-Accel-Redirect: /protegido/<ruta>
location /protegido/ {
internal;
alias /srv/archivos_prueba/;
add_header X-Content-Type-Options nosniff;
}
}
# Con esto, en el .env:
# PUBLIC_BASE_URL=https://midominio.com/api
# DOWNLOAD_MODE=nginx
# NGINX_INTERNAL_PREFIX=/protegido/
# El enlace queda: https://midominio.com/api/descargas/15?u=7&exp=...&sig=...