跨平台快速上手：Couchbase 安装与使用指南
Couchbase 简介
Couchbase 是一款分布式 NoSQL 文档型数据库，专为交互式应用而设计。它可安装在 Windows、macOS 和 Linux 上，也可以通过 Docker 容器运行。安装完成后，Couchbase 提供基于 Web 的用户界面，简化配置流程，便于创建和管理数据集群与桶（Buckets）。本文将帮助你快速入门 Couchbase。
前置条件（Prerequisites）
在开始安装之前，请确保系统满足以下要求：
- 操作系统：Couchbase Server 可运行于 Windows、macOS 和 Linux
- 硬件要求：测试环境至少 4 GB RAM，生产环境 8 GB 或以上，并配备多核 CPU
- 磁盘空间：至少 10 GB 空间用于 Couchbase 存储与索引
- 网络：需开放相关端口（如 8091 用于 Web 控制台，11210 用于数据服务）
- 可选：Docker 可以运行 Couchbase，用于简化安装与隔离；生产环境中需要管理跨节点的集群。
下载 Couchbase
步骤如下：
- 访问 Couchbase 官方下载页面
- 选择对应的版本和平台（Windows、macOS 或 Linux）
- 下载安装包
安装 Couchbase Server
Windows 安装
- 运行下载的 .exe 文件
- 按提示完成安装
- 安装完成后，Couchbase Server 将自动启动
macOS 安装
- 打开下载的 .dmg 文件
- 将 Couchbase Server 图标拖入 Applications（应用程序） 文件夹
- 从应用程序中启动 Couchbase Server
Linux 安装（以 Debian/Ubuntu 为例）
sudo dpkg -i couchbase-server-enterprise_version.deb
sudo systemctl start couchbase-server
Docker 安装
使用以下命令运行 Couchbase 容器：
docker run -d --name couchbase -p 8091-8094:8091-8094 -p 11210:11210 couchbase:latest
更多配置可参考官方 Docker 文档。
设置 Couchbase Web 控制台
安装完成后，可使用 Web 控制台进行管理：
- 打开浏览器
- 输入 http://localhost:8091（默认端口）
- 按引导完成初始化配置
创建集群（Cluster）
设置过程中需创建至少一个集群：
- 点击 Create a New Cluster （新建集群）
- 输入集群名称（如 MyCouchbaseCluster）
- 设置管理员账号密码
- 分配资源内存（RAM）用于各类服务
添加桶（Bucket）
桶类似数据库或集合，是 Couchbase 的逻辑存储单元：
- 进入 Web Console → Buckets 页面
- 输入桶名（如 UserData）
- 为桶分配内存并选择副本及淘汰策略
- 点击 Add Bucket 完成创建
基本配置与优化
为了获得更佳性能，可进行如下优化：
- 内存配额：调整 Data、Index、Query 服务的内存分配
- 自动故障转移：启用节点自动故障切换
- 索引类型：对高频查询数据使用内存优化索引
使用 SDK 连接 Couchbase
Couchbase 提供多语言 SDK（Java、Python、Node.js、.NET 等）。
例如在 Node.js 中安装：
npm install couchbase
连接并进行 CRUD 操作示例：
async function run() {// 插入文档await collection.upsert("user::123", { name: "John Doe", age: 29 });// 获取文档const result = await collection.get("user::123");console.log("User:", result.content);
}run().catch((err) => console.error("Error:", err));
更多高级功能可在 Couchbase SDK 文档中查阅。
使用 Couchbase 命令行工具（CLI）
Couchbase 还提供命令行接口。基本语法：
couchbase-cli -c <host>:<port> -u <username> -p <password> [options]
常用命令
- 初始化集群：
couchbase-cli cluster-init -c localhost:8091 -u Administrator -p password \--cluster-username Administrator --cluster-password password \--services data,index,query
- 创建桶：
couchbase-cli bucket-create -c localhost:8091 -u Administrator -p password \--bucket testBucket --bucket-type couchbase --bucket-ramsize 100
- 添加节点：
couchbase-cli server-add -c localhost:8091 -u Administrator -p password \--server-add <host> --server-add-username Administrator \--server-add-password password
- 平衡集群：
couchbase-cli rebalance -c localhost:8091 -u Administrator -p password
验证安装
- Web 控制台：检查集群与桶状态
- 指标监控：监控系统和集群运行情况
- 示例查询：在 Query Editor 中运行 N1QL 查询
总结
Couchbase 是一款功能强大的 NoSQL 数据库，支持 Windows、macOS、Linux 及 Docker 快速部署。其 Web 控制台简化了管理，集群与桶提供灵活的数据组织能力。通过内存和索引优化可提升性能。同时，SDK 便于与多语言应用集成，而 CLI 则为命令行管理提供强大工具。