fgrehm/libduckdb Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

libduckdb Docker镜像文档

镜像概述

libduckdb是一个以Docker镜像形式分发DuckDB头文件和库文件的项目。该镜像主要为Ruby项目设计，旨在支持依赖suketa/ruby-duckdb的应用，同时也适用于其他需要使用DuckDB的平台。其核心价值在于简化DuckDB在Docker环境中的部署，尤其是解决了Alpine等精简Linux发行版中手动编译DuckDB的复杂问题。

核心功能和特性

• 预编译分发：提供预编译的DuckDB头文件（.h）和库文件（.so），避免手动编译的耗时过程（通常需要20-30分钟）。
• 跨发行版支持：支持多种Linux发行版，包括Alpine（基于musl libc）和Debian/Ubuntu（基于glibc）等。
• 简化依赖管理：通过Docker多阶段构建，可直接将预编译文件复制到目标镜像，无需手动下载和配置。

使用场景

• Ruby项目中需要使用suketa/ruby-duckdb gem时，作为DuckDB依赖的提供方。
• 在Docker环境中（尤其是使用Alpine或slim等精简基础镜像时）快速部署DuckDB。
• 避免因不同Linux发行版（如Alpine的musl libc与标准glibc差异）导致的DuckDB安装问题。

可用标签

所有可用标签请参见Docker Hub：[***]

使用方法

基本用法

在Dockerfile中通过多阶段构建，从libduckdb镜像复制所需文件：

dockerfile
FROM fgrehm/libduckdb:<TAG> AS libduckdb

FROM some/base:image-tag

# 方式一：直接复制所有文件（信任镜像时使用）
COPY --from=libduckdb /libduckdb /

# 方式二：显式复制指定文件
COPY --from=libduckdb /libduckdb/usr/local/include/duckdb.h /usr/local/include
COPY --from=libduckdb /libduckdb/usr/local/lib/libduckdb.so /usr/local/lib

Alpine Linux示例

适用于基于Alpine的Ruby镜像：

dockerfile
FROM fgrehm/libduckdb:0.8.0-alpine3.18 AS libduckdb

FROM ruby:3.2-alpine3.18
RUN apk add --no-cache --update \
            make \
            g++

# 复制DuckDB文件
COPY --from=libduckdb /libduckdb /

# 实际项目中需添加Gemfile等步骤
RUN gem install duckdb

其他发行版示例（如Debian/Ubuntu）

适用于基于Debian的slim镜像：

dockerfile
FROM fgrehm/libduckdb:0.8.0 AS libduckdb

FROM ruby:3-slim

RUN apt-get update \
    && apt-get install -y --no-install-recommends make gcc \
    && rm -rf /var/lib/apt/lists/*

# 复制DuckDB文件
COPY --from=libduckdb /libduckdb /

# 实际项目中需添加Gemfile等步骤
RUN gem install duckdb

为什么需要此镜像

使用suketa/ruby-duckdb gem时，需要先安装DuckDB引擎，否则会出现类似以下错误：

=> gem install duckdb

...

********************************************************************************
duckdb >= 0.5.0 is not found. Install duckdb >= 0.5.0 library and header file.
********************************************************************************

在macOS上，可通过brew install duckdb轻松解决；但在Linux上，尤其是Alpine等精简发行版中，问题更为复杂：

• 标准Linux：需手动下载DuckDB的C++包并配置，但流程繁琐。
• Alpine Linux：由于基于musl libc，直接使用官方预编译包会因glibc依赖问题失败，需手动编译DuckDB（耗时20+分钟）。

本镜像通过提供预编译的DuckDB文件，解决了上述问题，可直接通过COPY命令在多阶段构建中集成，大幅简化部署流程。