【V4】客户端通过 PL/SQL Developer 连接 Oracle 数据库资产

概述

在企业级运维架构中，Oracle 数据库凭借高稳定性、强事务支持能力，广泛承载核心业务数据，其访问链路的安全性与可控性直接关联业务连续性。借助 JumpServer 堡垒机实现 Oracle 数据库访问的统一管控，可有效规避凭证泄露、越权操作、操作无审计等风险，同时通过动态凭证分发、细粒度权限分配功能，在保障运维便捷性的同时满足等保合规要求。

本文档聚焦 JumpServer V4.1.0 客户端场景，结合 PL/SQL Developer 工具的 Oracle 专属适配优势，系统讲解从环境校验、客户端配置到连接验证的全流程操作，助力运维人员快速实现安全、合规的 Oracle 数据库客户端接入。

配置前前置条件

为确保配置流程顺畅推进，避免因环境不达标、依赖缺失或网络阻隔导致连接异常，需提前完成以下前置检查与准备工作：

JumpServer 版本兼容：需为 V4.10.13 及以上稳定版本，该版本已完善 Oracle 数据库资产纳管、客户端连接转发及动态凭证签发功能，可避免低版本兼容问题；
Oracle 资产纳管有效性：目标 Oracle 数据库实例已成功录入 JumpServer 资产列表，实例运行状态正常，且关联的数据库账号可通过 JumpServer Web 终端 SQL 模式正常登录，能执行查询、新增等基础操作，验证资产与账号可用性；
JumpServer 客户端配置完成：本地终端已安装 V4.1.0 及以上版本的 JumpServer 客户端，且已通过令牌、密码等方式完成与服务端的认证绑定，客户端可正常拉取资产列表；
PL/SQL Developer 环境适配：已安装 PL/SQL Developer 12.0 及以上版本，并搭配与 Oracle 数据库版本匹配的 Oracle Instant Client，已正确配置 Oracle Home 路径及 OCI 库（oci.dll）路径，确保工具可正常加载 Oracle 客户端驱动；
网络链路通畅：本地客户端需能正常访问 JumpServer 服务端对应端口（默认 80/443 及客户端通信端口）；JumpServer 服务端与 Oracle 数据库资产的默认端口 1521（自定义端口需同步调整）需双向互通，且两端防火墙、安全组已放行对应端口流量，无拦截规则。

一、客户端配置

在客户端页面点击右上角的设置按钮进入连接设置页面，之后点击”应用配置 --- Oracle ---下载应用“，即可进入浏览器页面进行 PL/SQL Developer 应用的下载，根据自身情况判断下载应用的版本。

下载并安装完成之后，需要在对应连接方式下选择应用的路径，点击图中的”Select path"，选择 PL/SQL Developer 的应用程序的绝对路径后打开就完成了客户端与应用之间的配置，之后在客户端中连接 Oracle 资产，就会自动调用相应的应用进行连接，无需输入账号密码。

注意：同一时间仅支持启用一种数据库客户端作为默认连接方式，避免在连接资产时产生冲突的情况，客户端默认在你激活一种连接方式时会自动断开另一种已开启的连接方式，启动按钮显示为“绿色”即为开启，“灰色”即为关闭。

二、资产连接

打开客户端之后，对相应的 Oracle 数据库资产进行连接，点击“连接”按钮，客户端会自动拉起刚刚配置好的连接方式（PL/SQL Developer），并自动连接到对应的资产上，成功拉起一次之后，后续无需再次输入数据库的账号密码，JumpServer 将根据授权关系自动完成账号映射并发起连接。

三、注意事项和常见报错

注意事项

建议优先使用 JumpServer 客户端连接数据库，避免直连数据库
若本地数据库客户端路径变更，需要在 JumpServer 客户端重新配置路径
连接失败时优先检查客户端版本与数据库客户端路径配置
注意防火墙对相应端口的放行情况（Oracle数据库资产默认端口 1521）

常见报错

若第一次安装使用 PL/SQL Developer，可能会报错：

 Initialization error
 Could not locate OCI dll
 OracleHomeKey;
 OracleHomeDir;

解决方案：

安装OCI工具：https://www.oracle.com/database/technologies/instant-client/winx64-64-downloads.html，安装完成后将文件解压到 PL/SQL Developer 所在目录下，并增加系统环境变量

菜单