温馨提示×

debian swagger在哪查看

小樊
56
2026-09-20 00:24:57
栏目: 智能运维

在 Debian 系统上,“Swagger 在哪查看”通常取决于你指的是哪种场景。下面分情况说明:


一、你是指「某个服务的 Swagger 文档」

如果是某个Web 服务 / API 项目使用了 Swagger(如 Spring Boot、FastAPI、Node.js 等):

常见访问地址

一般在服务启动后通过浏览器访问:

  • http://<服务器IP>:<端口>/swagger-ui.html(Spring Boot 常见)
  • http://<服务器IP>:<端口>/swagger-ui/
  • http://<服务器IP>:<端口>/docs(FastAPI 默认)
  • http://<服务器IP>:<端口>/api-docs

示例:

http://localhost:8080/swagger-ui.html

查看服务是否在运行

ss -lntp | grep <端口>
# 或
systemctl status <服务名>

二、你是指「Debian 上安装了 Swagger 工具」

1. Swagger CLI(swagger-codegen / swagger-cli)

查看是否安装:

which swagger
swagger --version

如果是 swagger-cli:

npx swagger-cli validate swagger.yaml

2. 本地查看 Swagger 文件

Swagger 文件一般是:

  • swagger.yaml
  • swagger.json

可用以下方式查看:

cat swagger.yaml

或浏览器打开:

xdg-open swagger.yaml

三、你是指「Swagger Editor(网页版)」

本地启动 Swagger Editor:

docker run -p 8080:8080 swaggerapi/swagger-editor

然后访问:

http://localhost:8080

四、在 Debian 服务器上“找不到 Swagger”的常见原因

  • 服务没启动
  • 防火墙 / 安全组未放行端口
  • Swagger 只在 localhost 监听
  • 生产环境被禁用(如 Spring Boot springdoc.swagger-ui.enabled=false)

如果你能补充:

  • 是 Java / Python / Node 项目?
  • Swagger 是 UI / JSON / YAML?
  • 服务是怎么部署的(Docker / systemd / 直接运行)?

我可以给你更精确的查看方式。

0 踩