轻量级开源Teedy部署退役军人事务部门基础档案管理系统

本文针对区县级、街道级退役军人服务站/事务局的轻量级电子档案需求，用100%开源免费的Teedy系统搭建，支持OCR识别、权限分层、PDF批量上传，操作零编程基础，单服务器即可落地。

一、前置准备（5分钟）

准备1台云服务器/本地电脑（本地需先做内网穿透，推荐官方免费工具frp客户端https://github.com/fatedier/frp/releases，云服务器优先选阿里云2核4G 40G云盘起步，配置镜像为Ubuntu 22.04 LTS）。

1.1 基础软件安装

SSH连接云服务器后，依次执行以下命令：

• 更新系统包：sudo apt update && sudo apt upgrade -y
• 安装Docker和Docker Compose： 一键安装Docker curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun 启动Docker并设置开机自启 sudo systemctl start docker sudo systemctl enable docker 安装Docker Compose sudo apt install docker-compose-plugin -y

1.2 创建系统目录

执行以下命令创建数据存储、配置文件目录，避免容器重启数据丢失：

• mkdir -p /opt/teedy/data /opt/teedy/logs
• chmod -R 777 /opt/teedy（临时给全权限，生产环境可后续细化）

二、编写Docker Compose配置文件（10分钟）

用Nano编辑器创建配置文件：sudo nano /opt/teedy/docker-compose.yml，复制以下完整内容后按Ctrl+O保存，Enter确认文件名，Ctrl+X退出：

```yaml version: '3.8' services: teedy: image: sismics/docs:latest container_name: teedy_archive restart: always ports: - "8080:8080" 8080可换成80/443，生产环境需配置SSL environment: - DOCS_BASE_URL=http://你的服务器公网IP:8080 公网IP/域名替换，本地穿透填穿透后的地址 - DOCS_ADMIN_EMAIL=admin@tyjrsw.gov.cn 管理员账号 - DOCS_ADMIN_PASSWORD=12345678Aa! 生产环境必须修改，建议8位以上含大小写字母数字符号 - DOCS_DATA_DIR=/data - DOCS_LOG_DIR=/logs - DOCS_OCR_ENABLED=true 开启OCR识别 - DOCS_OCR_LANGS=chi_sim+eng 支持简体中文+英文识别 volumes: - /opt/teedy/data:/data - /opt/teedy/logs:/logs networks: - teedy_net networks: teedy_net: driver: bridge ```

三、启动系统并初始化（5分钟）

• 启动容器：cd /opt/teedy && sudo docker compose up -d
• 查看启动状态：sudo docker compose logs -f，看到“Starting server on port 8080”提示后按Ctrl+C退出日志
• 访问系统：浏览器输入配置文件中的DOCS_BASE_URL，进入登录页

四、系统核心配置（20分钟）

登录系统用配置文件中的管理员账号密码，按以下步骤配置核心功能：

4.1 权限分层配置（适合部门分级管理）

Teedy支持用户组、空间权限分离，可按“区局管理员→街道管理员→普通服务站用户”分层：

• 创建用户组：点击顶部「设置」→「用户组」→「添加用户组」，依次添加“区局档案组（管理员权限）”“街道档案组（编辑权限）”“服务站组（仅查看对应空间权限）”
• 创建用户：点击「设置」→「用户」→「添加用户」，输入姓名、邮箱（账号）、密码，勾选对应用户组
• 创建档案空间：点击顶部「文档」→「空间」→「添加空间」，空间名设为“XX区退役军人档案总库”，创建子空间如“XX街道1档案库”“XX街道2档案库”
• 绑定空间权限：进入子空间→点击右上角「设置」→「权限」→添加对应街道用户组，权限勾选「创建/编辑/删除文档」；服务站用户组只勾选「查看文档」

4.2 OCR识别功能验证

Teedy自带轻量级OCR引擎Tesseract，先测试识别效果：

• 点击顶部「文档」→「上传」，选择一张包含身份证号、姓名的退役证照片/PDF
• 上传后等待30秒-2分钟（取决于文件大小和服务器配置），点击文档进入详情页
• 查看右侧「标签」下方是否有自动提取的关键词，或点击「搜索」输入姓名测试是否能搜到

4.3 标签分类配置（方便检索）

提前设置符合退役军人事务的标签体系：

• 全局标签：点击顶部「设置」→「标签」→「添加全局标签」，依次添加“退役士兵”“转业干部”“军休干部”“带病回乡”“伤残军人”“优抚对象”
• 子标签：点击全局标签右侧的「添加子标签」，比如“退役士兵”下加“2020年入伍”“2022年退伍”“自谋职业”

五、批量上传退役档案（实操落地）

Teedy支持ZIP包批量上传，按以下步骤整理档案：

• 档案命名规范：统一格式为「退役证号_姓名_档案类型.pdf」，比如「123456789012345678_张三_退役登记表.pdf」
• 打包上传：同一街道的退役档案放入同一文件夹，压缩为ZIP包（不要嵌套多层文件夹），点击顶部「文档」→「上传」→选择对应街道子空间→上传ZIP包，系统会自动解压并识别内容
• 手动补全标签：上传后批量勾选文档，点击顶部「标签」→选择对应全局/子标签

六、安全加固（生产环境必做）

• 修改默认端口：编辑docker-compose.yml，将8080:8080改为其他端口比如9090:8080，然后执行sudo docker compose restart
• 配置SSL证书： 安装Certbot获取免费证书 sudo apt install certbot -y 申请证书（需域名解析到服务器IP） sudo certbot certonly --standalone -d yourdomain.com 编辑docker-compose.yml，添加443端口映射和证书挂载，替换为你的证书路径 ports: - "443:8443" environment: - DOCS_BASE_URL=https://yourdomain.com - DOCS_SSL=true - DOCS_SSL_CERT=/etc/letsencrypt/live/yourdomain.com/fullchain.pem - DOCS_SSL_KEY=/etc/letsencrypt/live/yourdomain.com/privkey.pem volumes: - /etc/letsencrypt:/etc/letsencrypt:ro
• 定期备份数据：编写备份脚本sudo nano /opt/teedy/backup.sh，内容如下： !/bin/bash DATE=$(date +%Y%m%d_%H%M%S) sudo tar -zcvf /opt/teedy/backup_$DATE.tar.gz /opt/teedy/data 删除7天前的备份 find /opt/teedy -name "backup_.tar.gz" -mtime +7 -delete 保存后执行sudo chmod +x /opt/teedy/backup.sh，添加定时任务sudo crontab -e，末尾加一行0 2 /opt/teedy/backup.sh（每天凌晨2点备份）

七、常见问题排查

• OCR识别失败：查看日志sudo docker compose logs -f teedy_archive，如提示“chi_sim.traineddata not found”，执行以下命令安装简体中文训练数据： sudo docker exec -it teedy_archive bash apt update && apt install tesseract-ocr-chi-sim -y exit sudo docker compose restart
• 容器无法启动：检查端口是否被占用，执行sudo lsof -i:8080，如被占用可修改docker-compose.yml端口或杀掉占用进程sudo kill -9 PID