快速安装¶

本页介绍部署 OpsAnt 的完整流程，主要分为四步：安装 Docker、获取代码、修改配置、执行安装脚本。

前置条件¶

一台 Linux 服务器（推荐 Ubuntu 24.04 / CentOS 7+ / Debian，内存不低于 8G）
服务器可访问外网（拉取镜像）

1. 安装 Docker 和依赖软件包¶

# Ubuntu / Debian 示例
sudo apt-get -y update
sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get -y update
sudo apt-get -y install docker-ce jq uuid wget git ntpdate mysql-client unzip
systemctl enable --now docker

其他系统（CentOS / RockyLinux / OpenEuler 等）的 Docker 安装命令请参考环境要求。

2. 获取代码¶

cd /opt && git clone https://github.com/unixhot/opsant.git
# 或下载源码包并解压到 /opt/opsant

3. 修改安装配置（必须）¶

cd /opt/opsant/install
cp install.config.example install.config
vim install.config

需要修改的关键配置：

配置项	说明
`DOMAIN_NAME`	访问 OpsAnt 的地址（IP 或可解析域名，修改 hosts 无效）
`LOCAL_IP`	本机内网 IP
`PROXY_PUBLIC_IP`	公网 IP（内网部署可保持默认，等于 `DOMAIN_NAME`）

脚本会自动生成随机字符串替换 INIT_PASSWORD，无需手动设置密码。

4. 执行安装脚本¶

cd /opt/opsant/install && ./opsant-install.sh install

脚本会自动完成：初始化 MySQL、Redis、Consul、Prometheus、Alertmanager、blackbox-exporter 等容器，部署 Proxy 主容器，写入 Prometheus 接入配置并导入内置告警规则。

重要：执行过程不能有 Error 报错（Warning 可忽略）。安装脚本会输出 admin 账号的随机初始密码，请务必妥善保存。

访问¶

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

http://<DOMAIN_NAME>:8010

默认账号 admin，密码为安装脚本输出的随机密码。

服务端口¶

端口	用途
8010	OpsAnt Web 平台（Django）
4505 / 4506	SaltStack Master
4507	OpsMini Server 数据面（gRPC，Agent 连接）
4508	OpsMini Server 控制面 HTTP（容器内调用，不对外映射）
9090	Prometheus
9093	Alertmanager
8500	Consul

其它安装方式¶

Docker 部署 — 手动拉取镜像部署
一键脚本安装 — 与快速安装相同的脚本流程

下一步¶

安装完成后，参考首次登录登录并纳管第一台主机。