如何在FusionAuth中绕过设置向导无UI创建Application？

我之前也碰到过类似的需求——用FusionAuth做认证后端，不想走UI设置向导，直接自动化配置应用。核心问题其实是：FusionAuth在初始化阶段必须先创建管理员账户，所有后续API调用都需要管理员认证，哪怕是无UI操作。你之前调用应用API返回401，就是因为系统还未完成初始化（没有管理员），API拒绝了未授权的请求。

下面给你两种可行的解决方案：

方案一：启动Docker容器时预配置管理员与应用（推荐） #

FusionAuth支持通过环境变量或初始化文件，在容器启动时自动完成管理员创建和应用配置，完全跳过设置向导。

1. 使用环境变量快速初始化管理员 #

启动容器时直接指定管理员的邮箱和密码，这样启动后系统就完成了初始化，你可以直接用这些凭证调用API：

docker run -p 9011:9011 \
  -e FUSIONAUTH_APP_SETUP_ADMIN_EMAIL="admin@example.com" \
  -e FUSIONAUTH_APP_SETUP_ADMIN_PASSWORD="your-strong-password" \
  fusionauth/fusionauth-app:latest

2. 用初始化文件批量配置应用（更灵活） #

如果需要同时创建应用、API Key等资源，可以编写一个JSON初始化文件，通过环境变量让FusionAuth在启动时自动执行：

第一步：创建初始化文件fusionauth-init.json

{
  "admin": {
    "email": "admin@example.com",
    "password": "your-strong-password"
  },
  "applications": [
    {
      "name": "Your Project App",
      "oauthConfiguration": {
        "authorizedRedirectURLs": ["https://your-app.com/callback"],
        "clientSecret": "your-client-secret",
        "enabledGrants": ["authorization_code", "refresh_token"]
      },
      "roles": [
        {
          "name": "user",
          "description": "Regular user role"
        }
      ]
    }
  ]
}

第二步：启动容器时挂载并指定初始化文件

docker run -p 9011:9011 \
  -v $(pwd)/fusionauth-init.json:/usr/local/fusionauth/config/initializer.json \
  -e FUSIONAUTH_APP_INITIALIZER_FILE="/usr/local/fusionauth/config/initializer.json" \
  fusionauth/fusionauth-app:latest

容器启动后，你的管理员账户和应用会自动创建完成，直接用管理员凭证调用API即可。

方案二：调用初始化API创建管理员，再创建应用 #

如果已经启动了容器，还没完成初始化，可以用无需认证的初始化API先创建管理员，再调用应用API：

1. 创建管理员账户 #

发送POST请求到初始化API（这个API仅在系统未初始化时可用）：

curl -X POST http://localhost:9011/api/system/setup \
  -H "Content-Type: application/json" \
  -d '{
    "admin": {
      "email": "admin@example.com",
      "password": "your-strong-password"
    }
  }'

成功后，系统会返回一个包含JWT token的响应，你可以用这个token调用后续API。

2. 创建Application #

用刚才拿到的token作为认证头，调用应用创建API：

curl -X POST http://localhost:9011/api/application \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application": {
      "name": "Your Project App",
      "oauthConfiguration": {
        "authorizedRedirectURLs": ["https://your-app.com/callback"],
        "clientSecret": "your-client-secret"
      }
    }
  }'

关键说明 #

• 不要试图绕过管理员认证直接创建应用：FusionAuth的设计就是所有操作都需要管理员权限，哪怕是自动化场景，初始化管理员是必经步骤。
• 初始化API仅在系统未完成设置时可用：一旦创建了管理员，这个API就会被禁用，后续操作必须用管理员凭证认证。

内容的提问来源于stack exchange，提问作者Manisha Bayya