用途:引导开发者下载、安装并启动本地 CockroachDB 集群用于开发。使用官方二进制,不依赖 Docker 或其他运行时。适用场景包括需要本地 CockroachDB 实例、没有可达集群、从零构建 CockroachDB 应用,或搭建新开发环境。
前提条件:macOS(Intel 或 Apple Silicon)、Linux(Intel 或 ARM)或 Windows(Intel);可用 curl 或 wget;每个节点约 500 MB 磁盘空间;3 节点集群需占用 26257-26259(SQL)、26357-26359(RPC)、8080-8082(DB Console)端口。
主要能力:检测平台并下载对应二进制;启动 3 节点集群(推荐,可体现复制、范围分布、租约持有者均衡与生存目标等单节点无法演示的能力);或启动单节点轻量方案;初始化集群;验证 SQL 连接、节点状态与副本因子。
使用方式:从 https://binaries.cockroachdb.com/ 按系统与架构选择文件名,例如 macOS Apple Silicon 为 cockroach-v{VERSION}.darwin-11.0-arm64.tgz,Linux Intel 为 cockroach-v{VERSION}.linux-amd64.tgz,Windows Intel 为 cockroach-v{VERSION}.windows-6.2-amd64.zip。解压后将 cockroach 放入 ~/.cockroachdb/bin 并加入 PATH。3 节点启动示例:cockroach start --insecure --listen-addr=localhost:26357 --sql-addr=localhost:26257 --http-addr=localhost:8080 --store=$HOME/.cockroachdb/data/node1 --log-dir=$HOME/.cockroachdb/logs/node1 --pid-file=$HOME/.cockroachdb/data/node1/cockroach.pid --join=localhost:26357,localhost:26358,localhost:26359 --background(其余节点端口依次递增)。首次启动后执行 cockroach init --insecure --host=localhost:26357。单节点使用 cockroach start-single-node --insecure。验证:cockroach sql --insecure --host=localhost:26257 -e "SELECT version();" 与 cockroach node status。连接串为 postgresql://root@localhost:26257/defaultdb?sslmode=disable,DB Console 为 http://localhost:8080。停止集群可 kill 各 PID 文件进程;清除数据执行 rm -rf $HOME/.cockroachdb/data $HOME/.cockroachdb/logs。
限制与安全:集群以非安全模式运行(无 TLS、无认证),仅适用于本地开发;数据持久化在 $HOME/.cockroachdb/data;二进制与数据均为用户级,无需 sudo;3 节点约占用 750 MB 内存。无网络环境可预先下载二进制,经批准渠道传输后放入 PATH 位置。