Oracle GoldenGate for PostgreSQL Free Release 26ai (23.26.1.0.5) 容器镜像文档

GoldenGate for PostgreSQL Free 是业界领先的数据复制软件的免费版本。GoldenGate 支持实时变更数据捕获和高可用性数据管理。

使用本镜像

要试用 GoldenGate for PostgreSQL Free，您需要从能够网络访问目标数据库的位置下载并运行此容器——可以是本地机器或云服务器，但请确保数据库可从您选择运行 GoldenGate Free 的位置访问。

• GoldenGate 26ai 入门指南：[***]

在使用 GoldenGate for PostgreSQL Free 过程中，如需帮助或发现需要 Oracle 开发团队关注的问题，请考虑在 Oracle 开发者社区论坛的 GoldenGate Free 版块发布评论或问题：[***]

如何在容器中运行 Oracle GoldenGate for PostgreSQL Free

使用 docker run 命令从 Oracle GoldenGate Free 容器镜像创建并启动容器。

$ docker run -p 8080:8080 -p 8443:8443 container-registry.oracle.com/goldengate/goldengate-postgresql-free:latest
----------------------------------------------------------------------------------
-- Password for OGG administrative user 'oggadmin' is 'xxxxxxxx'
----------------------------------------------------------------------------------
...

容器将使用以下默认选项实例化：

• 自动生成的容器名称
• 8080 端口用于 HTTP 服务器
• 8443 端口用于 HTTPS 服务器
• 'oggadmin' 作为管理员账户名称
• 自动生成的管理员账户密码
• 'Local' 作为部署名称
• 使用容器存储作为 /u02 和 /u03 卷
• 自动生成的自签名证书

镜像的高级用法

$ docker run \
--name <container_name> \
-p <host_port>:8080 \
-p <host_port>:8443 \
-e OGG_ADMIN=<admin_username> \
-e OGG_ADMIN_PWD=<admin_password> \
-e OGG_DEPLOYMENT=<deployment_name> \
-e OGG_DOMAIN=<domain_name> \
-v <host_dir>[:<container_dir>]/u02 \
-v <host_dir>[:<container_dir>]/u03 \
-v <host_dir>[:<container_dir>]/etc/nginx/cert \
container-registry.oracle.com/goldengate/goldengate-postgresql-free:latest

参数说明：

• --name <container_name> - 新容器的名称（默认：自动生成）
• -p <host_port>:8080 - 映射到 Oracle GoldenGate HTTP 服务器的主机端口（默认：不映射）
• -p <host_port>:8443 - 映射到 Oracle GoldenGate HTTPS 服务器的主机端口（默认：不映射）
• -e OGG_ADMIN=<admin_username> - 要创建的管理员账户名称（默认：oggadmin）
• -e OGG_ADMIN_PWD=<admin_password> - 管理员账户密码（默认：自动生成）
• -e OGG_DEPLOYMENT=<deployment_name> - 部署名称（默认：Local）
• -e OGG_DOMAIN=<domain_name> - 自签名证书使用的域名（默认：容器主机名）。如果使用自定义 SSL 证书，则不需要此参数。
• -v <host_dir>/u02 - 用于 GoldenGate 持久数据的卷（默认：使用容器存储）
• -v <host_dir>/u03 - 用于 GoldenGate 临时数据的卷（默认：使用容器存储）
• -v <host_dir>/etc/nginx/cert - 用于存储 HTTPS 服务器 SSL 证书的卷（默认：创建自签名证书）

更多详细信息请参见以下部分。

数据存储卷

• /u01 - GoldenGate 系统卷
• /u02 - GoldenGate 持久数据卷
• /u03 - GoldenGate 临时数据卷

管理员账户密码

如果未通过 OGG_ADMIN_PWD 环境变量提供密码，容器首次启动时将为 Oracle GoldenGate 管理员用户生成随机密码。您可以在容器日志的开头找到此密码：

$ docker logs <container_name> | head -3
----------------------------------------------------------------------------------
-- Password for OGG administrative user 'oggadmin' is 'xxxxxxxx'
----------------------------------------------------------------------------------

修改默认管理员账户密码

如果未提供密码，容器首次启动时将为 Oracle GoldenGate 管理员用户生成随机密码。容器创建并进入健康状态后，用户必须强制修改密码。

使用 docker exec 命令，通过调用容器中的 setPassword.sh 脚本修改账户密码。注意容器必须处于运行状态。例如：

$ docker exec <container_name> setPassword.sh <new_password>

此后将使用新密码。此工具只能使用一次，因为修改密码后没有日志或系统环境变量记录相关信息。使用此工具后，您可以通过 GoldenGate Administrator Console 修改密码。

SSL 证书

将自定义 SSL 证书用于 Oracle GoldenGate 容器时，需要以下文件：

1. ogg.key - OGG SSL 证书的私钥。
2. ogg.pem - OGG 的 SSL 叶证书以及完整的证书信任链。

如果这些文件位于名为 cert 的目录中，可以通过卷挂载在 GoldenGate 容器中使用，如下所示：

$ docker run -v ${PWD}/cert:/etc/nginx/cert:ro -p 8443:8443 container-registry.oracle.com/goldengate/goldengate-postgresql-free:latest
...

所有证书文件必须包含完整的证书链，从叶证书开始，后跟证书颁发机构链中的所有其他证书。

-----BEGIN CERTIFICATE-----
MIIFBTCCA+2gAwIBAgISBJSzNXE+Ha5eDw76N5lgHhTpMA0GCSqGSIb3DQEBCwUA
MEoxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1MZXQncyBFbmNyeXB0MSMwIQYDVQQD
...
dr7wTE+AQwcOLAGjIvFOL7GK8JrhKvuFvnSoys/1O2CK3vVhBgS+mEF6D+QjIGTv
VC01LCPT51q58INy4RtDBPSqlJwrzz+pOOWd5rBWhu2UPktVHz3AtYE=
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/
MSQwIgYDVQQKExtEaWdpdGFsIFNpZ25hdHVyZSBUcnVzdCBDby4xFzAVBgNVBAMT
...
PfZ+G6Z6h7mjem0Y+iWlkYcV4PIWL1iwBi8saCbGS5jN2p8M+X+Q7UNKEkROb3N6
KOqkqm57TH2H3eDJAkSnh6/DNFu0Qg==
-----END CERTIFICATE-----

运行管理客户端

管理客户端工具可通过以下命令运行：

$ docker exec -ti <container_name> --user ogg adminclient
Oracle GoldenGate Free Administration Client for PostgreSQL
Version 23.26
...

保护 Docker 容器的最佳实践

以非 root 用户身份运行容器有助于减轻安全漏洞。在无 root 模式下运行容器可确保应用环境安全。Oracle Enterprise Linux 使用与 Docker 兼容的 Podman 来运行和管理开放容器倡议（OCI）兼容的容器。请按照 Rootless Podman 教程设置无 root 模式的 Podman。

已知问题

无

GoldenGate 许可信息用户手册 (LIUM)

[***]

文档可访问性

有关 Oracle 对可访问性的承诺信息，请访问 Oracle 可访问性计划网站：[***]

---

Oracle GoldenGate for PostgreSQL Free Release 26ai (23.26.1.0.2) 容器镜像文档
Copyright © 2026 Oracle 和/或其关联公司。

Oracle 免费使用条款和条件

定义

"You" 和 "Your" 指：(a) 如果程序的使用将代表某实体，则指访问程序的公司或组织（每个称为“实体”）；或 (b) 如果程序的使用不代表实体，则指访问程序的个人。

"Program(s)" 指 Oracle 根据以下条款提供的 Oracle 软件，以及 Oracle 提供的任何更新、错误修正和/或程序文档。

"Program Documentation" 指程序用户手册和程序安装手册（如有）。程序文档（如可用）可能随程序一起提供和/或可从 [***] 访问。

"Separate Terms" 指程序文档、自述文件或通知文件中指定的单独许可条款，适用于单独许可技术。

"Separately Licensed Technology" 指根据单独条款而非本许可条款许可的 Oracle 或第三方技术。

单独许可技术

Oracle 可能在程序文档、自述文件或通知文件中就作为程序一部分或与程序一起提供的 Oracle 或第三方技术向您提供某些通知。如果程序文档、自述文件或通知文件中指定，此类技术将根据单独条款许可给您。您根据单独条款使用单独许可技术的权利不受本文条款的任何限制。为明确起见，尽管存在通知，非单独许可技术的第三方技术应被视为根据本许可条款许可给您的程序的一部分。

开源软件的源代码

对于您从 Oracle 获得的、根据开源许可授权的二进制形式软件（该许可赋予您获取该二进制文件源代码的权利），您可以从 [] 或 [] 获取适用的源代码。如果此类软件的源代码未随二进制文件提供给您，您也可以按照后一个网站“源代码书面提供”部分的说明提交书面请求，以获取物理介质上的源代码副本。

---

以下许可条款适用于未根据单独条款提供给您的程序。

许可权利和限制

Oracle 授予您（作为本程序的接收者）非独占、不可转让的有限许可，在符合本文规定的条件下：(a) 内部使用未修改的程序，用于开发、测试、原型设计和演示您的应用程序，以及为您自己的内部业务运营运行程序；(b) 根据本许可条款重新分发未修改的程序和程序文档，但您不得就程序的使用向最终用户收取任何额外费用。

您可以复制程序，复制数量应合理地为行使本文授予的许可权利和备份目的所必需。

仅当程序的下载页面或程序文档中明确授权此类使用时，您才有权使用程序为第三方提供有关程序和相关单独许可技术使用的培训。

您的许可取决于您是否遵守以下条件：

• 您在分发程序时包含本许可的副本；
• 您不得从程序或程序文档中移除 Oracle 或许可方的专有权利标记或通知；
• 您遵守所有管辖您使用程序（包括技术数据）的美国和适用及经济制裁***；
• 您不得自行或允许关联方对程序进行反向工程、反汇编或反编译（***允许的情况除外）。

为明确起见，分发中可能包含的任何源代码仅用于参考目的，不得修改，除非此类源代码受允许修改的单独条款约束。

所有权

Oracle 或其许可方保留对程序的所有所有权和知识产权。

信息收集

程序的安装和/或自动更新过程（如有）可能会向 Oracle 或其服务