OpenSource-Hub
D

docat

898 stars·开发工具·已提供 SHA-256 校验码,下载后可自行核对文件完整性

一个简单、支持多版本的文档托管工具,让你像管理代码一样管理文档版本。

智能下载

前往项目主页

该项目暂未提供安装包,请直接访问源代码仓库

一键 Docker 部署,轻松托管多版本文档。

核心功能

  • 支持多个项目及每个项目的多个版本
  • 通过 Docker 一键部署,两分钟即可上线
  • 提供 CLI 客户端 docatl,一键上传文档
  • 支持项目认领和令牌认证,保证上传安全
  • 支持自定义页面页眉页脚,适配品牌风格

避坑指南

  • 默认不开启身份认证,任何知道服务地址的人都可以上传文档。若要在公网部署,务必配置 Nginx 的 HTTP Basic Auth(详见 README)。另外,DOCAT 只负责托管文档,并不提供文档编写功能,你需要先用 mkdocs 等工具生成静态文件。

适用场景

  • 为软件的不同版本(如 v1.0、v2.0)分别托管对应的用户手册
  • 企业内部团队使用,无需依赖第三方文档托管平台
  • 开源项目展示文档,同时保留旧版本文档供用户查阅

详细介绍

DOCAT 是一款轻量级、自托管的文档托管服务器,专为需要维护多个文档版本的项目或团队设计。它无缝兼容 mkdocs、Sphinx、mdBook 等静态站点生成器。只需一条 Docker 命令,即可获得一个功能完善的文档托管平台。支持通过令牌认领项目、提供 CLI 工具(docatl)轻松上传文档,并允许通过配置文件自定义页眉页脚。与 Read the Docs 等托管服务不同,DOCAT 让您完全掌控数据,非常适合内部企业文档或对隐私有严格要求的项目。

常见问题与排障 (1)

故障排除
docat是否支持上传.tar或.tar.gz文件而不是.zip文件?

不,docat只接受.zip文件上传。如果您的构建环境缺少zip命令,请使用docatl CLI工具(来自docat项目)将文档打包成zip。docatl可以作为二进制文件添加到您的容器中。请参阅 https://github.com/docat-org/docatl。

来源 Issue #916

标签

documentationhostingversioningdockermkdocssphinx

快速上手

1

下载安装包

点击上方按钮下载对应系统的安装包

2

安装软件

双击下载的安装程序,按提示完成安装

3

步骤1:在本地创建持久化目录(如 mkdir -p docat-run/doc)

4

步骤2:运行 Docker 命令启动容器(端口8000,挂载目录)

5

步骤3:打开浏览器访问 http://localhost:8000,即可看到默认界面

安装指引
  1. 步骤1:在本地创建持久化目录(如 mkdir -p docat-run/doc)
  2. 步骤2:运行 Docker 命令启动容器(端口8000,挂载目录)
  3. 步骤3:打开浏览器访问 http://localhost:8000,即可看到默认界面
文件完整性

暂未获取到校验码

该项目暂未在 GitHub Release 页面提供 SHA-256 校验码

SHA256 校验码

暂无校验码

建议从 GitHub Releases 页面直接下载,并自行核对文件完整性

本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。

运维指引

卸载说明

停止并删除 Docker 容器:docker stop docat && docker rm docat;然后删除本地持久化数据目录(默认为 docat-run/)即可完全卸载。

无额外依赖

下载后即可直接使用,无需安装其他运行环境

项目信息
开源协议MIT
最后更新2026-06-27 13:40:07
GitHub 仓库官方网站

遇到问题?查看下方 FAQ

1 FAQ

相似推荐