# 在 Alpine 上运行 glibc 编译的程序
$ ./program_from_glibc
# /bin/sh: ./program_from_glibc: not found

# 这不是因为文件不存在，而是因为找不到动态链接器
# glibc 程序需要 /lib64/ld-linux-x86-64.so.2
# Alpine 只有 /lib/ld-musl-x86_64.so.1

# 方案 1：安装 gcompat 兼容层（推荐）
$ apk add gcompat
$ ./program_from_glibc
# 现在可以运行了

# 方案 2：重新编译
$ apk add gcc musl-dev
$ gcc -o program program.c
# 或者静态链接
$ gcc -static -o program program.c

# 方案 3：使用多架构 Docker
# 使用 Ubuntu 镜像运行 glibc 程序，Alpine 运行 musl 程序

# 某些程序在 Alpine 上无法解析域名
$ curl: (6) Could not resolve host: example.com

# 原因：musl 不支持 nsswitch.conf 中的复杂配置
# musl 只读取 /etc/resolv.conf 和 /etc/hosts

# 1. 确保 /etc/resolv.conf 存在且正确
$ cat /etc/resolv.conf
nameserver 8.8.8.8
nameserver 8.8.4.4

# 2. 在 Docker 中确保 DNS 配置正确
$ docker run --dns 8.8.8.8 alpine ping example.com

# 3. 如果程序硬编码使用 NSS 功能，需要修改代码
# 或使用 getaddrinfo() 替代 gethostbyname()

/* 推荐使用 getaddrinfo() 替代 gethostbyname() */
#include <stdio.h>
#include <netdb.h>
#include <arpa/inet.h>

int main() {
    struct addrinfo hints = {0}, *res;
    hints.ai_family = AF_UNSPEC;
    hints.ai_socktype = SOCK_STREAM;

    /* getaddrinfo 在 glibc 和 musl 上都能正常工作 */
    int err = getaddrinfo("example.com", "80", &hints, &res);
    if (err) {
        fprintf(stderr, "Error: %s\n", gai_strerror(err));
        return 1;
    }

    char ip[INET6_ADDRSTRLEN];
    if (res->ai_family == AF_INET) {
        inet_ntop(AF_INET,
                  &((struct sockaddr_in *)res->ai_addr)->sin_addr,
                  ip, sizeof(ip));
    } else {
        inet_ntop(AF_INET6,
                  &((struct sockaddr_in6 *)res->ai_addr)->sin6_addr,
                  ip, sizeof(ip));
    }
    printf("Resolved: %s\n", ip);

    freeaddrinfo(res);
    return 0;
}

# glibc 中文排序（按拼音）
$ echo -e "中国\n北京\n上海" | sort
# 北京
# 上海
# 中国

# musl 中文排序（按字节序）
$ echo -e "中国\n北京\n上海" | sort
# 输出可能是 Unicode 码点顺序

# musl 不支持完整的 locale 数据
# 如果需要特定 locale 排序，使用应用程序层面的排序

# Python 示例：
$ python3 -c "
import locale
locale.setlocale(locale.LC_ALL, 'zh_CN.UTF-8')
words = ['中国', '北京', '上海']
print(sorted(words, key=locale.strxfrm))
"

# Alpine 使用 apk 包管理器
# 一些 glibc 系统上的包可能在 Alpine 上有不同的名字

# 常见包名对照
# glibc 系统          Alpine
# libssl-dev          openssl-dev
# libffi-dev          libffi-dev
# libxml2-dev         libxml2-dev
# zlib1g-dev          zlib-dev
# libsqlite3-dev      sqlite-dev
# libc-dev            musl-dev
# glibc-source        (不存在)

# 搜索 Alpine 包
$ apk search libxml
$ apk info --description libxml2-dev

# 查看包提供的文件
$ apk info -L libxml2-dev

# 安装 gcompat
$ apk add gcompat

# gcompat 安装了什么
$ apk info -L gcompat
# /lib/ld-linux-x86-64.so.2  — glibc 动态链接器模拟
# /lib64/ld-linux-x86-64.so.2
# /lib/libgcompat.so.0        — glibc 函数兼容实现

# 现在可以运行 glibc 二进制了
$ ./glibc_program

# 安装基本开发工具
$ apk add build-base
# 包含：gcc, g++, make, libc-dev (musl-dev), binutils

# 安装常用开发库
$ apk add \
    cmake \
    git \
    pkgconf \
    autoconf \
    automake \
    libtool \
    linux-headers

# 安装语言运行时
$ apk add python3 nodejs go rust

# 网络
$ apk add openssl-dev curl-dev nghttp2-dev

# 数据库
$ apk add postgresql-dev sqlite-dev mysql-dev mariadb-dev

# 图像
$ apk add libpng-dev jpeg-dev zlib-dev

# XML/JSON
$ apk add libxml2-dev json-c-dev

# 加密
$ apk add openssl-dev libsodium-dev

# 系统
$ apk add linux-headers eudev-dev libcap-dev

# 调试
$ apk add gdb strace ltrace valgrind

# Python 在 Alpine 上通常能正常工作
$ apk add python3 py3-pip

# 但某些 C 扩展可能需要额外的开发库
$ apk add python3-dev gcc musl-dev

# 常见问题：pip 安装二进制 wheel 时
# 许多 PyPI wheel 是为 glibc 编译的，需要重新编译
$ pip install --no-binary :all: package_name

# 或使用 manylinux wheel 的替代方案
$ pip install --only-binary=:all: package_name
# 可能会失败，需要从源码编译

# Python Alpine 最佳实践
FROM python:3.12-alpine

# 安装编译依赖
RUN apk add --no-cache \
    build-base \
    libffi-dev \
    openssl-dev \
    python3-dev

# 安装 Python 包
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 清理编译依赖（可选）
RUN apk del build-base python3-dev

# Node.js 官方提供 Alpine 版本
$ apk add nodejs npm

# 常见问题：npm 包中的原生模块
# 需要安装编译工具
$ apk add build-base python3

# 特定包的兼容性问题
# sharp, better-sqlite3 等需要编译的包
$ npm install sharp  # 可能需要额外配置

# Node.js Alpine 最佳实践
FROM node:20-alpine

# 安装原生模块编译依赖
RUN apk add --no-cache \
    build-base \
    python3 \
    make \
    g++

WORKDIR /app
COPY package*.json ./
RUN npm ci --production

COPY . .

# Go 原生支持 musl/Alpine
$ apk add go

# Go 使用 CGO 时需要 musl 兼容的 C 库
$ CGO_ENABLED=1 go build -o myapp .

# Go 静态链接（推荐用于容器）
$ CGO_ENABLED=0 go build -o myapp .
$ file myapp
# myapp: ELF 64-bit LSB executable, statically linked

# 使用 CGO 且需要静态链接
$ CGO_ENABLED=1 go build \
    -ldflags '-linkmode external -extldflags "-static"' \
    -o myapp .

# Rust 在 Alpine 上工作良好
$ apk add rust cargo

# 使用 musl target 静态编译
$ rustup target add x86_64-unknown-linux-musl
$ cargo build --target x86_64-unknown-linux-musl --release
$ file target/x86_64-unknown-linux-musl/release/myapp
# myapp: ELF 64-bit LSB executable, statically linked

# 某些程序依赖 glibc 的 fts 函数
# Alpine 上需要安装 musl-fts-dev
$ apk add musl-fts-dev
$ gcc -o program program.c -lfts

# 某些程序依赖 GNU gettext
$ apk add musl-dev gettext-dev
$ gcc -o program program.c -lintl

# glibc 的 crypt 在 libcrypt 中
# musl 的 crypt 内置在 libc 中
# 但 Alpine 也提供了独立的 libxcrypt

$ apk add libxcrypt-dev
$ gcc -o program program.c -lcrypt

/* __attribute__((constructor)) 在 glibc 和 musl 都支持 */
__attribute__((constructor))
static void init(void) {
    /* 在 main() 之前执行 */
}

__attribute__((destructor))
static void cleanup(void) {
    /* 在 main() 之后执行 */
}

int main() {
    return 0;
}

/* 这在两者上都能正常工作 */

#include <string.h>
#include <stdio.h>

int main() {
    char buf[256];

    /* glibc 有两个版本：
     * - GNU 版本：char *strerror_r(int, char *, size_t)  — 返回字符串指针
     * - POSIX 版本：int strerror_r(int, char *, size_t)  — 返回错误码
     *
     * musl 只有 POSIX 版本
     * 使用 _POSIX_C_SOURCE 或 _GNU_SOURCE 来选择
     */

#ifdef _GNU_SOURCE
    /* GNU 版本 */
    char *msg = strerror_r(ENOENT, buf, sizeof(buf));
    printf("Error: %s\n", msg);
#else
    /* POSIX 版本（musl 兼容） */
    int ret = strerror_r(ENOENT, buf, sizeof(buf));
    printf("Error: %s\n", buf);
#endif

    return 0;
}

/*
 * 推荐：使用 POSIX 版本（int 返回值）以保持兼容性
 * 或者使用 snprintf + strerror(errno) 代替
 */

# Alpine 3.15+ 使用 libxcrypt 替代 musl 内置的 crypt
$ apk add libxcrypt-dev

# 编译时可能需要显式链接
$ gcc -o program program.c -lcrypt

#!/bin/bash
# alpine_compat_test.sh — 测试程序在 Alpine/musl 上的兼容性

set -e

PROGRAM="$1"
ERRORS=0

echo "=== Alpine/musl Compatibility Test ==="
echo "Program: $PROGRAM"
echo ""

# 测试 1：动态链接检查
echo "[1/5] Dynamic linking..."
if ldd "$PROGRAM" 2>&1 | grep -q "Not a dynamic executable"; then
    echo "  Static binary - OK"
else
    MISSING=$(ldd "$PROGRAM" 2>&1 | grep "not found" | wc -l)
    if [ "$MISSING" -gt 0 ]; then
        echo "  FAILED: $MISSING libraries not found"
        ldd "$PROGRAM" 2>&1 | grep "not found"
        ERRORS=$((ERRORS + 1))
    else
        echo "  All libraries found - OK"
    fi
fi

# 测试 2：符号检查
echo "[2/5] Symbol check..."
if [ -f "/lib/ld-musl-x86_64.so.1" ]; then
    UNDEF=$(nm -u "$PROGRAM" 2>/dev/null | wc -l)
    echo "  $UNDEF undefined symbols (may be resolved at runtime)"
fi

# 测试 3：运行测试
echo "[3/5] Basic run..."
if timeout 5 "$PROGRAM" --help >/dev/null 2>&1; then
    echo "  Runs successfully - OK"
elif timeout 5 "$PROGRAM" --version >/dev/null 2>&1; then
    echo "  Runs with --version - OK"
else
    echo "  WARNING: Could not run basic test"
fi

# 测试 4：DNS 测试
echo "[4/5] DNS resolution..."
if getent hosts example.com >/dev/null 2>&1; then
    echo "  DNS works - OK"
else
    echo "  WARNING: DNS resolution may not work"
fi

# 测试 5：文件操作测试
echo "[5/5] File operations..."
TMPFILE=$(mktemp)
if echo "test" > "$TMPFILE" && cat "$TMPFILE" >/dev/null 2>&1; then
    echo "  File I/O works - OK"
else
    echo "  FAILED: File I/O issues"
    ERRORS=$((ERRORS + 1))
fi
rm -f "$TMPFILE"

echo ""
echo "=== Result: $ERRORS errors found ==="
exit $ERRORS