快速安裝¶

本頁介紹部署 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 部署 — 手動拉取映象部署
一鍵指令碼安裝 — 與快速安裝相同的指令碼流程

下一步¶

安裝完成後，參考首次登入登入並納管第一臺主機。