
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
启动apicurio/apicurio-studio-ui
docker run -it apicurio/apicurio-studio-ui:latest-release
您可能需要映射端口以访问应用
docker run -it -p 8080:8080 -p 8443:8443 apicurio/apicurio-studio-ui:latest-release
启动此组件时,有一些重要的配置选项。以下是您可以设置的环境变量列表(例如,启动docker镜像时):
| 环境变量名称 | 描述 | 默认值 |
|---|---|---|
| APICURIO_KC_AUTH_URL | Keycloak认证服务器的URL。 | [***] |
| APICURIO_KC_REALM | 用于认证的Keycloak领域名称。 | apicurio |
| APICURIO_KC_CLIENT_ID | 用于认证的Keycloak客户端ID。 | apicurio-studio |
| APICURIO_KC_SSL_REQUIRED | 用于确定是否必须通过HTTPS访问Keycloak服务器。 | NONE |
| APICURIO_KC_DISABLE_TRUST_MANAGER | 设置为true可禁用访问Keycloak时的HTTP客户端信任管理器(用于对Keycloak进行HTTPS客户端调用时)。 | true |
| APICURIO_PORT_OFFSET | 启动服务器时使用的端口偏移量(例如,设置为10可将HTTP端口从8080移至8090)。 | 0 |
| APICURIO_LOGGING_LEVEL | 默认日志级别。 | INFO |
| APICURIO_MIN_HEAP | 最小Java堆设置。 | 768m |
| APICURIO_MAX_HEAP | 最大Java堆设置。 | 2048m |
| APICURIO_UI_HUB_API_URL | Apicurio Studio API组件(apicurio-studio-api)的URL。 | https://localhost:8443/api |
| APICURIO_UI_EDITING_URL | Apicurio Studio编辑组件(apicurio-studio-ws)的URL。 | https://localhost:8443/ws |
注意:通常,您至少需要提供Keycloak以及Apicurio API和WS组件的URL。因此,实际的启动命令可能如下所示:
docker run -it -p 8080:8080 -p 8443:8443 \ -e "APICURIO_KC_AUTH_URL=https://keycloak.example.com/auth/" \ -e "APICURIO_UI_HUB_API_URL=https://apicurio-api.example.com/" \ -e "APICURIO_UI_EDITING_URL=https://apicurio-ws.example.com/" \ apicurio/apicurio-studio-ui:latest-release
apicurio/apicurio-studio-ui组件只是构成Apicurio Studio应用程序的几个组件之一。要使Apicurio Studio完全正常运行,需要以下组件:
| 组件 | 描述 | Docker镜像 |
|---|---|---|
| API | 基于REST API的后端。UI的大多数操作都使用此组件。 | apicurio/apicurio-studio-api |
| Editing | 基于WebSocket的并发编辑层。仅当编辑API时UI才使用此组件。 | apicurio/apicurio-studio-ws |
| UI | 基于Angular的UI。用户通过此处访问Apicurio UI。 | apicurio/apicurio-studio-ui |
| Auth | 提供认证和账户链接功能的Keycloak服务器。 | apicurio/apicurio-studio-auth |
注意:如果您已有Keycloak服务器或不想使用apicurio/apicurio-studio-auth镜像,可以安装/运行/配置自己的Keycloak服务器。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。


来自真实用户的反馈,见证轩辕镜像的优质服务