CouchDB _replicate端点无法使用443端口的解决办法咨询

问题核心 #

Docker部署的CouchDB仅对外暴露80/443端口，流量内部路由至5984：

• 用5984端口发起复制请求超时（外部无法访问该端口）
• 切换到443端口后返回{"error":"invalid_json","reason":"{error,{1,invalid_json}}"}错误

解决步骤 #

1. 修正JSON格式转义问题

原命令用双引号嵌套JSON导致转义混乱，是触发invalid_json错误的核心原因。改用单引号包裹JSON主体，避免不必要的转义冲突：

curl -XPOST "$COUCHDB_ADMIN_URL/_replicate"  \
  -H 'Content-Type:application/json' \
  -d '{
    "source": "'"$COUCHDB_ADMIN_URL"'/alice-db",
    "target": "https://bob:p%40ssword@your-external-domain:443/alice-db-copy-for-bob",
    "create_target": true
  }'

• 说明：单引号内的JSON无需转义双引号，变量$COUCHDB_ADMIN_URL用'"$VAR"'的方式嵌入，既保留变量引用，又避免格式冲突。

2. 替换目标地址为外部可访问的443端口

原命令中localhost:5984是容器内部地址，外部无法访问，必须替换为：

• 外部可访问的域名/公网IP
• 使用HTTPS协议（443端口默认对应HTTPS，需和你的CouchDB服务配置一致）
• 保留已编码的密码字符（p%40ssword中的%40是@的URL编码，无需修改）

3. 验证环境配置

• 确认$COUCHDB_ADMIN_URL是HTTPS开头的443端口地址，例如https://admin:your-admin-pass@your-domain:443
• 测试443端口可正常访问CouchDB：执行curl "$COUCHDB_ADMIN_URL/_utils"确认能返回管理界面

额外注意事项 #

如果是容器内部发起复制（比如在同一个Docker网络内），可以直接用容器名称+5984端口作为目标地址，但外部发起的复制必须使用对外暴露的443端口地址。

内容的提问来源于stack exchange，提问作者magp