概要

フル名
docker.io/getlago/lago-gotenberg
Registry
docker.io
名前空間
getlago
リポジトリ
lago-gotenberg
キャッシュ Tag 数
6
最終同期
07/06/2026, 05:12 PM

概要

Lago 账单系统配套的 Gotenberg PDF 渲染 Sidecar,将 HTML/Office 模板转为 PDF 发票,通过 HTTP API 供 lago-api 调用。

詳細

getlago/lago-gotenberg 基于 Gotenberg 封装,为 Lago 开源计费平台提供无状态文档生成能力。lago-api 将发票 HTML POST 至 /forms/chromium/convert/html,返回 PDF 字节流供邮件或对象存储。与独立部署 gotenberg/gotenberg 相比版本与 Lago 发行版对齐;可水平扩展多副本,但单次转换 CPU 密集,生产应限制并发与请求超时。

快速启动

docker run -d --name lago-gotenberg \
  -p 3000:3000 \
  docker.io/getlago/lago-gotenberg:latest

推荐实践

docker run -d --name lago-gotenberg \
  --restart unless-stopped \
  -p 3000:3000 \
  -e GOTENBERG_API_TIMEOUT=120s \
  -e GOTENBERG_CHROMIUM_MAX_QUEUE_SIZE=20 \
  docker.io/getlago/lago-gotenberg:7.9.0

核心参数说明

  • -p 3000:3000 — Gotenberg HTTP API 端口
  • -e GOTENBERG_API_TIMEOUT — 单次 PDF 转换超时
  • -e GOTENBERG_CHROMIUM_MAX_QUEUE_SIZE — Chromium 队列上限
  • --restart unless-stopped — 发票生成链路不中断
  • 固定 tag — 与 Lago 发行版配套
  • 无状态 — 无需持久卷,可随意扩副本

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: lago-gotenberg
spec:
  replicas: 2
  selector:
    matchLabels:
      app: lago-gotenberg
  template:
    metadata:
      labels:
        app: lago-gotenberg
    spec:
      containers:
        - name: gotenberg
          image: docker.io/getlago/lago-gotenberg:7.9.0
          ports:
            - containerPort: 3000
          resources:
            limits:
              cpu: "2"
              memory: 2Gi
---
apiVersion: v1
kind: Service
metadata:
  name: lago-gotenberg
spec:
  selector:
    app: lago-gotenberg
  ports:
    - port: 3000
      targetPort: 3000

lago-api 经 ClusterIP 调用;按 CPU 设置 HPA,Chromium 进程内存建议 requests/limits 预留 1Gi 以上。

Tagアーキテクチャプッシュ日時サイズDigest同期期望操作
docker.io/getlago/lago-gotenberg
:8.15
linux/amd64linux/arm64
2025/09/23 23:04738.2 MBsha256:093267d0b5c9
docker.io/getlago/lago-gotenberg
:latest
linux/amd64linux/arm64
2025/09/23 23:04738.2 MBsha256:093267d0b5c9
docker.io/getlago/lago-gotenberg
:8
linux/amd64linux/arm64
2024/05/07 17:130.0 MBsha256:6c008cec0a43
docker.io/getlago/lago-gotenberg
:7.10
linux/amd64linux/arm64
2024/05/07 17:07682.0 MBsha256:071224d77047
docker.io/getlago/lago-gotenberg
:7.8.2
linux/amd64
2023/05/26 21:10652.7 MBsha256:e8eef6fb4a92
docker.io/getlago/lago-gotenberg
:7
linux/amd64linux/arm64
2022/09/12 20:41643.8 MBsha256:9757e2528b1c