如何本地微调？
解读
面试官抛出“如何本地微调”时，并不是在问 CouchDB 有没有传统意义上的参数调优文件，而是想确认候选人是否理解 CouchDB 的“离线优先”架构，以及在国内开发机（Windows/Mac/Linux 笔记本）上，如何在不连接远程集群的前提下，把数据、索引、同步策略、安全配置等快速调整到最适合本地开发/测试的状态。回答必须体现本地场景（单机、低配置、可能断网）、国内网络环境（Maven/Gradle 镜像、NPM 镜像、Docker 镜像加速）、最小可用原则（十分钟内能跑起来），并给出可落地的命令行或配置片段。
知识点
- CouchDB 单节点与集群模式的区别：本地微调只启单节点，避免集群端口 5986 与 4369 的额外开销。
- 本地配置优先级：etc/local.ini > etc/default.ini，修改 local.ini 不会随着版本升级被覆盖。
- 国内镜像源：Docker 使用 registry.docker-cn.com 或阿里云加速器，NPM 使用淘宝镜像，减少容器拉取与构建时间。
- 离线同步与 CORS：本地开发经常需要 PWA 或 Electron 直连 5984，**必须显式开启 [chttpd] enable_cors = true 并设置 [cors] origins = *，否则浏览器拦截。
- 小数据量下的性能陷阱：默认延迟写（delayed_commits）在意外断电时可能丢最后 1 秒数据，本地 demo 可关闭；但生产环境不能关，面试时要区分。
- 视图索引预热：第一次访问视图会触发全量索引，本地调试可用 curl -X POST $COUCH/_view_cleanup 提前触发，避免首次请求超时。
- 内存与磁盘配额：国内笔记本多为 8 G 内存，把 [couchdb] max_dbs_open 从默认 100 调到 20，防止同时启 10 个微服务就把内存吃满。
- 日志级别：本地调成 debug 会刷屏，用 [log] level = info，file = ./var/log/couchdb-local.log，方便 VSCode 实时 tail。
答案
“本地微调”我分四步，十分钟内让 CouchDB 在笔记本上跑到最舒服的状态：
第一步，用 Docker 单节点镜像并换国内源
docker pull registry.docker-cn.com/apache/couchdb:3.3
docker run -d --name couch-local -p 5984:5984 -p 5986:5986 -e COUCHDB_USER=admin -e COUCHDB_PASSWORD=admin123 -v $PWD/data:/opt/couchdb/data registry.docker-cn.com/apache/couchdb:3.3
第二步，写一份最小 local.ini 覆盖关键参数，放在宿主机 ./config 目录，挂载进容器：
[chttpd]
port = 5984
bind_address = 0.0.0.0
enable_cors = true
[cors]
origins = *
credentials = true
[couchdb]
max_dbs_open = 20
delayed_commits = false
[log]
level = info
file = /opt/couchdb/var/log/couchdb-local.log
第三步，容器内重启节点使配置生效
docker exec couch-local couchdb -d && docker exec couch-local couchdb -b
第四步，本地验证与预热
curl -X PUT http://admin:admin123@127.0.0.1:5984/_users
curl -X PUT http://admin:admin123@127.0.0.1:5984/demo
curl -X POST http://admin:admin123@127.0.0.1:5984/demo -H "Content-Type: application/json" -d '{"_id":"1","name":"北京"}'
curl -X GET http://admin:admin123@127.0.0.1:5984/demo/_all_docs
提前触发视图索引，避免首次前端调用超时
curl -X POST http://admin:admin123@127.0.0.1:5984/_view_cleanup
以上四步完成后，5984 端口即可被本地 Vue/React/Electron 直连，断网也能离线增删改查，重启容器数据不丢，日志清晰，内存占用稳定在 300 M 以内。
拓展思考
- 如果面试官追问“本地数据如何与远程测试库做选择性同步”，可答：用 _replicator 数据库，写一条“单向过滤同步”文档，filter 函数里用 doc.region === '北京'，避免把全量 50 G 数据拖回笔记本。
- 若问到“国内 Windows 开发机无法装 Docker”，可答：直接装 Windows 版 CouchDB 3.3 MSI，把 Erlang 最大进程数从 256 K 降到 64 K，再配 NSSM 做成系统服务，同样改 local.ini。
- 若追问“微服务场景下每个开发者都要启一个 CouchDB，端口冲突怎么办”，可答：用 Docker Compose 的 ports 段做“127.0.0.1:${COUCH_PORT}:5984”，每人用 .env 文件隔离，CI 里通过 job_id 动态分配端口，保证并行流水线不抢端口。