概要

フル名
docker.io/savatar101/marker-api
Registry
docker.io
名前空間
savatar101
リポジトリ
marker-api
キャッシュ Tag 数
3
最終同期
07/06/2026, 12:49 PM

概要

Marker PDF 转 Markdown API 服务镜像,OCR 与版面分析提取学术 PDF 结构化文本,适合 RAG 文档预处理与知识库 ingestion。

詳細

savatar101/marker-api 封装 VikParuchuri/marker 流水线,上传 PDF 返回 Markdown/JSON 结构化内容。典型用于 RAG 知识库文档清洗,与 unstructured-api 同类但专注 PDF 学术排版。生产应固定 tag、挂载模型缓存 volume、限制上传大小并启用 API Key,GPU 可显著加速 OCR。

快速启动

docker run -d --name marker-api \
  -p 8000:8000 \
  -v $(pwd)/cache:/root/.cache \
  docker.io/savatar101/marker-api:latest

推荐实践

docker run -d --name marker-api \
  --restart unless-stopped \
  -p 8000:8000 \
  -v /data/marker/cache:/root/.cache \
  -e API_KEY=team-shared-key \
  -e MAX_UPLOAD_MB=50 \
  docker.io/savatar101/marker-api:0.2.0

核心参数说明

  • -p 8000:8000 — PDF 转换 REST API
  • -v .../cache:... — 模型权重缓存
  • -e API_KEY — 客户端访问密钥
  • -e MAX_UPLOAD_MB — 单文件上传上限
  • --restart unless-stopped — 文档预处理服务持续在线
  • 固定 tag — OCR 模型与 API 版本 pin

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: marker-api
spec:
  replicas: 2
  selector:
    matchLabels:
      app: marker-api
  template:
    metadata:
      labels:
        app: marker-api
    spec:
      containers:
        - name: marker
          image: docker.io/savatar101/marker-api:0.2.0
          ports:
            - containerPort: 8000
          envFrom:
            - secretRef:
                name: marker-api-secrets
          volumeMounts:
            - name: cache
              mountPath: /root/.cache
      volumes:
        - name: cache
          persistentVolumeClaim:
            claimName: marker-cache
---
apiVersion: v1
kind: Service
metadata:
  name: marker-api
spec:
  selector:
    app: marker-api
  ports:
    - port: 8000
      targetPort: 8000

模型缓存 PVC 避免重复下载;GPU 节点可选加速,Ingress 限制内网与 body size,与 RAG ingestion worker 队列对接。

Tagアーキテクチャプッシュ日時サイズDigest同期期望操作
docker.io/savatar101/marker-api
:0.3
linux/amd64
2024/06/20 03:128.0 GBsha256:5c5660cd0c38
docker.io/savatar101/marker-api
:0.2
linux/amd64
2024/06/01 21:518.1 GBsha256:83b290a54be6
docker.io/savatar101/marker-api
:0.1
linux/amd64
2024/05/31 20:158.0 GBsha256:07e5bc1118d9