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

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

使用此镜像

要试用 GoldenGate for SQL Server Free，您需要从能够访问目标数据库（您希望连接并复制数据的数据库）的位置下载并运行此容器——可以在本地机器或云服务器上运行，但请确保从您选择运行 GoldenGate Free 的位置能够访问数据库。

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

在使用 GoldenGate for SQL Server Free 时，如果您需要任何帮助或发现任何 Oracle 开发团队应关注的问题，请考虑在 Oracle 开发者社区论坛的 GoldenGate Free 版块发布评论或问题：[***]

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

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

$ docker run -p 8080:8080 -p 8443:8443 container-registry.oracle.com/goldengate/goldengate-sqlserver-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_user> \
-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_cert_dir>[:<container_cert_dir>]/etc/nginx/cert \
container-registry.oracle.com/goldengate/goldengate-sqlserver-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_dir>/u02 - 用于 GoldenGate 持久数据的卷（默认：使用容器存储）
• -v <host_dir>/u03 - 用于 GoldenGate 临时数据的卷（默认：使用容器存储）
• -v <host_cert_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-sqlserver-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 SQL Server
Version 23.26
...

保护 Docker 容器的最佳实践

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

已知问题

无

GoldenGate 许可信息

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

文档可访问性

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

---

Oracle GoldenGate for SQL Server Free Release 26ai (23.26.1.0.1) 容器镜像文档 版权所有 © 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 或其许可方保留对程序的所有所有权和知识产权。

信息收集 程序的安装和/或自动更新过程（如有）可能会向 Oracle 或其服务传输有限数量的数据...