pa-radserver-ib Docker镜像文档

镜像概述与主要用途

pa-radserver-ib 是一个集成了 PAServer（Platform Assistant Server）、RAD Server 引擎、Apache Web 服务器和 InterBase 数据库的 Docker 镜像，旨在简化 RAD Studio 应用程序的 Linux 环境部署流程。该镜像提供了一站式的 RAD Studio Linux 部署解决方案，适用于开发、调试及非生产环境的应用部署。

核心功能与特性

• 组件集成：整合 PAServer、RAD Server 引擎、Apache 和 InterBase 数据库，无需单独配置各组件
• 默认配置：开箱即用，默认运行 PAServer 服务（端口 64211，默认密码 securepass）
• 系统兼容性：10.x 版本基于 Ubuntu 18.04.6 LTS（Bionic Beaver），11.x 版本基于 Ubuntu 22.04.1 LTS（Jammy Jellyfish）
• 多运行模式：支持完整模式（PAServer+RAD Server+InterBase）和仅 InterBase 模式
• 配置灵活性：支持通过脚本修改核心配置文件（emsserver.ini）并自动重启服务
• 自定义扩展：提供 Solutions 目录支持自定义 RAD Server 模块部署

使用场景与适用范围

适用场景

• RAD Studio 应用程序的 Linux 环境开发与调试
• 非生产环境下的 RAD Server 应用快速部署
• InterBase 数据库独立测试环境搭建
• 自定义 RAD Server 模块的集成测试

适用范围

• 需要使用 RAD Server 和 InterBase 进行应用开发的开发者
• 基于 RAD Studio 构建跨平台应用的团队
• 需简化 Linux 部署流程的 RAD Studio 项目

注意：使用该镜像需具备 Embarcadero 开发者工具产品的有效授权许可。

详细使用方法与配置说明

1. 获取镜像

1.1 从 Docker Hub 拉取（推荐）

使用***提供的 pull.sh 脚本或直接执行 docker pull 命令：

bash
# 使用脚本拉取
./pull.sh

# 或直接执行 docker pull（指定标签，如 latest）
docker pull radstudio/pa-radserver-ib:latest

标签说明：latest 对应最新稳定版，也可指定具体版本（如 11.0、10.4 等）。

1.2 从 GitHub 源码构建

若需修改镜像或自定义构建，从 GitHub 仓库获取源码后使用 build.sh 脚本（需确保 radserver_docker.sh 与 Dockerfile 在同一目录）：

bash
# 克隆仓库（假设已克隆）
./build.sh

2. 运行镜像

2.1 默认模式（PAServer+RAD Server+InterBase）

使用*** run.sh 脚本或直接执行 docker run 命令：

bash
# 使用脚本运行
./run.sh

# 或直接执行 docker run（示例，映射端口 64211/PAServer、80/Apache）
docker run -d -p 64211:64211 -p 80:80 --name pa-radserver-ib radstudio/pa-radserver-ib:latest

2.2 仅 InterBase 模式

如需单独运行 InterBase 数据库，使用 run-interbase-only.sh 脚本：

bash
# 使用脚本运行仅 InterBase 模式
./run-interbase-only.sh

# 或直接执行 docker run（仅暴露 InterBase 相关端口）
docker run -d -p 3050:3050 --name interbase-only radstudio/pa-radserver-ib:latest /run-interbase-only.sh

2.3 拉取并运行（一站式）

使用 pull-run.sh 脚本直接拉取并启动镜像（适用于首次部署）：

bash
./pull-run.sh

3. 配置管理

3.1 修改核心配置文件

通过 config.sh 脚本可配置运行中容器的 emsserver.ini 文件（修改后自动重启 Apache）：

bash
./config.sh

该脚本会进入容器内部编辑配置文件，保存后自动应用更改。

3.2 自定义配置参数

核心配置项可通过修改 emsserver.ini 实现，主要包括：

• RAD Server 服务端口、超时设置
• InterBase 数据库连接参数
• Apache 虚拟主机配置

4. 自定义模块部署

Solutions 目录提供了自定义 RAD Server 模块的部署方案，以 Custom-RAD_Server-Module 为例：

1. 将自定义模块文件（如 samplemodule.so）置于与 Dockerfile 同级目录
2. 执行 build-run.sh 脚本部署：

bash
./build-run.sh samplemodule.so

脚本会构建包含自定义模块的镜像并启动容器。

Docker 部署方案示例

示例 1：基础 docker run 命令（默认模式）

bash
docker run -d \
  --name radserver-env \
  -p 64211:64211 \  # PAServer 端口
  -p 80:80 \        # Apache Web 端口
  -p 3050:3050 \    # InterBase 端口（如需外部访问）
  radstudio/pa-radserver-ib:latest

示例 2：仅 InterBase 模式 docker run 命令

bash
docker run -d \
  --name interbase-instance \
  -p 3050:3050 \    # InterBase 默认端口
  radstudio/pa-radserver-ib:latest \
  /run-interbase-only.sh

示例 3：docker-compose 配置（基础版）

yaml
version: '3'
services:
  radserver:
    image: radstudio/pa-radserver-ib:latest
    ports:
      - "64211:64211"
      - "80:80"
      - "3050:3050"
    container_name: radserver-env
    restart: unless-stopped

配置参数说明

注意事项

• 许可证要求：使用该镜像需持有 Embarcadero 开发者工具产品的有效授权许可，详见 软件许可协议。
• 生产环境建议：默认配置适用于开发调试，生产环境需根据需求调整安全策略（如修改默认密码、限制端口访问等）。
• 版本兼容性：10.x 与 11.x 版本基于不同 Ubuntu 系统，部署时需根据应用依赖选择对应版本。

相关资源

• Docker Hub 镜像地址：radstudio/pa-radserver-ib
• PAServer 文档：PAServer Documentation
• RAD Server Docker 部署文档：RAD Server Docker Deployment
• InterBase 文档：InterBase Documentation