kx1t/webproxy

镜像概述

本镜像为基于NGINX的反向Web代理，专门针对@Mikenye的ADSB Docker栈优化。ADSB Docker栈是用于接收、处理和展示飞机ADS-B信号的Docker容器集合（如tar1090、dump1090、piaware等）。本代理旨在提供统一的Web服务入口，简化多服务访问与流量管理。

核心功能与特性

• 反向代理核心能力：基于NGINX实现HTTP请求转发、流量路由，支持多服务统一入口
• ADSB栈适配：预配置适用于@Mikenye ADSB栈常见服务（tar1090、dump1090等）的代理规则
• 简化访问：通过单一端口/域名访问多个ADSB Web服务，无需记忆多个端口
• 灵活配置：支持自定义NGINX配置，适应不同部署场景需求
• 轻量级：基于官方NGINX镜像构建，体积小，资源占用低

使用场景与适用范围

• @Mikenye ADSB Docker栈用户：需集中管理栈内多个Web服务（如tar1090、dump1090-webinterface）访问入口
• 多服务整合需求：希望通过单一IP/域名访问所有ADSB相关Web界面
• 网络简化：减少宿主机端口暴露，通过代理统一管理外部访问

使用方法与配置说明

基本要求

• 已部署@Mikenye的ADSB Docker栈（需确保各服务容器在同一网络或可相互访问）
• Docker Engine 19.03+ 或 Docker Compose 2.0+

Docker Run 部署示例

bash
docker run -d \
  --name adsb-nginx-proxy \
  --restart unless-stopped \
  -p 80:80 \  # 宿主机端口映射（根据需求调整）
  --network adsb-network \  # 需与ADSB栈在同一网络
  -v /path/to/custom/nginx/conf.d:/etc/nginx/conf.d \  # 自定义配置（可选）
  mikenye/adsb-nginx-proxy  # 假设镜像名称（请替换为实际镜像名）

Docker Compose 配置示例

与@Mikenye ADSB栈整合的docker-compose.yml片段：

yaml
version: '3.8'

services:
  adsb-proxy:
    image: mikenye/adsb-nginx-proxy  # 假设镜像名称
    container_name: adsb-proxy
    restart: unless-stopped
    ports:
      - "80:80"  # 对外暴露的Web端口
    networks:
      - adsb-network  # 与ADSB栈共享网络
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d  # 自定义代理配置（可选）
    depends_on:
      - tar1090  # 依赖的ADSB服务（根据实际栈调整）
      - dump1090

  # 其他ADSB栈服务（如tar1090、dump1090等）...

networks:
  adsb-network:
    driver: bridge

配置说明

默认代理规则

默认配置通常包含对@Mikenye ADSB栈常见服务的代理路由，例如：

• /tar1090 → 转发至tar1090服务
• /dump1090 → 转发至dump1090-webinterface服务
• / → 默认首页（可能显示服务列表或重定向至主服务）

自定义配置

如需修改代理规则，可通过挂载/etc/nginx/conf.d目录自定义NGINX配置文件（.conf格式）。示例配置片段（adsb-proxy.conf）：

nginx
server {
    listen 80;
    server_name localhost;

    # 代理tar1090服务
    location /tar1090/ {
        proxy_pass http://tar1090:80/;  # 假设tar1090服务容器名为tar1090，端口80
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    # 代理dump1090服务
    location /dump1090/ {
        proxy_pass http://dump1090:8080/;  # 假设dump1090服务端口8080
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    # 默认首页
    location / {
        return 302 /tar1090/;  # 重定向至tar1090
    }
}

环境变量（可选）

部分场景下可通过环境变量调整基础配置（具体支持的变量需参考镜像官方文档），例如：

• TAR1090_HOST: 指定tar1090服务地址（默认：tar1090）
• DUMP1090_PORT: 指定dump1090服务端口（默认：8080）

注意事项

• 确保代理容器与ADSB栈服务容器在同一Docker网络，或通过IP:端口可访问
• 自定义配置时需注意NGINX语法正确性，错误配置可能导致容器启动失败
• 如需启用HTTPS，可通过挂载SSL证书并修改NGINX配置实现SSL终止
• 部署前建议参考@Mikenye ADSB Docker栈官方文档，确认服务名称与端口映射关系