Airflow使用PythonOperator调用Docker时遇权限拒绝错误求助

这个错误Error while fetching server API version: ('Connection aborted.', PermissionError(13, 'Permission denied'))核心原因是Airflow运行进程的用户没有访问Docker Unix socket的权限——不管用PythonOperator还是DockerOperator，本质都是调用Docker API时的权限不足问题。以下是针对性解决方法：

1. 确认Docker Socket权限 #

Docker默认的Unix socket路径是/var/run/docker.sock，先检查它的权限与所属组：

ls -l /var/run/docker.sock

正常输出应类似：

srw-rw---- 1 root docker 0 Aug 20 10:00 /var/run/docker.sock

所属组为docker，只有该组用户才能读写这个socket。

2. 给Airflow用户添加Docker组权限 #

方法一：修改Airflow容器运行用户（Docker Compose部署场景） #

如果Airflow用Docker Compose部署，在docker-compose.yml中给Airflow worker/webserver服务添加用户配置，将Airflow用户加入docker组：

services:
  airflow-worker:
    user: "${AIRFLOW_UID}:${DOCKER_GID}"
    # 其他原有配置...
  airflow-webserver:
    user: "${AIRFLOW_UID}:${DOCKER_GID}"
    # 其他原有配置...

接着在.env文件中添加DOCKER_GID变量，值为宿主机上docker组的GID（可通过getent group docker | cut -d: -f3命令获取）：

AIRFLOW_UID=50000
DOCKER_GID=999 # 替换为你实际的docker组GID

最后重启Airflow容器：

docker-compose down && docker-compose up -d

方法二：临时调整Docker Socket权限（仅测试用，不推荐生产环境） #

若不想修改Airflow配置，可临时放宽Docker socket权限（存在安全风险，仅限测试）：

sudo chmod 666 /var/run/docker.sock

3. 验证PythonOperator中的Docker调用代码 #

确保Python代码调用Docker的方式正确，比如使用docker库时，默认会读取/var/run/docker.sock，示例代码：

from docker import from_env

def run_php_task():
    client = from_env()
    # 替换为你的PHP容器名称
    client.containers.run(
        "php-app",
        "php artisan showAddress",
        detach=False,
        remove=True
    )

若Docker socket路径非默认值，需在初始化客户端时指定：

from docker import DockerClient

client = DockerClient(base_url='unix:///自定义路径/docker.sock')

4. 检查SELinux/AppArmor限制（Linux主机场景） #

Linux系统中，SELinux或AppArmor可能阻止Airflow进程访问Docker socket，可临时关闭SELinux测试：

sudo setenforce 0

若问题解决，需添加永久规则允许Airflow访问Docker socket，或调整AppArmor配置。

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