Bitnami版CouchDB重启后管理员密码未哈希的原因咨询

我来帮你梳理下这个问题——Bitnami打包的CouchDB和官方原生版本有不少自定义配置逻辑，这就是为什么你按照官方文档操作却没看到密码被哈希的原因，主要可能是这几个点：

1. Bitnami的配置文件隔离机制 #

Bitnami会把应用的核心配置拆分到多个文件，管理员密码这类敏感信息通常不会直接存在主local.ini里，而是放在/opt/bitnami/couchdb/conf/local.d/目录下的专属配置文件（比如bitnami.ini）。如果你只修改了主local.ini的[admins]段，很可能这个配置根本没生效，或者Bitnami的启动脚本会自动覆盖你的修改，保持它自己管理的明文/哈希密码。

2. 原生哈希逻辑被Bitnami脚本干预 #

官方CouchDB的密码哈希逻辑是：当local.ini的[admins]里存在明文密码，重启时会自动将其替换为哈希值。但Bitnami可能预先通过环境变量（比如COUCHDB_ADMIN_PASSWORD）或者初始化脚本设置了密码，这时候你手动写入的明文密码会被Bitnami的启动流程忽略，自然不会触发哈希操作。

3. 文件权限导致无法修改配置 #

如果local.ini的所有者或权限设置不对，CouchDB进程重启时没有权限修改这个文件，也就无法把明文密码替换成哈希值。你可以执行以下命令检查权限：

ls -l /opt/bitnami/couchdb/conf/local.ini

正常情况下，文件所有者应该是couchdb用户和组。

解决建议 #

• 使用Bitnami官方工具修改密码：这是最稳妥的方式，运行Bitnami提供的密码修改脚本（路径可能因版本略有差异）：

  sudo /opt/bitnami/scripts/couchdb/change-password.sh
  

  这个脚本会自动处理密码哈希、配置文件更新和服务重启，完全符合Bitnami的配置逻辑。
• 手动修改需遵循Bitnami规则：如果一定要手动操作，先停止CouchDB服务：

  sudo /opt/bitnami/ctlscript.sh stop couchdb
  

  然后找到Bitnami的专属配置文件（比如local.d/bitnami.ini），写入明文密码，设置正确的文件权限：

  sudo chown couchdb:couchdb /opt/bitnami/couchdb/conf/local.d/bitnami.ini
  

  再启动服务，观察是否会自动哈希。不过这种方式可能在后续Bitnami的更新中被覆盖，不推荐长期使用。
• 检查环境变量配置：查看Bitnami的启动脚本或/opt/bitnami/scripts/couchdb/setup.sh，确认是否存在COUCHDB_ADMIN_PASSWORD环境变量，如果有，这个变量会优先于配置文件的设置，需要修改这个变量才能生效。

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