skillhub/document/docs/02-administration/deployment/single-machine.md

65 lines
1.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: 单机部署
sidebar_position: 1
description: 使用 Docker Compose 单机部署 SkillHub
---
# 单机部署
本文介绍如何使用 Docker Compose 在单台服务器上部署 SkillHub。
## 前置要求
- Docker Engine 20.10+
- Docker Compose Plugin 2.0+
- 至少 4GB 可用内存
- 至少 20GB 可用磁盘空间
## 快速部署
```bash
# 1. 克隆仓库
git clone https://github.com/iflytek/skillhub.git
cd skillhub
# 2. 复制环境变量模板
cp .env.release.example .env.release
# 3. 编辑配置
# 修改 .env.release 中的配置项,特别是密码和公网地址
# 4. 验证配置
make validate-release-config
# 5. 启动服务
docker compose --env-file .env.release -f compose.release.yml up -d
```
## 配置说明
详见 [配置说明](./configuration) 文档。
## 验证部署
```bash
# 检查容器状态
docker compose --env-file .env.release -f compose.release.yml ps
# 检查后端健康状态
curl -i http://127.0.0.1:8080/actuator/health
# 访问 Web UI
# 浏览器打开 http://localhost或配置的公网地址
```
## 首登配置
1. 使用 `BOOTSTRAP_ADMIN_USERNAME``BOOTSTRAP_ADMIN_PASSWORD` 登录(默认 `admin` / `ChangeMe!2026`
2. 立即修改管理员密码
3. 配置企业 SSO可选
4. 创建团队命名空间
## 下一步
- [配置说明](./configuration) - 详细配置项说明
- [Kubernetes 部署](./kubernetes) - 高可用部署