schickling/swagger-ui
schickling
自动构建
该Docker镜像用于快速部署Swagger UI 2.2.10，支持通过环境变量注入API地址、API密钥及OAuth2配置，方便展示和测试API文档。
50 次收藏下载次数: 0状态：自动构建维护者：schickling仓库类型：镜像最近更新：8 年前
让 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镜像说明
镜像概述
这是一个轻量级的Swagger UI 2.2.10镜像（大小约45MB），支持通过环境变量灵活配置API端点、认证信息等参数，便于快速搭建可视化的API文档展示界面。
核心功能
- 支持通过
API_URL指定API的Swagger文档端点 - 可选注入
API_KEY作为默认访问密钥 - 支持OAuth2认证配置（客户端ID、密钥、 realm等）
- 可自定义运行端口和Swagger验证器地址
使用场景
- 开发团队快速展示内部API文档，供测试人员或前端开发者参考
- 对外提供公开API的文档界面，方便合作伙伴对接
- 本地调试API时，快速生成可视化交互界面
配置说明
环境变量列表
| 变量名 | 说明 | 可选性 |
|---|---|---|
API_URL | API的Swagger文档端点地址 | 必填 |
API_KEY | 默认API访问密钥 | 可选 |
PORT | 镜像运行端口 | 可选（默认80） |
VALIDATOR_URL | Swagger验证器地址 | 可选 |
OAUTH_CLIENT_ID | OAuth2客户端ID（留空则移除OAuth2配置） | 可选 |
OAUTH_CLIENT_SECRET | OAuth2客户端密钥 | 可选 |
OAUTH_REALM | OAuth2 realm | 可选 |
OAUTH_APP_NAME | OAuth2应用名称 | 可选 |
OAUTH_ADDITIONAL_PARAMS | OAuth2额外查询参数 | 可选 |
注意：上述变量不应使用**None**作为值。
部署示例
Docker Run命令
shdocker run -d -p 80:80 -e API_URL=http://localhost:4000/swagger docker.xuanyuan.run/schickling/swagger-ui
执行后，访问http://localhost即可查看API文档界面。
===FULL_DESC===
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 swagger-ui 镜像标签
docker pull docker.xuanyuan.run/schickling/swagger-ui:<标签>
DockerHub 原生拉取命令
docker pull schickling/swagger-ui:<标签>
更多 swagger-ui 镜像推荐
openeuler/swagger-ui
openeuler
官方Swagger UI Docker镜像，基于openEuler构建，由openEuler CloudNative SIG维护，用于从Swagger兼容的API动态生成美观的文档，支持多种架构且免费使用。
1.5千+ 次下载
18 天前更新
swaggerapi/swagger-ui
swaggerapi
用于托管Swagger UI的简单Docker容器，可可视化和交互API资源，基于OpenAPI规范自动生成文档，便于后端实现与客户端使用。
288 次收藏1亿+ 次下载
6 天前更新
neemuchaordic/swagger-ui
neemuchaordic
Swagger UI是一款用于可视化展示OpenAPI规范的API文档工具，支持多种版本规范，提供交互式接口测试功能，帮助开发者高效查看和使用API。
100万+ 次下载
8 年前更新
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访问体验非常流畅，大镜像也能快速完成下载。"