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!

Metadata

Release files for fastapi-self-hosting-docs 0.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fastapi-self-hosting-docs 0.8.0
File Size Uploaded
fastapi_self_hosting_docs-0.8.0.tar.gz 1.1 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for fastapi-self-hosting-docs 0.8.0
File Interpreter ABI Platform
fastapi_self_hosting_docs-0.8.0-py3-none-any.whl Python 3 none any Details

Total release size: 1.8 MB

Release files / fastapi_self_hosting_docs-0.8.0.tar.gz

Download URL fastapi_self_hosting_docs-0.8.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
58950e8f7a267225242219831aa3148ff5874f669594638950428299dbc0a927
BLAKE2b-256 checksum
How to use checksums
e6f235aaae5c82495a2141367997cb487d93a95c7ee17a36cc1eca9215f25438
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.10

Release files / fastapi_self_hosting_docs-0.8.0-py3-none-any.whl

Download URL fastapi_self_hosting_docs-0.8.0-py3-none-any.whl
Size 747.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
eed54d9c11f4712dee6459559e677a74d1a8930a95414395a39f13b7b605fe0e
BLAKE2b-256 checksum
How to use checksums
63a281c683cb2ce9e7ffdfa05a25f8ffda95c50dc5e6cceaf93c8205b428b8c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.10

Release history Release notifications | RSS feed

This release

0.8.0 This release

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page