因为某些原因,FastAPI使用的Swagger UI在中国大陆并不能很好地访问。为了能够更方便地使用这个库,我将其中的CSS和Js代码进行了本地化,使得在离线环境下也能够查看它。但是在在线环境,我还是更愿意将这个资源缓存到我的服务器上(因为可以走CDN)。于是便有了这篇文章,把我缓存下来的文件分享给大家,方便使用。
打开fastapi/openapi/docs.py
即可看到,FastAPI默认走的是Jsdelivr
,我们对它做一些改动:
swagger_js_url: Annotated[
str,
Doc(
"""
The URL to use to load the Swagger UI JavaScript.
It is normally set to a CDN URL.
"""
),
] = "https://www.yxqi.cn/wp-content/uploads/2024/12/swagger-ui-bundle.js",
swagger_css_url: Annotated[
str,
Doc(
"""
The URL to use to load the Swagger UI CSS.
It is normally set to a CDN URL.
"""
),
] = "https://www.yxqi.cn/wp-content/uploads/2024/12/swagger-ui.css",
这样就可以正常访问了。另外我也缓存了redoc的js代码,你也可以按需修改。
地址
swagger ui js:https://www.yxqi.cn/wp-content/uploads/2024/12/swagger-ui-bundle.js
swagger ui css:https://www.yxqi.cn/wp-content/uploads/2024/12/swagger-ui.css
redoc js:https://www.yxqi.cn/wp-content/uploads/2024/12/redoc.standalone.js
© 版权声明
除非另行声明,文章版权归作者所有,未经允许请勿转载。
THE END