热门搜索:
codenotary/immuclient
codenotary
immudb的CLI客户端，用于轻量级、高速的不可变数据库，适用于系统和应用程序
下载次数: 0状态：社区镜像维护者：codenotary仓库类型：镜像最近更新：1 个月前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
immudb CLI客户端
镜像概述
immudb CLI客户端是与immudb数据库交互的命令行工具。immudb是一款轻量级、高速的不可变数据库，专为系统和应用程序设计，确保数据写入后不可篡改，提供数据完整性和审计跟踪能力。
核心功能和特性
- 提供与immudb数据库的命令行交互接口
- 支持数据写入（set、safeset等）、查询（get、safeget等）及统计（count）操作
- 具备数据一致性验证功能（check-consistency、inclusion）
- 支持身份验证（login/logout）和双向TLS（mtls）安全配置
- 提供多样化数据操作命令，包括历史记录查询（history）、索引查询（getByIndex）、迭代扫描（iscan/zscan）等
使用场景和适用范围
- 开发环境中与immudb数据库的日常交互与测试
- 自动化脚本中执行数据库操作（如数据写入、查询、一致性验证）
- 系统和应用程序中通过命令行管理不可变数据
- 数据审计场景，用于验证数据完整性和追溯历史变更
使用方法和配置说明
环境变量配置
通过以下环境变量配置客户端连接参数：
| 环境变量名 | 默认值 | 说明 |
|---|---|---|
| IMMUCLIENT_IMMUDB_ADDRESS | 127.0.0.1 | immudb服务器地址 |
| IMMUCLIENT_IMMUDB_PORT | 3322 | immudb服务器端口 |
| IMMUCLIENT_AUTH | false | 是否启用身份验证 |
| IMMUCLIENT_MTLS | false | 是否启用双向TLS |
| IMMUCLIENT_SERVERNAME | localhost | 证书主机名验证 |
| IMMUCLIENT_PKEY | ./tools/mtls/4_client/private/localhost.key.pem | 客户端私钥文件路径 |
| IMMUCLIENT_CERTIFICATE | ./tools/mtls/4_client/certs/localhost.cert.pem | 客户端证书文件路径 |
| IMMUCLIENT_CLIENTCAS | ./tools/mtls/2_intermediate/certs/ca***.cert.pem | 客户端CA证书链文件路径 |
基本命令格式
bashimmuclient [command]
获取命令帮助：
bashimmuclient [command] --help
可用命令列表
| 命令 | 说明 |
|---|---|
| check-consistency | 检查指定索引和哈希的一致性 |
| count | 统计指定前缀的键数量 |
| current | 返回本地存储的最后默克尔树根和索引 |
| get | 获取指定键的项 |
| getByIndex | 按索引返回元素 |
| getByRawSafeIndex | 按原始安全索引返回元素 |
| help | 获取命令帮助 |
| history | 查询指定键的历史记录 |
| inclusion | 检查指定索引是否包含在当前默克尔树中 |
| iscan | 按插入顺序迭代所有元素 |
| login | 使用用户名密码登录 |
| logout | 登出系统 |
| rawsafeget | 获取指定键（不解析结构化值） |
| rawsafeset | 设置指定键值（不设置结构化值） |
| reference | 为现有键添加引用 |
| safeget | 获取并验证指定键的项 |
| safereference | 添加并验证引用 |
| safeset | 添加并验证键值对 |
| safezadd | 添加并验证有序集合元素 |
| scan | 迭代指定前缀的键 |
| set | 添加键值对 |
| status | 检查服务器连接状态（ping） |
| version | 显示客户端版本 |
| zadd | 添加有序集合元素 |
| zscan | 迭代有序集合 |
命令行标志参数
| 标志 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| --certificate string | 字符串 | ./tools/mtls/4_client/certs/localhost.cert.pem | 服务器证书文件路径 |
| --clientcas string | 字符串 | ./tools/mtls/2_intermediate/certs/ca***.cert.pem | CA证书链文件路径 |
| --config string | 字符串 | 配置文件（默认路径：configs/$HOME，文件名：immuclient.toml） | 配置文件路径 |
| -h, --help | 布尔 | - | 显示帮助信息 |
| -a, --immudb-address | 字符串 | 127.0.0.1 | 服务器地址 |
| -p, --immudb-port | 整数 | 3322 | 服务器端口 |
| -m, --mtls | 布尔 | false | 启用双向TLS |
| --pkey string | 字符串 | ./tools/mtls/4_client/private/localhost.key.pem | 私钥文件路径 |
| --servername string | 字符串 | localhost | 证书主机名验证 |
| --tokenfile string | 字符串 | token（默认路径：$HOME/二进制位置） | 身份验证令牌文件 |
| --value-only | 布尔 | false | get操作仅返回值 |
Docker部署示例
bash# 连接本地immudb并获取键值 docker run --rm immudb/immuclient immuclient get mykey # 指定远程服务器地址和端口 docker run --rm immudb/immuclient immuclient -a 192.168.1.100 -p 3322 get mykey # 使用环境变量配置连接 docker run --rm -e IMMUCLIENT_IMMUDB_ADDRESS=192.168.1.100 -e IMMUCLIENT_IMMUDB_PORT=3322 immudb/immuclient immuclient safeget mykey
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 immuclient 镜像标签
docker pull docker.xuanyuan.run/codenotary/immuclient:<标签>
DockerHub 原生拉取命令
docker pull codenotary/immuclient:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"