diff --git a/README.md b/README.md index ef24ba2..f8c05df 100644 --- a/README.md +++ b/README.md @@ -77,6 +77,26 @@ Este stack no expone el puerto `8000` por defecto. Si necesitas gestionar agente - 8000:8000 ``` +## Integración con Proxy Inverso + +Este repositorio incluye archivos de ejemplo para integrar Portainer con Traefik o NPM: + +### Con Traefik +```bash +cp docker-compose.override.traefik.yml.example docker-compose.override.yml +# Edita el dominio en docker-compose.override.yml +docker compose up -d +``` + +### Con NGINX Proxy Manager +```bash +cp docker-compose.override.npm.yml.example docker-compose.override.yml +docker compose up -d +# Configura el proxy host desde la UI de NPM +``` + +Ver documentación detallada en la [Wiki - Traefik](https://git.ictiberia.com/groales/portainer/wiki/Traefik). + ## Documentación adicional Consulta la [**Wiki del proyecto**](https://git.ictiberia.com/groales/portainer/wiki) para documentación detallada: - [Guía inicial](https://git.ictiberia.com/groales/portainer/wiki/Home) @@ -85,7 +105,7 @@ Consulta la [**Wiki del proyecto**](https://git.ictiberia.com/groales/portainer/ - [Proxy inverso y TLS con Traefik](https://git.ictiberia.com/groales/portainer/wiki/Traefik) ## Solución de problemas -- Puerto ocupado (`9443/8000`): comprueba procesos con `netstat` o `Get-NetTCPConnection` y ajusta puertos en `docker-compose.yaml`. +- Puerto ocupado (`9443/8000`): comprueba procesos con `netstat` o `Get-NetTCPConnection` y ajusta puertos en `docker-compose.yml`. - Permisos sobre `/var/run/docker.sock`: ejecuta con un usuario que pertenezca al grupo `docker` (Linux) o valida que Docker Desktop esté activo (Windows WSL2). - Certificados/TLS: si accedes por `https://` y hay advertencias, usa un proxy inverso con certificados válidos o configura confiables en el cliente. - Contenedor no arranca: revisa logs con `docker logs portainer` y valida que el volumen `portainer_data` exista. diff --git a/docker-compose.override.npm.yml.example b/docker-compose.override.npm.yml.example new file mode 100644 index 0000000..07bef2f --- /dev/null +++ b/docker-compose.override.npm.yml.example @@ -0,0 +1,20 @@ +# docker-compose.override.npm.yml.example +# +# Este archivo muestra cómo integrar Portainer con NGINX Proxy Manager del repositorio groales/npm. +# Para usarlo: +# 1. Copia este archivo a docker-compose.override.yml +# 2. Asegúrate de que la red 'proxy' existe (creada por NPM) +# +# Docker Compose automáticamente fusiona docker-compose.yml + docker-compose.override.yml +# +# IMPORTANTE: La configuración del proxy host se hace desde la UI de NPM, no mediante labels. +# Este override solo conecta Portainer a la red compartida. + +services: + portainer: + networks: + - proxy + +networks: + proxy: + external: true diff --git a/docker-compose.override.yaml.example b/docker-compose.override.traefik.yml.example similarity index 84% rename from docker-compose.override.yaml.example rename to docker-compose.override.traefik.yml.example index 85aa8d8..933633c 100644 --- a/docker-compose.override.yaml.example +++ b/docker-compose.override.traefik.yml.example @@ -1,12 +1,12 @@ -# docker-compose.override.yaml.example +# docker-compose.override.traefik.yml.example # # Este archivo muestra cómo integrar Portainer con Traefik del repositorio groales/traefik. # Para usarlo: -# 1. Copia este archivo a docker-compose.override.yaml +# 1. Copia este archivo a docker-compose.override.yml # 2. Ajusta el dominio (portainer.tudominio.com) # 3. Asegúrate de que la red 'proxy' existe (creada por Traefik) # -# Docker Compose automáticamente fusiona docker-compose.yaml + docker-compose.override.yaml +# Docker Compose automáticamente fusiona docker-compose.yml + docker-compose.override.yml services: portainer: