wuuker/docker-airflow
wuuker
快速在单个容器中搭建Apache Airflow 2工作流管理系统，支持多种执行器配置、自定义插件与Python包，便于工作流调度与管理。
1 次收藏下载次数: 0状态：社区镜像维护者：wuuker仓库类型：镜像最近更新：3 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
注意事项 - 从2.2.0之前版本升级到2.2.0时
- 存在https://github.com/apache/airflow/blob/main/UPDATING.md#taskinstances-now-require-a-dagrun，**升级前必须处理**，人工干预不可少，`airflow db upgrade`命令无法自动解决。可通过以下方式处理：
- 遵循官方文档步骤（上述链接）；
- 暂停所有DAG，删除运行中任务及记录（可能有效但未测试）；
- 若可丢失记录，让Airflow重建数据库：导出设置→删除元数据DB→重建容器→等待新DB创建→导入设置。
airflow.cfg多个参数已重命名，需查看https://github.com/apache/airflow/blob/main/UPDATING.md#airflow-220确保参数名称一致。
说明
- 镜像测试时间有限，可在https://github.com/ukewea/docker-airflow反馈问题。
使用方法
默认用SequentialExecutor运行：
bashdocker run -d -p 8080:8080 docker.xuanyuan.run/wuuker/docker-airflow webserver
其他执行器需用对应docker-compose文件：
- LocalExecutor：
bash
docker-compose -f docker-compose-LocalExecutor.yml up -d - CeleryExecutor：
bash
docker-compose -f docker-compose-CeleryExecutor.yml up -d
加载示例DAG需设环境变量：
bashdocker run -d -p 8080:8080 -e LOAD_EX=y docker.xuanyuan.run/wuuker/docker-airflow
即席查询需配置连接：Admin→Connections编辑"postgres_default"，设置Host=postgres、Schema=airflow、Login=airflow、Password=airflow。
配置Airflow
通过环境变量设置配置，格式为AIRFLOW__<section>__<key>（如AIRFLOW__CORE__SQL_ALCHEMY_CONN）。连接可通过AIRFLOW_CONN_前缀定义（如AIRFLOW_CONN_POSTGRES_MASTER=postgres://user:pass@localhost:5432/master）。详情见http://airflow.readthedocs.io/en/latest/howto/set-config.html#setting-configuration-options。
自定义插件
创建plugins/文件夹放插件，通过-v $(pwd)/plugins/:/usr/local/airflow/plugins挂载，或用带插件卷的compose文件。
安装Python包
创建requirements.txt，挂载为-v $(pwd)/requirements.txt:/requirements.txt，entrypoint.sh会自动执行pip install。
UI链接
- Airflow：http://localhost:8080/
- Flower：http://localhost:5555/
扩展Worker
bashdocker-compose -f docker-compose-CeleryExecutor.yml scale worker=5
运行其他命令
bash# 列出DAG docker run --rm -ti docker.xuanyuan.run/wuuker/docker-airflow airflow list_dags # 进入bash docker run --rm -ti docker.xuanyuan.run/wuuker/docker-airflow bash
PostgreSQL配置
非SequentialExecutor需数据库，变量及默认值：
| 变量名 | 默认值 | 作用 |
|---|---|---|
| POSTGRES_HOST | postgres | 数据库主机 |
| POSTGRES_PORT | 5432 | 端口 |
| POSTGRES_USER | airflow | 用户 |
| POSTGRES_PASSWORD | airflow | 密码 |
| POSTGRES_DB | airflow | 数据库名 |
| POSTGRES_EXTRAS | 空 | 额外参数（需URL编码） |
Redis配置（CeleryExecutor用）
| 变量名 | 默认值 | 作用 |
|---|---|---|
| REDIS_PROTO | redis:// | 协议 |
| REDIS_HOST | redis | 主机 |
| REDIS_PORT | 6379 | 端口 |
| REDIS_PASSWORD | 空 | 密码 |
| REDIS_DBNUM | 1 | 数据库编号 |
推荐绑定主机目录：
/usr/local/airflow/dags（存放DAG）/usr/local/airflow/plugins（插件）/usr/local/airflow/logs（日志）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 docker-airflow 镜像标签
docker pull docker.xuanyuan.run/wuuker/docker-airflow:<标签>
DockerHub 原生拉取命令
docker pull wuuker/docker-airflow:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"