概要

フル名
docker.io/akkuman/headless-wps
Registry
docker.io
名前空間
akkuman
リポジトリ
headless-wps
キャッシュ Tag 数
7
最終同期
07/06/2026, 10:01 AM

概要

Headless WPS 文档转换服务镜像,无 GUI 将 Office 文档转为 PDF/图片,适合 OA 预览与批量格式转换 API。

詳細

akkuman/headless-wps 在 Linux 无头环境运行 WPS 进行 doc/xls/ppt 转换,典型替代 LibreOffice 在某些格式兼容性场景。定位为文档转换 API 服务,需 Xvfb 或 headless 模式与字体 volume;K8s 可 Deployment,注意 license 与资源占用。

快速启动

docker run -d --name headless-wps \
  -p 8080:8080 \
  docker.io/akkuman/headless-wps:latest

推荐实践

docker run -d --name headless-wps \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /usr/share/fonts:/usr/share/fonts:ro \
  --shm-size=1g \
  docker.io/akkuman/headless-wps:1.0.0

核心参数说明

  • -p 8080:8080 — 转换 API HTTP 端口
  • -v .../fonts:... — CJK 字体目录
  • --shm-size=1g — WPS 进程共享内存
  • --restart unless-stopped — 转换服务持续在线
  • 许可 — 遵守 WPS 授权条款

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: headless-wps
spec:
  replicas: 2
  selector:
    matchLabels:
      app: headless-wps
  template:
    metadata:
      labels:
        app: headless-wps
    spec:
      containers:
        - name: wps
          image: docker.io/akkuman/headless-wps:1.0.0
          ports:
            - containerPort: 8080
          volumeMounts:
            - name: fonts
              mountPath: /usr/share/fonts
              readOnly: true
      volumes:
        - name: fonts
          configMap:
            name: cjk-fonts
---
apiVersion: v1
kind: Service
metadata:
  name: headless-wps
spec:
  selector:
    app: headless-wps
  ports:
    - port: 8080
      targetPort: 8080

转换 CPU 密集;队列化请求并 limit 并发防 OOM。

Tagアーキテクチャプッシュ日時サイズDigest同期期望操作
docker.io/akkuman/headless-wps
:latest
linux/amd64
2025/09/19 11:121.1 GBsha256:bdc79260addd
docker.io/akkuman/headless-wps
:v1.2.0
linux/amd64
2025/09/19 11:121.1 GBsha256:bdc79260addd
docker.io/akkuman/headless-wps
:v1.1.3
linux/amd64
2025/09/19 10:231.2 GBsha256:a2e8de283ea7
docker.io/akkuman/headless-wps
:v1.1.2
linux/amd64
2025/08/26 16:141.1 GBsha256:21e94086321f
docker.io/akkuman/headless-wps
:v1.1.1
linux/amd64
2025/08/21 13:421.1 GBsha256:2653d5ed9a7d
docker.io/akkuman/headless-wps
:v1.1.0
linux/amd64
2025/08/21 13:211.1 GBsha256:e9d7b1d06a1b
docker.io/akkuman/headless-wps
:v1.0.0
linux/amd64
2023/08/02 16:28785.1 MBsha256:6ba867896e9b