feat: create standalone native fnOS repository

2026-10-02 15:19:09 +08:00
parent 69f3c30fab
commit 6725fc131d
492 changed files with 94023 additions and 3 deletions
@@ -0,0 +1,89 @@
+# 不写 `# syntax=docker/dockerfile:1`：显式指定会让 BuildKit 额外去拉 docker/dockerfile 镜像，
+# 在国内加速器（如飞牛的 docker.fnnas.com）上可能直接 401 Unauthorized；
+# 而下面用到的 RUN --mount=type=cache 由 Docker 内建的 BuildKit frontend 已支持，无需显式指定。
+
+ARG TARGETARCH
+# 版本单一来源：根目录 VERSION 文件，本地改版本号只需改此文件
+ARG VERSION_FILE=VERSION
+
+# 本地项目：基础镜像默认走国内镜像源（fnOS 等环境直连 Docker Hub 会被加速器拦截 401）。
+# 海外/可直连环境可用 --build-arg 或 .env 覆盖回官方名：NODE_IMAGE=node:22-alpine 等
+ARG NODE_IMAGE=docker.m.daocloud.io/library/node:22-alpine
+ARG GO_IMAGE=docker.m.daocloud.io/library/golang:1.23-bookworm
+ARG RUNTIME_IMAGE=docker.m.daocloud.io/library/debian:bookworm-slim
+ARG UPDATER_IMAGE=docker.m.daocloud.io/library/docker:27-cli
+# Go 依赖代理：国内默认 goproxy.cn（官方 proxy.golang.org 国内不可达），海外可覆盖回 direct
+ARG GOPROXY=https://goproxy.cn,direct
+
+# 版本注入 stage：把根目录 VERSION 文件载入构建图，供前后端构建 stage 读取
+FROM ${NODE_IMAGE} AS version
+ARG VERSION_FILE
+COPY ${VERSION_FILE} /VERSION
+
+FROM --platform=$BUILDPLATFORM ${NODE_IMAGE} AS web-builder
+WORKDIR /src/web
+COPY web/package.json web/package-lock.json* ./
+RUN --mount=type=cache,target=/root/.npm npm ci
+COPY web/ ./
+COPY --from=version /VERSION /src/web/.version
+RUN VITE_APP_VERSION=$(tr -d ' \t\n\r' < /src/web/.version) npm run build
+
+FROM --platform=$BUILDPLATFORM ${GO_IMAGE} AS go-builder
+ARG TARGETARCH
+ARG GOPROXY
+ENV GOPROXY=${GOPROXY}
+WORKDIR /src
+COPY go.mod go.sum ./
+RUN --mount=type=cache,target=/go/pkg/mod go mod download
+COPY . .
+COPY --from=version /VERSION ./VERSION
+# 先交叉编译 havline-agent 到 embed 目录（替换仓库中的占位文件），主程序构建时自动内嵌
+RUN --mount=type=cache,target=/go/pkg/mod --mount=type=cache,target=/root/.cache/go-build CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -o internal/frp/agentbin/havline-agent-linux-amd64 ./cmd/havline-agent \
+    && CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -trimpath -o internal/frp/agentbin/havline-agent-linux-arm64 ./cmd/havline-agent
+COPY --from=web-builder /src/web/dist ./cmd/havline/web/dist
+RUN --mount=type=cache,target=/go/pkg/mod --mount=type=cache,target=/root/.cache/go-build CGO_ENABLED=0 GOOS=linux GOARCH=${TARGETARCH} go build \
+    -ldflags "-X github.com/havline/havline/internal/version.Version=$(cat /src/VERSION | tr -d ' \t\n\r')" \
+    -o /havline ./cmd/havline
+
+# 一键升级 sidecar：独立容器持有 Docker Socket，主程序只通过共享 Unix Socket 调用它
+FROM --platform=$BUILDPLATFORM ${GO_IMAGE} AS updater-builder
+ARG TARGETARCH
+ARG GOPROXY
+ENV GOPROXY=${GOPROXY}
+WORKDIR /src
+COPY go.mod go.sum ./
+RUN --mount=type=cache,target=/go/pkg/mod go mod download
+COPY cmd ./cmd
+COPY internal ./internal
+RUN --mount=type=cache,target=/go/pkg/mod --mount=type=cache,target=/root/.cache/go-build CGO_ENABLED=0 GOOS=linux GOARCH=${TARGETARCH} go build -trimpath -o /havline-updater ./cmd/havline-updater
+
+# updater 运行时：Docker CLI / Compose 与 Git 只在 sidecar 内可用
+FROM ${UPDATER_IMAGE} AS updater
+RUN apk add --no-cache git docker-cli-compose docker-cli-buildx ca-certificates
+COPY --from=updater-builder /havline-updater /usr/local/bin/havline-updater
+ENTRYPOINT ["/usr/local/bin/havline-updater"]
+
+# 运行时 stage
+FROM ${RUNTIME_IMAGE}
+ARG TARGETARCH
+# frpc 不预装：需要内网穿透时在「应用配置」弹窗内按需下载（存入数据目录）
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends nginx ca-certificates tzdata \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+COPY --from=go-builder /havline /app/havline
+COPY --from=go-builder /src/web/assets/image /app/web/assets/image
+COPY migrations /app/migrations
+
+# 时区：Go 的 time.Local 取决于 TZ 环境变量，且需要镜像内存在 zoneinfo（故装上 tzdata）
+ENV TZ=Asia/Shanghai \
+    HAVLINE_DATA_DIR=/data \
+    HAVLINE_LISTEN=:6893 \
+    HAVLINE_NGINX_MIME_TYPES=/etc/nginx/mime.types
+
+EXPOSE 6893 80 443
+
+VOLUME ["/data"]
+
+CMD ["/app/havline"]