中小企业智能档案库房从零搭建：部署调试全流程实操落地指南

前期物料与工具准备

必备硬件清单（1000㎡以内中小型库房适用）

• UHF超高频RFID阅读器1台（识别距离0-5米），选USB接口免驱款即可
• 超薄不干胶RFID档案标签，按实际档案盒数量准备
• RS485接口温湿度传感器，每500㎡布设1台
• TCP/IP联网款ID/IC门禁控制器1台
• 4核8G内存工业电脑/普通服务器1台，预留100G以上空闲存储空间

以上均为通用标准化硬件，按参数采购即可，无需定制开发。

软件源码获取

直接执行以下命令拉取开源开箱即用的系统源码，不需要从零开发：

``` git clone https://github.com/yanxuanorg/open-archive-system.git cd open-archive-system ```

未安装git的用户可直接下载压缩包：https://github.com/yanxuanorg/open-archive-system/archive/refs/heads/main.zip

系统环境部署步骤

本次采用Python+SQLite轻量架构，不需要安装复杂的数据库服务，零门槛即可部署。服务器操作系统推荐使用Ubuntu 22.04 LTS，执行以下命令一键安装所有依赖：

``` sudo apt update && sudo apt install python3 python3-pip git -y pip3 install -r requirements.txt ```

依赖列表已经预配置在源码中，上述命令会自动完成安装，不需要手动添加包。接下来修改核心配置，打开项目根目录下的config/device_config.ini，替换为以下完整配置，后续可根据硬件信息调整参数：

``` [SYSTEM] debug = False port = 5000 default_admin_user = admin default_admin_pwd = 123456 [RFID] device_port = /dev/ttyUSB0 baud_rate = 9600 max_range = 4 [ENV_MONITOR] sensor_port = /dev/ttyUSB1 max_temp = 30 min_temp = 14 max_humi = 60 min_humi = 45 alarm_enable = True [ACCESS_CONTROL] controller_ip = 192.168.1.100 controller_port = 4001 ```

执行初始化命令，一键生成系统所需数据库表结构：

``` python3 init_database.py ```

看到终端输出Init database success即为初始化成功。最后执行后台启动命令：

``` nohup python3 app.py > run.log 2>&1 & ```

启动完成后，在同局域网浏览器输入http://[服务器IP]:5000即可访问后台，用默认账号admin、密码123456登录即可开始配置。

硬件对接调试实操

确认硬件设备端口

所有USB硬件插入服务器后，执行以下命令查看设备端口地址：

``` ls /dev/ttyUSB ```

输出结果会显示/dev/ttyUSB0、/dev/ttyUSB1这类地址，分别对应填入配置文件的RFID和传感器端口即可，门禁控制器IP修改为你给设备设置的同网段静态IP。

核心功能逐一调试

• 档案识别调试：进入后台「档案管理」-「标签绑定」，录入一条测试档案，绑定标签ID后将档案放入库房，点击「区域扫描」，系统能正常显示该档案信息即为成功。如果识别不到，将配置文件中的max_range参数调大1-2，重新测试即可。
• 温湿度监控调试：进入「环境监控」页面，查看显示的温湿度数值，和手持标准温湿度计对比，偏差超过±1℃的，在后台「设备配置」页面修改温度/湿度补偿值即可。模拟超出阈值的环境，确认系统会弹出告警提示即为调试成功。
• 门禁权限调试：进入「权限管理」添加用户，绑定门禁卡ID后刷卡测试，能正常开门且系统自动记录出入时间即为成功。

正式上线落地步骤

调试完成后，按以下步骤批量录入档案即可正式使用：

1. 给所有待存档案盒粘贴RFID标签，每个标签对应唯一ID。
2. 在后台「档案管理」页面导出Excel模板，按模板填入所有档案的基本信息，批量导入系统，自动完成标签ID绑定。
3. 将档案按预设架位号放入库房，全部上架后启动一次全库自动盘点，系统会自动匹配架位信息，生成盘点报告，修正错放档案的位置信息即可。

日常维护实操要点

• 定期盘点：每月启动一次全库自动盘点，点击后台「盘点管理」-「开始全库盘点」，1000㎡库房10分钟即可完成，直接导出盘点报告，不需要人工逐一清点。
• 常见问题排查：识别失败时，首先检查USB接线是否松动，再重新执行端口查看命令，替换配置文件中的端口即可；系统无法访问时，执行ps aux | grep app.py查看进程状态，进程不存在重新执行启动命令即可。
• 自动数据备份：执行crontab -e添加定时任务，每天凌晨自动备份数据库，添加以下内容即可：

``` 0 0 cp /your-path/open-archive-system/data/archive.db /your-backup-path/archive-$(date +\%Y\%m\%d).db ```

替换命令中的/your-path/和/your-backup-path/为你实际的项目路径和备份路径即可。