胡杨河本地轻量档案管理系统从零部署到文件快速检索完整流程
一、前期准备：硬件软件清单与环境检查
1. 本地硬件要求
基础配置：2核CPU、4GB内存、50GB可用硬盘空间（SSD优先），适合胡杨河社区、中小微单位、家庭日常归档。
2. 软件安装环境
- 操作系统：Windows 10/11（推荐）、macOS Ventura+、Ubuntu 22.04+
- 运行环境：Node.js v18 LTS（胡杨河1.2.3版本依赖此版本），下载地址：https://nodejs.org/dist/v18.18.2/node-v18.18.2-x64.msi（Windows）、https://nodejs.org/dist/v18.18.2/node-v18.18.2.pkg（macOS）、Ubuntu用命令`sudo apt install -y nodejs npm && sudo npm install -g n && sudo n 18.18.2`
- 压缩工具：WinRAR/7-Zip/系统自带解压
3. 环境验证
打开终端（Windows用Win+R输入cmd，macOS/Ubuntu用终端），依次输入：
``` node -v npm -v ```若分别输出`v18.18.2`、`9.8.1`（或更高兼容版本），说明环境正常。
二、下载并安装胡杨河档案管理系统
1. 获取系统安装包
胡杨河是开源免费轻量系统，GitHub下载地址：https://github.com/yangyang920729/huyanghe-archive/releases/download/v1.2.3/huyanghe-archive-v1.2.3.zip
2. 解压与目录规划
Windows：解压到D:\Software\huyanghe（不要带中文路径！），目录结构为：
- config/（配置文件）
- data/（默认归档存储目录）
- public/（前端资源）
- server/（后端代码）
- package.json
3. 安装依赖包
在终端进入解压后的目录（比如Windows输入`cd D:\Software\huyanghe`），输入命令：
``` npm install --registry=https://registry.npmmirror.com ```
用国内镜像源避免下载超时，依赖安装完成会显示`added xxx packages`。
三、核心配置：端口、存储、管理员账号
1. 修改基础配置文件
打开`config/config.js`，替换全部内容为可直接复制的配置：
``` module.exports = { // 服务端口，默认3000，被占用可改3001-65535之间未用的 port: 3000, // 归档文件存储绝对路径，不要中文，新建可改D:\HuYangHeData storagePath: 'D:\\Software\\huyanghe\\data', // 管理员初始账号密码，首次登录必须修改！ admin: { username: 'admin', password: 'hyh_202X_Archive' // 替换为自己的强密码 }, // 单文件最大上传大小（MB），默认100，按需调整 maxFileSize: 200, // 支持的文件格式 allowedExtensions: [ 'pdf', 'doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx', 'txt', 'jpg', 'jpeg', 'png', 'gif', 'mp4', 'mp3' ] }; ```2. 验证配置合法性
在终端继续输入：
``` node server/check-config.js ```若输出`✅ 配置文件合法`，继续下一步；若有错误，按提示修改。
四、启动服务与后台初始化
1. 启动服务
终端输入：
``` node server/index.js ```看到`✅ 胡杨河档案管理系统已启动，访问地址：http://localhost:3000`即成功。
2. 后台初始化
- 打开浏览器访问上述地址
- 输入配置的初始管理员账号密码，点击登录
- 首次登录会弹出密码修改弹窗，必须输入8位以上含大小写字母+数字的新密码
- 修改后自动跳转至后台首页，创建基础档案分类（如“行政文件”“合同协议”“技术资料”“个人证书”）
五、日常使用：文件上传、标签标注与全文检索
1. 文件批量上传
- 点击后台左侧档案管理→上传档案
- 选择已创建的分类，支持拖拽文件或点击选择文件夹/文件（Chrome/Firefox支持文件夹选择）
- 上传前可勾选自动提取文件名关键词，勾选后系统会自动生成3-5个标签
- 点击开始上传，状态栏显示100%后完成
2. 标签与元数据手动完善
- 点击档案管理→档案列表，找到刚上传的文件
- 点击文件右侧的编辑按钮
- 补充档案编号（如“202X-XZ-001”，XZ对应行政文件）、归档日期、责任人、自定义标签
- 若上传的是PDF/Word/Excel/TXT，可点击提取全文，10秒内完成全文OCR/解析
- 点击保存生效
3. 快速全文检索
- 后台首页右上角有全局检索框，可输入：
- 文件名关键词（如“202X年度总结”）
- 标签（如“XZ”“合同”）
- 全文内容关键词（如“员工福利”“采购预算”，仅已提取全文的文件支持）
- 输入后按Enter键，或点击检索，结果会按相关度排序
- 点击预览可在线查看PDF/图片/TXT，点击下载获取原文件
六、进阶操作：开机自启与局域网访问
1. Windows设置开机自启
- 在解压目录新建`start.bat`文件，内容为： ``` @echo off cd /d D:\Software\huyanghe node server/index.js pause ```
- 按Win+R输入`shell:startup`，打开开机启动文件夹
- 将`start.bat`的快捷方式（右键→发送到→桌面快捷方式，再拖进去）复制到启动文件夹
- 测试重启电脑，打开浏览器访问http://localhost:3000验证
2. 局域网内其他设备访问
- 在终端输入`ipconfig`（Windows）或`ifconfig`（macOS/Ubuntu），找到本机的IPv4地址（如192.168.1.100）
- 打开Windows Defender防火墙→允许应用通过防火墙→更改设置→勾选Node.js的专用/公用网络
- 局域网内其他设备（手机/平板/电脑）连接同一WiFi，浏览器访问`http://192.168.1.100:3000`即可
七、数据备份与恢复
1. 数据备份
直接复制整个`config`和`data`目录到移动硬盘/云盘，建议每天自动备份（可用Windows任务计划程序+xcopy命令实现）。
2. 数据恢复
重新安装胡杨河系统后，将备份的`config`和`data`目录替换解压后的同名目录，重启服务即可。
相关文章
