统信uos部署mongodb需据网络与版本选方式：联网时仅desktop 20等debian系可用apt源安装（含密钥导入、唯一源配置、指定版本安装及systemd启用）；离线时server 20 enterprise或国产cpu平台须用tgz包手动部署（含解压、目录创建、yaml格式conf配置、环境变量设置及mongod -f启动），且mongodb 6.0起必须单独安装mongosh客户端连接。

在统信UOS系统中部署MongoDB数据库，需根据网络连通性、系统版本（Desktop 20/Server 20/1050系列）及架构（x86_64/Phytium/Hygon）选择适配方式；离线环境不能用apt源，联网环境若误加多源会导致包冲突，必须严格控制仓库唯一性。

联网环境：APT源安装（仅限UOS Desktop 20等Debian系）

该方法适用于已配置标准Debian兼容源的UOS Desktop 20或Deepin 23，自动解决依赖，但【禁止在UOS Server 20 Enterprise上使用】，因其底层为独立内核，apt源不兼容会导致安装失败或服务无法启动。

第一步：导入官方GPG密钥，防止软件包签名验证失败
sudo apt-get install -y gnupg wget && wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -

第二步：写入唯一APT源地址，覆盖默认源可能存在的旧版残留
echo "deb http://repo.mongodb.org/apt/debian bookworm/mongodb-org/6.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

第三步：更新索引并安装完整套件，指定版本可避免自动升级引发的配置不兼容
sudo apt-get update && sudo apt-get install -y mongodb-org=6.0.26 mongodb-org-server=6.0.26 mongodb-org-shell=6.0.26 mongodb-org-mongos=6.0.26 mongodb-org-tools=6.0.26

第四步：启用并启动服务，systemd重载是必要前置动作，否则enable无效
sudo systemctl daemon-reload && sudo systemctl enable mongod && sudo systemctl start mongod

无网环境：TGZ二进制包手动部署

适用于UOS Server 20 Enterprise、国产CPU平台（如Phytium FT-2000+/Hygon Dhyana）等完全断网场景，绕过包管理器，直接运行预编译二进制文件。

方法一：标准路径部署
下载对应平台的tgz包（例如：mongodb-linux-x86_64-rhel8-8.2.3.tgz），上传至服务器后执行：
sudo mkdir -p /usr/local/mongodb && sudo tar -zxvf mongodb-linux-x86_64-rhel8-8.2.3.tgz -C /usr/local/mongodb --strip-components=1

创建数据与日志目录，路径必须与后续配置文件严格一致：
sudo mkdir -p /usr/local/mongodb/data /usr/local/mongodb/log

方法二：自定义路径部署（推荐用于多实例隔离）
将包解压到非标准路径如/opt/mongo-prod，然后手动创建conf子目录，在其中新建mongod.conf，内容需显式声明dbPath和path为实际路径，否则mongod启动时会报错“data directory not found”。

Miku

一款AI工具，主要用于Miku AI搜索是一个由Agent驱动的AI搜索引擎，以快速精准的搜索结果而著称，适合需要提升相关任务效率的用户。

下载

配置文件关键项必须存在且格式正确，YAML缩进错误会导致服务拒绝启动：
storage:
  dbPath: /usr/local/mongodb/data
systemLog:
  destination: file
  path: /usr/local/mongodb/log/mongod.log
net:
  port: 27017
  bindIp: 0.0.0.0

配置环境变量与启动服务

编辑全局环境配置，使mongod命令可在任意路径调用：
sudo vi /etc/profile，末尾添加：
export MONGODB_HOME=/usr/local/mongodb
export PATH=$MONGODB_HOME/bin:$PATH

立即生效配置：
source /etc/profile

启动数据库进程，必须指定配置文件路径，否则使用默认参数可能导致绑定失败：
mongod -f /usr/local/mongodb/conf/mongod.conf

验证是否监听成功：
ss -tlnp | grep :27017

安装Mongosh客户端工具

MongoDB 6.0起弃用旧版mongo shell，必须单独安装mongosh才能连接操作。

方法1：离线rpm安装（适用于有rpm支持的UOS Server 20）
下载mongodb-mongosh-shared-openssl1-1.6.0.x86_64.rpm，执行：
sudo rpm -ivh mongodb-mongosh-shared-openssl1-1.6.0.x86_64.rpm

方法2：tgz解压即用（全平台通用）
下载mongosh-1.10.6-linux-x64.tgz，解压到/usr/local/mongosh，再将/usr/local/mongosh/bin加入PATH，之后直接运行mongosh即可连接本地实例。

连接测试：
mongosh "mongodb://127.0.0.1:27017"