跳到主要内容
版本：1.x

社区版部署指南

本文档介绍如何快速部署华杨 CMDB 社区版本。社区版适用于产品体验、功能评估和培训演示场景。

前置要求​

运行环境​

  • 操作系统：Linux（64 位）。推荐 Ubuntu 22.04 / 24.04 LTS。其他支持安装 Docker CE 的 Linux 发行版均可运行。

  • Docker 要求：推荐安装 Docker CE 20.10 及以上版本。

    Docker 20.10+ 已内置 Docker Compose V2 插件，用户可直接使用 docker compose 命令，无需再单独安装旧版 docker-compose。

硬件配置​

配置项最低配置推荐配置
CPU4 核8 核或以上
内存8 GB16 GB 或以上
硬盘100 GB SSD200 GB 或以上 SSD

网络要求​

  • 端口 4443 未被其他服务占用
  • 如需远程访问，请确保防火墙已开放 4443 端口

安装步骤​

1. 解压安装包​

tar -zxvf hyo-cmdb-1.0.0.tar.gz

2. 进入解压后的安装包目录​

cd hyo-cmdb-1.0.0

3. 运行安装脚本​

sudo ./scripts/install.sh <host_FQDN>

参数说明：<host_FQDN> 为包含域名的完整主机名。

本应用必须通过域名访问，不能使用 IP 地址。请选择以下任一方式配置：

方式一：真实域名

将您的域名 DNS 解析指向安装机器的 IP，安装时传入该域名（如 app.yourcompany.com）。

方式二：修改 hosts 文件

在每台需要访问的客户端机器上，以管理员身份编辑 hosts 文件，添加一行：

<机器IP>   <自定义域名>

例如：192.168.1.100 mydemo.local

  • Linux/macOS：编辑 /etc/hosts
  • Windows：编辑 C:\Windows\System32\drivers\etc\hosts

安装时传入该自定义域名（如 mydemo.local），之后通过 https://mydemo.local:4443/... 访问。

4. 等待安装完成​

安装脚本会自动执行以下操作：

  • 加载镜像到本地 registry
  • 生成 SSL 证书（如不存在）
  • 启动所有服务容器

安装完成后，终端会显示访问地址。

访问 华杨 CMDB​

安装完成后，通过浏览器访问：

https://<host_FQDN>:4443/ui/100000001

常用运维操作​

请确保先进入解压后的安装目录再执行下列命令。

查看服务状态​

docker compose ps

查看日志​

# 查看所有服务日志
docker compose logs -f

# 查看指定服务日志
docker compose logs -f <service_name>

重启服务​

docker compose restart

停止服务​

docker compose down

完全卸载​

警告

此操作会删除所有数据，不可恢复。

docker compose down -v

常见问题​

执行 docker compose 命令报错 "no configuration file provided: not found"​

原因：docker compose 需要在包含 docker-compose.yml 的目录下执行。如果不处于解压后的安装目录中，将找不到配置文件。

解决方法：确保先进入解压后的安装目录再执行命令：

cd hyo-cmdb-1.0.0
docker compose ps

浏览器提示证书不安全​

原因：社区版默认使用自签名 SSL 证书。

解决方法：在浏览器中点击"高级"→"继续访问"即可。生产环境建议使用正式 CA 签发的证书。

下一步​

安装完成后，您可以：