5 分钟快速安装¶
使用官方安装脚本 install.sh，在 Linux 主机上一键完成部署。
前提¶
- 目标主机：Linux
x86_64或aarch64 - 拥有
sudo权限 - 可访问外网（用于下载二进制）或提前准备二进制文件
一键安装¶
# 一键安装（推荐，脚本自动按架构从阿里云 OSS 下载二进制）
curl -fsSL https://opsmini.com/install.sh | sudo bash
# 指定本地二进制安装（默认安装到 /data/opsmini，端口 8888）
sudo ./install.sh -b ./opsmini
# 自定义下载地址
sudo ./install.sh -u https://opsmini.oss-cn-beijing.aliyuncs.com/opsmini-v1.0.0-linux-amd64
# 自定义目录与端口
sudo ./install.sh -b ./opsmini -d /data/opsmini -p 9999
安装参数¶
| 参数 | 说明 | 默认值 |
|---|---|---|
-d, --dir <path> |
安装目录 | /data/opsmini |
-p, --port <port> |
面板监听端口 | 8888 |
-b, --binary <path> |
opsmini 二进制路径 | 未指定时从 OSS 下载 |
-u, --url <url> |
从 URL 下载（.tar.gz 或裸二进制） |
OSS 官方地址 |
-n, --no-systemd |
不注册 systemd 服务 | — |
安装行为¶
- 创建安装目录（默认
/data/opsmini） - 下载 / 复制二进制到
<目录>/opsmini（默认按架构从阿里云 OSS 下载） - 生成
<目录>/config.yaml（端口、SQLite 路径、JWT 有效期、日志级别与日志文件；JWT 密钥与 Agent Token 首次启动自动生成存库） - 生成 16 位随机管理员密码，写入
<目录>/.init_passwd（权限 600） - 注册并启动 systemd 服务
opsmini.service - 探测服务响应，打印访问地址 / 用户名 / 密码 / 日志文件路径
产物结构¶
/data/opsmini/
├── opsmini # 二进制
├── config.yaml # 配置（600）
├── opsmini.db # SQLite 数据库（首次启动后生成）
├── opsmini.log # 运行日志文件
└── .init_passwd # 初始密码（600）
首次登录¶
- 访问
http://<host>:8888 - 用户名：
opsmini - 密码：安装脚本打印的密码，或查看
/data/opsmini/.init_passwd
⚠️ 请立即记录密码并登录后修改。重装时密码会自动重置并重新打印。