热门搜索:
codenotary/immugw
codenotary
immudb的智能REST代理，为轻量级、高速的不可变数据库提供REST接口，封装所有SAFE端点并提供验证服务。
下载次数: 0状态：社区镜像维护者：codenotary仓库类型：镜像最近更新：2 年前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
immugw Docker镜像文档
镜像概述
immu gateway（简称immugw）是immudb的智能REST代理，专为轻量级、高速的不可变数据库immudb设计。它将immudb的所有gRPC方法转换为REST接口，同时对所有SAFE端点进行封装并提供验证服务，使系统和应用能通过REST API便捷访问immudb功能。
核心功能
- REST接口转换：将immudb的gRPC方法完整暴露为REST接口，简化跨语言/跨平台访问
- SAFE端点验证：自动封装所有SAFE端点，提供内置数据验证服务
- 灵活配置：支持通过环境变量、命令行参数和配置文件进行配置
- 审计模式：可选启用审计功能，持续从服务器获取最新根数据，验证本地数据一致性
- 安全通信：支持mutual TLS (mTLS)加密通信，保障数据传输安全
使用场景
- 需要通过REST API而非gRPC协议访问immudb的应用系统
- 需对数据操作进行自动验证的业务场景
- 跨语言/跨平台集成immudb的开发环境
- 要求安全通信的生产环境部署
- 需要持续数据一致性验证的审计场景
使用方法
基本部署命令
bashdocker run -it -d -p 3323:3323 --name immugw --env IMMUGW_IMMUDB_ADDRESS=immudb-container codenotary/immugw:latest
参数说明：
-it：交互式终端-d：后台运行-p 3323:3323：端口映射（主机端口:容器端口）--name immugw：容器名称--env IMMUGW_IMMUDB_ADDRESS=immudb-container：设置immudb服务地址（需替换为实际immudb容器名或IP）
命令行使用
容器内可通过immugw命令进行操作，主要命令：
bash# 显示帮助信息 immugw --help # 显示版本信息 immugw version
配置说明
环境变量
| 环境变量 | 默认值 | 说明 |
|---|---|---|
| IMMUGW_ADDRESS | 127.0.0.1 | immugw服务绑定地址 |
| IMMUGW_PORT | 3323 | immugw服务端口 |
| IMMUGW_IMMUDB_ADDRESS | 127.0.0.1 | 连接的immudb服务地址 |
| IMMUGW_IMMUDB_PORT | 3322 | 连接的immudb服务端口 |
| IMMUGW_DIR | . | 程序文件目录 |
| IMMUGW_PIDFILE | PID文件路径（如/var/run/immugw.pid） | |
| IMMUGW_LOGFILE | 日志文件路径（如/tmp/immugw/immugw.log） | |
| IMMUGW_DETACHED | false | 是否后台运行 |
| IMMUGW_MTLS | false | 是否启用mutual TLS |
| IMMUGW_SERVERNAME | localhost | 证书主机名验证 |
| IMMUGW_PKEY | ./tools/mtls/4_client/private/localhost.key.pem | 服务器私钥文件路径 |
| IMMUGW_CERTIFICATE | ./tools/mtls/4_client/certs/localhost.cert.pem | 服务器证书文件路径 |
| IMMUGW_CLIENTCAS | ./tools/mtls/2_intermediate/certs/ca***.cert.pem | 客户端CA证书链路径 |
| IMMUGW_AUDIT | "false" | 是否启用审计模式 |
| IMMUGW_AUDIT_USERNAME | "" | 审计模式下的immudb用户名 |
| IMMUGW_AUDIT_PASSWORD | "" | 审计模式下的immudb密码 |
命令行参数
| 参数 | 缩写 | 默认值 | 说明 |
|---|---|---|---|
| --address | -a | 127.0.0.1 | immugw服务绑定地址 |
| --port | -p | 3323 | immugw服务端口 |
| --immudb-address | -k | 127.0.0.1 | immudb服务地址 |
| --immudb-port | -j | 3322 | immudb服务端口 |
| --dir | . | 程序文件目录 | |
| --pidfile | PID文件路径 | ||
| --logfile | 日志文件路径 | ||
| --detached | -d | false | 后台运行 |
| --mtls | -m | false | 启用mutual TLS |
| --servername | localhost | 证书主机名验证 | |
| --pkey | ./tools/mtls/4_client/private/localhost.key.pem | 服务器私钥路径 | |
| --certificate | ./tools/mtls/4_client/certs/localhost.cert.pem | 服务器证书路径 | |
| --clientcas | ./tools/mtls/2_intermediate/certs/ca***.cert.pem | 客户端CA证书链路径 | |
| --audit | false | 启用审计模式 | |
| --audit-username | immugwauditor | 审计用户名 | |
| --audit-password | 审计密码 | ||
| --audit-interval | 5m0s | 审计间隔时间 | |
| --config | 配置文件路径（默认configs或$HOME目录下的immugw.toml） | ||
| --help | -h | 显示帮助信息 |
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull codenotary/immugw:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"