手把手零门槛部署轻量开源文书档案系统历史版Teedy

1. 前置准备清单

确保你的环境满足以下条件，避免后续部署卡壳：

• 1台至少2核4G内存、10G以上可用磁盘的云服务器/本地虚拟机
• 服务器已安装Docker和Docker Compose（两者缺一不可）
• 服务器防火墙已开放8080端口（Teedy默认访问端口）

1.1 快速安装Docker

如果是Ubuntu/Debian系统，执行以下命令一键安装：

```bash curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo systemctl start docker sudo systemctl enable docker ```

如果是CentOS/RHEL系统，执行：

```bash curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo systemctl start docker sudo systemctl enable docker ```

1.2 快速安装Docker Compose

执行以下命令安装最新稳定版Docker Compose（2.29.2，截至202X年8月）：

```bash sudo curl -L "https://github.com/docker/compose/releases/download/v2.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose ```

验证安装是否成功：

```bash docker --version docker-compose --version ```

2. 下载并配置Teedy历史版

这里选择Teedy 1.9.12（最后一个支持独立历史文件存储的稳定历史版），完全适配当前Docker生态。

2.1 创建部署目录

在服务器/home目录下创建专用目录，避免文件混乱：

```bash cd /home sudo mkdir -p teedy-history cd teedy-history ```

2.2 编写完整docker-compose.yml配置

使用vi或nano编辑器创建配置文件，这里推荐nano，保存退出更简单：

```bash sudo nano docker-compose.yml ```

将以下完整内容复制粘贴进去（不需要修改任何参数即可直接使用）：

```yaml version: '3.8' services: teedy: image: sismics/docs:1.9.12 container_name: teedy-history restart: always ports: - "8080:8080" environment: - DOCS_BASE_URL=http://你的服务器公网IP:8080 换成实际IP，比如http://123.45.67.89:8080 - DOCS_DATABASE_DRIVER=org.h2.Driver - DOCS_DATABASE_URL=jdbc:h2:file:/data/docs/db;MODE=MYSQL - DOCS_DATABASE_USERNAME=sa - DOCS_DATABASE_PASSWORD= - DOCS_STORAGE_PATH=/data/docs/files - DOCS_HISTORY_PATH=/data/docs/history 开启独立历史文件存储 - DOCS_MAX_FILE_SIZE=52428800 单个文件最大50MB，单位字节，可按需修改 volumes: - ./data:/data/docs healthcheck: test: ["CMD", "curl", "-f", "http://localhost:8080/api/system/ping"] interval: 30s timeout: 10s retries: 3 ```

粘贴后，按Ctrl+O保存，按Enter确认文件名，再按Ctrl+X退出。

2.3 特别注意！修改BASE_URL

如果忘记修改配置文件中的DOCS_BASE_URL，登录后上传文件、预览等功能会报错。请务必将其替换为你服务器的实际公网IP或已绑定的域名（如果用域名请确保80/443端口已配置好）。

3. 启动Teedy历史版

执行以下命令启动服务：

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

等待1-2分钟，服务初始化完成后，可以查看日志确认运行状态：

```bash sudo docker-compose logs -f teedy ```

当日志出现Started DocsApplication字样时，说明启动成功，按Ctrl+C退出日志查看。

4. 初始化Teedy并开启历史版本功能

4.1 访问并注册管理员账户

在浏览器中输入：http://你的服务器公网IP:8080，进入Teedy登录/注册页面。

点击Sign up，填写以下信息（所有字段必填）：

• Username：自定义管理员用户名（比如admin）
• Password：设置强密码（至少8位，包含字母和数字）
• Confirm Password：再次输入密码
• Email：填写你的邮箱（用于找回密码，可选但建议填）

填写完成后点击Sign up，系统会自动登录并跳转到主页。

4.2 全局开启历史版本自动记录

这是使用历史版的核心操作：

1. 点击页面右上角的齿轮图标（设置）
2. 在左侧菜单中选择General（通用设置）
3. 找到File History（文件历史）板块
4. 勾选Enable automatic versioning（启用自动版本控制）
5. （可选）设置Number of versions to keep（保留的版本数量），默认是-1（无限保留），可根据磁盘空间调整
6. 点击页面底部的Save按钮保存设置

5. 日常核心功能实操（含历史版专属）

5.1 上传并预览文书档案

1. 点击页面顶部的Upload按钮
2. 选择要上传的PDF、Word、Excel、图片等文件（支持批量上传）
3. （可选）添加Tags（标签）和Notes（备注），方便后续检索
4. 点击Upload确认上传，上传完成后会自动跳转到文件列表
5. 点击任意文件的文件名，可直接在线预览PDF、图片等格式

5.2 历史版专属：查看、下载、恢复历史版本

1. 找到之前上传的文件，点击文件名进入详情页
2. 在详情页右侧找到Versions（版本）板块
3. 每个版本会显示：版本号、修改时间、修改人、修改说明（如果是手动更新可添加）
4. 点击任意版本的Download（下载）按钮，可直接下载该版本的原始文件
5. 点击任意版本的Restore（恢复）按钮，系统会自动将该版本设为当前最新版本，并生成新的版本记录

5.3 权限管理（可选但实用）

Teedy支持多用户和权限隔离：

1. 点击右上角齿轮图标，选择左侧菜单的Users（用户）
2. 点击Add User（添加用户），填写新用户信息
3. 点击左侧菜单的Groups（用户组），创建“财务组”“行政组”等专用组
4. 将新用户添加到对应的组
5. 在文件或文件夹详情页右侧的Permissions（权限）板块，设置组或单个用户的Read（读）、Write（写）、Delete（删除）权限

6. 数据备份与恢复（必做）

6.1 数据备份

Teedy的所有数据（包括数据库、文件、历史版本）都存储在/home/teedy-history/data目录下，执行以下命令一键打包备份：

```bash cd /home/teedy-history sudo tar -czvf teedy-backup-$(date +%Y%m%d).tar.gz data ```

建议每周备份一次，并将备份文件下载到本地或其他云存储。

6.2 数据恢复

1. 先停止Teedy服务：sudo docker-compose down
2. 删除旧的data目录（确保已备份）：sudo rm -rf data
3. 解压备份文件：sudo tar -xzvf teedy-backup-202X0X0X.tar.gz（替换成实际备份文件名）
4. 重新启动服务：sudo docker-compose up -d