debian swagger如何权限控制

在 Debian 上部署的 Swagger（如 Swagger UI / Swagger Editor / Springdoc-openapi 等） 做权限控制，常见做法分 运行时访问控制 和 代码层控制 两类。下面按使用场景说明。

一、最常用：在 Web 层做访问控制（推荐）

1️⃣ Nginx 反向代理 + 基础认证（最简单）

如果 Swagger 通过 Nginx 暴露：

sudo apt install nginx apache2-utils

生成密码：

htpasswd -c /etc/nginx/swagger.htpasswd admin

Nginx 配置：

location /swagger-ui/ {
    auth_basic "Swagger Restricted";
    auth_basic_user_file /etc/nginx/swagger.htpasswd;
    proxy_pass http://127.0.0.1:8080;
}

✅ 优点：不改动代码
❌ 缺点：只有账号密码，无细粒度权限

2️⃣ Nginx + IP 白名单（内网使用）

location /swagger-ui/ {
    allow 192.168.1.0/24;
    deny all;
}

二、Spring Boot + Swagger / Springdoc

1️⃣ 生产环境直接禁用 Swagger

spring:
  profiles:
    active: prod

@Profile("!prod")
@Configuration
public class SwaggerConfig {}

2️⃣ Spring Security 控制 Swagger 路径

@Override
protected void configure(HttpSecurity http) throws Exception {
    http
      .authorizeRequests()
      .antMatchers("/swagger-ui/**", "/v3/api-docs/**")
      .hasRole("ADMIN")
      .anyRequest().authenticated();
}

3️⃣ 仅登录用户可访问

.antMatchers("/swagger-ui.html").authenticated()

三、Swagger 文档级权限（接口级）

Springdoc + @SecurityRequirement

@Operation(security = @SecurityRequirement(name = "bearerAuth"))
@GetMapping("/admin")
public String admin() {
    return "admin";
}

四、Swagger Editor / Swagger UI 单独部署

Docker + 密码

docker run -e SWAGGER_JSON=/foo/api.yaml \
  -p 8080:8080 swaggerapi/swagger-ui

配合 Nginx 做认证即可。

五、推荐组合方案 ✅

如果你能告诉我：

• 用的是 Swagger UI / Springdoc / Swagger Editor
• 是否 Spring Boot
• 是否 Docker / Nginx

我可以给你一份可直接用的配置。