用免费开源档案整理数字化工具Teedy 快速搭建并落地简易管理系统

一、前期准备：硬件与系统环境

这套方案无需高性能服务器，普通家用电脑、老旧笔记本、树莓派4B及以上均可。

系统要求

• Windows 10/11 64位
• macOS 10.15及以上
• Ubuntu 20.04/22.04/24.04 LTS 64位
• Docker环境（推荐，跨平台最稳）

Docker安装（如果没有）

直接用官方一键脚本安装Docker：

```bash Linux/macOS终端直接执行 curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo usermod -aG docker $USER 非root用户需执行，重启终端生效 ```

Windows用户下载Docker Desktop安装包：https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe

二、Teedy 一键部署

采用Docker Compose部署，一步到位包含应用、数据库、文件存储。

创建部署目录与配置文件

• Windows：在D盘根目录新建文件夹`teedy`，进入后新建记事本，重命名为`docker-compose.yml`（注意后缀不是txt）
• Linux/macOS：终端执行`mkdir -p ~/teedy && cd ~/teedy`，然后新建配置文件

将以下完整配置复制到`docker-compose.yml`中，无需修改即可使用：

```yaml version: '3' services: teedy-db: image: postgres:15-alpine restart: always environment: POSTGRES_USER: teedy POSTGRES_PASSWORD: teedy123456 POSTGRES_DB: teedy volumes: - ./postgres-data:/var/lib/postgresql/data teedy-app: image: sismics/docs:latest restart: always ports: - "8080:8080" depends_on: - teedy-db environment: DOCS_BASE_URL: http://localhost:8080 后续局域网/公网访问需修改 DOCS_DATABASE_URL: postgresql://teedy:teedy123456@teedy-db:5432/teedy DOCS_STORAGE_DIR: /data volumes: - ./teedy-data:/data ```

启动服务

在部署目录下（Windows打开teedy文件夹，按住Shift右键选“在终端中打开”）执行：

```bash docker-compose up -d ```

首次启动需等待3-5分钟（取决于网络与硬件），可通过以下命令检查状态：

```bash docker-compose ps ```

当`teedy-app`和`teedy-db`状态均为`Up`时，部署完成。

三、系统初始化与基础配置

创建管理员账户

打开浏览器，输入`http://localhost:8080`，进入登录页。首次点击“注册”按钮，输入用户名（admin，建议保留）、邮箱（任意有效邮箱，找回密码用）、密码（8位以上含字母数字），点击提交即可自动成为唯一管理员。

修改默认管理员密码（重要！）

• 登录后点击右上角头像→账户设置
• 点击左侧密码，输入旧密码、新密码，提交

配置OCR文字识别（核心功能）

Teedy默认带基础OCR，但支持接入更强的Tesseract中文识别。

先停止当前服务：

```bash docker-compose down ```

修改`docker-compose.yml`中`teedy-app`的`image`为`sismics/docs:tesseract-latest`，保存后重新启动：

```bash docker-compose up -d ```

自定义系统参数

• 登录后点击右上角头像→管理
• 常规设置：修改系统名称、默认语言（选中文）、最大上传文件大小（根据需要调整，默认50MB）
• 安全设置：可关闭公开注册、开启登录验证码

四、零门槛档案整理实操流程

创建档案分类（目录树）

Teedy用“标签”替代传统文件夹，标签可嵌套，支持无限层级，更灵活。

• 登录后点击左侧标签→新建标签
• 输入一级标签名（如“2024年度合同”），点击提交
• 选中一级标签，点击新建子标签，输入二级标签名（如“销售合同”“采购合同”），重复操作直到层级完整

批量上传与自动归档

• 点击左侧上传→选择文件（支持PDF、JPG、PNG、DOCX、XLSX等主流格式，Ctrl+A可全选）
• 上传完成前，右侧标签栏提前选中对应分类标签；日期栏可自动识别文档创建日期，也可手动选择归档日期
• 点击上传并处理，系统自动完成OCR识别（约10秒/页）

快速搜索与定位（OCR识别生效后）

• 在顶部搜索框输入关键词（如合同编号、采购物品名称）
• 支持高级搜索：点击搜索框右侧放大镜图标，可按标签、日期、文件类型、作者组合筛选

权限分配（多人协作时）

• 管理员点击右上角头像→管理→用户→新建用户
• 输入新用户信息，设置角色（普通用户/审核员/管理员）
• 点击标签→选中对应标签→权限，添加新用户，勾选查看/编辑/删除权限

五、常见问题排查

无法访问localhost:8080

• 检查Docker是否正在运行（Windows打开Docker Desktop看右下角托盘图标）
• 检查端口8080是否被占用：Windows执行`netstat -ano | findstr :8080`，Linux/macOS执行`lsof -i :8080`，如被占用可修改`docker-compose.yml`中`ports`为`"9090:8080"`

OCR中文识别不准确

• 确认已切换到`sismics/docs:tesseract-latest`镜像
• 上传扫描件时分辨率不低于300DPI

数据备份（重要！）

直接复制部署目录下的`postgres-data`和`teedy-data`文件夹到U盘或云盘即可，恢复时粘贴回原目录，重新启动服务。