单机 RPM 快速试用

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

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

运行快速开始脚本

将许可证随附的安装包复制到主机。文件名、发行版和架构请参考获取安装包。然后解压并运行安装包内置的 quickstart.sh：

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

--no-same-owner 选项让解压出的文件归执行解压的用户所有。v3.10.10 之前发布的安装包中，文件属主记录为构建机上的用户，以 root 身份运行 tar 时会保留这个属主。

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

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 --no-same-owner'
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 的镜像。

后续步骤

• 启用控制台指标：安装 Prometheus。
• API7 网关 3.10.2 及更高版本提供 RPM 选项。较早版本或不显示该选项的定制控制台，请使用从 Docker 脚本手动接入 RPM 数据面这一备用流程。
• 查看运维、端口、升级和故障排查说明：使用离线 RPM 包部署。