swaggerapi/swagger-ui Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务
swaggerapi/swagger-uiswaggerapi
用于托管Swagger UI的简单Docker容器，可可视化和交互API资源，基于OpenAPI规范自动生成文档，便于后端实现与客户端使用。
288 次收藏下载次数: 0状态：社区镜像维护者：swaggerapi仓库类型：镜像最近更新：12 天前
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/petstore3
swaggerapi
暂无描述
3 次收藏1000万+ 次下载
7 个月前更新
swaggerapi/swagger-editor
swaggerapi
Swagger-Editor Web服务，提供在线编辑Swagger/OpenAPI规范的功能，用于API文档的设计与测试。
387 次收藏1000万+ 次下载
12 天前更新
swaggerapi/petstore
swaggerapi
这是一个示例宠物商店应用程序，可部署高性能的宠物商店服务，支持自定义API路径、主机和访问URL，用于演示和测试REST API功能。
14 次收藏100万+ 次下载
1 年前更新
swaggerapi/swagger-codegen-cli
swaggerapi
暂无描述
56 次收藏100万+ 次下载
2 个月前更新
swaggerapi/swagger-generator
swaggerapi
Swagger代码生成器Web服务
93 次收藏100万+ 次下载
2 个月前更新
swaggerapi/swagger-generator-v3
swaggerapi
暂无描述
9 次收藏100万+ 次下载
21 天前更新
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"