概述

本 AMI 指南面向 AWS Marketplace 用户，提供 ComPDF 转换能力的自托管部署方式。用户通过 Marketplace 启动 EC2 实例后，配置 License 并启动服务，即可通过 HTTP API 在同一 VPC（私有网络）内由你的应用访问并完成 PDF 转换处理；如需从公网访问，请为 EC2 实例分配公网地址并在安全组中放行 7000 端口，同时建议限制来源 IP。

---

1. 组件架构

该 AMI 使用 Docker Compose 管理并启动两个容器：

• compdfkit_processor

  • 镜像：compdfkit/compdfkit:3.2.1
  • 作用：对外提供 PDF 转换 HTTP API
  • 对外端口：7000/tcp

• dbmysql

  • 镜像：mysql:8.0.27
  • 作用：服务数据库（默认与 processor 一起启动）

---

2. 关键端口

• 7000/tcp：对外提供 API 服务（需要在安全组放行才可访问）
• 22/tcp：SSH 登录管理（建议限制来源 IP）
• 3306/tcp：MySQL 端口（是否开放由用户自行决定；若无明确需要，不建议对公网开放）

---

3. 关键文件与目录

• Docker Compose 文件：/var/www/compdf/docker-compose.yml
• 数据库初始化脚本：/var/www/compdf/compdfkit.sql
• MySQL 数据持久化目录：/var/www/compdf/data/

---

4. License 说明（重要）

该 AMI 需要用户自行提供 LICENSE_KEY 并写入 docker-compose.yml 后才能启动使用。

购买/获取 License：

• 联系我们的销售团队，获取您的许可证密钥。