统信UOS部署CouchDB需手动添加官方APT源：先导入密钥，再根据版本代号（如bullseye）写入源地址，安装时选择standalone模式并设置管理员密码；随后修改local.ini中bind_address为0.0.0.0、启用enable_cors，重启服务并通过http://127.0.0.1:5984/_utils登录Fauxton管理界面，局域网访问需放行ufw 5984端口。
在统信UOS系统中部署CouchDB数据库，用于本地开发、轻量级文档存储或与Web应用对接，需绕过默认仓库缺失问题，手动添加官方源并完成安全配置。UOS基于Debian 11/12，但官方couchdb包未预置，直接apt install couchdb会失败。
添加CouchDB官方APT源并安装
第一步：打开终端（Ctrl+Alt+T），执行以下命令更新密钥环：
curl -L https://couchdb.apache.org/repo/keys.asc | sudo apt-key add -
第二步：根据你的UOS版本代号（如20/23对应bookworm，可执行lsb_release -sc确认），写入对应源地址。若为UOS 20（基于Debian 11 bullseye）：
echo "deb https://apache.jfrog.io/artifactory/couchdb-deb/ bullseye main" | sudo tee /etc/apt/sources.list.d/couchdb.list
第三步：更新软件源并安装CouchDB主程序及依赖：
sudo apt update && sudo apt install -y couchdb
安装过程中会弹出文本界面配置向导——【必须选择“standalone”单节点模式，否则后续无法启动】。管理员密码在此步设定，记牢该密码，后续Web界面登录必需。
修改绑定地址与启用远程访问
CouchDB默认只监听127.0.0.1:5984，局域网其他设备无法连接。要让手机、平板或同事电脑访问本机数据库，必须放开监听。
用nano编辑主配置文件：
sudo nano /opt/couchdb/etc/local.ini
找到[httpd]区块，将bind_address行改为：
bind_address = 0.0.0.0
再找到[chttpd]区块，确保有这一行（没有就手动添加）：
enable_cors = true
保存退出后重启服务：
sudo systemctl restart couchdb
验证安装并登录Fauxton管理界面
方法一：终端验证服务状态
systemctl is-active couchdb → 应返回active
curl http://127.0.0.1:5984 → 返回{"couchdb":"Welcome","version":"3.4.1",...}即成功
方法二：浏览器访问管理界面
打开Firefox或Chrome，输入地址：http://127.0.0.1:5984/_utils
使用安装时设置的管理员账号密码登录，进入Fauxton图形控制台。首次登录后，点击左上角“Create database”可新建数据库，比如命名为myapp_data。
【注意：若页面空白或提示401，请检查是否输错密码，或确认local.ini中[admins]下已正确写入admin = your_password】
开放防火墙端口（仅需局域网访问时操作）
统信UOS默认启用ufw防火墙，5984端口被拦截会导致外部设备无法连接。
执行放行命令：
sudo ufw allow 5984
然后验证规则是否生效：
sudo ufw status | grep 5984
看到5984/tcp ALLOW Anywhere即表示已放行。此时局域网内其他设备访问http://uos-ip:5984/_utils即可管理数据库。
