单机 RPM 快速试用

你可以使用 RPM 包内置的 quickstart.sh 在单台主机上快速拉起控制面，用于产品评估或概念验证（PoC）。该脚本会安装 RPM、安装并初始化 PostgreSQL、创建数据库和角色、生成随机密码并写入配置，最后启动控制面并打印访问地址和默认凭据。

本文仅适用于单机评估。它会配置本地 PostgreSQL，因此目标主机需要能从在线仓库或预置的离线仓库获取 PostgreSQL 依赖，除非 PostgreSQL 已经安装。生产环境如需使用外部或高可用数据库、CP/DP 分离和安全加固，请使用离线 RPM 包标准部署。

运行快速开始脚本

下载与主机匹配的安装包。如何确认 <version>、<dist> 和 <arch>，请参考获取安装包：

export API7EE_VERSION="3.10.1"   # 要安装的版本
export API7EE_DIST="el9"         # 来自 /etc/os-release 的 PLATFORM_ID
export API7EE_ARCH="x86_64"      # 来自 uname -m
curl -fSLO "https://run.api7.ai/api7-ee/api7-ee-rpm-${API7EE_VERSION}-${API7EE_DIST}.${API7EE_ARCH}.tar.gz"

解压并运行安装包内置的 quickstart.sh：

tar -xzf api7-ee-rpm-<version>-<dist>.<arch>.tar.gz
cd api7-ee-rpm-<version>-<dist>.<arch>/
sudo ./quickstart.sh

脚本完成后，根据终端提示继续：

1. 打开输出中的 https://<host>:7443，使用 admin / admin 登录并修改密码，然后上传许可证，直到状态正常。
2. 接入数据面：在控制台创建网关组，点击 Add Instance，选择 RPM，在安装了 api7-gateway 的主机上运行生成的脚本。更多说明见接入数据面网关。

在容器中评估

所有组件都是 systemd 服务，因此容器也必须以 systemd 作为 PID 1 运行。否则 quickstart.sh 会在执行 systemctl 或 postgresql-setup 时失败，并输出 System has not been booted with systemd as init system。示例：

docker run -d --name api7-eval --privileged \
  -v /sys/fs/cgroup:/sys/fs/cgroup:rw --cgroupns=host \
  -p 7443:7443 -p 9080:9080 -p 9443:9443 \
  rockylinux:8 /sbin/init        # el9 评估可使用 rockylinux:9
docker cp api7-ee-rpm-<version>-<dist>.<arch>.tar.gz api7-eval:/root/
docker exec api7-eval bash -lc 'cd /root && tar -xzf api7-ee-rpm-*.tar.gz'
docker exec -it api7-eval bash -lc 'cd /root/api7-ee-rpm-*/ && ./quickstart.sh'

rockylinux:8 等基础镜像默认可能不包含 systemd。如果 /sbin/init 不存在，请先安装 systemd（dnf -y install systemd），或使用已经支持 systemd 的镜像。

后续步骤

• 启用控制台（Dashboard）指标：安装 Prometheus。
• 通过 RPM 接入更多网关：从 Docker 脚本接入 RPM 数据面。
• 查看运维、端口、升级和故障排查说明：使用离线 RPM 包部署。