统信UOS安装配置Couchbase详细教程

在统信UOS上安装Couchbase时，官方并未提供现成的安装包，需手动通过Debian系的deb包完成部署。具体步骤为：下载amd64架构的.deb文件，使用dpkg命令安装，然后逐一补齐依赖（如libcurl4、libssl1.1等），启动服务后开放8091等端口，最后通过浏览器访问http://localhost:8091执行管理员设置、路径指定以及内存配额（建议不低于2048MB）的初始化配置。

在统信UOS上运行Couchbase，官方虽未直接提供适配版本，但UOS底层采用Debian架构，因此使用对应的Debian/Ubuntu兼容包手动部署是完全可行的。整个过程无图形化向导，全部通过终端命令完成。以下将详细拆解关键步骤，并指出容易遇到问题的环节。

下载适配统信UOS的Couchbase安装包

由于统信UOS基于Debian，下载时必须选择amd64架构的.deb安装包。前往Couchbase官网下载页面（https://www.couchbase.com/downloads），可选择Enterprise版或Community版，但务必在平台选项中勾选“Linux → Debian/Ubuntu”。下载后的文件名称类似 couchbase-server-enterprise_7.6.3-ubuntu22.04_amd64.deb——切勿误选CentOS/RHEL的.rpm包，否则使用dpkg安装时会报架构冲突，导致徒劳无功。

将下载好的.deb文件放置到 /home/用户名/Downloads 目录下，后续所有操作均在此目录进行。

安装Couchbase并解决依赖缺失问题

打开终端（Ctrl+Alt+T），首先执行以下命令：

sudo dpkg -i ~/Downloads/couchbase-server-enterprise_*.deb

此步骤大概率会报错，提示缺少某些依赖包，例如libcurl4、libc6-dev、libssl1.1等。此时有一个常见错误：直接使用 apt --fix-broken install 进行强制修复。此操作需极为谨慎，因为它可能意外升级系统关键库，导致UOS桌面环境崩溃。

正确的做法是逐个安装缺失的依赖包：

sudo apt install -y libcurl4 libc6-dev libssl1.1 libncurses5 libtinfo5

安装完毕后，重新执行dpkg安装命令。若仍有报错，请检查错误信息最后一行提示的缺失包名，使用 apt search 模糊搜索，例如 apt search libssl | grep 1.1 确认具体是libssl1.1还是libssl3，然后精确安装。

启动Couchbase服务并开放防火墙端口

安装成功后，Couchbase服务默认处于停止状态，需手动启动：

sudo systemctl start couchbase-server

确认服务是否正常运行：sudo systemctl is-active couchbase-server 应返回 active。若返回 failed，则查看日志：sudo journalctl -u couchbase-server -n 50 --no-pager。最常见的原因是 /opt/couchbase/var/lib/couchbase/data 目录权限问题，执行 sudo chown -R couchbase:couchbase /opt/couchbase/var/lib/couchbase 即可解决。

统信UOS默认启用firewalld，需要放行Web管理端口：sudo ufw allow 8091。若需从其他机器访问集群，还需开放集群通信端口：sudo ufw allow 11210:11211/tcp 和 sudo ufw allow 18091:18092/tcp。

初次访问Web控制台并完成初始化

在UOS自带的浏览器中访问 http://localhost:8091，页面加载后进入 Setup New Cluster 流程。

第一步：创建管理员账户
输入用户名（例如admin），密码必须足够复杂——至少8位，包含大小写字母和数字。密码一旦设定，后续无法通过界面修改，只能重装或使用命令行重置，因此请一次性确认无误。

第二步：配置数据存储路径
默认路径 /opt/couchbase/var/lib/couchbase/data 可保持不变。若系统盘空间不足，点击右侧文件夹图标，选择大容量分区下的目录（如 /data/cb-data），但需确保该目录已创建且属主为couchbase用户。

第三步：设置内存配额与选择服务
将“Memory Quota”滑块拖动至至少2048MB（UOS桌面环境建议设置为3072MB以上）。勾选“Data Service”和“Index Service”，取消勾选“Search Service”——否则首次启动容易卡死。

点击“Next”，等待约90秒，页面跳转到 Buckets 列表，即表示初始化成功。