热门搜索:
openeuler/swagger-ui
openeuler
官方Swagger UI Docker镜像，基于openEuler构建，由openEuler CloudNative SIG维护，用于从Swagger兼容的API动态生成美观的文档，支持多种架构且免费使用。
下载次数: 0状态：社区镜像维护者：openeuler仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Swagger UI | openEuler 镜像文档
镜像概述和主要用途
本镜像为官方Swagger UI Docker镜像，基于openEuler构建，由openEuler CloudNative SIG维护。Swagger UI是一套HTML、JavaScript和CSS资产集合，能够从Swagger兼容的API动态生成美观的文档。本仓库可免费使用，且无每用户速率限制。
核心功能和特性
- 动态文档生成：从Swagger/OpenAPI规范自动生成交互式API文档
- 多架构支持：提供amd64和arm64架构版本
- 基于openEuler：构建于稳定可靠的openEuler操作系统之上
- 版本化管理：提供多个Swagger UI版本，满足不同需求
支持的标签及对应Dockerfile链接
镜像标签由Swagger UI版本和基础镜像版本组成，具体如下：
| 标签 | 内容 | 架构 |
|---|---|---|
| 5.30.2-oe2403sp2 | Swagger UI 5.30.2 基于 openEuler 24.03-LTS-SP2 | amd64, arm64 |
| 5.30.0-oe2403sp2 | Swagger UI 5.30.0 基于 openEuler 24.03-LTS-SP2 | amd64, arm64 |
| 5.29.1-oe2403sp2 | Swagger UI 5.29.1 基于 openEuler 24.03-LTS-SP2 | amd64, arm64 |
| 5.21.0-oe2403sp1 | Swagger UI 5.21.0 基于 openEuler 24.03-LTS-SP1 | amd64, arm64 |
使用场景和适用范围
- API文档展示与交互测试
- 开发环境中的API接口调试
- 团队协作时的API规范共享
- 前后端分离项目的接口文档管理
使用方法和配置说明
拉取镜像
根据需求选择对应的{Tag}标签拉取镜像：
bashdocker pull openeuler/swagger-ui:{Tag}
交互式运行
可通过交互式shell启动容器使用Swagger UI：
bashdocker run -it --rm openeuler/swagger-ui:{Tag} bash
快速启动示例（HTML本地版本）
1. 准备swagger.json文件
json{ "openapi": "3.0.0", "info": { "title": "简单API", "version": "1.0.0" }, "paths": { "/hello": { "get": { "summary": "打招呼", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "example": { "message": "Hello, World!" } } } } } } } } }
2. 准备index.html文件
html<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>Swagger UI示例</title> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css" /> </head> <body> <div id="swagger-ui"></div> <script src="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js"></script> <script> SwaggerUIBundle({ url: "./swagger.json", // 指向您的OpenAPI文件 dom_id: "#swagger-ui" }); </script> </body> </html>
3. 启动静态服务器（可选）
bashpython3 -m http.server 8080
然后访问：
http://localhost:8080/
您将看到交互式Swagger UI页面。点击/hello → GET → Try it out → Execute，将显示示例响应。
问题与反馈
如有任何问题或需要使用特定功能，请在openeuler-docker-images提交issue或pull request。
获取帮助：openEuler CloudNative SIG、openEuler社区
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 swagger-ui 镜像标签
docker pull docker.xuanyuan.run/openeuler/swagger-ui:<标签>
DockerHub 原生拉取命令
docker pull openeuler/swagger-ui:<标签>
更多 swagger-ui 镜像推荐
swaggerapi/swagger-ui
swaggerapi
用于托管Swagger UI的简单Docker容器，可可视化和交互API资源，基于OpenAPI规范自动生成文档，便于后端实现与客户端使用。
288 次收藏1亿+ 次下载
13 天前更新
neemuchaordic/swagger-ui
neemuchaordic
Swagger UI是一款用于可视化展示OpenAPI规范的API文档工具，支持多种版本规范，提供交互式接口测试功能，帮助开发者高效查看和使用API。
100万+ 次下载
8 年前更新
schickling/swagger-ui
schickling
该Docker镜像用于快速部署Swagger UI 2.2.10，支持通过环境变量注入API地址、API密钥及OAuth2配置，方便展示和测试API文档。
50 次收藏100万+ 次下载
7 年前更新
stempler/swagger-ui
stempler
支持JWT的Swagger UI镜像，基于schickling/swagger-ui改编，提供API文档可视化与交互功能，轻量级且支持API_URL和API_KEY注入。
50万+ 次下载
2 年前更新
mist/swagger-ui
mist
暂无描述
10万+ 次下载
8 年前更新
valdemaras/swagger-ui
valdemaras
Forked swagger-ui
10万+ 次下载
7 年前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"