无法连接localhost:8080访问Airflow，求解决方法

1. 确认容器端口映射配置 #

• 检查docker-compose.yml（或容器启动命令）中Airflow webserver的端口映射规则，确保存在如下格式的配置：

  webserver:
    ports:
      - "8080:8080"
  

• 执行docker ps命令查看容器实际端口映射状态，确认输出中包含0.0.0.0:8080->8080/tcp或127.0.0.1:8080->8080/tcp的映射记录

2. 验证容器内服务运行状态 #

• 进入Airflow webserver容器：docker exec -it <webserver_container_id_or_name> bash
• 在容器内部执行curl localhost:8080，若返回HTML内容则说明容器内服务正常；若报错，检查webserver进程状态：

  ps aux | grep airflow-webserver
  

• 查看容器日志排查启动异常：docker logs <webserver_container_id_or_name>，重点关注端口占用、配置错误、依赖缺失类的报错信息

3. 检查本地网络与防火墙设置 #

• 尝试使用127.0.0.1:8080替代localhost:8080访问，规避本地DNS解析问题
• 检查本地防火墙（Windows Defender防火墙、Linux ufw/iptables）是否允许8080端口的入站连接，必要时临时关闭防火墙测试
• 若在WSL2环境运行Docker，需验证WSL2端口转发是否正常：在WSL2终端内访问localhost:8080，若能访问但Windows主机无法访问，执行以下命令重启WSL2服务：

  wsl --shutdown
  

  之后重新启动WSL2与Docker

4. 确认Airflow配置与依赖容器状态 #

• 检查Airflow配置文件airflow.cfg中web_server_port是否为8080，web_server_host是否设置为0.0.0.0（允许外部访问）
• 执行docker ps确认postgres、redis等依赖容器状态均为Up，若有容器未启动，查看对应容器日志排查原因
• 若使用Airflow官方docker-compose.yml，首次启动后等待2-3分钟，确保数据库初始化、依赖安装等流程完成

5. 排查端口冲突问题 #

• 检查本地8080端口是否被其他进程占用：

  # Linux/macOS
  lsof -i :8080
  # Windows
  netstat -ano | findstr :8080
  

• 若端口被占用，修改docker-compose.yml中的端口映射为其他端口（如8081:8080），然后重启容器：

  docker-compose down
  docker-compose up -d
  

内容的提问来源于stack exchange，提问作者user3319338