Instalar Octop en un VPS con Docker Compose
Despliegue Octop v0.9.19 con Docker Compose, usuarios separados, backend compatible con OpenAI y TLS. Evite el instalador curl y fije una etiqueta.
Qué es Octop y por qué alojarlo usted mismo
Octop es un asistente de IA autoalojado para un hogar o un equipo pequeño. La razón para alojar Octop usted mismo en lugar de usar una interfaz de chat sencilla es que mantiene separados a los usuarios. Open WebUI proporciona una interfaz de navegador delante de un modelo y también admite varios usuarios y controles de acceso. Octop combina cuentas con un rol de administrador, un espacio de trabajo privado y un conjunto de credenciales para cada usuario, además de una biblioteca de agentes especializados entre los que cada usuario puede cambiar según la tarea. Esa es la diferencia que permite que un solo VPS atienda a cinco personas en lugar de a una.
El proyecto se encuentra en github.com/TencentCloud/Octop. Es un único proceso que proporciona un panel web, una interfaz de línea de comandos, canales de chat (Feishu, DingTalk, QQ, Discord, WeCom) y tareas programadas. Todo utiliza una única base de datos SQLite en ~/.octop/. Todo lo que sigue se basa en la etiqueta v0.9.19, publicada el 5 August 2026. Si todavía está decidiendo entre plataformas, la comparación de alternativas a Open WebUI que puede ejecutar en un VPS cubre un conjunto más amplio de opciones.
Debe tener algo claro antes de dedicarle una tarde. Cuando se redactó esta guía, Octop era software anterior a la versión 1.0, publicado desde la organización de GitHub de un proveedor. Desde entonces, el proyecto ha etiquetado la versión v1.0.0 el 14 September 2026. A fecha de 20 November 2026, la etiqueta más reciente es v1.0.3b7, publicada el 18 November 2026, y el repositorio tiene alrededor de 12,300 estrellas. La versión estable más reciente sigue siendo v1.0.2, publicada el 18 October 2026. Los pasos siguientes se escribieron para v0.9.19 y no se han vuelto a probar en 1.x. El proyecto cambia rápido, como demuestran los números de versión, y nada de lo que aparece aquí garantiza una ruta de actualización estable. Fije una etiqueta, lea el registro de cambios y mantenga copias de seguridad.
Qué necesita antes de empezar
- Un VPS con Ubuntu 24.04, Docker Engine y el complemento Compose. ¿Es la primera vez que usa Compose? Empiece por Conceptos básicos de Docker Compose para un VPS.
git, porque va a obtener una etiqueta de versión en lugar de descargar una imagen.- Un nombre de dominio que apunte al VPS, porque necesita TLS (seguridad de la capa de transporte) delante del servicio.
- Un backend de modelo compatible con la API de OpenAI: un Ollama local, una puerta de enlace autogestionada o una clave de pago.
Octop consume pocos recursos. Es un proceso de Python y un archivo de SQLite. El consumo principal corresponde al backend del modelo. Si planea ejecutar el modelo en el mismo servidor, dimensione el servidor para el modelo.
Por qué no recomendamos el instalador mediante curl
El README de v0.9.19 comienza con una instalación de una sola línea:
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bashNo recomendamos enviarlo directamente a bash en un servidor importante. El repositorio sí incluye scripts/install.sh, por lo que esa copia tiene historial de git y está cubierta por una etiqueta. La copia que se sirve desde el bucket de Tencent Cloud Object Storage no está fijada por el comando anterior. El bucket puede servir bytes diferentes mañana y el comando seguirá ejecutándolos. Enviar el resultado directamente a bash también significa que la máquina ejecuta el script antes de que haya leído una sola línea.
El instalador también escribe en el host en lugar de usar un contenedor. Usa uv para obtener Python 3.12 y crear un entorno que el gestor de paquetes no conoce, por lo que eliminarlo después requiere trabajo manual.
Hay dos opciones mejores. Obtenga el script, léalo y después ejecútelo; sólo le llevará treinta segundos: curl -fsSL <url> -o install.sh, después less install.sh y después bash install.sh. O use Docker, que es el resto de esta guía. El paquete de PyPI (pip install octop) es al menos un artefacto versionado que puede fijar a una versión concreta.
Implementar Octop con Docker Compose, fijado en v0.9.19
El archivo de Compose incluido en v0.9.19 compila la imagen desde el repositorio. Por tanto, en esta guía fijar una versión significa cambiar a un tag de git. Existen imágenes publicadas. El árbol de v0.9.19 ya incluye un flujo de trabajo docker-publish.yml, añadido en v0.9.8 el 15 de julio de 2026, que compila una imagen y la sube a Docker Hub para cada tag v*. Desde el 20 de octubre de 2026, el proyecto también publica en el registro de contenedores de GitHub (docker pull ghcr.io/tencentcloud/octop:1.0.2). Compilar desde el tag del repositorio clonado sigue siendo un bloqueo de versión más estricto, porque compila exactamente el código que ha revisado en lugar de confiar en un tag del registro. Es un paso adicional respecto a lo que suelen exigir la mayoría de los proyectos autoalojados. Por ejemplo, un espacio de trabajo AFFiNE autoalojado fija un tag de imagen publicado y no compila nada en su VPS. La rutina de clonado, cambio de rama y compilación que se muestra a continuación es la misma que explica la guía de implementación de openGym. Si ya la configuró una vez, la estructura le resultará familiar.
git clone https://github.com/TencentCloud/Octop.git
cd Octop
git checkout v0.9.19Este es el servicio que define el archivo, reducido a las partes relevantes:
services:
octop:
build:
context: ..
dockerfile: docker/Dockerfile
image: octop:latest
container_name: octop
restart: unless-stopped
ports:
- "${OCTOP_PORT:-8088}:${OCTOP_PORT:-8088}"
volumes:
- ${OCTOP_DATA:-~/.octop}:/data/.octop
environment:
- HOME=/data
- OCTOP_BIND_HOST=0.0.0.0
- OCTOP_PORT=${OCTOP_PORT:-8088}
- OCTOP_DEFAULT_PASSWORD=${OCTOP_DEFAULT_PASSWORD:-octop}
- OCTOP_ADMIN_USERNAME=${OCTOP_ADMIN_USERNAME:-admin}
- OPENAI_API_KEY=${OPENAI_API_KEY:-}Observe el bloque build:. image: octop:latest es el nombre de la compilación local, no una referencia a un registro. Por tanto, latest aquí significa lo que haya compilado más recientemente. Establezca la ruta de datos de forma explícita en lugar de dejarla en manos de un valor predeterminado y asigne una contraseña real a la cuenta de administración antes del primer arranque. Coloque esto en docker/.env:
OCTOP_PORT=8088
OCTOP_ADMIN_USERNAME=admin
OCTOP_DEFAULT_PASSWORD=<a long random password>
OCTOP_DATA=/srv/octop-dataHay un error frecuente aquí que conviene destacar. Compose lee docker/.env únicamente para interpolar los marcadores ${...} del archivo YAML. Una clave que añada a ese archivo no llega al contenedor a menos que también aparezca bajo environment: en el archivo de Compose. Añadir OCTOP_ACCESS_TOKEN_TTL sólo a .env no produce ningún efecto, y no se muestra ningún error. La alternativa consiste en escribir las mismas claves en ~/.octop/env dentro del directorio de datos montado. Octop lo carga al arrancar. La guía sobre archivos de entorno y secretos en Docker Compose explica por qué estos dos mecanismos no son equivalentes.
Compile la imagen e inicie el servicio:
docker compose -f docker/docker-compose.yml up -d --build
docker compose -f docker/docker-compose.yml ps
curl http://127.0.0.1:8088/api/healthUna instancia en buen estado responde a la comprobación de estado con un objeto JSON similar a {"ok":true,"started_at":...,"db":...,"users_loaded":0,"agents_running":0}. Si obtiene cualquier otra respuesta, revise docker compose -f docker/docker-compose.yml logs -f octop antes de abrir el navegador.
Ahora asigne un nombre descriptivo a la imagen que acaba de compilar, porque el siguiente --build sobrescribirá octop:latest y no tendrá forma de distinguir ambas imágenes:
docker image tag octop:latest octop:0.9.19En el primer arranque se ejecuta octop init y se escriben las credenciales iniciales en el volumen de datos:
docker exec -it octop cat /data/.octop/credential.txtLos valores predeterminados son admin / octop y se aplican sólo durante la primera inicialización. Esto explica una pregunta frecuente: cambiar OCTOP_DEFAULT_PASSWORD después de que el contenedor se haya iniciado por primera vez no produce ningún efecto, porque la cuenta ya existe. Cambie la contraseña desde el panel de administración.
No publique el puerto 8088
La línea ports: anterior enlaza todas las interfaces del VPS. En cuanto se inicia el contenedor, el panel queda disponible en Internet pública sin cifrado. El valor predeterminado de OCTOP_BIND_HOST de Octop es 127.0.0.1; el archivo Compose lo sobrescribe con 0.0.0.0 porque el proceso debe aceptar tráfico desde fuera de su propio espacio de nombres de red. Esa sobrescritura es correcta. El puerto publicado es lo que expone el servicio.
Edite la línea ports: en docker/docker-compose.yml para que la asignación escuche sólo en loopback:
ports:
- "127.0.0.1:${OCTOP_PORT:-8088}:${OCTOP_PORT:-8088}"No intente corregir esto con un archivo de sobrescritura simple. Compose concatena las listas ports de varios archivos en lugar de reemplazarlas, por lo que termina publicando ambas asignaciones y la segunda no puede enlazarse. Si quiere mantener intacto el archivo ascendente, use la etiqueta !override en la secuencia. Es la forma documentada de reemplazarla en lugar de añadir elementos. La explicación de cómo Compose combina varios archivos cubre el resto de esas reglas de combinación.
Enlazar con loopback también resuelve un problema que, de otro modo, tendría con el firewall. Docker escribe sus reglas de puertos publicados en la tabla nat antes de las cadenas que administra ufw, por lo que ufw deny 8088 no bloquea un puerto de contenedor publicado. En Docker Engine 28.0.0 o posterior, un puerto enlazado a 127.0.0.1 no es accesible desde fuera, independientemente de la configuración de ufw. Por eso esta es la corrección adecuada y no una alternativa de segundo nivel. Las versiones anteriores de Engine permiten que los hosts del mismo segmento L2, como otras máquinas conectadas al switch de su proveedor, accedan a los puertos publicados en localhost. Ejecute docker version y actualice si el servidor informa de una versión inferior a 28.
Coloque TLS delante con un proxy inverso
Caddy es la opción más directa porque solicita el certificado mediante ACME (entorno de gestión automática de certificados) por sí solo y gestiona WebSockets sin configuración adicional:
octop.example.com {
reverse_proxy 127.0.0.1:8088
}nginx requiere más cuidado porque Octop transmite el chat mediante un WebSocket:
server {
listen 443 ssl;
server_name octop.example.com;
ssl_certificate /etc/letsencrypt/live/octop.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/octop.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8088;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
proxy_read_timeout 3600s;
}
}Cada línea cumple una función. El chat usa WS /api/agents/{id}/chat/ws, por lo que nginx debe reenviar las dos cabeceras de actualización y usar HTTP/1.1 hacia el upstream; proxy_http_version 1.1 lo hace explícito y es necesario en versiones de nginx anteriores a 1.29.7. Sin una actualización correcta, el panel se carga con normalidad, pero el chat no puede conectarse; v0.9.19 finaliza el estado de transmisión después de un handshake fallido en lugar de dejar el mensaje bloqueado indefinidamente. proxy_buffering off es importante porque el endpoint de reanudación human-in-the-loop devuelve text/event-stream, y los eventos SSE (server-sent events) retenidos en un búfer del proxy llegan todos juntos al final en lugar de transmitirse progresivamente. proxy_read_timeout cubre los intervalos prolongados sin datos del upstream: el valor predeterminado de 60 segundos puede desconectar el WebSocket y registrar upstream timed out (110: Connection timed out), pero v0.9.19 mantiene en ejecución la tarea del agente después de una desconexión. Una cancelación explícita detiene la tarea.
Cómo funciona la autenticación JWT detrás del proxy
Octop se autentica con un token bearer, no con una cookie. POST /api/auth/login devuelve {access_token, token_type, expires_in, user} y las llamadas posteriores incluyen Authorization: Bearer <access_token>. Esto es positivo para un reverse proxy: no hay ningún dominio de cookie, ninguna directiva Secure ni ninguna regla SameSite que configurar incorrectamente, por lo que una sesión que funcionaba en http://127.0.0.1:8088 se comporta igual en https://octop.example.com.
Conviene conocer dos consecuencias antes de ponerlo a disposición de usuarios reales.
El WebSocket incluye el token en la URL. El endpoint es WS /api/agents/{id}/chat/ws?token=<jwt>, porque JavaScript en el navegador no puede establecer una cabecera Authorization durante el handshake de WebSocket. TLS protege ese token durante el tránsito. No lo protege de sus propios registros: nginx escribe de forma predeterminada la línea de solicitud completa, incluida la cadena de consulta, en access_log, por lo que un token válido de un usuario real termina en un archivo de texto sin cifrar del servidor. Registre la ruta sin los argumentos. $uri es la ruta normalizada con la cadena de consulta ya eliminada, así que añada esto al bloque http y haga referencia a él desde el servidor:
log_format octop_noargs '$remote_addr [$time_local] '
'"$request_method $uri $server_protocol" '
'$status $body_bytes_sent';
access_log /var/log/nginx/octop.log octop_noargs;El cierre de sesión no revoca un token en v0.9.19. OCTOP_ACCESS_TOKEN_TTL tiene 86400 como valor predeterminado, por lo que un token sigue siendo válido durante 24 horas después del inicio de sesión. La única forma documentada de invalidarlo es octop admin rotate-jwt-secret, que rota la clave de firma almacenada en ~/.octop/secrets/jwt_secret e invalida inmediatamente todos los tokens pendientes para todos los usuarios. Por tanto, cuando alguien abandona el equipo, el orden es el siguiente: elimine el usuario, rote el secreto y pida a los usuarios restantes que inicien sesión de nuevo. Si esto resulta excesivo, reduzca la duración y recuerde añadir la variable a la lista environment: y también a .env:
OCTOP_ACCESS_TOKEN_TTL=28800La protección contra fuerza bruta está integrada: OCTOP_LOGIN_MAX_ATTEMPTS tiene 5 fallos como valor predeterminado y OCTOP_LOGIN_LOCKOUT_SECONDS tiene 900, por lo que un usuario bloqueado sólo debe esperar quince minutos en lugar de asumir que la instalación está dañada. Octop tiene su propio almacén de usuarios y no ofrece compatibilidad documentada con OIDC en v0.9.19. Si necesita un inicio de sesión único real, coloque delante un proxy de autenticación; para eso sirve un servidor Authentik autohospedado. La compatibilidad integrada con OIDC llegó en v0.9.24, el 15 de agosto de 2026.
Configurar Octop con un backend de modelos
Los proveedores se configuran por agente en el panel, y octop provider list muestra la configuración actual. Octop incluye ajustes predefinidos para API compatibles con OpenAI, DashScope (Qwen) y Ollama. Las credenciales se almacenan en la tabla providers de su propia base de datos SQLite. Esta elección determina cuánto paga y qué datos salen del servidor.
Un modelo local con Ollama. Nada sale del servidor y el coste se produce en memoria RAM en lugar de tokens. El detalle de conexión que suele causar problemas es el siguiente: un contenedor no puede acceder al Ollama del host mediante 127.0.0.1:11434, porque esa dirección corresponde al loopback del propio contenedor. Añada una entrada de gateway del host al servicio:
extra_hosts:
- "host.docker.internal:host-gateway"Después, establezca la URL base del proveedor en http://host.docker.internal:11434/v1, que es la ruta compatible con OpenAI de Ollama, y escriba cualquier cadena no vacía en el campo de la clave API, porque Ollama la ignora, pero los clientes de OpenAI no envían una clave vacía. Ollama también debe escuchar fuera del loopback para que esto funcione. Esto implica configurar OLLAMA_HOST=0.0.0.0:11434 en su unidad de systemd. Esta es la parte de riesgo: la API local de Ollama no requiere autenticación, por lo que un puerto 11434 abierto en una IP pública se convierte en un servidor de modelos disponible para quien lo detecte primero. Permita sólo el rango privado de Docker, sudo ufw allow from 172.16.0.0/12 to any port 11434 proto tcp, y bloquee el resto. Ejecutar Ollama en un VPS explica cómo dimensionar el modelo, y la comparación entre Ollama y vLLM explica cuándo Ollama deja de ser el servidor adecuado.
Hay otra advertencia sobre los modelos locales, porque parece un error de Octop, pero no lo es. Los agentes funcionan mediante llamadas a herramientas, y el prompt del sistema, las definiciones de las herramientas y el historial forman un prompt grande. La ventana de contexto predeterminada de Ollama depende ahora de la VRAM: 4k por debajo de 24 GiB, 32k desde 24 GiB hasta menos de 48 GiB y 256k con 48 GiB o más. Sus recomendaciones actuales indican usar al menos 64,000 tokens para agentes y herramientas de programación. Configure num_ctx para que esa carga de trabajo quepa en el contexto compatible con el modelo y en la memoria disponible. Elija también un modelo que admita correctamente llamadas a funciones. Una respuesta que termina a mitad de una frase indica el problema contrario y depende de otro ajuste, num_predict. Por tanto, si las respuestas llegan truncadas, conviene comprobar dónde se configura num_predict y qué indica done_reason antes de culpar al agente. Si prefiere empezar con un candidato concreto en lugar de una lista corta, Nemotron 3.5 Lightning merece una prueba. Ese artículo indica la etiqueta exacta que debe descargar, la RAM que necesita y si el rendimiento con sólo CPU es suficiente.
Un gateway autogestionado. Coloque un gateway LiteLLM autogestionado entre Octop y el resto de los servicios. Obtendrá una única URL base, una clave independiente por usuario, límites de gasto y un único registro. También podrá cambiar el modelo situado detrás del gateway sin editar nada en Octop.
Una API de pago. Ofrece la mejor calidad, con una contrapartida clara: el contenido de las conversaciones sale del servidor y llega al proveedor, que es precisamente lo que se pretendía evitar en gran parte con el alojamiento propio. La clave se introduce en docker/.env como OPENAI_API_KEY, y el archivo Compose ya la transmite.
Independientemente de la opción elegida, el archivo Compose también incluye OCTOP_LANGFUSE_ENABLED, LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY y LANGFUSE_BASE_URL. Así puede enviar trazas a su propia instancia de Langfuse y ver qué hacen realmente los agentes en lugar de deducirlo a partir de la ventana de chat.
Usuarios, roles y biblioteca compartida de agentes
La cuenta de administración creada durante el primer arranque crea y administra las demás. Cada usuario tiene sus propios agentes, espacio de trabajo y credenciales. El token que conserva el navegador mantiene ese aislamiento. Además, Octop incluye plantillas de expertos y paquetes de habilidades disponibles para toda la instancia. La posibilidad de compartir los propios agentes con otros usuarios llegó en v0.9.24, después de la versión fijada aquí.
Tenga cuidado con las herramientas. Octop anuncia la aprobación de herramientas y controles para los comandos de shell, y ambos existen. Sin embargo, un agente que ejecuta comandos de shell los ejecuta dentro del contenedor de Octop, con el volumen de datos montado. Los controles limitan lo que puede hacer un prompt descuidado. No constituyen un límite de aislamiento, así que mantenga activada la aprobación de herramientas para cualquier persona a quien no entregaría acceso al shell. Si compara esta opción con otras alternativas, el resumen de agentes de IA autoalojados explica cómo gestiona cada una ese aspecto.
Actualizar un proyecto que publica versiones con tanta frecuencia
Los datos de este gráfico
[
{
"version": "v0.9.16",
"days_since_previous_release": 2
},
{
"version": "v0.9.17",
"days_since_previous_release": 3
},
{
"version": "v0.9.18",
"days_since_previous_release": 1
},
{
"version": "v0.9.19",
"days_since_previous_release": 3
}
]Esas son las fechas de las etiquetas del repositorio, contabilizadas hasta el 7 de agosto de 2026. Se publicaron 4 versiones etiquetadas en nueve días. El intervalo más corto fue de 1 día, y v0.9.19 llegó 3 días después de la etiqueta anterior. Esta frecuencia es una buena señal sobre el proyecto, pero una mala razón para ejecutar latest. Lea los cambios antes de aplicarlos:
cd Octop
git fetch --tags
git tag --sort=-creatordate | head
NEW_TAG=$(git tag --sort=-creatordate | head -1)
git log --oneline "v0.9.19..$NEW_TAG"Compruebe qué contiene realmente $NEW_TAG antes de cambiar a esa versión, porque el proyecto etiqueta versiones beta como v1.0.2b9 junto con las versiones estables. Al 20 de noviembre de 2026, la etiqueta más reciente es v1.0.3b7, publicada el 18 de noviembre de 2026. La versión estable más reciente sigue siendo v1.0.2, publicada el 18 de octubre de 2026. El salto desde v0.9.19 incluye la versión v1.0.0, publicada el 14 de septiembre de 2026. Por tanto, ese registro es largo y conviene leerlo con atención.
Haga primero una copia de seguridad, siempre, porque las migraciones de la base de datos se ejecutan durante el arranque. Si una migración falla en un proyecto que publica versiones con tanta frecuencia, tendrá que resolverlo usted:
docker compose -f docker/docker-compose.yml stop
sudo tar czf octop-backup-$(date +%F).tgz -C /srv octop-data
docker compose -f docker/docker-compose.yml startDespués, cambie a la etiqueta nueva y vuelva a compilar con docker compose -f docker/docker-compose.yml up -d --build. Si algo falla, cambiar a la etiqueta anterior y volver a compilar restaura el código, pero sólo el archivo tar restaura la base de datos.
Ese archivo tar contiene octop.db, config.json, el secreto de firma JWT y credential.txt, por lo que es tan sensible como el propio servidor. Manténgalo con permisos 600 y conserve una copia fuera del servidor. En instalaciones más grandes, el proyecto también publica docker/docker-compose.postgres.yml, que ejecuta PostgreSQL con pgvector en lugar de SQLite.
Modos de fallo y cadenas que verá
La comprobación de estado nunca responde. curl http://127.0.0.1:8088/api/health se bloquea o rechaza la conexión. Lea docker compose -f docker/docker-compose.yml logs -f octop. Un contenedor que sale durante la inicialización suele no poder escribir en el directorio de datos, así que compruebe el propietario de la ruta que configuró en OCTOP_DATA.
El panel se carga, pero el chat no puede conectarse. Un protocolo de enlace WebSocket fallido termina el estado de transmisión en v0.9.19. Abra la consola del navegador y busque un intento de conexión fallido a wss://octop.example.com/api/agents/.../chat/ws. Compruebe que el proxy reenvíe la actualización. Añada los encabezados proxy_http_version 1.1, Upgrade y Connection.
Toda la respuesta aparece de una vez, con varios segundos de retraso. La transmisión funciona, pero el almacenamiento en búfer está activado. Configure proxy_buffering off.
bind: address already in use. Algo ya está usando 8088. sudo ss -tlnp | grep 8088 identifica el proceso. También verá este error si añadió una segunda entrada ports en un archivo de anulación en lugar de editar la original.
Se rechaza la contraseña correcta. Cinco intentos incorrectos activan un bloqueo de 900 segundos. Espere a que termine en lugar de reinstalar.
La nueva contraseña de .env no tuvo efecto. Esas credenciales sólo se aplican durante la primera inicialización. Cámbiela en el panel.
El agente responde, pero nunca ejecuta una herramienta. Compruebe la asignación de contexto del modelo local y su compatibilidad con llamadas a funciones. Ollama recomienda ahora al menos 64,000 tokens para cargas de trabajo de agentes; elija un modelo y un presupuesto de memoria compatibles.
FAQ
¿Octop sustituye a Open WebUI?
Sólo si necesita las funciones que añade. Open WebUI también admite varios usuarios, roles y controles de acceso. Octop combina cuentas con un rol de administrador, espacios de trabajo y credenciales por usuario, y una biblioteca conmutable de agentes especializados. Así, varias personas pueden compartir un servidor sin compartir un mismo historial. Si una sola cuenta es suficiente, Open WebUI es la opción más sencilla y mucho más madura.
¿Por qué no debería usar el script de instalación de Octop mediante curl?
El comando de una línea de v0.9.19 descarga un script de un bucket de Tencent Cloud Object Storage sin fijar su contenido a una etiqueta o un commit de git. El repositorio sí contiene una copia versionada en scripts/install.sh, pero canalizar la copia remota a bash la ejecuta antes de que pueda leerla. Además, instala el software en el host con su propio entorno de Python 3.12, fuera del gestor de paquetes. Descárguelo y léalo primero, o despliegue con Docker Compose desde una etiqueta comprobada.
¿Puede Octop usar un modelo local en lugar de una API de pago?
Sí. Octop usa APIs compatibles con OpenAI e incluye un perfil predefinido para Ollama. Por tanto, apuntarlo a http://host.docker.internal:11434/v1 funciona después de añadir extra_hosts: ["host.docker.internal:host-gateway"] al contenedor y establecer OLLAMA_HOST=0.0.0.0:11434 en el host. Filtre el puerto 11434 para el rango de direcciones de Docker, porque la API local de Ollama no requiere autenticación. Compruebe la ventana de contexto asignada. Los valores predeterminados de Ollama ahora varían según la VRAM, y sus indicaciones actuales recomiendan al menos 64,000 tokens para cargas de trabajo con agentes, dentro del contexto admitido por el modelo y de la memoria disponible.
¿Necesito un proxy inverso o puedo abrir el puerto 8088?
Necesita el proxy. El archivo Compose incluido con Octop publica 8088 en todas las interfaces y no usa TLS. Por tanto, las contraseñas y los tokens bearer atravesarían Internet en texto sin cifrar. Cambie el puerto publicado a 127.0.0.1:8088:8088 y coloque Caddy o nginx delante con un certificado. Con nginx, reenvíe las cabeceras de actualización de WebSocket y establezca proxy_buffering off. Si la actualización falla, el chat no puede conectarse. El almacenamiento en búfer también retrasa el flujo de reanudación de HITL. En v0.9.19, un handshake fallido termina el estado de streaming, y una desconexión no cancela una tarea activa del agente.
¿Está Octop preparado para producción?
Era anterior a la versión 1.0 y publicaba varias releases etiquetadas por semana en agosto de 2026. Etiquetó v1.0.0 el 14 de septiembre de 2026 y después publicó varias etiquetas beta de 1.0.2 antes de la versión estable v1.0.2, el 18 de octubre de 2026. A 20 de noviembre de 2026, la etiqueta más reciente es v1.0.3b7, publicada el 18 de noviembre de 2026, mientras que v1.0.2 sigue siendo la última release estable. Ese ritmo sigue siendo rápido. Considérelo un proyecto prometedor, no consolidado. Puede funcionar para una familia o un equipo interno pequeño si fija una etiqueta exacta, lee el registro de commits antes de cada actualización y hace una copia de seguridad del volumen de datos antes de cada reconstrucción. No lo ejecute en latest ni almacene todavía datos de clientes en él.