swaggerapi/swagger-ui Docker 镜像 - 轩辕镜像
swaggerapi/swagger-ui用于托管Swagger UI的简单Docker容器，可可视化和交互API资源，基于OpenAPI规范自动生成文档，便于后端实现与客户端使用。
288 收藏0 次下载activeswaggerapi镜像
Swagger UI Docker镜像文档
概述
Swagger UI是一款允许开发团队及终端用户可视化和交互API资源的工具，无需了解底层实现逻辑。该Docker镜像提供预构建环境，基于OpenAPI（原Swagger）规范自动生成可视化文档，简化API的后端实现与客户端消费流程。
核心功能与特性
- API可视化：直观展示API资源结构与详情，自动生成交互式文档
- 实时交互：支持直接在界面中测试API端点，验证请求与响应
- 规范驱动：基于OpenAPI规范自动构建，减少手动文档维护成本
- 零依赖部署：无需预先部署API实现逻辑即可使用
- 跨团队协作：促进前后端开发、测试及终端用户间的API文档共享
使用场景
- API开发团队快速生成和托管API文档
- 前后端协作时提供清晰的接口规范说明
- API测试与调试过程中的实时交互验证
- 向第三方合作伙伴展示API功能与使用方法
快速部署指南
拉取镜像
从官方仓库拉取预构建的Swagger UI Docker镜像：
shdocker pull docker.swagger.io/swaggerapi/swagger-ui
启动容器
运行以下命令启动容器，将本地80端口映射到容器的8080端口：
shdocker run -p 80:8080 docker.swagger.io/swaggerapi/swagger-ui
容器启动后，Swagger UI将通过nginx服务在http://localhost:80地址可用。
版本兼容性
Swagger UI与OpenAPI规范的兼容性如下表所示：
| Swagger UI 版本 | 发布日期 | OpenAPI 规范兼容性 | 说明 |
|---|---|---|---|
| 5.0.0 | 2023-06-12 | 2.0, 3.0.0, 3.0.1, 3.0.2, 3.0.3, 3.1.0 | v5.0.0 标签 |
| 4.0.0 | 2021-11-03 | 2.0, 3.0.0, 3.0.1, 3.0.2, 3.0.3 | v4.0.0 标签 |
| 3.18.3 | 2018-08-03 | 2.0, 3.0.0, 3.0.1, 3.0.2, 3.0.3 | v3.18.3 标签 |
| 3.0.21 | 2017-07-26 | 2.0 | v3.0.21 标签 |
| 2.2.10 | 2017-01-04 | 1.1, 1.2, 2.0 | v2.2.10 标签 |
| 2.1.5 | 2016-07-20 | 1.1, 1.2, 2.0 | v2.1.5 标签 |
| 2.0.24 | 2014-09-12 | 1.1, 1.2 | v2.0.24 标签 |
| 1.0.13 | 2013-03-08 | 1.1, 1.2 | v1.0.13 标签 |
| 1.0.1 | 2011-10-11 | 1.0, 1.1 | v1.0.1 标签 |
扩展文档与资源
使用指南（英文）
- 安装
- 配置
- CORS设置
- OAuth2集成
- 深度链接
- 功能限制
自定义开发（英文）
- 自定义概述
- 插件API
- 自定义布局
浏览器支持
兼容最新版本的Chrome、Safari、Firefox和Edge浏览器。
安全联系
如发现安全漏洞，请发送邮件至***，而非公共issue追踪器。
许可证
采用Apache 2.0许可证，附带NOTICE文件包含额外***声明。
swaggerapi/swagger-editor
by swaggerapi
Swagger-Editor Web服务，提供在线编辑Swagger/OpenAPI规范的功能，用于API文档的设计与测试。
38610M+ pulls
上次更新：26 天前
swaggerapi/petstore3
by swaggerapi
暂无描述
310M+ pulls
上次更新：5 个月前
swaggerapi/swagger-codegen-cli
by swaggerapi
暂无描述
561M+ pulls
上次更新：13 天前
swaggerapi/swagger-generator
by swaggerapi
Swagger代码生成器Web服务
931M+ pulls
上次更新：13 天前
swaggerapi/swagger-generator-v3
by swaggerapi
暂无描述
91M+ pulls
上次更新：2 个月前
swaggerapi/swagger-codegen-cli-v3
by swaggerapi
暂无描述
181M+ pulls
上次更新：2 个月前
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录仓库拉取
通过 Docker 登录认证访问私有仓库
Linux
在 Linux 系统配置镜像服务
Windows/Mac
在 Docker Desktop 配置镜像
Docker Compose
Docker Compose 项目配置
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
宝塔面板
在宝塔面板一键配置镜像
群晖
Synology 群晖 NAS 配置
飞牛
飞牛 fnOS 系统配置镜像
极空间
极空间 NAS 系统配置服务
爱快路由
爱快 iKuai 路由系统配置
绿联
绿联 NAS 系统配置镜像
威联通
QNAP 威联通 NAS 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
专属域名拉取
无需登录使用专属域名
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
轩辕镜像免费版与专业版有什么区别？
免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。
轩辕镜像支持哪些镜像仓库？
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。
流量耗尽错误提示
当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
410 错误问题
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
manifest unknown 错误
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
镜像拉取成功后，如何去掉轩辕镜像域名前缀？
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"