畜牧部门数字档案馆系统从零搭建部署与落地实操全流程指南

一、前置环境准备

1.1 硬件配置要求

选用标准x86服务器即可，最低配置：4核vCPU、8G内存、1T SATA存储、10M以上公网带宽，可支撑100万份以内畜牧档案的存储与访问。

1.2 软件依赖安装

操作系统统一使用CentOS7.9，所有命令直接复制执行即可：

``` 先更新系统源 yum update -y yum install -y wget gcc make zlib-devel openssl-devel 安装Python3.8.10 wget https://www.python.org/ftp/python/3.8.10/Python-3.8.10.tgz tar zxvf Python-3.8.10.tgz && cd Python-3.8.10 ./configure --prefix=/usr/local/python3.8 --with-openssl make && make install ln -s /usr/local/python3.8/bin/python3 /usr/local/bin/python3 ln -s /usr/local/python3.8/bin/pip3 /usr/local/bin/pip3 安装MySQL8.0 rpm -ivh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm yum install -y mysql-community-server --nogpgcheck systemctl start mysqld && systemctl enable mysqld 获取初始密码 grep 'temporary password' /var/log/mysqld.log 登录后修改root密码，替换为你自己的密码 mysql -uroot -p ALTER USER 'root'@'localhost' IDENTIFIED BY 'Lsm@2024archive'; flush privileges; exit; 安装Nginx yum install -y nginx systemctl start nginx && systemctl enable nginx ```

二、系统部署实操

2.1 源码拉取与依赖安装

``` 拉取适配畜牧场景的开源档案系统源码 cd /opt git clone https://gitee.com/agri-open-source/livestock-archive-system.git cd livestock-archive-system 安装Python依赖包 pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple ```

2.2 数据库与配置文件初始化

先创建业务数据库，登录MySQL执行：

``` CREATE DATABASE livestock_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; exit; ```

修改配置文件`/opt/livestock-archive-system/conf/config.py`，直接复制以下内容替换，仅需修改标注的3处参数：

``` import os BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) 数据库配置，仅需修改PASSWORD为你设置的MySQL密码 DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'livestock_archive', 'USER': 'root', 'PASSWORD': 'Lsm@2024archive', 'HOST': '127.0.0.1', 'PORT': '3306', 'OPTIONS': {'charset': 'utf8mb4'} } } 文件存储配置 UPLOAD_FOLDER = '/data/livestock_archive/files' MAX_CONTENT_LENGTH = 100 1024 1024 ALLOWED_EXTENSIONS = {'pdf', 'doc', 'docx', 'xls', 'xlsx', 'jpg', 'png'} 安全配置，修改ALLOWED_HOSTS为你的服务器公网IP或域名，SECRET_KEY可执行openssl rand -hex 16生成替换 DEBUG = False SECRET_KEY = 'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6' ALLOWED_HOSTS = ['192.168.1.100'] ```

执行数据库表结构初始化与管理员创建：

``` 创建存储目录并授权 mkdir -p /data/livestock_archive/files chmod 755 /data/livestock_archive/files 初始化表结构 python3 manage.py makemigrations python3 manage.py migrate 创建超级管理员账号，按提示输入账号、邮箱、密码即可 python3 manage.py createsuperuser ```

2.3 服务配置与开机自启

新增systemd服务配置文件`/etc/systemd/system/archive.service`，复制以下内容：

``` [Unit] Description=Livestock Archive System After=network.target mysqld.service [Service] Type=simple User=root WorkingDirectory=/opt/livestock-archive-system ExecStart=/usr/local/bin/python3 manage.py runserver 127.0.0.1:8000 Restart=always RestartSec=10 [Install] WantedBy=multi-user.target ```

启动服务并配置Nginx反向代理：

``` 启动服务并设置开机自启 systemctl daemon-reload systemctl start archive && systemctl enable archive 新增Nginx配置文件/etc/nginx/conf.d/archive.conf，替换server_name为你的IP或域名 cat > /etc/nginx/conf.d/archive.conf << EOF server { listen 80; server_name 192.168.1.100; client_max_body_size 100M; location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host \$host; proxy_set_header X-Real-IP \$remote_addr; } location /static { alias /opt/livestock-archive-system/static; } location /media { alias /data/livestock_archive/files; } } EOF 验证配置并重启Nginx nginx -t systemctl restart nginx 开放防火墙端口 firewall-cmd --add-port=80/tcp --permanent firewall-cmd --reload ```

此时访问服务器公网IP即可进入系统，后台路径为`/admin`，用之前创建的超级管理员账号登录。

三、核心功能配置

3.1 档案分类配置

登录后台进入【档案分类管理】，按畜牧场景需求添加以下5类基础分类，必须标注存储期限：

• 畜禽种质资源档案：永久存储
• 养殖主体备案档案：30年存储
• 检疫检验合格档案：30年存储
• 疫病防控处置档案：20年存储
• 畜牧政策文件档案：10年存储

3.2 权限与模板配置

进入【角色管理】创建4类默认角色，分配对应权限：

• 系统管理员：所有权限
• 档案录入员：仅可上传、编辑待审核档案
• 档案审核员：可审核、归档、删除档案
• 普通查询员：仅可查询公开类档案

进入【导入模板管理】，下载官方适配的畜牧档案Excel模板，必填字段不可留空：养殖主体统一社会信用代码、畜禽种类、检疫证明编号、档案生成日期，导入失败可直接下载错误日志定位问题行。

四、数据迁移与常见问题排查

4.1 历史数据批量迁移

纸质档案扫描后统一命名为【分类编号_档案编号_生成日期.pdf】，全部上传到服务器`/data/history_files`目录，执行批量导入命令即可自动归档：

``` python3 manage.py batch_upload /data/history_files ```

4.2 常见问题排查

• 上传文件失败：先执行`chmod 755 /data/livestock_archive/files`授权，若仍失败检查配置文件中`MAX_CONTENT_LENGTH`是否小于文件大小
• 关键词检索无结果：执行`python3 manage.py build_fulltext_index`重建全文索引即可
• 服务启动失败：执行`journalctl -u archive`查看日志，通常为数据库密码配置错误或8000端口被占用，执行`netstat -tunlp | grep 8000`找到占用进程kill即可