
apicurio/apicurio-studio-wsApicurio WS 组件是 Apicurio Studio 应用程序的重要组成部分,主要提供基于 WebSocket 的并发编辑层,仅在用户编辑 API 时由 UI 组件调用,支持实时协作编辑功能。
启动 Apicurio WS 组件的基础命令:
bashdocker run -it apicurio/apicurio-studio-ws:latest-release
若需外部访问应用,需映射端口:
bashdocker run -it -p 8080:8080 -p 8443:8443 apicurio/apicurio-studio-ws:latest-release
启动该组件时,可通过以下环境变量进行配置:
| 环境变量名称 | 描述 | 默认值 |
|---|---|---|
| APICURIO_PORT_OFFSET | 服务器启动时使用的端口偏移量(例如,设为10可将HTTP端口从8080移至8090) | 0 |
| APICURIO_DB_DRIVER_NAME | 数据库驱动名称,可选值:h2、mysql、postgresql | h2 |
| APICURIO_DB_CONNECTION_URL | 数据库(JDBC)连接URL | jdbc:h2:mem:apicuriodb |
| APICURIO_DB_USER_NAME | 数据库用户名 | sa |
| APICURIO_DB_PASSWORD | 数据库密码 | sa |
| APICURIO_DB_INITIALIZE | 是否由Apicurio初始化数据库(若DBA手动初始化则设为false) | true |
| APICURIO_DB_TYPE | 数据库类型,有效值:h2、postgresql9、mysql5 | h2 |
| APICURIO_LOGGING_LEVEL | 默认日志级别 | INFO |
| APICURIO_MIN_HEAP | Java堆内存最小值 | 768m |
| APICURIO_MAX_HEAP | Java堆内存最大值 | 2048m |
通常需要自定义数据库设置,确保所有 Apicurio 组件(API、WS、UI)指向同一共享数据库实例(通常为 MySQL 或 PostgreSQL)。示例配置:
bashdocker run -it -p 8080:8080 -p 8443:8443 \ -e "APICURIO_KC_AUTH_URL=[***]" \ -e "APICURIO_DB_DRIVER_NAME=postgresql" \ -e "APICURIO_DB_CONNECTION_URL=jdbc:postgresql://db.example.com:5432/apicuriodb" \ -e "APICURIO_DB_TYPE=postgresql9" \ -e "APICURIO_DB_USER_NAME=dbuser" \ -e "APICURIO_DB_PASSWORD=dbpassword123" \ apicurio/apicurio-studio-ws:latest-release
apicurio/apicurio-studio-ws 仅是 Apicurio Studio 应用程序的组件之一。要使 Apicurio Studio 完全正常运行,需部署以下组件:
| 组件 | 描述 | Docker 镜像 |
|---|---|---|
| API | 基于 REST API 的后端,UI 用于大多数操作 | apicurio/apicurio-studio-api |
| Editing | 基于 WebSocket 的并发编辑层,仅在编辑 API 时由 UI 使用 | apicurio/apicurio-studio-ws |
| UI | 基于 Angular 的用户界面,用户通过此处访问 Apicurio | apicurio/apicurio-studio-ui |
| Auth | 提供身份验证和账户链接功能的 Keycloak 服务器 | apicurio/apicurio-studio-auth |
注意:如果已有 Keycloak 服务器或不想使用
apicurio/apicurio-studio-auth镜像,可自行安装/运行/配置 Keycloak 服务器。


探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务