Couchbase安装与配置 #

一、系统要求 #

1.1 硬件要求 #

资源	最低要求	推荐配置
CPU	2核	4核+
内存	4GB	16GB+
磁盘	10GB	SSD 100GB+
网络	100Mbps	1Gbps

1.2 软件要求 #

操作系统	支持版本
Linux	RHEL/CentOS 7+, Ubuntu 18.04+
Windows	Windows Server 2016+
macOS	macOS 10.15+
Docker	Docker 19.03+

1.3 端口配置 #

端口	服务	说明
8091	Web控制台	管理界面
8092	REST API	数据服务
8093	Query	N1QL查询服务
8094	Search	全文搜索服务
8095	Analytics	分析服务
8096	Eventing	事件服务
11207	数据传输	客户端通信
11210	数据服务	数据节点通信
18091	SSL控制台	安全管理界面

二、Docker安装（推荐） #

2.1 单节点部署 #

bash

docker run -d --name couchbase-server \
    -p 8091-8096:8091-8096 \
    -p 11210-11211:11210-11211 \
    -p 4964-4972:4964-4972 \
    couchbase:latest

2.2 持久化存储 #

bash

docker run -d --name couchbase-server \
    -p 8091-8096:8091-8096 \
    -p 11210-11211:11210-11211 \
    -v ~/couchbase/data:/opt/couchbase/var/lib/couchbase/data \
    -v ~/couchbase/logs:/opt/couchbase/var/lib/couchbase/logs \
    couchbase:latest

2.3 Docker Compose部署 #

yaml

version: '3.8'

services:
  couchbase-server:
    image: couchbase:latest
    container_name: couchbase-server
    ports:
      - "8091-8096:8091-8096"
      - "11210-11211:11210-11211"
      - "4964-4972:4964-4972"
    volumes:
      - ./data:/opt/couchbase/var/lib/couchbase/data
      - ./logs:/opt/couchbase/var/lib/couchbase/logs
    environment:
      - COUCHBASE_MEMORY_QUOTA=1024
      - COUCHBASE_INDEX_MEMORY_QUOTA=512
    restart: unless-stopped

启动服务：

bash

docker-compose up -d

2.4 集群部署 #

yaml

version: '3.8'

services:
  couchbase-node1:
    image: couchbase:latest
    container_name: couchbase-node1
    hostname: couchbase-node1
    ports:
      - "8091:8091"
    volumes:
      - ./node1/data:/opt/couchbase/var/lib/couchbase/data

  couchbase-node2:
    image: couchbase:latest
    container_name: couchbase-node2
    hostname: couchbase-node2
    ports:
      - "8092:8091"
    volumes:
      - ./node2/data:/opt/couchbase/var/lib/couchbase/data

  couchbase-node3:
    image: couchbase:latest
    container_name: couchbase-node3
    hostname: couchbase-node3
    ports:
      - "8093:8091"
    volumes:
      - ./node3/data:/opt/couchbase/var/lib/couchbase/data

三、Linux安装 #

3.1 CentOS/RHEL #

bash

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://packages.couchbase.com/rpm/couchbase.repo
sudo yum install -y couchbase-server

启动服务：

bash

sudo systemctl start couchbase-server
sudo systemctl enable couchbase-server
sudo systemctl status couchbase-server

3.2 Ubuntu/Debian #

bash

wget https://packages.couchbase.com/releases/couchbase-release/couchbase-release-1.0-amd64.deb
sudo dpkg -i couchbase-release-1.0-amd64.deb
sudo apt-get update
sudo apt-get install -y couchbase-server

启动服务：

bash

sudo service couchbase-server start
sudo service couchbase-server status

3.3 防火墙配置 #

bash

sudo firewall-cmd --permanent --add-port=8091-8096/tcp
sudo firewall-cmd --permanent --add-port=11207/tcp
sudo firewall-cmd --permanent --add-port=11210-11211/tcp
sudo firewall-cmd --reload

四、macOS安装 #

4.1 Homebrew安装 #

bash

brew install couchbase-server

4.2 手动安装 #

下载安装包：

bash

wget https://packages.couchbase.com/releases/7.2.0/couchbase-server-enterprise_7.2.0-macos_x86_64.zip

解压并安装：

bash

unzip couchbase-server-enterprise_7.2.0-macos_x86_64.zip
sudo mv couchbase-server /Applications/

4.3 启动服务 #

bash

/Applications/Couchbase\ Server.app/Contents/Resources/couchbase-core/bin/couchbase-server \
    -- -noinput -detached

五、Windows安装 #

5.1 下载安装 #

访问官网下载页面：https://www.couchbase.com/downloads
选择Windows版本下载安装包
运行安装向导，按提示完成安装

5.2 命令行安装 #

powershell

msiexec /i couchbase-server-enterprise_7.2.0-windows_amd64.msi /qn

5.3 服务管理 #

powershell

net start CouchbaseServer
net stop CouchbaseServer

六、初始化配置 #

6.1 Web控制台初始化 #

打开浏览器访问：http://localhost:8091
点击"Setup New Cluster"
配置集群信息：

text

集群名称: my-cluster
管理员用户: Administrator
管理员密码: your-password

配置服务：

服务	内存配额	说明
Data	2048 MB	数据存储
Index	512 MB	索引服务
Query	-	查询服务
Search	512 MB	全文搜索

创建默认Bucket：

text

Bucket名称: my-bucket
类型: Couchbase
内存配额: 512 MB
副本数: 1

6.2 命令行初始化 #

bash

/opt/couchbase/bin/couchbase-cli cluster-init \
    --cluster localhost:8091 \
    --cluster-name my-cluster \
    --cluster-username Administrator \
    --cluster-password your-password \
    --cluster-ramsize 2048 \
    --cluster-index-ramsize 512 \
    --cluster-eventing-ramsize 512 \
    --cluster-fts-ramsize 512 \
    --services data,index,query,eventing,fts

6.3 创建Bucket #

bash

/opt/couchbase/bin/couchbase-cli bucket-create \
    --cluster localhost:8091 \
    --username Administrator \
    --password your-password \
    --bucket my-bucket \
    --bucket-type couchbase \
    --bucket-ramsize 512 \
    --bucket-replica 1 \
    --enable-flush 1

七、客户端工具安装 #

7.1 命令行工具 #

CBQ（Couchbase Query工具）：

bash

/opt/couchbase/bin/cbq \
    --engine http://localhost:8091 \
    --user Administrator \
    --password your-password

7.2 SDK安装 #

Python SDK:

bash

pip install couchbase

Node.js SDK:

bash

npm install couchbase

Java SDK (Maven):

xml

<dependency>
    <groupId>com.couchbase.client</groupId>
    <artifactId>java-client</artifactId>
    <version>3.4.0</version>
</dependency>

Go SDK:

bash

go get github.com/couchbase/gocb/v2

7.3 连接示例 #

Python:

python

from couchbase.cluster import Cluster, ClusterOptions
from couchbase.auth import PasswordAuthenticator

cluster = Cluster(
    'couchbase://localhost',
    ClusterOptions(PasswordAuthenticator('Administrator', 'your-password'))
)

bucket = cluster.bucket('my-bucket')
collection = bucket.default_collection()

Node.js:

javascript

const couchbase = require('couchbase');

const cluster = new couchbase.Cluster('couchbase://localhost', {
    username: 'Administrator',
    password: 'your-password'
});

const bucket = cluster.bucket('my-bucket');
const collection = bucket.defaultCollection();

八、配置优化 #

8.1 内存配置 #

bash

/opt/couchbase/bin/couchbase-cli cluster-edit \
    --cluster localhost:8091 \
    --username Administrator \
    --password your-password \
    --cluster-ramsize 4096 \
    --cluster-index-ramsize 1024 \
    --cluster-fts-ramsize 1024

8.2 自动压缩配置 #

bash

/opt/couchbase/bin/couchbase-cli bucket-edit \
    --cluster localhost:8091 \
    --username Administrator \
    --password your-password \
    --bucket my-bucket \
    --compaction-db-percentage 30 \
    --compaction-view-percentage 30 \
    --enable-compaction-parallel true

8.3 日志配置 #

编辑配置文件：

bash

vi /opt/couchbase/var/lib/couchbase/config/couchbase-server.log

日志级别配置：

text

log_level=debug
log_path=/opt/couchbase/var/lib/couchbase/logs

九、验证安装 #

9.1 检查服务状态 #

bash

/opt/couchbase/bin/couchbase-cli server-list \
    --cluster localhost:8091 \
    --username Administrator \
    --password your-password

9.2 检查集群状态 #

bash

/opt/couchbase/bin/couchbase-cli server-info \
    --cluster localhost:8091 \
    --username Administrator \
    --password your-password

9.3 测试查询 #

bash

/opt/couchbase/bin/cbq -u Administrator -p your-password

cbq> SELECT 1 AS test;

十、常见问题 #

10.1 端口冲突 #

bash

netstat -tlnp | grep 8091
lsof -i :8091

10.2 内存不足 #

bash

/opt/couchbase/bin/couchbase-cli cluster-edit \
    --cluster localhost:8091 \
    --username Administrator \
    --password your-password \
    --cluster-ramsize 1024

10.3 服务无法启动 #

bash

tail -f /opt/couchbase/var/lib/couchbase/logs/couchbase.log

十一、总结 #

安装要点：

环境	推荐方式	说明
开发环境	Docker	快速部署，易于管理
测试环境	Docker Compose	模拟集群环境
生产环境	原生安装	性能最优

下一步，让我们学习Couchbase的基础语法！