songloft/Dockerfile at main · songloft-org/songloft · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
# syntax=docker/dockerfile:1
# 启用 BuildKit 高级特性，支持缓存挂载

# 关键：固定在原生构建平台（amd64）编译，靠 Go 交叉编译产出目标架构二进制，
# 避免在 QEMU 模拟下跑 Go 编译 + UPX（arm64/armv7 会慢 6~8 倍）。
FROM --platform=$BUILDPLATFORM golang:1.26-alpine AS go-builder

WORKDIR /app

# CGO_ENABLED=0 交叉编译无需 gcc/musl-dev；仅保留 make/upx/git
RUN apk add --no-cache make upx git || \
    (sleep 5 && apk add --no-cache make upx git) || \
    (sleep 10 && apk add --no-cache make upx git)

# 设置 Go 缓存目录（使用标准路径）
ENV GOCACHE=/root/.cache/go-build
ENV GOMODCACHE=/go/pkg/mod

# 构建参数 - 通过 --build-arg 传入
ARG GIT_COMMIT=unknown
ARG BUILD_TIME=unknown
ARG GOPROXY=https://goproxy.cn,https://goproxy.io,direct
ENV GOPROXY=${GOPROXY}
ARG TRACELY_APP_ID=
ARG TRACELY_APP_SECRET=
ARG TRACELY_HOST=

# buildx 自动注入的目标平台参数（用于 Go 交叉编译）
ARG TARGETOS
ARG TARGETARCH
ARG TARGETVARIANT

# 先复制 go.mod 和 go.sum，利用 Docker 层缓存加速依赖下载
COPY go.mod go.sum ./
# 创建目录并复制子模块的 go.mod/go.sum
RUN mkdir -p pkg/tag
COPY pkg/tag/go.mod pkg/tag/go.sum ./pkg/tag/
# 仅下载依赖，此层会被缓存（除非 go.mod/go.sum 变化）
RUN go mod download && go mod verify

# 再复制其余源码
COPY . .

# 使用缓存挂载加速编译（Go 编译缓存会被保留）
# 同时挂载 GOMODCACHE 和 GOCACHE
# Makefile 根据 VERSION=dev 自动启用 dev 编译标签（含 Swagger + pprof）
# 用 build-cross 交叉编译到 $TARGETOS/$TARGETARCH（GOARM 由 $TARGETVARIANT 推导），
# 始终在原生 amd64 上编译 + UPX，产物统一输出为 /app/songloft
ARG LITE_BUILD=false
ARG VERSION
RUN --mount=type=cache,target=/go/pkg/mod \
    --mount=type=cache,target=/root/.cache/go-build \
    set -x && \
    echo "VERSION=[${VERSION}] LITE_BUILD=[${LITE_BUILD}] TARGET=[${TARGETOS}/${TARGETARCH}/${TARGETVARIANT}]" && \
    case "${TARGETVARIANT}" in v7) GOARM=7;; v6) GOARM=6;; *) GOARM=;; esac && \
    if [ "$LITE_BUILD" = "true" ]; then \
        make build-cross GOOS="${TARGETOS}" GOARCH="${TARGETARCH}" GOARM="${GOARM}" OUTPUT=songloft \
            EXTRA_TAGS=lite BUILD_TYPE=lite \
            GIT_COMMIT="${GIT_COMMIT}" BUILD_TIME="${BUILD_TIME}" \
            TRACELY_APP_ID="${TRACELY_APP_ID}" \
            TRACELY_APP_SECRET="${TRACELY_APP_SECRET}" \
            TRACELY_HOST="${TRACELY_HOST}" \
            ${VERSION:+VERSION=${VERSION}}; \
    else \
        make build-cross GOOS="${TARGETOS}" GOARCH="${TARGETARCH}" GOARM="${GOARM}" OUTPUT=songloft \
            GIT_COMMIT="${GIT_COMMIT}" BUILD_TIME="${BUILD_TIME}" \
            TRACELY_APP_ID="${TRACELY_APP_ID}" \
            TRACELY_APP_SECRET="${TRACELY_APP_SECRET}" \
            TRACELY_HOST="${TRACELY_HOST}" \
            ${VERSION:+VERSION=${VERSION}}; \
    fi

# 固定 base 到具体版本 + digest（不用 alpine:latest）：
# docker pull 更新是按 layer digest 去重、与层顺序无关，所以「大层命中缓存」的前提
# 是这些层的 digest 在版本间稳定。alpine:latest 会随上游跳小版本（3.24→3.25）导致
# base 层与 apk 解析结果一起变，用户被迫重拉 ~8MiB 的 apk 层。pin 到 3.24 分支后，
# 该层仅在分支内偶发安全补丁时才变，长期命中本地缓存。
# 刷新方式：docker pull alpine:3.24 && docker inspect --format '{{index .RepoDigests 0}}' alpine:3.24
FROM alpine:3.24@sha256:28bd5fe8b56d1bd048e5babf5b10710ebe0bae67db86916198a6eec434943f8b

# 分层顺序按「变更频率」由低到高排列：越少变动的层越靠前，配合上面的 base pin，
# 保证用户 docker pull 更新时只需下载末尾变动的二进制层，前面的大层命中本地缓存。

# 增加 ALSA 用户态运行时，解决容器内 MPD 打开 ALSA 设备时报
# "No such file or directory" 的问题
RUN apk add --no-cache \
    ca-certificates \
    tzdata \
    alsa-lib \
    alsa-plugins \
    alsa-utils \
    alsa-ucm-conf \
    pulseaudio-utils

# 设置默认时区为东八区
ENV TZ=Asia/Shanghai

WORKDIR /app

# 创建挂载目录（静态，无外部依赖）
# /app/music - 音乐文件存储目录
# /app/data - 应用数据存储目录
RUN mkdir -p /app/music /app/data

# --link 使 COPY 层与 parent 层解耦：即使 apk add 层因包更新而变化，
# 下面这些层的 digest 也保持不变（不再受 parent chain 影响）。
# 直接引用 hanxi/ffmpeg:latest，始终拉取上游最新的 ffmpeg/ffprobe，无需手动维护/刷新 digest。
COPY --link --from=hanxi/ffmpeg:latest /ffmpeg /bin/ffmpeg
COPY --link --from=hanxi/ffmpeg:latest /ffprobe /bin/ffprobe

# 启动脚本小、极少变动（--chmod 合并原独立 chmod 层）
COPY --link --chmod=0755 scripts/docker-entrypoint.sh /app/docker-entrypoint.sh

# 主程序二进制每次构建都变 → 放在最后一个 content 层，更新时仅此层需重新下载
COPY --link --from=go-builder /app/songloft /app/songloft

EXPOSE 58091

# 挂载点说明：
# /app/music - 音乐文件目录，建议挂载: -v /your/music/path:/app/music
# /app/data - 数据目录，建议挂载: -v /your/data/path:/app/data
ENV ADMIN_USERNAME=admin
ENV ADMIN_PASSWORD=admin
ENV IN_DOCKER=true

VOLUME ["/app/music", "/app/data"]

ENTRYPOINT ["/app/docker-entrypoint.sh"]
CMD []