从零搭建可本地部署的免费动物园档案管理软件实操指南

一、准备工作

本次搭建使用开源免费系统改造，全流程零代码、零成本，支持Windows、Mac、Linux全平台，仅需10分钟即可完成部署。

1. 安装Docker环境

Docker可跳过复杂的环境配置，直接一键启动软件，直接访问以下地址下载对应系统安装包：

https://www.docker.com/products/docker-desktop/

安装注意事项：

• Windows用户安装时，必须勾选「Install required WSL 2 components」选项，不要使用Hyper-V模式，避免启动失败
• 安装完成后启动Docker，等待它完成初始化即可，不需要额外配置

二、一键启动动物园档案软件

1. 在本地磁盘新建文件夹，命名为zoo-archive

2. 在该文件夹内新建空白文本文件，将文件名修改为docker-compose.yml，必须把后缀.txt改为.yml，Windows系统默认隐藏后缀名，需要先在文件夹选项开启「显示文件扩展名」

3. 用记事本打开docker-compose.yml，将以下完整配置复制进去，可直接使用不需要修改：

``` version: "3.5" services: zoo-archive: image: ghcr.io/paperless-ngx/paperless-ngx:latest restart: always ports: - "8000:8000" environment: PAPERLESS_REDIS: redis://redis:6379 PAPERLESS_DBHOST: db PAPERLESS_SECRET_KEY: "zoo-archive-2024-unique-key" PAPERLESS_URL: "http://localhost:8000" volumes: - ./data:/usr/src/paperless/data - ./media:/usr/src/paperless/media - ./export:/usr/src/paperless/export - ./consume:/usr/src/paperless/consume depends_on: - db - redis db: image: docker.io/library/postgres:15 restart: always volumes: - ./postgres:/var/lib/postgresql/data environment: POSTGRES_DB: paperless POSTGRES_USER: paperless POSTGRES_PASSWORD: paperlesszoo2024 redis: image: docker.io/library/redis:7 restart: always volumes: - ./redis:/data ```

4. 打开命令提示符（Windows按Win+R输入cmd回车，Mac/Linux打开终端），进入zoo-archive文件夹，执行以下命令：

``` cd D:\zoo-archive docker-compose up -d ```

注：如果你的文件夹不在D盘，把路径改成你实际存放的位置即可。执行命令后Docker会自动下载所有依赖文件，根据网速不同需要3-8分钟。

5. 创建管理员账号，等待下载启动完成后，执行以下命令：

``` docker-compose exec zoo-archive createsuperuser ```

按照提示依次输入管理员用户名、邮箱（可填格式正确的任意邮箱，比如admin@zoo.com）、登录密码，输入完成后管理员账号就创建好了。

6. 验证启动：打开浏览器，输入地址 http://localhost:8000，如果能看到登录页面，说明部署成功，输入刚才创建的账号密码即可登录后台。

三、配置动物园专属档案字段

系统默认是通用文档管理，我们只需要添加动物园需要的专属字段即可，步骤如下：

1. 登录后台后，点击左侧菜单栏 设置 > 自定义字段
2. 点击右上角「添加字段」，按照下表依次创建所有需要的字段：

字段名称	字段类型	可选选项（仅选择框需要）
动物中文名称	单行文本	无
动物拉丁学名	单行文本	无
谱系编号	单行文本	无
展区编号	单行文本	无
保护等级	选择框	国家一级、国家二级、无危、近危、濒危、极危
出生日期	日期	无
入园日期	日期	无
健康状态	选择框	健康、观察、治疗、病逝

所有字段创建完成后，点击保存即可生效，之后录入档案就可以直接填写这些信息。

四、档案录入与日常使用

1. 单份档案录入

点击左侧菜单栏「添加文档」，上传对应动物的照片、体检报告、谱系证明等材料，然后在下方自定义字段区域填写对应信息，点击保存就完成一份动物档案的录入。

2. 批量导入存量档案

如果已经有整理好的存量档案，可批量导入：

• 将所有档案信息整理为Excel表格，第一行表头和你创建的字段名称完全一致，每行对应一只动物
• 把Excel表格和所有附件放入zoo-archive文件夹下的consume目录
• 系统会每10分钟自动扫描一次，自动匹配信息完成导入，不需要手动操作。

3. 常用功能说明

• 搜索查询：顶部搜索框支持按任意字段搜索，比如输入「国家一级 亚洲区」就能筛选出符合条件的所有动物档案，支持多条件组合搜索
• 权限管理：如果需要多个饲养员分别管理不同展区，可以进入设置 > 用户组创建不同账号，给每个账号分配对应展区的访问权限，数据隔离更安全
• 备份导出：定期进入文档 > 导出，可以批量导出所有档案信息和附件，保存到外接存储做备份，避免数据丢失
• 园内多设备访问：找到部署电脑的内网IP（比如192.168.1.123），园内手机、平板直接访问http://192.168.1.123:8000就能使用，不需要额外部署。

整个软件完全本地部署，数据存在自己的设备里，不需要依赖外网，功能可根据需求新增自定义字段，满足不同动物园的档案管理需求。