一、docat介绍

• docat简介

docat是一个简单开源的自托管文档管理系统，它旨在帮助团队和组织更好地管理和共享文档。

二、本地环境介绍

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为centos7.6。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.需要提前在服务器上配置好Docker环境，确保Docker环境正常；
3.在Docker环境下部署docat文档管理系统。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

[root@jeven ~]# systemctl status docker
● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
   Active: active (running) since Fri 2023-12-08 19:10:36 CST; 2 days ago
     Docs: https://docs.docker.com
 Main PID: 11729 (dockerd)
    Tasks: 38
   Memory: 1.3G
   CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本，当前使用版本为20.10.17。

[root@jeven ~]# docker -v
Docker version 20.10.17, build 100c701

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

[root@jeven ~]# docker compose version
Docker Compose version v2.6.0

四、下载docat镜像

从谷歌镜像仓库拉取docat镜像，版本为latest版本，如果下载过慢，可以配置国内云厂商的镜像加速，或者使用第三方的容器镜像加速服务。

[root@jeven ~]# docker pull   ghcr.io/docat-org/docat
Using default tag: latest
latest: Pulling from docat-org/docat
a378f10b3218: Already exists
c11bdfacfd25: Pull complete
64fc9a66a5d8: Pull complete
5146634606ba: Pull complete
479ce1f6823a: Pull complete
bf870de2c3ef: Pull complete
ea2d8a284c4a: Pull complete
4f4fb700ef54: Pull complete
aa6dcd230ba7: Pull complete
c74a0bc6e22f: Pull complete
0b0e8e29ac38: Pull complete
909d5fd77059: Pull complete
Digest: sha256:934b7c1cbb4faba59d6afeb629309b337f0b5f81165b97471b38bc12a8933ce5
Status: Downloaded newer image for ghcr.io/docat-org/docat:latest
ghcr.io/docat-org/docat:latest

五、部署docat文档管理系统

5.1 使用docker-cli创建docat容器

使用docker-cli快速部署docat容器

docker run -d \
  --name docat \
  --restart always \
  -v  /data/docat/data:/var/docat/ \
  -p  8200:80 \
  ghcr.io/docat-org/docat

5.2 创建目录

创建主机挂载目录

mkdir -p /data/docat/data && cd /data/docat/

设置目录权限

 chmod -R 777  /data/docat/

5.3 使用docker compose创建docat容器

使用docker compose部署docat容器

version: '3.8'

services:
  docat:
    image: ghcr.io/docat-org/docat
    container_name: docat
    restart: always
    volumes:
      - /data/docat/data:/var/docat/
    ports:
      - "8200:80"

• 使用docker-compose.yaml文件创建docat容器

[root@jeven docat]# docker compose up -d
[+] Running 2/2
 ⠿ Network docat_default  Created                                                                                       0.0s
 ⠿ Container docat        Started                                                                                       1.0s

5.4 检查docat容器状态

检查docat容器状态，确保容器正常启动。

[root@jeven docat]# docker compose ps
NAME                COMMAND                  SERVICE             STATUS              PORTS
docat               "/usr/bin/dumb-init …"   docat               running             0.0.0.0:8200->80/tcp, :::8200->80/tcp

5.3 检查docat容器日志

检查docat容器运行日志，确保docat服务正常运行。

[root@jeven docat]# docker compose logs
docat  | INFO:     Started server process [11]
docat  | INFO:     Waiting for application startup.
docat  | INFO:     Application startup complete.
docat  | INFO:     Uvicorn running on http://0.0.0.0:5000 (Press CTRL+C to quit)

六、访问docat服务

6.1 访问docat首页

访问地址：http://192.168.3.166:8200/，将IP更换为自己服务器的IP地址。如果无法访问，注意防火墙和安全组设置问题，如果是使用云厂商服务器，需要放行安全组的服务端口。

6.2 上传文档

在docat首页中，在右下角位置点击上传文档的图标。

填写项目名称，文档的版本，将文档压缩包进行上传后，在点击“update”进行更新。

6.3 查看文档

这个项目部署完成后，发现点击文档名称，自动跳转的链接错误，需要手动修改下链接才能打开文档。

将链接后面部分改为版本加文档名的形式，例如这里错误跳转的是http://192.168.3.166:8200/#/mydoc/latest，修改为http://192.168.3.166:8200/#/mydoc/v1.0.0/cloud.pdf

七、总结

1.这个项目适合初学者练习，但不建议在生产或个人环境中部署。
2.项目的部署过程简单且轻量，版本管理也很好。
3.项目的文档链接跳转存在问题，需要手动修改链接，不太方便。
4.在网上找到该项目的部署资料比较困难，按照项目文档使用docker方式部署时遇到了上述问题，希望未来版本开发者能够改进和升级。