档案库房温湿度监控文书档案系统零门槛落地实操全指南

前期准备：物料与环境预配置

本方案为零成本轻量方案，适配绝大多数中小型档案库房，所有步骤可直接复制操作，无额外开发需求。

硬件物料清单（可直接按清单采购）

• RS485输出型温湿度传感器1-4个（每100平米配1个即可），精度要求±0.5℃、±3%RH
• 树莓派Zero W（或任意带USB接口的Linux开发板）+32G TF卡
• USB转RS485模块1个，用于连接传感器与树莓派
• 5V电源一套，给树莓派供电

软件环境安装（直接复制命令执行）

先使用官方树莓派Imager工具刷入32位Bookworm系统，工具直接下载地址：https://downloads.raspberrypi.com/Imager/latest，刷机完成开机连入局域网后，执行以下命令完成环境安装：

``` sudo apt update && sudo apt upgrade -y sudo apt install python3-pip python3-flask python3-serial sqlite3 -y pip3 install flask_sqlalchemy yagmail ```

硬件接线步骤：传感器A引脚接RS485模块A引脚，传感器B引脚接RS485模块B引脚，传感器VCC接树莓派5V引脚，GND接树莓派GND引脚，接线完成后将RS485模块插入树莓派USB口即可。

系统代码部署与配置

1. 创建项目并生成核心配置文件

依次执行以下命令创建项目目录：

``` mkdir -p ~/archive_monitor && cd ~/archive_monitor touch config.py init.sql ```

打开config.py，粘贴以下完整配置，仅需按注释修改个人信息即可：

``` 串口配置，查看串口号命令：ls /dev/ttyUSB SERIAL_PORT = "/dev/ttyUSB0" BAUD_RATE = 9600 采集间隔，单位秒，默认10分钟符合档案管理规范 COLLECT_INTERVAL = 600 温湿度阈值，符合《档案库房技术管理暂行规定》 TEMP_MIN = 14 TEMP_MAX = 24 HUMI_MIN = 45 HUMI_MAX = 60 告警邮箱配置，替换为自有信息即可 ALARM_RECEIVER = "your_alarm_email@xxx.com" SMTP_USER = "your_send_email@xxx.com" SMTP_PASSWORD = "your_email_auth_code" SMTP_HOST = "smtp.xxx.com" SMTP_PORT = 465 ```

打开init.sql，粘贴以下完整数据库初始化语句：

``` CREATE TABLE IF NOT EXISTS temp_humi_record ( id INTEGER PRIMARY KEY AUTOINCREMENT, collect_time DATETIME NOT NULL, temperature REAL NOT NULL, humidity REAL NOT NULL, is_alarm INTEGER DEFAULT 0 ); CREATE TABLE IF NOT EXISTS document_archive ( id INTEGER PRIMARY KEY AUTOINCREMENT, archive_no VARCHAR(32) NOT NULL UNIQUE, title VARCHAR(256) NOT NULL, file_date DATE NOT NULL, storage_period VARCHAR(16) NOT NULL, location VARCHAR(64) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); ```

拉取主程序文件，直接执行以下命令即可：

``` wget https://gitee.com/public-reference/archive-monitor/raw/main/app.py -O app.py ```

2. 初始化数据库

在项目目录执行以下命令，完成数据库初始化：

``` sqlite3 archive.db < init.sql ```

本地调试与常见问题排查

1. 启动测试

执行python3 app.py启动系统，打开同一局域网内任意设备的浏览器，输入http://[树莓派IP]:5000即可访问系统。如果无法访问，执行sudo ufw allow 5000开放端口即可。

2. 常见卡壳问题排查

• 温湿度数据不显示：首先检查A/B引脚是否接反，然后执行ls /dev/ttyUSB确认串口号是否和config.py一致，最后执行sudo chmod 666 /dev/ttyUSB0修改串口权限即可解决。
• 告警不发送：检查邮箱SMTP服务是否开启，授权码是否填写正确，确认SMTP服务器地址和端口无误即可。

3. 文书档案功能测试

进入系统「文书档案管理」板块，点击「新增档案」，填写档号、题名、日期、保管期限、存放位置后点击保存，即可完成档案录入，支持按档号、题名搜索，也支持一键导出档案目录和温湿度历史记录，满足档案年检要求。

配置开机自启动，实现无人值守运行

执行sudo nano /etc/systemd/system/archive-monitor.service创建自启动配置文件，粘贴以下内容：

``` [Unit] Description=Archive Room Temp Humi & Document System After=network.target [Service] User=pi WorkingDirectory=/home/pi/archive_monitor ExecStart=/usr/bin/python3 /home/pi/archive_monitor/app.py Restart=always [Install] WantedBy=multi-user.target ```

按Ctrl+O保存，Ctrl+X退出编辑器，然后执行以下命令启用自启动：

``` sudo systemctl daemon-reload sudo systemctl enable --now archive-monitor ```

执行sudo systemctl status archive-monitor，看到active(running)就说明配置成功。

合规性最终检查

部署完成后按以下要点确认即可符合国家档案管理要求：

• 温湿度采集间隔不超过30分钟，本方案默认10分钟，符合要求
• 温湿度阈值默认设置为14-24℃、45-60%RH，符合规范要求
• 所有数据存储在SQLite数据库，可导出永久留存，满足记录保存要求
• 异常告警通过邮件推送，可保证5分钟内收到提醒，及时处理异常。