Bun Docker 部署指南：官方镜像、多阶段构建、生产环境配置与开发热重载

Bun Docker by secondsky/claude-skills

98 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/secondsky/claude-skills --skill 'Bun Docker'

Node.js 开发开发运维

🇨🇳中文介绍

Bun Docker

使用官方镜像在 Docker 容器中部署 Bun 应用程序。

官方镜像

# 最新稳定版
docker pull oven/bun

# 特定版本
docker pull oven/bun:1.0.0

# 变体
oven/bun:latest       # 完整镜像 (~100MB)
oven/bun:slim         # 最小化镜像 (~80MB)
oven/bun:alpine       # 基于 Alpine (~50MB)
oven/bun:distroless   # Distroless (~60MB)
oven/bun:debian       # 基于 Debian (~100MB)

基础 Dockerfile

FROM oven/bun:1 AS base

WORKDIR /app

# 安装依赖
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

# 复制源代码
COPY . .

# 运行
EXPOSE 3000
CMD ["bun", "run", "src/index.ts"]

多阶段构建（生产环境）

# 构建阶段
FROM oven/bun:1 AS builder

WORKDIR /app

COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

COPY . .
RUN bun run build

# 生产阶段
FROM oven/bun:1-slim AS production

WORKDIR /app

# 仅复制生产依赖
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile --production

# 复制构建产物
COPY --from=builder /app/dist ./dist

# 以非 root 用户运行
USER bun

EXPOSE 3000
CMD ["bun", "run", "dist/index.js"]

Alpine 镜像

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

开发环境热重载

# docker-compose.dev.yml
version: "3.8"

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile.dev
    ports:
      - "3000:3000"
    volumes:
      - ./src:/app/src
      - ./package.json:/app/package.json
    command: bun --hot run src/index.ts



# Dockerfile.dev
FROM oven/bun:1

WORKDIR /app

COPY package.json bun.lockb ./
RUN bun install

# 源代码作为卷挂载
CMD ["bun", "--hot", "run", "src/index.ts"]

编译二进制文件

FROM oven/bun:1 AS builder

WORKDIR /app
COPY . .
RUN bun install --frozen-lockfile
RUN bun build src/index.ts --compile --outfile=server

# 最小化运行时
FROM ubuntu:22.04

# 安装运行时依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates \
    && rm -rf /var/lib/apt/lists/*

COPY --from=builder /app/server /usr/local/bin/server

USER nobody
EXPOSE 3000
CMD ["server"]

在 Docker 中使用 SQLite

FROM oven/bun:1

WORKDIR /app

COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

COPY . .

# 创建数据目录
RUN mkdir -p /app/data

# SQLite 数据库卷
VOLUME /app/data

ENV DATABASE_PATH=/app/data/app.sqlite

CMD ["bun", "run", "src/index.ts"]

FROM oven/bun:1

WORKDIR /app
COPY . .
RUN bun install --frozen-lockfile

EXPOSE 3000

HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
  CMD curl -f http://localhost:3000/health || exit 1

CMD ["bun", "run", "src/index.ts"]



// 健康检查端点
app.get("/health", (c) => c.json({ status: "ok" }));

FROM oven/bun:1

WORKDIR /app

# 构建时参数
ARG NODE_ENV=production
ARG API_URL

# 运行时环境变量
ENV NODE_ENV=${NODE_ENV}
ENV API_URL=${API_URL}

COPY . .
RUN bun install --frozen-lockfile

CMD ["bun", "run", "src/index.ts"]



# 使用参数构建
docker build --build-arg API_URL=https://api.example.com -t myapp .

# 使用环境变量运行
docker run -e DATABASE_URL=postgres://... myapp

FROM oven/bun:1 AS base

WORKDIR /app

# 单独缓存依赖
FROM base AS deps
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

# 构建
FROM deps AS builder
COPY . .
RUN bun run build

# 生产环境
FROM base AS runner
COPY --from=deps /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
COPY package.json ./

USER bun
CMD ["bun", "run", "dist/index.js"]

FROM oven/bun:1-slim

WORKDIR /app

# 不要以 root 用户运行
USER bun

# 使用正确的所有权复制文件
COPY --chown=bun:bun package.json bun.lockb ./
RUN bun install --frozen-lockfile --production

COPY --chown=bun:bun . .

# 只读文件系统
# (与 docker run --read-only 一起使用)

EXPOSE 3000
CMD ["bun", "run", "src/index.ts"]

node_modules
.git
.gitignore
*.md
Dockerfile*
docker-compose*
.env*
.DS_Store
coverage
dist
.bun

# 构建
docker build -t myapp .

# 运行
docker run -p 3000:3000 myapp

# 使用环境变量文件运行
docker run --env-file .env -p 3000:3000 myapp

# 交互式 shell
docker run -it oven/bun sh

# 检查 Bun 版本
docker run oven/bun bun --version

错误	原因	解决方法
`bun.lockb not found`	缺少锁文件	在本地运行 `bun install`
`EACCES permission`	文件所有权问题	使用 `--chown=bun:bun`
`OOM killed`	内存限制	增加容器内存
`No space left`	层过大	使用多阶段构建

何时加载参考文档

在以下情况下加载 references/optimization.md：

镜像大小优化
层缓存
构建性能

在以下情况下加载 references/kubernetes.md：

K8s 部署
水平扩展
服务网格

🇺🇸English

Bun Docker

Deploy Bun applications in Docker containers using official images.

Official Images

# Latest stable
docker pull oven/bun

# Specific version
docker pull oven/bun:1.0.0

# Variants
oven/bun:latest       # Full image (~100MB)
oven/bun:slim         # Minimal image (~80MB)
oven/bun:alpine       # Alpine-based (~50MB)
oven/bun:distroless   # Distroless (~60MB)
oven/bun:debian       # Debian-based (~100MB)

Basic Dockerfile

FROM oven/bun:1 AS base

WORKDIR /app

# Install dependencies
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

# Copy source
COPY . .

# Run
EXPOSE 3000
CMD ["bun", "run", "src/index.ts"]

Multi-Stage Build (Production)

# Build stage
FROM oven/bun:1 AS builder

WORKDIR /app

COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

COPY . .
RUN bun run build

# Production stage
FROM oven/bun:1-slim AS production

WORKDIR /app

# Copy only production dependencies
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile --production

# Copy built assets
COPY --from=builder /app/dist ./dist

# Run as non-root
USER bun

EXPOSE 3000
CMD ["bun", "run", "dist/index.js"]

Alpine Image

FROM oven/bun:1-alpine

WORKDIR /app

# Alpine uses apk for packages
RUN apk add --no-cache git

COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

COPY . .

CMD ["bun", "run", "src/index.ts"]

Distroless Image

# Build stage
FROM oven/bun:1 AS builder

WORKDIR /app
COPY . .
RUN bun install --frozen-lockfile
RUN bun build src/index.ts --compile --outfile=app

# Runtime stage
FROM gcr.io/distroless/base

COPY --from=builder /app/app /app

ENTRYPOINT ["/app"]

Docker Compose

# docker-compose.yml
version: "3.8"

services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - DATABASE_URL=postgres://db:5432/app
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: app
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

Hot Reload in Development

# docker-compose.dev.yml
version: "3.8"

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile.dev
    ports:
      - "3000:3000"
    volumes:
      - ./src:/app/src
      - ./package.json:/app/package.json
    command: bun --hot run src/index.ts



# Dockerfile.dev
FROM oven/bun:1

WORKDIR /app

COPY package.json bun.lockb ./
RUN bun install

# Source mounted as volume
CMD ["bun", "--hot", "run", "src/index.ts"]

Compiled Binary

FROM oven/bun:1 AS builder

WORKDIR /app
COPY . .
RUN bun install --frozen-lockfile
RUN bun build src/index.ts --compile --outfile=server

# Minimal runtime
FROM ubuntu:22.04

# Install runtime dependencies
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates \
    && rm -rf /var/lib/apt/lists/*

COPY --from=builder /app/server /usr/local/bin/server

USER nobody
EXPOSE 3000
CMD ["server"]

SQLite with Docker

FROM oven/bun:1

WORKDIR /app

COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

COPY . .

# Create data directory
RUN mkdir -p /app/data

# Volume for SQLite database
VOLUME /app/data

ENV DATABASE_PATH=/app/data/app.sqlite

CMD ["bun", "run", "src/index.ts"]

Health Checks

FROM oven/bun:1

WORKDIR /app
COPY . .
RUN bun install --frozen-lockfile

EXPOSE 3000

HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
  CMD curl -f http://localhost:3000/health || exit 1

CMD ["bun", "run", "src/index.ts"]



// Health endpoint
app.get("/health", (c) => c.json({ status: "ok" }));

Environment Variables

FROM oven/bun:1

WORKDIR /app

# Build-time args
ARG NODE_ENV=production
ARG API_URL

# Runtime env
ENV NODE_ENV=${NODE_ENV}
ENV API_URL=${API_URL}

COPY . .
RUN bun install --frozen-lockfile

CMD ["bun", "run", "src/index.ts"]



# Build with args
docker build --build-arg API_URL=https://api.example.com -t myapp .

# Run with env
docker run -e DATABASE_URL=postgres://... myapp

Caching Optimization

FROM oven/bun:1 AS base

WORKDIR /app

# Cache dependencies separately
FROM base AS deps
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

# Build
FROM deps AS builder
COPY . .
RUN bun run build

# Production
FROM base AS runner
COPY --from=deps /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
COPY package.json ./

USER bun
CMD ["bun", "run", "dist/index.js"]

Security Best Practices

FROM oven/bun:1-slim

WORKDIR /app

# Don't run as root
USER bun

# Copy with correct ownership
COPY --chown=bun:bun package.json bun.lockb ./
RUN bun install --frozen-lockfile --production

COPY --chown=bun:bun . .

# Read-only filesystem
# (use with: docker run --read-only)

EXPOSE 3000
CMD ["bun", "run", "src/index.ts"]

.dockerignore

node_modules
.git
.gitignore
*.md
Dockerfile*
docker-compose*
.env*
.DS_Store
coverage
dist
.bun

Common Commands

# Build
docker build -t myapp .

# Run
docker run -p 3000:3000 myapp

# Run with env file
docker run --env-file .env -p 3000:3000 myapp

# Interactive shell
docker run -it oven/bun sh

# Check Bun version
docker run oven/bun bun --version

Common Errors

Error	Cause	Fix
`bun.lockb not found`	Missing lockfile	Run `bun install` locally
`EACCES permission`	File ownership	Use `--chown=bun:bun`
`OOM killed`	Memory limit	Increase container memory
`No space left`	Large layers

When to Load References

Load references/optimization.md when:

Image size reduction
Layer caching
Build performance

Load references/kubernetes.md when:

K8s deployment
Horizontal scaling
Service mesh

Weekly Installs

–

Repository

secondsky/claude-skills

GitHub Stars

First Seen

–

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

114,200 周安装

Bun Docker 部署指南：官方镜像、多阶段构建、生产环境配置与开发热重载

🇨🇳中文介绍

Bun Docker

官方镜像

基础 Dockerfile

多阶段构建（生产环境）

Alpine 镜像

相关 Skills

Distroless 镜像

Docker Compose

开发环境热重载

编译二进制文件

在 Docker 中使用 SQLite

健康检查

环境变量

缓存优化

安全最佳实践

.dockerignore

常用命令

常见错误

何时加载参考文档

🇺🇸English

Bun Docker

Official Images

Basic Dockerfile

Multi-Stage Build (Production)

Alpine Image

Distroless Image

Docker Compose

Hot Reload in Development

Compiled Binary

SQLite with Docker

Health Checks

Environment Variables

Caching Optimization

Security Best Practices

.dockerignore

Common Commands

Common Errors

When to Load References

最新 Skills