CouchDB 没有 API Key 以及解决办法

Thu, 25 Jun 2026 12:10:34 +0800

问题链接到标题

需要给 CouchDB 创建一个凭证，让其他节点能拉取数据库做数据同步。最初想的是"API Key"——一个静态字符串，像大多数现代服务那样，拿来就能用在 curl 或代码中。

很多人提到的 CouchDB “API Key” 其实来自 IBM Cloudant（托管的 CouchDB 兼容服务），它提供了 POST /_api_keys 端点，返回一个 key 和 password。

但原生 Apache CouchDB 没有这个端点。一个常见的误解是把通过 _config/admins/<username> 创建的 server-level admin 当成了"API Key"——它有用户名和密码，需要 Basic Auth，本质上就是一个管理员账号。

通过 PUT /_node/_local/_config/admins/sync_obsidian 在 _config 中注册一个同步用账号。

CouchDB 从 3.x 开始支持 JWT 认证，通过配置 jwt_keys 和 jwt_authentication_handler 启用。