档案数字化网络系统从零部署实操指南 全流程可直接落地复用

一、前置准备

1.1 硬件配置选型

根据使用规模选择对应配置，避免资源浪费或性能不足：

• 100人以内使用、档案存量≤10万份：2核4G云服务器，5M带宽，系统盘40G，数据盘100G
• 100-500人使用、档案存量10-50万份：4核8G云服务器，10M带宽，系统盘40G，数据盘300G
• 500人以上使用、档案存量≥50万份：8核16G云服务器，20M以上带宽，数据盘按每10万份档案加50G扩容

1.2 基础软件依赖

所有软件均使用固定版本，避免兼容性问题：CentOS7.9操作系统、Python3.8.10、MySQL8.0、Nginx1.20、Redis6.2

二、系统部署实操步骤

2.1 基础环境安装配置

首先执行以下命令关闭防火墙和SELinux，避免端口访问拦截：

``` systemctl stop firewalld systemctl disable firewalld setenforce 0 sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config ```

安装Python3.8.10，执行以下命令：

``` yum install -y wget gcc make zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel gdbm-devel db4-devel libpcap-devel xz-devel libffi-devel 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 --enable-shared make && make install ln -s /usr/local/python3.8/bin/python3 /usr/bin/python3 ln -s /usr/local/python3.8/bin/pip3 /usr/bin/pip3 echo "/usr/local/python3.8/lib" >> /etc/ld.so.conf ldconfig ```

安装MySQL8.0并初始化数据库：

``` rpm -ivh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm yum install -y mysql-community-server systemctl start mysqld systemctl enable mysqld 获取初始密码 grep 'temporary password' /var/log/mysqld.log 登录MySQL（替换为获取到的初始密码） mysql -uroot -p'初始密码' 执行以下SQL语句创建数据库和授权用户（替换为自定义密码） ALTER USER 'root'@'localhost' IDENTIFIED BY '自定义Root密码'; CREATE DATABASE archive_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'archive_user'@'127.0.0.1' IDENTIFIED BY '自定义业务库密码'; GRANT ALL ON archive_system. TO 'archive_user'@'127.0.0.1'; FLUSH PRIVILEGES; exit; ```

安装Redis和Nginx：

``` yum install -y redis nginx systemctl start redis nginx systemctl enable redis nginx ```

2.2 系统源码部署

拉取开源稳定版源码并安装依赖：

``` git clone https://gitee.com/opensource_archive/archive-digital-system.git /opt/archive_system cd /opt/archive_system pip3 install -r requirements.txt ```

修改配置文件/opt/archive_system/archive_system/settings.py，替换为以下内容（对应修改数据库密码部分）：

``` import os BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) SECRET_KEY = 'django-insecure-=t!s1u90%&8z3@9%xq5z3@9%xq5z3@9%xq5z3' DEBUG = False ALLOWED_HOSTS = [''] INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'rest_framework', 'archive', ] DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'archive_system', 'USER': 'archive_user', 'PASSWORD': '你设置的业务库密码', 'HOST': '127.0.0.1', 'PORT': '3306', } } CACHES = { 'default': { 'BACKEND': 'django_redis.cache.RedisCache', 'LOCATION': 'redis://127.0.0.1:6379/0', 'OPTIONS': { 'CLIENT_CLASS': 'django_redis.client.DefaultClient', } } } CACHE_TTL = 3600 MEDIA_ROOT = '/data/archive_files' MEDIA_URL = '/media/' STATIC_ROOT = os.path.join(BASE_DIR, 'static') ```

创建档案存储目录并授权：

``` mkdir -p /data/archive_files chmod 755 /data/archive_files ```

执行数据库迁移和创建超级管理员账号：

``` python3 manage.py makemigrations python3 manage.py migrate 按提示输入管理员账号、邮箱、密码 python3 manage.py createsuperuser ```

配置系统服务开机自启，新建/etc/systemd/system/archive.service文件，内容如下：

``` [Unit] Description=Archive Digital System After=network.target mysql.service redis.service [Service] Type=simple User=root WorkingDirectory=/opt/archive_system ExecStart=/usr/bin/python3 manage.py runserver 0.0.0.0:8000 Restart=always RestartSec=5 [Install] WantedBy=multi-user.target ```

启动服务：

``` systemctl daemon-reload systemctl start archive systemctl enable archive ```

2.3 Nginx反向代理配置

新建/etc/nginx/conf.d/archive.conf文件，内容如下（替换为你的服务器IP或域名）：

``` server { listen 80; server_name 你的服务器IP或域名; client_max_body_size 100M; location / { root /opt/archive_system/dist; index index.html index.htm; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8000/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location /media/ { root /data/archive_files; rewrite ^/media/(.)$ /$1 break; } } ```

验证配置并重启Nginx：

``` nginx -t systemctl restart nginx ```

三、功能验证&批量档案录入实操

3.1 系统登录验证

在浏览器输入服务器IP或域名，使用之前创建的超级管理员账号登录，确认页面正常加载无报错。

3.2 批量档案数字化录入

• 第一步：进入【档案管理】-【批量导入】页面，下载标准Excel模板，按模板要求填写档案编号、题名、归档单位、保管期限、密级等字段
• 第二步：准备档案扫描件，要求分辨率≥300DPI，格式为PDF/JPG/PNG，单文件大小≤50M，扫描件命名为对应档案的编号
• 第三步：上传填写完成的Excel模板，再批量上传所有扫描件，系统自动关联条目和扫描件并入库，导入完成后可在【档案查询】页面验证录入结果

3.3 权限配置

进入【系统设置】-【用户管理】页面，按岗位分配权限：档案录入员仅分配录入权限，档案管理员分配查询、借阅审批权限，普通用户仅分配本人权限范围内的查询权限，避免越权操作。

四、常见问题排查

• 上传扫描件失败：首先检查/data/archive_files目录权限是否为755，其次确认Nginx配置中已添加client_max_body_size 100M配置，最后检查扫描件大小是否超过50M
• 访问报错502：执行systemctl status archive查看服务状态，如停止执行systemctl start archive启动，同时检查MySQL、Redis服务是否正常运行
• 查询速度慢：执行redis-cli ping返回PONG则Redis正常，确认settings.py中已配置CACHE_TTL = 3600开启查询缓存，存量超过50万份可给档案编号、题名字段添加数据库索引