Unleash项目入门指南：基于Docker的自托管部署

原创于 2025-06-03 09:06:02 发布 · 367 阅读

9 ·

CC 4.0 BY-SA版权

Unleash项目入门指南：基于Docker的自托管部署

什么是Unleash？

Unleash是一个开源的特性标志（Feature Flag）管理系统，它允许开发团队在不重新部署代码的情况下控制功能的发布。通过Unleash，团队可以实现渐进式发布、A/B测试、金丝雀发布等高级部署策略。

部署前的准备

在开始部署Unleash之前，您需要确保系统满足以下要求：

已安装Docker（建议使用最新稳定版）
已安装Docker Compose（如果选择Compose方式部署）
至少2GB可用内存
基本的命令行操作知识

两种部署方式对比

Unleash提供了两种基于Docker的部署方式，各有优缺点：

Docker Compose方式

优点：

一键式部署，简单快捷
配置文件集中管理
适合快速启动和测试环境

缺点：

灵活性较低
对自定义配置支持有限

Docker CLI方式

优点：

更高的灵活性和控制力
适合生产环境定制
可以单独管理每个容器

缺点：

需要手动配置网络连接
命令更复杂

详细部署步骤

使用Docker Compose部署

企业版部署

获取Unleash企业版镜像
使用专用Compose文件启动服务
系统会自动配置数据库连接

docker compose -f docker-compose-enterprise.yml up -d

开源版部署

获取Unleash开源版镜像
使用默认Compose文件启动服务

docker compose up -d

使用Docker CLI部署

1. 创建专用网络

docker network create unleash

2. 启动PostgreSQL容器

docker run -d \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_USER=unleash_user \
  -e POSTGRES_DB=unleash \
  --network unleash \
  --name postgres \
  postgres:15

3. 启动Unleash服务容器

企业版：

docker run -d -p 4242:4242 \
  -e DATABASE_HOST=postgres \
  -e DATABASE_NAME=unleash \
  -e DATABASE_USERNAME=unleash_user \
  -e DATABASE_PASSWORD=your_secure_password \
  -e DATABASE_SSL=false \
  --network unleash \
  --name unleash \
  --pull=always \
  unleashorg/unleash-enterprise

开源版：

docker run -d -p 4242:4242 \
  -e DATABASE_HOST=postgres \
  -e DATABASE_NAME=unleash \
  -e DATABASE_USERNAME=unleash_user \
  -e DATABASE_PASSWORD=your_secure_password \
  -e DATABASE_SSL=false \
  --network unleash \
  --name unleash \
  --pull=always \
  unleashorg/unleash-server

初始登录与配置

默认管理员账户

首次启动Unleash后，系统会自动创建默认管理员账户：

用户名：admin
密码：unleash4all

安全建议：生产环境中，建议通过环境变量修改默认凭证：

UNLEASH_DEFAULT_ADMIN_USERNAME=自定义用户名
UNLEASH_DEFAULT_ADMIN_PASSWORD=强密码

企业版许可证安装

如果您部署的是企业版，需要：

获取许可证密钥
登录管理界面
导航至"Admin > License"
输入许可证密钥并激活

服务验证

部署完成后，可以通过以下方式验证服务是否正常运行：

访问管理界面：http://localhost:4242
使用API测试连接：

curl --location --request POST 'http://localhost:4242/api/admin/features' \
--header 'Authorization: <API_TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "Test Feature Flag",
  "description": "Feature flag for testing",
  "type": "release",
  "enabled": false,
  "stale": false,
  "strategies": [
    {
      "name": "default",
      "parameters": {}
    }
  ]
}'