针对政务、国企、医院、军工等内网物理隔离的客户,有时需要多次摆渡才能到达要安装软件的服务器。本教程将指导您使用Linux和Docker Compose编排服务,实现APISQL的离线部署。
准备
-
准备一台Linux(x86_64)服务器。
-
安装Docker Engine(推荐版本
20.10.15
及以上,最低19.03
)。- 安装指南:https://docs.docker.com/engine/install
-
安装Docker Compose。如果Docker Engine版本
>= 20.10.15
,则可以跳过此步骤,因为Docker引擎已包含docker-compose
,使用时需执行命令docker compose
。 -
下载APISQL安装包:https://drive.weixin.qq.com/s?k=ALgAgwdlAAcwJql5cQ
微信扫一扫进行下载
部署
-
确保部署文件夹中包含以下文件:
apisql.images.tar.gz
:Docker镜像文件。apisql.tar.gz
:包含Docker Compose编排文件及服务初始数据。
-
将文件上传至服务器。
-
导入Docker镜像
apisql.images.tar.gz
,此过程可能需要一些时间。# 终端执行,注意替换文件路径 docker load < apisql.images.tar.gz
-
解压文件
apisql.tar.gz
。# 1. 创建目标文件夹 mkdir apisql # 2. 解压文件到目标文件夹 tar -zxf apisql.tar.gz -C ./apisql
-
修改参数:
- 在
apisql/docker-compose.yml
中找到caddy
模块的参数MY_HOST
,并更改为当前设备的IPv4地址。
- 启动容器。
# 切换到创建的文件夹
cd apisql# 启动容器
docker-compose up -d
- 部署完成。
在浏览器中输入:
服务器IP/ui
,即可访问主页面,例如:192.168.1.1/ui
,初始密码:admin/66666666
。
- 更新包的安装(按需)
当有更新包时,只需上传最大版本号的更新包(包含之前所有补丁和更改)。
右上角切换为控制台 -> 模块管理 -> 上传.hyapp 更新包,看到下面有文件列表,表示已上传成功。
发布新版本即可;如果涉及ApiGate网关的升级,请右上角点击 项目管理 -> 数据网关 -> 选择对应的网关进行升级。
如需更多信息和帮助,请参考APISQL官网:https://www.apisql.cn 教程、文档、联系方式。
其他
若需修改相关服务的账户/密码,必须同步更新各配置文件中的相关配置,否则服务可能无法正常运行,其余账户信息详见
docker-compose.yml
。
如需管理容器,在浏览器中输入:
服务器IP:28100
,即可访问Docker Portainer容器管理页面,例如:192.168.1.1:28100
,初始密码:admin/abcd12345678
。