单机部署

本文介绍如何使用 Docker Compose 在单台服务器上部署 SkillHub。

前置要求

• Docker Engine 20.10+
• Docker Compose Plugin 2.0+
• 至少 4GB 可用内存
• 至少 20GB 可用磁盘空间

快速部署

# 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

配置说明

详见 配置说明 文档。

验证部署

# 检查容器状态
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. 创建团队命名空间

下一步

• 配置说明 - 详细配置项说明
• Kubernetes 部署 - 高可用部署