tiktzuki/oracle-xe-11g

Oracle XE 11g Docker镜像文档

镜像概述

Oracle XE 11g Docker镜像是Oracle Database 11g Express Edition (XE)的容器化版本，提供轻量级、易于部署的Oracle数据库环境。该镜像适用于开发、测试和学习场景，无需复杂的本地安装配置即可快速启动Oracle数据库服务。

核心功能与特性

• 基于Oracle Database 11g Express Edition构建，轻量级且功能完整
• 支持远程连接配置，通过环境变量控制访问权限
• 集成APEX (Oracle Application Express)，提供Web应用开发平台
• 支持XDB用户启用，默认密码可配置
• 允许自定义数据库初始化脚本（SQL或Shell脚本）
• 支持禁用磁盘异步IO以优化性能
• 默认禁用密码过期策略，适合开发环境

使用场景

• 开发环境：为应用开发提供本地Oracle数据库服务
• 测试环境：快速部署一致的数据库环境进行功能测试
• 学习环境：供Oracle数据库初学者学习和实践
• 演示环境：快速搭建临时数据库用于演示或培训

使用方法

镜像拉取

bash
docker pull tiktzuki/oracle-xe-11g

Docker Compose配置

yaml
version: '3'

services: 
  oracle-db:
    image: oracleinanutshell/oracle-xe-11g:latest
    ports:
      - 1521:1521  # 数据库服务端口
      - 5500:5500  # EM Express端口

快速启动

基本运行（仅开放数据库端口）

bash
docker run -d -p 49161:1521 oracleinanutshell/oracle-xe-11g

允许远程连接

bash
docker run -d -p 49161:1521 -e ORACLE_ALLOW_REMOTE=true oracleinanutshell/oracle-xe-11g

禁用磁盘异步IO（性能优化）

bash
docker run -d -p 49161:1521 -e ORACLE_DISABLE_ASYNCH_IO=true oracleinanutshell/oracle-xe-11g

启用XDB用户（默认密码：xdb）

bash
docker run -d -p 49161:1521 -e ORACLE_ENABLE_XDB=true oracleinanutshell/oracle-xe-11g

启用APEX（默认版本）

bash
docker run -d -p 49161:1521 -p 8080:8080 oracleinanutshell/oracle-xe-11g

APEX登录信息：

• 访问地址：http://localhost:8080/apex/apex_admin
• 用户名：ADMIN
• 密码：admin

启用APEX（18.1版本）

bash
# 首先拉取特定版本镜像
docker run -d -p 49161:1521 -p 8080:8080 oracleinanutshell/oracle-xe-11g:18.04-apex

APEX登录信息：

• 访问地址：http://localhost:8080/apex/apex_admin
• 用户名：ADMIN
• 密码：Oracle_11g

数据库连接参数

默认连接配置：

• 主机名：localhost
• 端口：49161（映射到容器内1521端口）
• SID：xe
• 用户名：system
• 密码：oracle

注意：SYS和SYSTEM用户的默认密码均为oracle

自定义数据库初始化

支持通过Dockerfile添加初始化SQL脚本或Shell脚本：

dockerfile
FROM oracleinanutshell/oracle-xe-11g

# 添加SQL初始化脚本
ADD init.sql /docker-entrypoint-initdb.d/

# 添加Shell脚本
ADD script.sh /docker-entrypoint-initdb.d/

客户端工具配置

Oracle SQL Developer安装（Ubuntu）

1. 从Oracle官网下载SQL Developer的.rpm安装包：[***]

2. 将.rpm包转换为.deb包：

   bash
   sudo alien -d *instantcl*.rpm
   

3. 安装OpenJDK 8：

   bash
   sudo apt-get install openjdk-8-jdk
   

4. 配置JDK路径：

   bash
   sudo vim ~/.sqldeveloper/20.4.1/product.conf
   

   添加以下内容：

   SetJavaHome /usr/lib/jvm/java-8-openjdk-amd64
   

5. 启动SQL Developer：

   bash
   /opt/sqldeveloper/sqldeveloper.sh
   

Ubuntu安装cx_Oracle

1. 安装依赖库：

   bash
   sudo apt-get install libaio1
   

2. 从Oracle官网下载适合平台的Instant Client包（需包含SDK和ODBC）：[***]

   • 示例下载包：oracle-instantclient12.1-basic-12.1.0.2.0-1.x86_64.rpm、oracle-instantclient12.1-devel-12.1.0.2.0-1.x86_64.rpm、oracle-instantclient12.1-odbc-12.1.0.2.0-1.x86_64.rpm

3. 转换为.deb包：

   bash
   sudo alien -d *instantcl*.rpm
   

   若未安装alien，需先执行：sudo apt-get install alien

4. 安装转换后的.deb包：

   bash
   sudo dpkg -i *instantcl*.deb
   

5. 配置库路径：

   bash
   sudo vi /etc/ld.so.conf.d/oracle.conf
   

   添加内容：

   /usr/lib/oracle/21/client64
   

6. 设置环境变量：

   bash
   export ORACLE_HOME=/usr/lib/oracle/12.1/client64
   export LD_LIBRARY_PATH=$ORACLE_HOME/lib
   

   若需永久生效，将上述命令添加到~/.bashrc文件

7. 更新动态链接库缓存：

   bash
   sudo ldconfig
   

8. 安装cx_Oracle：

   bash
   python -m pip install cx_oracle
   

   Python 3.5以下版本使用：pip install cx_oracle；若未安装pip，需先执行：sudo apt-get install python3-pip

9. 验证安装：启动Python控制台，执行import cx_Oracle，无错误则安装成功。

使用SQLAlchemy连接数据库

python
from sqlalchemy import create_engine
import cx_Oracle

# 数据库连接参数
host = "localhost"
port = 1521
sid = 'xe'
user = 'system'
password = 'oracle'

# 创建DSN
sid = cx_Oracle.makedsn(host, port, sid=sid)

# 构建连接字符串
cstr = 'oracle://{user}:{password}@{sid}'.format(
    user=user,
    password=password,
    sid=sid
)

# 创建引擎
engine = create_engine(
    cstr,
    convert_unicode=False,
    pool_recycle=10,  # 连接回收时间（秒）
    pool_size=50,     # 连接池大小
    echo=True         # 输出SQL执行日志
)

# 执行查询示例
result = engine.execute("select table_name, owner from dba_tables")

# 输出结果
for row in result:
    print(row)