rticom/dds-spy

RTI® DDS Spy Docker镜像

镜像概述

RTI® DDS Spy是RTI Connext®生态系统中的官方工具，通过Docker镜像形式提供，旨在帮助开发者监控DDS（数据分发服务）域内的实时数据流量，支持调试和分析DDS网络中的数据发布与订阅行为，是DDS应用开发和运维过程中的核心调试工具。更多信息请参考RTI官方文档。

核心功能

1. 监控指定DDS域内的全量数据流量；
2. 分析实时数据的发布源、订阅方及数据内容；
3. 支持自定义QoS（服务质量）配置以适配不同业务场景；
4. 提供灵活的命令行参数（如域ID、日志详细程度等）调整工具行为；
5. 兼容RTI Connext® 7.7.0及以上版本。

使用场景

• DDS应用开发阶段的功能调试与问题排查；
• 实时数据系统的流量分析与性能优化；
• 多节点DDS网络的连通性与数据一致性验证；
• 自定义QoS策略的效果验证与优化。

配置说明

版本信息

本页面文档适用于带有latest标签的镜像（对应RTI最新发布版本）。如需确认版本对应关系或查看历史版本，请访问https://hub.docker.com/r/rticom/dds-spy/tags%EF%BC%8C%E5%8E%86%E5%8F%B2%E7%89%88%E6%9C%AC%E6%96%87%E6%A1%A3%E8%AF%B7%E5%8F%82%E8%80%83https://github.com/rticommunity/rticonnextdds-containers%E3%80%82

基础使用

运行DDS Spy容器的基础命令：

bash
docker run -dt \
        --network host \
        --name=dds_spy \
        docker.xuanyuan.run/rticom/dds-spy:latest \
        -domainId 0

该命令将在域ID 0上启动DDS Spy，使用主机网络模式（推荐，确保DDS流量可达）。

容器默认信息：

• 用户/组：rtiuser（1010）/ rtigroup（1010）
• 工作目录：/home/rtiuser/rti_workspace/7.7.0/user_config/spy

内置配置获取

获取容器内置的QoS配置文件：

bash
docker cp dds_spy:/opt/rti.com/rti_connext_dds-7.7.0/resource/xml/RTI_DDS_SPY_QOS_PROFILES.xml .

自定义配置

如需使用自定义QoS配置，需将本地配置文件挂载到容器指定路径，并通过参数指定：

bash
docker run -dt \
        --network host \
        -v $PWD/MyQOSProfiles.xml:/home/rtiuser/rti_workspace/7.7.0/user_config/spy/USER_DDS_SPY_QOS_PROFILES.xml \
        --name=dds_spy \
        docker.xuanyuan.run/rticom/dds-spy:latest \
        -domainId 0 \
        -qosFile USER_DDS_SPY_QOS_PROFILES.xml

命令行参数

通过命令行参数调整工具行为（示例：设置详细程度为3）：

bash
docker run -dt \
        --network host \
        --name=dds_spy \
        docker.xuanyuan.run/rticom/dds-spy:latest \
        -domainId 0 \
        -verbosity 3

使用-h参数查看所有支持的参数：

bash
docker run --rm -t docker.xuanyuan.run/rticom/dds-spy:latest -h

网络配置

• 主机网络模式：使用--network host（推荐，适用于大多数场景）；
• 自定义网络：通过docker network create创建隔离网络，需确保DDS节点间的连通性；
• 外部访问：如需从Docker环境外访问，可使用RTI Real-Time WAN Transport并通过-p暴露UDP端口（需自定义配置）。

许可证与获取

运行容器需RTI许可证：

• 现有客户：联系RTI支持获取；
• 评估用户：访问RTI免费试用页面获取7.7.0及以上版本试用许可证。

镜像基于Ubuntu构建，需遵守https://hub.docker.com/_/ubuntu%EF%BC%8CRTI%E8%AE%B8%E5%8F%AF%E6%9D%A1%E6%AC%BE%E8%AF%A6%E8%A7%81%E5%AE%98%E6%96%B9%E9%A1%B5%E9%9D%A2%E3%80%82

获取内置许可文件：

bash
docker cp dds_spy:/opt/rti.com/rti_connext_dds-7.7.0/RTI_License_Agreement_LM.pdf .

发布说明

产品发布说明请查看RTI社区门户，Docker镜像发布说明请参考https://github.com/rticommunity/rticonnextdds-containers%E3%80%82 ===END===