基础介绍

ZRPBX适应各种部署方式，本文使用 Docker 和 Docker compose 的方式，适合体验、开发、测试和上线ZRPBX，此种方式简单快捷。

准备条件

前提

项目	说明
操作系统	Linux (CentOS 7.x, Debian11, Ubuntu 20+ 等)，推荐使用 Debian11。
Docker 版本	Docker version 20.01.x 及以上
Docker-compose	2.30.x 及以上
其他软件	git， make
内存	2GB及上
CPU	核心数>=2，arm64/X86
存储	>=20GB

克隆代码

git clone url prod
cd prod/release

配置项

cd prod/release
cp env.example .env

以下为部署相关的环境变量，可以在 .env 中覆盖默认值。

key	默认值	说明
MYSQL_ROOT_PASSWORD	guanyu401	数据库ROOT密码
MYSQL_DATABASE	uam	数据库名称
MYSQL_USER	uam	数据库用户名
MYSQL_PASSWORD	guanyu401	数据库密码
HTTP_PORT	8000	HTTP端口
PBX_GATEWAY_URL	http://127.0.0.1:8000/api/v1/pbx-gateway	网关地址
PBX_EVENT_URI	ws://127.0.0.1:8000/api/v1/pbx-event-push	ws事件地址

注意

以上配置中，端口的各默认值需要保证在宿主机器上还没有被占用；数据库的密码尽量复杂；PBX_GATEWAY_URL 和 PBX_EVENT_URI 这两个值尽量不要变更。

管理命令

启动服务

cd prod/release    #进入下载后的文件夹
make up            #首次部署会自动拉取镜像并启动服务，后续则为启动服务
make pull          #拉取docker镜像

查看服务状态

docker ps

查看服务日志

docker logs -f <CONTAINER ID>

关闭服务

cd prod/release    #进入下载后的文件夹
make down            #首次部署会自动拉取镜像并启动服务，后续则为启动服务

无网络访问条件下部署

首先，找一个网络条件好的电脑或服务器，执行以上操作

导出镜像

cd prod/   #进入下载后的文件夹
docker save <IMAGE>:<VERSION> > zrpbx.image.tar.gz

打包文件目录

tar -czvf zrpbx.tar.gz prod

上传镜像

将所有导出的 tar.gz 文件上传到目标部署的服务器，即网络条件不好的机器，比如用 FTP 工具或 SCP、rz命令。

注意

需提前安装好docker、make、docker-compose

离线安装

cd   #到目标安装目录
tar zxvf zrpbx.tar.gz   #解压安装目录
cd prod      #进入安装目录
docker load < zrpbx.image.tar.gz   #安装docker镜像
cd prod/release  #进入安装目录
cp env.example .env   #添加配置文件
rm -rf .cached   #清除前置缓存