能直接拉镜像启动，但需注意三点：镜像源访问不稳定、默认密码和端口须显式指定、数据不挂载则重启即丢；国内直连失败因Oracle未对大陆IP开放匿名拉取；启动必设-e ORACLE_PWD、-p 1521:1521、-v挂载；首次启动需5–8分钟，待日志显示“Database ready to use”再连接，PDB名为FREEPDB1；初始化后须检查并按需升级MAX_STRING_SIZE至EXTENDED。
能直接拉镜像启动，但必须注意三点：镜像源访问不稳定、默认密码和端口要显式指定、数据不挂载就等于重启即丢。
docker pull container-registry.oracle.com/database/free 失败怎么办
国内直连 container-registry.oracle.com 常见 TLS handshake timeout 或 401 错误，不是配置问题，是 Oracle 镜像仓库未对大陆 IP 开放匿名拉取权限。
- 临时解决：加代理环境变量，如
export all_proxy=http://127.0.0.1:9910（需本地运行代理） - 更稳做法：先用海外服务器或 CI 环境拉取镜像，
docker save导出再docker load导入本地 - 别试
docker pull oracle/database-free—— Docker Hub 上没有官方 Oracle 镜像，全是第三方非受信构建
docker run 启动时必须设的参数有哪些
Oracle Free 镜像不会在容器启动后自动初始化数据库，缺关键参数会导致容器卡在 “Initializing…” 状态，日志里反复刷 ORACLE_HOME not set 或 Waiting for database to start...。
-
-e ORACLE_PWD=your_password：必须设置，否则初始化失败（默认无密码） -
-p 1521:1521：端口映射不能省，否则宿主机连不上 -
-v /path/on/host:/opt/oracle/oradata：不挂载，每次docker stop && docker start都会重建数据库，数据全丢 - 可选但建议：
-e TZ=Asia/Shanghai避免时区错乱；--name oracle23ai方便后续命令识别
完整示例：
docker run -d --name oracle23ai \ -p 1521:1521 \ -e ORACLE_PWD=Mrv587.. \ -e TZ=Asia/Shanghai \ -v $PWD/oradata:/opt/oracle/oradata \ container-registry.oracle.com/database/free:23.4.0.0-lite
启动后连不上数据库的常见原因
容器 docker ps 显示 up，但 sqlplus system/Mrv587..@localhost:1521/FREEPDB1 报 ORA-12541 或 ORA-12170，大概率是服务没真正就绪或连接串写错。
- 等初始化完成：首次启动需 5–8 分钟，查日志确认出现
Database ready to use再连：docker logs -f oracle23ai - PDB 名称固定为
FREEPDB1（不是FREE），CDB 名是FREE；连 CDB 用@localhost:1521/FREE，连 PDB 必须用@localhost:1521/FREEPDB1 - 宿主机连容器要用
localhost，但 Linux 下 Docker 默认绑定127.0.0.1，如果防火墙拦截了 1521，telnet localhost 1521会不通 - Windows/macOS 用户注意：Docker Desktop 的
localhost指向容器网关，连不上时改用host.docker.internal
初始化完成后第一件事该做什么
别急着建表，先确认 PDB 状态和字符集——Free 版默认启用 AL32UTF8，但 MAX_STRING_SIZE 是 STANDARD，超长字符串（>4000 字节）会报错，而 23ai 新特性如 AI Vector Search 强依赖 EXTENDED 模式。
- 进容器执行：
docker exec -it oracle23ai sqlplus / as sysdba - 切到 PDB：
ALTER SESSION SET CONTAINER = FREEPDB1; - 查当前设置：
SHOW PARAMETER max_string_size;（大概率返回STANDARD） - 如需启用扩展字符串，必须走
OPEN UPGRADE流程，且重启一次 PDB —— 这步不可跳过，否则后续 DDL 会失败
真正麻烦的点不在启动，而在启动之后那 10 分钟：日志要看全、PDB 要切准、参数要调对。少盯一眼，后面建表报错就得重来。
