skillhub/document/docs/01-getting-started/quick-start.md

85 lines
1.9 KiB
Markdown

---
title: 快速开始
sidebar_position: 2
description: 一键启动 SkillHub 开发环境
---
# 快速开始
## 一键启动
使用以下命令一键启动完整的 SkillHub 环境:
```bash
curl -fsSL https://raw.githubusercontent.com/iflytek/skillhub/main/scripts/runtime.sh | sh -s -- up
```
或者克隆仓库后手动启动:
```bash
git clone https://github.com/iflytek/skillhub.git
cd skillhub
make dev-all
```
## 默认账号
两种启动方式都会默认创建一个 bootstrap 管理员账号:
- 用户名:`admin`
- 密码:`ChangeMe!2026`
### `curl` 一键部署
| 服务 | 地址 |
|------|------|
| Web UI | http://localhost |
| Backend API | http://localhost:8080 |
使用上述默认账号密码登录即可。**生产环境请务必修改密码。**
### `make dev-all` 本地开发
| 服务 | 地址 |
|------|------|
| Web UI | http://localhost:3000 |
| Backend API | http://localhost:8080 |
| MinIO Console | http://localhost:9001 |
除了上述 bootstrap 管理员,本地开发还预置两个模拟用户(无需密码):
| 用户 | 角色 | 说明 |
|------|------|------|
| `local-user` | 普通用户 | 可发布技能、管理命名空间 |
| `local-admin` | 超级管理员 | 拥有所有权限,包括审核和用户管理 |
使用 `X-Mock-User-Id` 请求头切换模拟用户。
如需关闭 bootstrap 管理员,启动前设置 `BOOTSTRAP_ADMIN_ENABLED=false`
## 常用命令
```bash
# 启动完整开发环境
make dev-all
# 停止所有服务
make dev-all-down
# 重置并重新启动
make dev-all-reset
# 仅启动后端
make dev
# 仅启动前端
make dev-web
# 查看所有可用命令
make help
```
## 下一步
- [产品概述](./overview) - 深入了解产品特性
- [典型应用场景](./use-cases) - 探索企业应用场景
- [单机部署](../administration/deployment/single-machine) - 生产环境部署指南