跳到主要内容

CLI命令

所有命令遵循模式：unraid-api <command> [options]

服务管理​

开始​

unraid-api start [--log-level <level>]

Starts the Unraid API service.

选项：

  • --log-level：设置日志记录级别(trace|debug|info|warn|error|fatal)

替代：您也可以使用 LOG_LEVEL 环境变量设置日志级别：

LOG_LEVEL=trace unraid-api start

停止​

unraid-api stop [--delete]

Stops the Unraid API service.

  • --delete: 可选。删除PM2主目录.

重启​

unraid-api restart [--log-level <level>]

重新启动 Unraid API 服务。

选项：

  • --log-level：设置日志记录级别(trace|debug|info|warn|error|fatal)

替代：您也可以使用 LOG_LEVEL 环境变量设置日志级别：

LOG_LEVEL=trace unraid-api restart

日志​

unraid-api logs [-l <lines>]

查看API日志。

  • -l, --lines: 可选。要尾部的行数（默认: 100）

配置命令​

配置​

unraid-api config

显示当前配置值。

切换环境​

unraid-api switch-env [-e <environment>]

在生产和测试环境间切换。

  • -e, --environment: 可选。目标环境（production|staging）。

开发者模式​

您也可以通过 WebGUI 中的 Settings → Management Access → Developer Options Web 界面管理开发者选项。

unraid-api developer                       # Interactive prompt for tools
unraid-api developer --sandbox true        # Enable %%GraphQL|graphql%% sandbox
unraid-api developer --sandbox false       # Disable %%GraphQL|graphql%% sandbox
unraid-api developer --enable-modal        # Enable modal testing tool
unraid-api developer --disable-modal       # Disable modal testing tool

配置API的开发人员功能：

  • GraphQL Sandbox：启用/禁用位于 /graphql 的 Apollo GraphQL 沙箱
  • 模态测试工具：在 Unraid 菜单中启用/禁用用户界面模态测试

API密钥管理​

您也可以通过 WebGUI 中的 Settings → Management Access → API Keys Web 界面管理 API 密钥。

API密钥命令​

unraid-api apikey [options]

通过CLI创建和管理API密钥。

选项：

  • --name <name>：密钥名称
  • --create：创建新密钥
  • -r, --roles <roles>：角色列表，逗号分隔
  • -p, --permissions <permissions>：权限列表，逗号分隔
  • -d, --description <description>：密钥描述

SSO（单点登录）管理​

有关 OIDC/SSO 提供商配置，请参阅 WebGUI 中的 Settings → Management Access → API → OIDC Web 界面，或参考 OIDC Provider Setup 指南。

SSO基础命令​

unraid-api sso

选项：

unraid-api sso add-user
# or
unraid-api sso add
# or
unraid-api sso a

移除 SSO 用户：

unraid-api sso remove-user
# or
unraid-api sso remove
# or
unraid-api sso r

有关OIDC/SSO提供商配置，请参阅Web界面在 设置 → 管理访问 → API → OIDC 或参考 OIDC提供商设置 指南。

unraid-api sso list-users
# or
unraid-api sso list
# or
unraid-api sso l

验证 SSO 令牌：

验证SSO令牌并返回其状态。

unraid-api sso validate-token <token>
# or
unraid-api sso validate
# or
unraid-api sso v

报告生成​

移除SSO用户​

unraid-api report [-r] [-j]

生成系统报告。

  • -r, --raw：显示原始命令输出
  • -j, --json：以JSON格式显示输出

大多数命令需要适当的权限才能修改系统状态。某些命令要求 API 处于运行或停止状态。请安全存储 API 密钥，因为它们可提供系统访问权限。SSO 配置更改可能需要重启服务。