Carbone是一款高效、通用且面向未来的文档生成器。通过Carbone,您可以在几分钟内生成各类文档:只需提供模板文件和JSON数据集,引擎即可返回填充数据后的文档。支持多种格式:PDF、ODT、DOCX、XLSX、HTML、XML、PPTX、JPG、PNG、TXT、CSV、EPUB、IDML、ODS、ODG、ODP等。
PDF、ODT、DOCX、XLSX、HTML、XML、PPTX、JPG、PNG、TXT、CSV、EPUB、IDML、ODS、ODG、ODP等。
Carbone注重性能优化,资源需求极低:
Carbone企业版为商业软件,需授权使用。社区版可免费无限制使用基础功能,但不包含高级功能且不提供技术支持。
启动命令:
consoledocker run -t -i --rm -p 4000:4000 carbone/carbone-ee
验证运行状态(需通过API文档了解完整接口):
consolecurl http://主机IP:4000/status
企业版需联系获取授权许可,启动时通过环境变量传入许可证:
启动命令:
consoleexport CARBONE_EE_LICENSE=`cat your_license_file.carbone-license` docker run -t -i --rm -p 4000:4000 -e CARBONE_EE_LICENSE carbone/carbone-ee
验证运行状态:
consolecurl http://主机IP:4000/status
通过环境变量配置Carbone功能,例如启用Studio:
consoledocker run -t --rm -e CARBONE_EE_LICENSE -e CARBONE_EE_STUDIO=true carbone/carbone-ee
完整配置选项参见官方文档。
单实例最小配置(模板存储)
使用S3兼容存储
支持AWS S3、GCS、Azure Blob Storage、MinIO等S3兼容服务,需配置以下环境变量:
AWS_SECRET_ACCESS_KEY:访问密钥AWS_ACCESS_KEY_ID:密钥IDAWS_ENDPOINT_URL:S3服务API地址AWS_REGION:区域(如paris)BUCKET_TEMPLATES:存储模板的桶名称挂载卷存储模板
通过挂载卷存储模板文件(本地文件夹或远程存储):
consoledocker run -t -i --rm -p 4000:4000 -v /本地路径:/app/templates carbone/carbone-ee
详细说明参见文件持久化文档。
多实例配置(渲染结果共享)
多实例部署需确保渲染结果可跨实例访问,可通过以下方式配置:
BUCKET_RENDERS环境变量(同模板存储的S3兼容配置)/app/render目录(需确保卷可读写)提供三种镜像变体,满足不同需求:
| 变体名称格式 | 特点 |
|---|---|
| slim, slim-'Carbone版本' | 精简版,不含LibreOffice(无法生成PDF),可搭配自定义LibreOffice使用 |
| latest, full, full-'Carbone版本', full-'Carbone版本'-L'LibreOffice版本' | 完整版,包含最新LibreOffice |
| latest-fonts, full-fonts, full-'Carbone版本'-fonts, full-'Carbone版本'-L'LibreOffice版本'-fonts | 完整版+字体,包含最新LibreOffice及所有Google Fonts(免版权) |
支持所有容器化环境部署:Docker、Kubernetes、AWS ECS、Azure Container App、CloudRun等。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务