# ============================================================================= # Sub2API Multi-Stage Dockerfile # ============================================================================= # Stage 1: Build frontend # Stage 2: Build Go backend with embedded frontend # Stage 3: Final minimal image # ============================================================================= ARG NODE_IMAGE=node:24-alpine ARG GOLANG_IMAGE=golang:1.26.1-alpine ARG ALPINE_IMAGE=alpine:3.21 ARG DEBIAN_IMAGE=debian:bookworm-slim ARG POSTGRES_IMAGE=postgres:18-alpine ARG GOPROXY=https://goproxy.cn,direct ARG GOSUMDB=sum.golang.google.cn # ----------------------------------------------------------------------------- # Stage 1: Frontend Builder # ----------------------------------------------------------------------------- FROM ${NODE_IMAGE} AS frontend-builder WORKDIR /app/frontend # Install pnpm RUN corepack enable && corepack prepare pnpm@latest --activate # Install dependencies first (better caching) COPY frontend/package.json frontend/pnpm-lock.yaml ./ RUN pnpm install --frozen-lockfile # Copy frontend source and build COPY frontend/ ./ RUN pnpm run build # ----------------------------------------------------------------------------- # Stage 2: Backend Builder # ----------------------------------------------------------------------------- FROM ${GOLANG_IMAGE} AS backend-builder # Build arguments for version info (set by CI) ARG VERSION= ARG COMMIT=docker ARG DATE ARG GOPROXY ARG GOSUMDB ENV GOPROXY=${GOPROXY} ENV GOSUMDB=${GOSUMDB} # Install build dependencies RUN apk add --no-cache git ca-certificates tzdata WORKDIR /app/backend # Copy go mod files first (better caching) COPY backend/go.mod backend/go.sum ./ RUN go mod download # Copy backend source first COPY backend/ ./ # Copy frontend dist from previous stage (must be after backend copy to avoid being overwritten) COPY --from=frontend-builder /app/backend/internal/web/dist ./internal/web/dist # Build the binary (BuildType=release for CI builds, embed frontend) # Version precedence: build arg VERSION > cmd/server/VERSION ARG TARGETARCH ARG TARGETOS=linux RUN VERSION_VALUE="${VERSION}" && \ if [ -z "${VERSION_VALUE}" ]; then VERSION_VALUE="$(tr -d '\r\n' < ./cmd/server/VERSION)"; fi && \ DATE_VALUE="${DATE:-$(date -u +%Y-%m-%dT%H:%M:%SZ)}" && \ CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} go build \ -tags embed \ -ldflags="-s -w -X main.Version=${VERSION_VALUE} -X main.Commit=${COMMIT} -X main.Date=${DATE_VALUE} -X main.BuildType=release" \ -trimpath \ -o /app/sub2api \ ./cmd/server # ----------------------------------------------------------------------------- # Stage 3: PostgreSQL Client (version-matched with docker-compose) # ----------------------------------------------------------------------------- FROM ${POSTGRES_IMAGE} AS pg-client # ----------------------------------------------------------------------------- # Stage 4: Final Runtime Image (Debian for glibc — LS binary requires it) # ----------------------------------------------------------------------------- FROM ${DEBIAN_IMAGE} # Labels LABEL maintainer="Wei-Shaw " LABEL description="Sub2API - AI API Gateway Platform" LABEL org.opencontainers.image.source="https://github.com/Wei-Shaw/sub2api" # Install runtime dependencies RUN apt-get update && apt-get install -y --no-install-recommends \ ca-certificates \ curl \ wget \ gosu \ proxychains4 \ tzdata \ libpq5 \ && rm -rf /var/lib/apt/lists/* # Copy pg_dump and psql from the same postgres image used in docker-compose COPY --from=pg-client /usr/local/bin/pg_dump /usr/local/bin/pg_dump COPY --from=pg-client /usr/local/bin/psql /usr/local/bin/psql COPY --from=pg-client /usr/local/lib/libpq.so.5* /usr/local/lib/ RUN ldconfig # Create non-root user RUN groupadd -g 1000 sub2api && \ useradd -u 1000 -g sub2api -m -s /bin/sh sub2api # Set working directory WORKDIR /app # Copy binary/resources with ownership to avoid extra full-layer chown copy COPY --from=backend-builder --chown=sub2api:sub2api /app/sub2api /app/sub2api COPY --from=backend-builder --chown=sub2api:sub2api /app/backend/resources /app/resources # Copy Language Server binary and cert (for LS pool mode) # Enable with: ANTIGRAVITY_LS_MODE=true ANTIGRAVITY_APP_ROOT=/app/ls # TARGETARCH is set automatically by buildx (amd64 or arm64) ARG TARGETARCH COPY --chown=sub2api:sub2api deploy/ls-bin/language_server_linux_* /tmp/ls-bin/ COPY --chown=sub2api:sub2api deploy/ls-bin/cert.pem /app/ls/extensions/antigravity/dist/languageServer/ RUN mkdir -p /app/ls/extensions/antigravity/bin && \ if [ "$TARGETARCH" = "arm64" ]; then \ cp /tmp/ls-bin/language_server_linux_arm /app/ls/extensions/antigravity/bin/language_server_linux_arm; \ else \ cp /tmp/ls-bin/language_server_linux_x64 /app/ls/extensions/antigravity/bin/language_server_linux_x64; \ fi && \ chmod +x /app/ls/extensions/antigravity/bin/language_server_linux_* && \ rm -rf /tmp/ls-bin # Create data directory RUN mkdir -p /app/data && chown sub2api:sub2api /app/data # Copy entrypoint script (fixes volume permissions then drops to sub2api) COPY deploy/docker-entrypoint.sh /app/docker-entrypoint.sh RUN chmod +x /app/docker-entrypoint.sh # Expose port (can be overridden by SERVER_PORT env var) EXPOSE 8080 # Health check HEALTHCHECK --interval=30s --timeout=10s --start-period=10s --retries=3 \ CMD wget -q -T 5 -O /dev/null http://localhost:${SERVER_PORT:-8080}/health || exit 1 # Run the application (entrypoint fixes /app/data ownership then execs as sub2api) ENTRYPOINT ["/app/docker-entrypoint.sh"] CMD ["/app/sub2api"]