vicanso/pingap

Pingap Docker镜像文档

镜像概述

Pingap是基于pingora构建的高性能反向代理，提供预构建的Docker镜像，可直接运行。该镜像适用于需要高性能请求转发、负载均衡的服务场景。注意：由于升级操作需守护进程模式，Docker运行环境下配置变更无法自动重启应用。

核心功能与特性

• 高性能：基于pingora构建，具备高性能反向代理能力
• 配置热更新：支持upstream和location配置热更新（通过--autoreload启用），无需重启应用
• Web管理后端：可通过--admin参数启用Web管理后端，支持基于base64编码认证
• 多端口监听：默认使用80和443端口提供服务，3018端口用于Web管理后端

使用场景

• 作为服务网关，实现请求转发与负载均衡
• 需要频繁更新上游服务（upstream）或路由规则（location）配置的场景
• 需通过Web界面管理反向代理配置的场景

使用方法与配置说明

基本运行命令

bash
docker run -it -d --restart=always \
  -v $PWD/pingap:/opt/pingap \
  -p 3018:3018 \
  -p 80:80 \
  -p 443:443 \
  vicanso/pingap -c /opt/pingap/conf \
  --autoreload \
  --admin=cGluZ2FwOjEyMzEyMw==@0.0.0.0:3018

参数说明

容器运行参数

• -v $PWD/pingap:/opt/pingap: 将宿主机当前目录下的pingap文件夹挂载到容器内/opt/pingap，用于持久化配置文件
• -p 3018:3018: 映射Web管理后端端口（容器内3018端口映射到宿主机3018端口）
• -p 80:80/-p 443:443: 映射服务监听端口，用于反向代理服务

应用启动参数

• -c /opt/pingap/conf: 指定配置文件目录
• --autoreload: 启用upstream和location配置热更新，无需重启应用即可生效
• --admin=<auth>@<address>: 启用Web管理后端，<auth>为base64编码的认证信息（格式：用户名:密码），<address>为管理后端监听地址和端口

认证信息说明

示例中cGluZ2FwOjEyMzEyMw==是pingap:123123的base64编码值，用于Web管理后端的身份认证。可通过以下命令生成自定义认证信息：

bash
echo -n "用户名:密码" | base64

配置热更新说明

--autoreload参数仅支持upstream（上游服务）和location（路由规则）两类配置的热更新，其他类型配置仍需重启容器生效。