描述

Oracle GoldenGate for MySQL Free 版本 26ai (23.26.1.0.5) 容器镜像文档

GoldenGate for MySQL Free 是业界领先的数据复制软件的免费版本。GoldenGate 允许您执行实时变更数据捕获（CDC）和高可用性数据管理。

使用此镜像

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

• 开始使用 GoldenGate 26ai：[***]

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

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

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

$ docker run -p 8080:8080 -p 8443:8443 container-registry.oracle.com/goldengate/goldengate-mysql-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_directory>[:<container_directory>]/u02 \  
-v <host_directory>[:<container_directory>]/u03 \  
-v <host_directory>[:<container_directory>]/etc/nginx/cert \  
container-registry.oracle.com/goldengate/goldengate-mysql-free:latest

参数说明：

• --name <container_name> - 新容器的名称（默认：自动生成）
• -p <host_port>:8080 - 映射到 Oracle GoldenGate HTTP 服务器的主机端口（默认：无映射）
• -p <host_port>:8443 - 映射到 Oracle GoldenGate HTTPS 服务器的主机端口（默认：无映射）
• -e OGG_ADMIN - 要创建的管理员账户名称（默认：oggadmin）
• -e OGG_ADMIN_PWD - 管理员账户密码（默认：自动生成）
• -e OGG_DEPLOYMENT - 部署名称（默认：Local）
• -e OGG_DOMAIN - 自签名证书使用的域名（默认：容器主机名）。如使用自有 SSL 证书则无需此参数。
• -v <host_directory>/u02 - 用于 GoldenGate 持久数据的卷（默认：使用容器存储）
• -v <host_directory>/u03 - 用于 GoldenGate 临时数据的卷（默认：使用容器存储）
• -v <host_directory>/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 管理控制台修改密码。

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-mysql-free:latest  
...

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

-----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 --user ogg <container_name> adminclient  
Oracle GoldenGate Free Administration Client for MySQL Version 23.26  
...

保护 Docker 容器的最佳实践

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

已知问题

无

GoldenGate 许可信息

用户手册（LIUM）：[***]

文档可访问性

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

---

Oracle GoldenGate for MySQL Free 版本 26ai (23.26.1.0.1) 容器镜像文档
版权所有 © 2026 Oracle 和/或其关联公司。

Oracle 免费使用条款和条件

定义
"Oracle" 指 Oracle America, Inc.
"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 或其服务提供商传输有关这些过程的有限数据，以帮助 Oracle...