CouchDB - 安装

CouchDB - 现代安装

本章将指导您使用现代、推荐的方法安装 CouchDB。从源代码构建的过时方法复杂且很少用于开发或标准生产设置。我们将重点关注用于跨平台开发的 Docker 和用于生产服务器的官方软件包管理器。

重要提示： CouchDB 3.x 默认是安全的。在设置过程中，您必须创建一个管理员用户。所有示例都将使用 admin 作为用户名，password 作为密码。请记住在实际应用中使用一个强密码。

方法一：Docker（推荐用于开发）

Docker 提供了一个沙盒化的（sandboxed）、一致且易于管理的环境，用于在任何操作系统（Windows、macOS 或 Linux）上运行 CouchDB。它是本地开发的理想选择。

首先，请确保您的系统上已安装并运行 Docker。

要启动一个单节点 CouchDB 容器，请在您的终端中运行以下命令：

docker run -d --name my-couchdb -p 5984:5984 -e COUCHDB_USER=admin -e COUCHDB_PASSWORD=password apache/couchdb:3

我们来分解一下这个命令：

docker run：用于创建并启动新容器的命令。
-d：以分离模式（detached mode，即在后台）运行容器。
--name my-couchdb：为您的容器分配一个易于记忆的名称。
-p 5984:5984：将您本地机器上的 5984 端口映射到容器内部的 5984 端口。这是您访问 CouchDB 的方式。
-e COUCHDB_USER=admin：通过环境变量设置管理员用户名。
-e COUCHDB_PASSWORD=password：设置管理员密码。请使用一个安全的密码！
apache/couchdb:3：指定官方 CouchDB 镜像，使用最新的 3.x 版本。

CouchDB 现已运行！就是这么简单。

方法二：官方软件包管理器（适用于 Linux 服务器）

对于生产环境的 Linux 服务器，最好使用 Apache CouchDB 项目提供的官方仓库，以确保您能及时获得更新。

适用于 Debian/Ubuntu

# 添加 CouchDB 仓库的 GPG 密钥
sudo apt-get update && sudo apt-get install -y curl apt-transport-https gnupg
curl -sSL https://apache.jfrog.io/artifactory/couchdb-deb/pubkey.asc | sudo gpg --dearmor -o /usr/share/keyrings/couchdb-archive-keyring.gpg

# 添加仓库源
echo "deb [signed-by=/usr/share/keyrings/couchdb-archive-keyring.gpg] https://apache.jfrog.io/artifactory/couchdb-deb/ `lsb_release -cs` main" \
| sudo tee /etc/apt/sources.list.d/couchdb.list >/dev/null

# 安装 CouchDB
sudo apt-get update
sudo apt-get install -y couchdb

安装程序将提示您配置 CouchDB，包括设置管理员用户和密码。对于单节点设置，请选择“独立”（standalone）选项。

适用于 RHEL/CentOS

# 添加 CouchDB 仓库配置
sudo tee /etc/yum.repos.d/couchdb.repo <<'EOF'
[couchdb]
name=couchdb
baseurl=https://apache.jfrog.io/artifactory/couchdb-rpm/el$releasever/$basearch/
gpgcheck=1
gpgkey=https://apache.jfrog.io/artifactory/couchdb-rpm/pubkey.asc
enabled=1
EOF

# 安装 CouchDB
sudo yum install -y couchdb

# 启动 CouchDB（在 /opt/couchdb/etc/local.ini 中设置管理员凭证后）
sudo systemctl start couchdb
sudo systemctl enable couchdb

验证

CouchDB 安装并运行后，您可以通过两种方式进行验证：

1. 通过 cURL

打开终端，向服务器的根端点发送一个认证请求：

$ curl http://admin:password@127.0.0.1:5984/

成功的响应将类似于以下内容（UUID 和版本可能有所不同）：

{
    "couchdb": "Welcome",
    "version": "3.2.1",
    "git_sha": "244d422af",
    "uuid": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
    "features": [
        "access-ready",
        "partitioned",
        "pluggable-storage-engines",
        "reshard",
        "scheduler"
    ],
    "vendor": {
        "name": "The Apache Software Foundation"
    }
}

2. 通过 Fauxton（Web界面）

Fauxton 是 CouchDB 的现代图形界面，取代了旧版 ‘Futon’。打开您的Web浏览器并导航至：

http://127.0.0.1:5984/_utils/

您将看到一个登录界面。输入您配置的管理员凭证（在我们的示例中是 admin 和 password）。登录后，您将看到 Fauxton 控制面板，它允许您可视化地管理数据库、文档和服务器配置。