快速开始

本指南帮助你在 5 分钟内启动 MLiev IAM 服务。

环境要求

• Go 1.25+（从源码构建时需要）
• MySQL 8.0+ / PostgreSQL 13+ / SQLite 3+
• Redis 6.0+（生产环境推荐；独立模式可使用内存缓存）

方式一：下载预编译二进制

# 创建项目目录
mkdir mliev-iam && cd mliev-iam

# 下载最新版本（以 Linux x86_64 为例）
# 前往 Release 页面下载对应平台的压缩包
tar -xzf mliev-iam_Linux_x86_64.tar.gz
chmod +x mliev-iam

启动服务：

./mliev-iam

方式二：从源码构建

git clone <repository-url>
cd mliev-iam
go mod download

# 构建并运行（仅后端）
make build-go
./mliev-iam

# 或构建完整版（含前端管理后台）
make all
./mliev-iam

方式三：Docker 部署

docker build -t mliev-iam .
docker run -p 8080:8080 mliev-iam

Web 安装向导

首次启动时（app.installed: false），访问 http://localhost:8080 会自动进入安装向导：

1. 测试数据库连接 — 输入数据库连接信息，点击测试
2. 测试 Redis 连接 — 输入 Redis 连接信息，点击测试
3. 设置管理员账户 — 创建初始管理员用户名和密码
4. 完成安装 — 系统自动执行数据库迁移和初始数据填充

安装完成后，系统会自动更新配置文件并重载服务。

验证安装

curl http://localhost:8080/health
curl http://localhost:8080/health/simple

安装完成后可以访问：

地址	说明
http://localhost:8080/admin	管理后台
http://localhost:8080/auth	OIDC 登录页面
http://localhost:8080/health	健康检查