从零用开源Teedy搭建轻量可落地物流企业专属档案管理实操指南

一、前置准备清单（卡壳必看）

本次使用的是轻量级开源Teedy（原Sismics Docs），无需复杂服务器，家用/办公电脑都能快速运行，先确认你满足以下条件：

• 操作系统：Windows 10/11、macOS 10.15+、主流Linux（Ubuntu/CentOS Stream推荐）
• 基础工具：任意浏览器（Chrome/Edge最佳）、终端（Windows用PowerShell/CMD，macOS/Linux用自带Terminal）
• 硬件配置：4GB以上内存、20GB以上剩余磁盘空间（存放扫描/上传的物流档案）

二、快速安装Teedy服务端

为简化流程，本次用官方Docker镜像安装，一键部署所有依赖（Java、数据库、存储）。如果没有Docker，请先按以下路径快速装：

2.1 前置Docker安装

• Windows/macOS：直接访问Docker Desktop官网下载安装包 https://www.docker.com/get-started/，下载对应版本双击安装，重启后打开Docker Desktop确认右下角小图标变绿
• Ubuntu 22.04+：打开终端执行以下完整命令 ```bash sudo apt update sudo apt install -y ca-certificates curl gnupg lsb-release sudo mkdir -m 0755 -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin sudo usermod -aG docker $USER ``` 执行后完全重启终端再验证Docker状态

2.2 一键启动Teedy

在桌面新建纯文本文件，重命名为docker-compose.yml，粘贴以下完整配置（无需修改任何参数，若需修改端口请替换8080为其他未占用端口，如8888）：

```yaml version: '3.8' services: teedy: image: sismics/docs:latest container_name: teedy_logistics ports: - "8080:8080" volumes: - teedy_data:/data environment: - DOCS_BASE_URL=http://localhost:8080 restart: unless-stopped volumes: teedy_data: ```

打开终端，进入docker-compose.yml所在文件夹（Windows/macOS可右键文件夹选“在终端打开”），执行以下命令：

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

等待1-2分钟，看到终端输出“teedy_logistics started”或Docker Desktop中teedy_logistics容器状态为“Running”，即启动成功。

三、初始化并配置物流专属档案系统

3.1 首次登录与基础设置

1. 打开Chrome/Edge浏览器，访问http://localhost:8080（如果是局域网内其他设备访问，需替换localhost为服务器电脑的局域网IP，查看IP方法：Windows用ipconfig、macOS/Linux用ifconfig/ip addr找“inet”开头的地址）
2. 首次进入会弹出“Welcome”界面，点击“Sign up”注册管理员账号，用户名建议设为logistics_admin，密码至少8位
3. 登录后进入管理后台，点击左侧菜单栏“Settings”→“General”，修改应用名称为“XX物流档案管理系统”，点击“Save”保存

3.2 配置物流专属标签体系（核心区分）

Teedy通过标签+元数据管理档案，先搭建物流常用的标签层级：

1. 点击左侧菜单栏“Tags”→“New tag”
2. 按以下层级依次新建标签（注意勾选“Parent tag”设置父标签）：
   • 一级标签：运输档案（Parent tag留空）
     • 二级标签：陆运、海运、空运、铁运
   • 一级标签：仓储档案
     • 二级标签：入库单、出库单、盘点表、库存台账
   • 一级标签：客户档案
     • 二级标签：月结客户、散单客户
   • 一级标签：车辆档案
     • 二级标签：自有车辆、挂靠车辆

3.3 配置物流专属元数据（精准检索）

元数据可以帮你直接按“单号、日期、发货人”等字段检索，点击左侧菜单栏“Custom fields”→“New custom field”，依次新建：

• 字段名：物流单号，类型：Text，必填：勾选，对所有文档启用：勾选，保存
• 字段名：业务日期，类型：Date，必填：勾选，对所有文档启用：勾选，保存
• 字段名：发货人，类型：Text，对所有文档启用：勾选，保存
• 字段名：收货人，类型：Text，对所有文档启用：勾选，保存
• 字段名：承运车辆，类型：Text，仅对“运输档案”及其子标签启用：勾选运输档案，保存
• 字段名：仓库名称，类型：Text，仅对“仓储档案”及其子标签启用：勾选仓储档案，保存

四、日常档案管理操作（零门槛上手）

4.1 快速上传物流档案

1. 点击左侧菜单栏“Documents”→“Upload”，或直接拖拽扫描件/电子档（支持PDF、JPG、PNG、DOCX等格式）到页面中心
2. 上传完成后，右侧会弹出“Edit document”面板：
   1. 填写必填的物流单号、业务日期，其他元数据按需填写
   2. 在“Tags”下拉框中选择对应标签（可多选，比如一份陆运入库单同时选“运输档案→陆运”、“仓储档案→入库单”）
   3. 若上传的是扫描件，Teedy会自动识别文字并生成全文检索（无需额外操作）
3. 点击“Save”完成上传

4.2 精准检索物流档案

点击左侧菜单栏“Documents”，页面上方有搜索栏和筛选栏：

• 全文搜索：直接在搜索栏输入物流单号、发货人、收货人、全文内容中的任意关键词，Teedy会自动匹配
• 标签筛选：点击搜索栏下方的“Tags”，选择对应标签（可多选）
• 元数据筛选：点击“Advanced search”，选择自定义字段并设置筛选条件（比如业务日期在2024-01-01到2024-06-30之间、物流单号包含“WL2024”）
• 筛选结果可按“业务日期”“上传时间”“文档名称”排序

4.3 权限设置（保护客户/公司隐私）

1. 点击左侧菜单栏“Users”→“New user”，填写新员工的用户名、密码、邮箱（可选）
2. 为新员工分配角色：
   • User：只能查看/下载自己上传的文档
   • Editor：可以查看/下载/编辑/删除所有文档，不能管理用户/标签/元数据
   • Manager：可以管理标签/元数据，不能管理用户/系统设置
3. 点击“Save”完成权限分配

五、数据备份与恢复（防止丢失）

5.1 自动备份

Teedy默认不会自动备份，需要手动设置：

1. 打开终端，进入docker-compose.yml所在文件夹
2. 执行以下命令备份数据到当前文件夹的teedy_backup.tar.gz： ```bash docker run --rm --volumes-from teedy_logistics -v $(pwd):/backup alpine tar czvf /backup/teedy_backup_$(date +%Y%m%d_%H%M%S).tar.gz /data ```
3. Windows可通过任务计划程序、macOS/Linux可通过crontab设置每天凌晨1点自动执行备份命令

5.2 数据恢复

如果需要恢复数据，先停止并删除teedy_logistics容器： ```bash docker compose down docker volume rm teedy_data ``` 然后创建新的teedy_data卷，解压备份文件： ```bash docker volume create teedy_data docker run --rm -v teedy_data:/data -v $(pwd):/backup alpine tar xzvf /backup/你的备份文件名.tar.gz -C / ``` 最后重新启动Teedy： ```bash docker compose up -d ```