Skip to main content

FastAPI Self Hosting Docs

一个用于 FastAPI 应用程序的自托管文档解决方案,提供本地化的 Swagger UI 和 ReDoc 文档界面。

特性

  • 🚀 自托管文档: 所有文档资源都托管在应用程序内部,无需外部依赖
  • 📖 Swagger UI: 提供交互式的 API 文档界面
  • 📋 ReDoc: 提供美观的 API 文档展示
  • 🎨 自定义样式: 包含自定义的 favicon 和样式
  • 🔧 简单集成: 只需一行代码即可替换标准 FastAPI 应用

安装

pip install fastapi-self-hosting-docs

快速开始

基本用法

import uvicorn
from fastapi import FastAPI
import fastapi_self_hosting_docs

app = FastAPI(
    docs_url=None,
    redoc_url=None
)

fastapi_self_hosting_docs.mount(app)

# 启动应用
uvicorn.run(app)

Swagger UI

ReDoc

文档访问

启动应用后,可以通过以下地址访问文档:

  • Swagger UI: http://127.0.0.1:8000/docs
  • ReDoc: http://127.0.0.1:8000/redoc

与标准 FastAPI 的区别

特性 标准 FastAPI FastAPI Self Hosting Docs
文档资源 外部 CDN 本地托管
Swagger UI /docs /docs
ReDoc /redoc /redoc
依赖 无额外依赖 仅需 fastapi
自定义 favicon 不支持 支持

许可证

本项目采用 Apache 2.0 许可证。详情请参阅 LICENSE 文件。

贡献

欢迎提交 Issue 和 Pull Request!

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fastapi_self_hosting_docs-0.8.0.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fastapi_self_hosting_docs-0.8.0-py3-none-any.whl (747.3 kB view details)

Uploaded Python 3

File details

Details for the file fastapi_self_hosting_docs-0.8.0.tar.gz.

File metadata

File hashes

Hashes for fastapi_self_hosting_docs-0.8.0.tar.gz
Algorithm Hash digest
SHA256 58950e8f7a267225242219831aa3148ff5874f669594638950428299dbc0a927
MD5 d67b25dd3e6262cc8ffeb2b3821ed6d3
BLAKE2b-256 e6f235aaae5c82495a2141367997cb487d93a95c7ee17a36cc1eca9215f25438

See more details on using hashes here.

File details

Details for the file fastapi_self_hosting_docs-0.8.0-py3-none-any.whl.

File metadata

File hashes

Hashes for fastapi_self_hosting_docs-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 eed54d9c11f4712dee6459559e677a74d1a8930a95414395a39f13b7b605fe0e
MD5 fba47c3e4ffd799b12c0f5feb39e5a9e
BLAKE2b-256 63a281c683cb2ce9e7ffdfa05a25f8ffda95c50dc5e6cceaf93c8205b428b8c4

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.8.0 This release

2 files

0.7.0

2 files

0.6.0

2 files

0.5.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page