进程入口是 api/app.py。它在模块顶层（不是在函数里）就决定了造哪种 app（api/app.py:36）：

# api/app.py:36
if is_db_command():                       # ① 如果是在跑 `flask db ...` 迁移命令
    from app_factory import create_migrations_app
    app = create_migrations_app()         # 只装 db/migrate/commands 三个扩展的精简 app
    socketio_app = app
    flask_app = app
else:
    from app_factory import create_app    # ② 正常情况：造完整 app
    socketio_app, flask_app = create_app()
    app = flask_app
    celery = cast("Celery", app.extensions["celery"])

那"真正 serve"发生在哪？在 if __name__ == "__main__" 里（api/app.py:56），用 gevent 的 WSGI 服务器起在 0.0.0.0:5001：

# api/app.py:56
if __name__ == "__main__":
    from gevent import pywsgi
    from geventwebsocket.handler import WebSocketHandler
    log_startup_banner(HOST, PORT)                       # HOST=0.0.0.0 PORT=5001
    server = pywsgi.WSGIServer((HOST, PORT), socketio_app, handler_class=WebSocketHandler)
    server.serve_forever()

核心在 api/app_factory.py。先看"造裸 app"（api/app_factory.py:49）：

# api/app_factory.py:49
def create_flask_app_with_configs() -> DifyApp:
    """create a raw flask app with configs loaded from .env file"""
    dify_app = DifyApp(__name__)
    dify_app.config.from_mapping(dify_config.model_dump())   # ① 把配置灌进 app.config
    dify_app.config["RESTX_INCLUDE_ALL_MODELS"] = True

    @dify_app.before_request
    def before_request():
        init_request_context()                                # ② 每个请求前：初始化日志上下文
        RecyclableContextVar.increment_thread_recycles()
        ...   # 企业版 license 校验
    return dify_app

再看"装配"（api/app_factory.py:127）——这就是工厂主函数：

# api/app_factory.py:127
def create_app() -> tuple[socketio.WSGIApp, DifyApp]:
    start_time = time.perf_counter()
    app = create_flask_app_with_configs()     # ① 先造裸 app
    initialize_extensions(app)                # ② 沿流水线装上所有扩展
    sio.app = app
    socketio_app = socketio.WSGIApp(sio, app) # ③ 再包一层 socket.io（支持 WebSocket）
    ...
    return socketio_app, app                  # ④ 返回二元组，正好对上 app.py:52 的解包

initialize_extensions 里有一个顺序列表（api/app_factory.py:178），扩展是按这个顺序一个个装的：

# api/app_factory.py:178
extensions = [
    ext_timezone, ext_logging, ext_warnings, ext_import_modules, ext_orjson,
    ext_forward_refs, ext_compress, ext_code_based_extension,
    ext_database,            # ← 数据库（很多后续扩展依赖它，所以排在前面）
    ext_app_metrics, ext_migrate, ext_redis, ext_storage, ext_set_secretkey,
    ext_logstore,            # 注释明说：storage 之后、celery 之前
    ext_celery,              # ← Celery（异步任务）
    ext_login, ext_mail, ext_hosting_provider, ext_sentry, ext_proxy_fix,
    ext_blueprints,          # ← 注册路由蓝图（controllers 在这里挂上）
    ext_commands, ext_fastopenapi, ext_otel, ext_enterprise_telemetry,
    ext_request_logging, ext_session_factory, ext_oauth_bearer,
]
for ext in extensions:                                          # ← 逐个装
    is_enabled = ext.is_enabled() if hasattr(ext, "is_enabled") else True
    if not is_enabled:
        continue                                                # 没开启的跳过
    ext.init_app(app)                                           # ★把扩展挂到 app 上

对比"精简 app"（迁移用，api/app_factory.py:224），你会更懂"按需组装"的意义：

# api/app_factory.py:224
def create_migrations_app() -> DifyApp:
    app = create_flask_app_with_configs()
    from extensions import ext_commands, ext_database, ext_migrate
    ext_database.init_app(app)     # 只装这三个
    ext_migrate.init_app(app)
    ext_commands.init_app(app)
    return app

部署编排在 docker/（docker-compose.yaml、docker-compose.middleware.yaml 等）。而"这个容器当什么角色"，由 api/docker/entrypoint.sh 根据环境变量 MODE 决定：

# api/docker/entrypoint.sh
if [[ "${MIGRATION_ENABLED}" == "true" ]]; then   # :11 先跑迁移（可选）
  flask upgrade-db
fi

if [[ "${MODE}" == "worker" ]]; then              # :21 角色①：Celery 后厨
  exec celery -A celery_entrypoint.celery worker -P ${WORKER_POOL} ...   # :66
elif [[ "${MODE}" == "beat" ]]; then              # :71 角色②：定时闹钟
  exec celery -A app.celery beat --loglevel ...   # :72
elif [[ "${MODE}" == "job" ]]; then               # :74 角色③：一次性命令
  flask "$@"
else                                              # :120 角色④：默认=api 前台
  if [[ "${DEBUG}" == "true" ]]; then
    exec python -m app                            # :124 开发：内置 gevent 服务器
  else
    exec gunicorn ... --bind "0.0.0.0:5001" \     # :126 生产：gunicorn
      --worker-class geventwebsocket...GeventWebSocketWorker
  fi
fi