热门搜索:
datastax/cql-proxy
datastax
CQL代理/边车，监听本地地址并安全转发应用CQL流量，支持不兼容CQL驱动与DataStax Astra集群通信，帮助现有Apache Cassandra/DSE应用无需代码修改即可使用Astra。
2 次收藏下载次数: 0状态：社区镜像维护者：datastax仓库类型：镜像最近更新：9 个月前
cql-proxy
镜像概述和主要用途
cql-proxy是一个客户端CQL代理/边车，它监听本地地址并安全转发应用的CQL流量。该镜像主要用于实现不支持的CQL驱动与DataStax Astra集群的通信，同时允许现有Apache Cassandra或DataStax Enterprise (DSE)应用无需代码修改即可迁移至Astra。
!https://raw.githubusercontent.com/datastax/cql-proxy/main/cql-proxy.png
核心功能和特性
- 本地监听与流量转发：监听本地地址，安全转发应用的CQL流量至目标集群
- 多集群支持：兼容DataStax Astra集群和Apache Cassandra集群
- 灵活认证方式：支持Astra令牌认证、Astra安全连接包认证及传统用户名密码认证
- 配置灵活性：支持通过命令行标志或环境变量进行配置
- 健康检查：提供存活和就绪性检查功能
- 协议版本控制：可配置初始及最大CQL协议版本
使用场景和适用范围
cql-proxy适用于以下场景：
- 需使用不支持DataStax Astra的CQL驱动（如legacy DataStax驱动、gocql、rust-driver等社区驱动）时
- 现有Apache Cassandra或DSE应用需迁移至Astra，且希望避免代码修改时
- 应用需通过本地代理与远程CQL集群通信，确保连接安全性时
注意：新建应用若使用DataStax官方驱动，无需使用cql-proxy，驱动可直接与Astra通信。
快速开始
连接DataStax Astra集群
使用Astra令牌
shdocker run -p 9042:9042 \ datastax/cql-proxy:v0.1.2 \ --astra-token <astra-token> --astra-database-id <astra-database-id>
<astra-token>可通过这些说明生成。
使用Astra安全连接包
需将安全连接包挂载至容器卷：
shdocker run -v <your-secure-connect-bundle.zip>:/tmp/scb.zip -p 9042:9042 \ --rm datastax/cql-proxy:v0.1.2 \ --astra-bundle /tmp/scb.zip --username <astra-client-id> --password <astra-client-secret>
连接Apache Cassandra集群
shdocker run -p 9042:9042 \ datastax/cql-proxy:v0.1.2 \ --contact-points <集群节点IP或DNS名称> [--username <用户名>] [--password <密码>]
配置说明
命令行标志和环境变量
使用-h或--help标志可查看所有配置标志及其描述和对应的环境变量（以下以`# cql-proxy
镜像概述和主要用途
cql-proxy是一个客户端CQL代理/边车，它监听本地地址并安全转发应用的CQL流量。该镜像主要用于实现不支持的CQL驱动与DataStax Astra集群的通信，同时允许现有Apache Cassandra或DataStax Enterprise (DSE)应用无需代码修改即可迁移至Astra。
!https://raw.githubusercontent.com/datastax/cql-proxy/main/cql-proxy.png
核心功能和特性
- 本地监听与流量转发：监听本地地址，安全转发应用的CQL流量至目标集群
- 多集群支持：兼容DataStax Astra集群和Apache Cassandra集群
- 灵活认证方式：支持Astra令牌认证、Astra安全连接包认证及传统用户名密码认证
- 配置灵活性：支持通过命令行标志或环境变量进行配置
- 健康检查：提供存活和就绪性检查功能
- 协议版本控制：可配置初始及最大CQL协议版本
使用场景和适用范围
cql-proxy适用于以下场景：
- 需使用不支持DataStax Astra的CQL驱动（如legacy DataStax驱动、gocql、rust-driver等社区驱动）时
- 现有Apache Cassandra或DSE应用需迁移至Astra，且希望避免代码修改时
- 应用需通过本地代理与远程CQL集群通信，确保连接安全性时
注意：新建应用若使用DataStax官方驱动，无需使用cql-proxy，驱动可直接与Astra通信。
快速开始
连接DataStax Astra集群
使用Astra令牌
shdocker run -p 9042:9042 \ datastax/cql-proxy:v0.1.2 \ --astra-token <astra-token> --astra-database-id <astra-database-id>
<astra-token>可通过这些说明生成。
使用Astra安全连接包
需将安全连接包挂载至容器卷：
shdocker run -v <your-secure-connect-bundle.zip>:/tmp/scb.zip -p 9042:9042 \ --rm datastax/cql-proxy:v0.1.2 \ --astra-bundle /tmp/scb.zip --username <astra-client-id> --password <astra-client-secret>
连接Apache Cassandra集群
shdocker run -p 9042:9042 \ datastax/cql-proxy:v0.1.2 \ --contact-points <集群节点IP或DNS名称> [--username <用户名>] [--password <密码>]
配置说明
命令行标志和环境变量
使用-h或--help标志可查看所有配置标志及其描述和对应的环境变量（以下以开头的项）：
sh$ ./cql-proxy -h Usage: cql-proxy Flags: -h, --help 显示上下文相关帮助 -b, --astra-bundle=STRING Astra数据库的安全连接包路径。需配合'--username'和'--password'使用。若使用令牌或联系点选项则忽略 ($ASTRA_BUNDLE) -t, --astra-token=STRING 用于Astra数据库认证的令牌。需配合'--astra-database-id'使用。若使用安全连接包或联系点选项则忽略 ($ASTRA_TOKEN) -i, --astra-database-id=STRING Astra数据库的数据库ID。需配合'--astra-token'使用 ($ASTRA_DATABASE_ID) --astra-api-url="https://api.astra.datastax.com" Astra API的URL ($ASTRA_API_URL) -c, --contact-points=CONTACT-POINTS,... 集群的联系点。若使用安全连接包或令牌选项则忽略 ($CONTACT_POINTS) -u, --username=STRING 认证用户名 ($USERNAME) -p, --password=STRING 认证密码 ($PASSWORD) -r, --port=9042 连接集群时使用的默认端口 ($PORT) -n, --protocol-version="v4" 连接后端集群时使用的初始协议版本（默认：v4，选项：v3, v4, v5, DSEv1, DSEv2）($PROTOCOL_VERSION) -m, --max-protocol-version="v4" 后端集群支持的最大协议版本（默认：v4，选项：v3, v4, v5, DSEv1, DSEv2）($MAX_PROTOCOL_VERSION) -a, --bind=":9042" 服务器绑定地址 ($BIND) -f, --config=CONFIG YAML配置文件 ($CONFIG_FILE) --debug 显示调试日志 ($DEBUG) --health-check 启用存活和就绪性检查 ($HEALTH_CHECK) --http-bind=":8000" 用于健康检查的HTTP服务器绑定地址 ($HTTP_BIND) --heartbeat-interval=30s 对集群执行心跳检查的间隔 ($HEARTBEAT_INTERVAL) --idle-timeout=60s 成功心跳后连接被视为无响应并关闭前的持续时间 ($IDLE_TIMEOUT) --readiness-timeout=30s 代理无法连接后端集群后被视为未就绪的持续时间 ($READINESS_TIMEOUT) --num-conns=1 向后端集群每个节点创建的连接数 ($NUM_CONNS) --rpc-address=STRING 在'system.local'表中'rpc_address'字段公布的地址。配置对等代理时必须设置 ($RPC_ADDRESS) --data-center=STRING 系统表中使用的数据中心 ($DATA_CENTER) --tokens=TOKENS,... 系统表中使用的令牌。不推荐使用 ($TOKENS)
配置方法示例
使用命令行标志
shdocker run -p 9042:9042 \ --rm datastax/cql-proxy:v0.1.2 \ --astra-token <astra-token> --astra-database-id <astra-database-id>
使用环境变量
shdocker run -p 9042:9042 \ --rm datastax/cql-proxy:v0.1.2 \ -e ASTRA_TOKEN=<astra-token> -e ASTRA_DATABASE_ID=<astra-database-id>
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 cql-proxy 镜像标签
docker pull docker.xuanyuan.run/datastax/cql-proxy:<标签>
DockerHub 原生拉取命令
docker pull datastax/cql-proxy:<标签>
更多 cql-proxy 镜像推荐
haproxytech/haproxy-debian
haproxytech
HAProxy社区版Docker Debian镜像，提供高性能的开源负载均衡和应用交付控制功能，支持TCP/HTTP代理、SSL终止、健康检查等特性，适用于构建可靠的流量管理解决方案。
9 次收藏1000万+ 次下载
4 天前更新
haproxytech/haproxy-alpine
haproxytech
HAProxy社区版Docker镜像，基于Alpine Linux构建，提供高性能负载均衡与反向代理功能，适用于构建轻量级、高可用的Web服务或应用集群。
18 次收藏500万+ 次下载
4 天前更新
haproxytech/haproxy-ubuntu
haproxytech
HAProxy社区版Docker Ubuntu镜像
6 次收藏100万+ 次下载
4 天前更新
haproxytech/haproxy-qns
haproxytech
该Docker镜像包含用于HAProxy的QUIC互操作性测试文件
2 次收藏10万+ 次下载
1 天前更新
library/haproxy
Docker 官方镜像
HAProxy是一款可靠的高性能负载均衡器，主要用于TCP和HTTP协议的流量分发，能够有效均衡服务器负载、提高系统可用性与响应速度，广泛应用于Web服务、数据库集群等场景，通过智能流量调度确保服务稳定运行，是构建高可用、高性能网络架构的关键工具。
2.0千 次收藏10亿+ 次下载
3 天前更新
envoyproxy/envoy
envoyproxy
云原生高性能边缘/中间层/服务代理
181 次收藏10亿+ 次下载
1 天前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"