fors33/data-bridge
fors33
这是一款配置驱动的数据摄入与规范化工具，支持本地文件（免费）、批量及实时连接器（需订阅），可输出清洁数据供下游分析使用。
下载次数: 0状态：社区镜像维护者：fors33仓库类型：镜像最近更新：10 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Fors33 T3thr
https://img.shields.io/github/actions/workflow/status/fors33-official/data-bridge/release.yml?branch=main&style=flat-square](https://github.com/fors33-official/data-bridge/actions) https://img.shields.io/badge/release-0.6.0-blue?style=flat-square](https://github.com/fors33-official/data-bridge/releases) https://img.shields.io/badge/docker-0.6.0%20%7C%20latest-2496ED?style=flat-square&logo=docker&logoColor=white](https://hub.docker.com/r/fors33/data-bridge) https://img.shields.io/docker/pulls/fors33/data-bridge?style=flat-square](https://hub.docker.com/r/fors33/data-bridge) https://img.shields.io/github/license/fors33-official/data-bridge?style=flat-square](https://github.com/fors33-official/data-bridge/blob/main/LICENSE)
T3thr是一款配置驱动的工具，用于处理来自本地文件（免费版）或实时连接器（订阅制）的时间序列数据，为下游分析生成清洁的输出结果。
责任限制
T3thr是一款确定性摄入引擎，按“原样”提供。Fors33不对因网络延迟、第三方API速率限制或本地硬件配置不当导致的数据丢失负责。操作员需承担所有合规性、数据保留及硬件配置的责任。完整最终用户许可协议（EULA）请参见fors33.com/products/t3thr。
快速开始（Docker）
- 挂载配置目录到
/app/config - 容器内默认配置路径为
/app/config/default.toml
推荐的硬化运行时标志
若使用--read-only运行，需同时：
- 将
/app/config挂载为只读 - 挂载可写的输出目标（来自
BridgeConfig.output，例如/app/out）
示例标志：
--cap-drop=ALL--security-opt no-new-privileges:true--read-only
Mac / Linux
bashdocker run --rm \ --cap-drop=ALL \ --security-opt no-new-privileges:true \ --read-only \ -v "$(pwd)/config:/app/config:ro" \ -v "$(pwd)/data:/app/out" \ docker.xuanyuan.run/fors33/data-bridge \ --config /app/config/default.toml
Windows（PowerShell）
powershelldocker run --rm ` --cap-drop=ALL ` --security-opt no-new-privileges:true ` --read-only ` -v ${PWD}/config:/app/config:ro ` -v ${PWD}/data:/app/out ` fors33/data-bridge ` --config /app/config/default.toml
GitHub容器 registry（替代方案）
也可从GitHub容器 registry拉取镜像：
bashdocker pull ***-ghcr.xuanyuan.run/fors33-official/data-bridge:0.6.0 docker pull ***-ghcr.xuanyuan.run/fors33-official/data-bridge:latest
实时连接器（需订阅）
实时连接器（WebSocket / REST / 消息总线 / gRPC / Syslog / UDP Raw / CDC）需要FORS33_LICENSE_KEY。
bashdocker run --rm \ -e FORS33_LICENSE_KEY="your_key" \ -v "$(pwd)/config:/app/config" \ docker.xuanyuan.run/fors33/data-bridge \ --config /app/config/default.toml
CLI概述
- 传统风格（未变更）：
t3thr --config /app/config/default.toml（等价于t3thr run --config …）。 - 显式子命令：
t3thr run …、t3thr generate --connector <slug>（模板位于config/templates/）、t3thr validate --config …、t3thr migrate …、t3thr wizard（与config_wizard二进制文件相同）。 - 轻量包装：
validate_config、migrate_config二进制文件委托给**t3thr**（适用于脚本）。
发布说明（展开）
0.6.0 – 传输一致性与批量限制
- 批量执行限制：
[execution]表（max_records、max_duration_sec、max_pages），配合[FORS33] batch completestderr信号；限制适用于CSV/文件批量循环和实时连接器。 - 多 feed 输出：
accepted_path_by_feed、accepted_prefix_by_feed、channel_scoped_accepted用于按通道生成接受文件。 - WebSocket：
binance_futures、binance_ws_api、HMAC签名、多通道Kraken；接受的JSONL行可选择添加feed。 - Postgres CDC： wal2json和pgoutput slot插件；可选
resume_lsn。 - 构建与发布：
native_certs功能门用于精简构建；CI在推送到registry前验证Docker镜像；捆绑config/default.toml和examples/sample_input.csv。 - 入门指南：
TERMINOLOGY.md；发布工作流同步Docker Hub README。 Cargo.toml和pkg/Dockerfile标签中的Semver同步至0.6.0。- 详见 https://github.com/fors33-official/data-bridge/blob/main/docs/bridge-release-notes-0.6.0.md%E3%80%82
0.5.0 – 扩展Rust桥一致性（独立版）
概要：独立Rust栈匹配L3dgr嵌入式T3thr传输层的TLS可观测性（[T3thr:CONNECTION_META]）、rustls中心连接器、FORS33_SECRET_*占位符扩展（与T3THR_*环境表兼容）、嵌套Kafka/MQTT配置、t3thr generate从嵌入式config/templates/生成、状态文件锁定、Tokioblock_in_place用于文件摄入、统一子命令CLI（向后兼容）、裸--config、--validate-only、--config-wizard，并保留**validate_config** / migrate_config二进制文件。发布镜像现在包含config_wizard、**validate_config和migrate_config**在/usr/local/bin/下。
技术说明：config crate在加载文件后合并**FORS33_SECRET**与__分隔符（详见 https://github.com/fors33-official/data-bridge/blob/main/docs/bridge-release-notes-0.5.0.md%EF%BC%89%E3%80%82
0.4.0 – 向导、连接器、批量模式
- 无摩擦配置： 标准提供商（Kraken、Binance、Alchemy、Infura、Postgres、MySQL等）的向导和模板。
- 交互式向导： 运行**
cargo run --bin config_wizard、t3thr wizard或t3thr --config-wizard**。 - 预配置示例： **
config/目录（示例TOML文件）；规范生成器模板从0.5.0起位于config/templates/**下。 - 连接器： Syslog（RFC 5424/3164）、UDP JSON、CDC（Postgres/MySQL）、Kafka/MQTT、gRPC。
- 批量模式：
mode = "batch"；状态文件**.t3thr-state.json，支持--reset-state** /--no-state。 - 镜像仓库： Docker Hub
fors33/data-bridge和ghcr.io/fors33-official/data-bridge。
0.3.0 – 环境中的 secrets，而非磁盘上
首选（直接映射）： 可选**env_*表将 wire key 映射到环境变量名**（T3THR_[A-Z0-9_]+）。值按原样发送（若需要，可在环境变量中放入完整的Bearer …）。
[connector.rest.env_headers][connector.websocket.env_headers][connector.grpc.env_metadata][connector.message_bus.kafka.env_client_properties]/[connector.message_bus.mqtt.env_client_properties]（嵌套；Kafka/MQTT也支持文字**client_properties**映射）
已弃用路径： 文字映射中的全值**${T3THR_*}仍可解析，但会发出[DEPRECATION]**警告。
License key PEM： 可选**FORS33_RUNTIME_PUBKEY_PEM**用于在嵌入式发行者PEM之前进行本地Ed25519验证。
验证： validate_config path/to.toml或t3thr validate --config …或**t3thr --validate-only --config …**。
默认精简构建支持文件、CSV和REST；full_engine添加WebSocket、消息总线、gRPC、syslog、UDP raw、CDC、Parquet（**fors33/data-bridge镜像使用full_engine**构建）。
文档
- https://github.com/fors33-official/data-bridge/blob/main/docs/bridge-release-notes-0.6.0.md
- https://github.com/fors33-official/data-bridge/blob/main/QUICK_START.md
- https://github.com/fors33-official/data-bridge/blob/main/TERMINOLOGY.md
- https://github.com/fors33-official/data-bridge/blob/main/pkg/README.md
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 data-bridge 镜像标签
docker pull docker.xuanyuan.run/fors33/data-bridge:<标签>
DockerHub 原生拉取命令
docker pull fors33/data-bridge:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"