mirror of https://github.com/iflytek/skillhub.git synced 2026-09-12 23:01:05 +00:00

dongmucat ae93dcadb6 fix(deploy): handle release anon cookie placeholder

Issue: ISSUE-69

GitHub: iflytek/skillhub#574
Signed-off-by: dongmucat <1127093059@qq.com>

2026-07-09 15:16:02 +08:00

1.8 KiB

Raw Permalink Blame History

title	sidebar_position	description
单机部署	1	使用 Docker Compose 单机部署 SkillHub

单机部署

本文介绍如何使用 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 中的配置项，特别是密码、公网地址和 SKILLHUB_DOWNLOAD_ANON_COOKIE_SECRET

# 4. 验证配置
make validate-release-config

# 5. 启动服务
docker compose --env-file .env.release -f compose.release.yml up -d

快速验证时可以暂时保留 SKILLHUB_DOWNLOAD_ANON_COOKIE_SECRET 的发布模板占位值，服务端会生成仅本次运行有效的随机签名密钥。生产环境必须替换为持久的 32 字符以上随机值（例如 openssl rand -hex 32 的输出），否则 make validate-release-config 会拒绝该配置。

配置说明

详见配置说明文档。

验证部署

# 检查容器状态
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（或配置的公网地址）

首登配置

使用 BOOTSTRAP_ADMIN_USERNAME 和 BOOTSTRAP_ADMIN_PASSWORD 登录（默认 admin / ChangeMe!2026）
立即修改管理员密码
配置企业 SSO（可选）
创建团队命名空间

下一步

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

1.8 KiB Raw Permalink Blame History Unescape Escape