freebucks-proxy
freebucks-proxy es un gateway en Go que actúa como proxy para endpoints de modelos de IA compatibles con OpenAI y Anthropic, implementando pools de tokens, ciclo de vida de sesiones, ocultamiento TLS y una interfaz administrativa integrada.
Ficha actualizada 22 sept 2026, 21:52 · upstream 22 sept 2026, 21:42 · release v1.18.1
Qué es freebucks-proxy
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
freebucks-proxy es un servicio en Go que se posiciona como un gateway multipunto (multi-account) compatible con protocolos de chat de OpenAI y Anthropic. Su arquitectura permite gestionar múltiples cuentas mediante pools de tokens, manejar el ciclo de vida de sesiones, implementar ocultamiento TLS para evitar advertencias del navegador y ofrecer una interfaz administrativa integrada basada en Svelte. El servicio no incluye anuncios ni CLI, sino que se enfoca exclusivamente en la API /v1/chat/completions.
- Gestionar múltiples cuentas de usuarios con diferentes tokens de acceso a modelos de IA
- Implementar ocultamiento TLS para evitar advertencias del navegador (X-Frame-Options)
- Proveer un dashboard administrativo integrado sin necesidad de interfaces externas
- Automatizar el ciclo de vida de sesiones mediante pools de tokens y gestión de créditos
- Servir como gateway único que traduce entre protocolos OpenAI, Anthropic y wire protocol del upstream
- Implementar métricas de uso por IP, sesión y día para la facturación o control de costos
- Soporta múltiples modelos compatibles con OpenAI (chat completions) y Anthropic sin necesidad de cambiar el endpoint
- Mecanismo de pooling de tokens que permite escalar horizontalmente según demanda
- Dashboard administrativo Svelte integrado directamente en la imagen del binario, eliminando dependencias externas
- Gestión de créditos basada en precios del upstream con facturación por sesión y refresco diario automático
- Soporte para múltiples modos operativos: pool (solo tokens), bridge (token por petición) y híbrido (combinado)
- Persistencia de configuración mediante SQLite con migraciones automáticas entre actualizaciones
- La persistencia de configuración se realiza en un archivo SQLite local, lo que puede generar problemas de compatibilidad si el volumen cambia de ubicación
- El modo 'bridge' no permite persistencia de tokens entre sesiones, por lo que cada petición requiere un token nuevo
- El sistema no incluye autenticación de usuarios con credenciales externas (API Keys), solo tokens globales en pools o bridge
- La facturación se basa en créditos del upstream y no tiene mecanismos de facturación interna
- No existe limitación de tasa por IP ni rate limiting configurable, lo que puede ser un riesgo de saturación
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar freebucks-proxy, se recomienda usar Docker Compose con el comando `docker compose up -d`. Se debe editar `.env` para configurar AUTH_TOKENS, ADMIN_TOKEN y credenciales. Antes de ejecutar, se debe realizar una copia de seguridad del estado (`scripts/backup-state.sh`). El servicio se ejecuta en modo de background (no requiere terminal), pero la interfaz administrativa está disponible en `/admin`. Para actualizaciones seguras, se recomienda detener el servicio con `docker compose stop`, ejecutar `scripts/backup-state.sh` y luego `docker compose up -d --build`. Se recomienda pinear la versión del Docker Image a un tag específico para garantizar consistencia entre entornos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.