中小规模农业企业免费开源档案软件部署快速上手操作指南

一、前置准备工作

1.1 软硬件环境确认

我们选用轻量级、无版权、针对多类型档案优化的OpenKM社区版6.3.12作为本次部署工具，环境要求如下：

• 硬件配置（最低）：4核CPU、8GB DDR3内存、100GB可用存储空间（SSD优先处理图片/视频档案）
• 硬件配置（推荐）：8核CPU、16GB DDR4内存、500GB SSD存储（支持5-20人同时在线管理）
• 软件环境：Windows Server 2019及以上/Windows 10专业版64位（中小农业企业本地部署优先）、CentOS 7/8（备选远程部署）、Java Development Kit 8u301 64位（OpenKM专用Java版本，不能用其他高版本）

1.2 专用Java环境安装

访问Oracle Java Archive（需注册免费Oracle账号）下载指定版本：https://www.oracle.com/java/technologies/javase/javase8-archive-downloads.html，搜索框输入“jdk-8u301-windows-x64.exe”下载并安装，安装路径必须用全英文（比如D:\Java\jdk1.8.0_301）。

配置Java环境变量，步骤如下：

1. 右键“此电脑”→属性→高级系统设置→环境变量
2. 在“系统变量”区域点击“新建”，变量名输入JAVA_HOME，变量值输入刚才的全英文安装路径
3. 找到“系统变量”中的Path，点击“编辑”，新建两个值：%JAVA_HOME%\bin和%JAVA_HOME%\jre\bin，并将这两个值移到Path列表最顶部
4. 打开CMD窗口（Win+R输入cmd），输入java -version和javac -version，若都显示“1.8.0_301”则配置成功

1.3 OpenKM社区版下载

访问OpenKM官方GitHub Releases下载6.3.12 Windows一键安装包：https://github.com/openkm/document-management-system/releases/tag/6.3.12，找到“openkm-6.3.12-windows-installer.exe”（约500MB）下载。

二、OpenKM本地部署实操

2.1 一键安装步骤

双击下载好的安装包，按以下强制不修改默认值的步骤操作（关键配置后续单独改）：

1. 选择安装语言为“中文（简体）”，点击“OK”
2. 点击“下一步”，阅读并勾选“接受许可协议”，点击“下一步”
3. 保持安装路径为默认的C:\openkm（后续升级兼容更好），点击“下一步”
4. 选择Java虚拟机内存配置：中小规模选“8 GB RAM配置”，点击“下一步”
5. 输入系统管理员账号密码：默认账号admin，密码建议设为Admin@123（首次登录后强制修改），点击“下一步”
6. 保持“创建桌面快捷方式”和“启动OpenKM服务”勾选，点击“下一步”，等待10-15分钟安装完成

2.2 首次登录与基础验证

安装完成后：

1. 桌面会生成“OpenKM Desktop Start”和“OpenKM Web Access”两个快捷方式
2. 双击“OpenKM Web Access”，或在同局域网内其他电脑浏览器输入部署电脑的IP地址:8080/OpenKM（比如192.168.1.100:8080/OpenKM）
3. 用刚才的admin账号密码登录，若成功进入中文操作界面则部署完成

三、农业企业档案个性化配置

3.1 农业专属档案分类创建

OpenKM默认分类不符合农业需求，需手动创建多级分类，操作路径：右上角“管理”→左侧“分类管理”→新建文件夹，建议分类结构如下（可按企业规模调整）：

• 1. 种植/养殖档案
  • 1.1 地块/圈舍编号档案
  • 1.2 种苗/种畜采购合同与检疫证明
  • 1.3 投入品（农药/化肥/饲料）采购与使用记录
  • 1.4 生长/养殖周期记录（含照片、台账扫描件）
  • 1.5 农产品检测报告
• 2. 经营管理档案
  • 2.1 营业执照、许可证等资质文件
  • 2.2 财务报表、税务凭证
  • 2.3 农产品销售合同与出库单
• 3. 员工管理档案
  • 3.1 劳动合同
  • 3.2 健康证、技能证书

3.2 农产品追溯标签关联配置

这是农业档案软件的核心实用功能，需先创建自定义属性组用于存储追溯信息，操作路径：右上角“管理”→左侧“属性组管理”→新建属性组：

属性组名称设为农产品追溯属性，创建以下必填属性：

• 属性名：追溯码，类型：文本，长度：32，是否必填：是，是否唯一：是
• 属性名：生产批次，类型：文本，长度：20，是否必填：是
• 属性名：检测状态，类型：单选，选项：合格/不合格，是否必填：是
• 属性名：销售对象，类型：文本，长度：50，是否必填：是

关联属性组到对应分类：回到“分类管理”，右键点击“1.5 农产品检测报告”文件夹→权限与属性→勾选刚才创建的“农产品追溯属性”→保存。

3.3 普通操作账号创建

避免使用admin账号日常操作，需创建不同权限的账号，操作路径：右上角“管理”→左侧“用户管理”→新建用户：

• 创建档案管理员账号：用户名nongda_admin，密码设为Nongda@123，勾选“管理员”角色
• 创建种植/养殖记录员账号：用户名jiluyuan01，密码设为Jiluyuan@123，不勾选角色
• 创建销售查看员账号：用户名xiaoshou01，密码设为Xiaoshou@123，不勾选角色

给普通账号分配分类权限：右键点击“1. 种植/养殖档案”文件夹→权限与属性→添加用户jiluyuan01，勾选读、写、删除权限；添加用户xiaoshou01，仅勾选读权限→保存。

四、日常档案管理实操

4.1 上传档案与添加追溯属性

用jiluyuan01账号登录：

1. 进入“1.5 农产品检测报告”文件夹
2. 点击左侧“上传”按钮，选择本地检测报告PDF或扫描件（单文件最大支持2GB）
3. 上传完成后，右键点击文件→属性→填写刚才创建的农产品追溯属性→保存

4.2 追溯信息查询与导出

用任意有读权限的账号登录：

1. 点击顶部搜索框右侧的“高级搜索”
2. 在“属性组”下拉框选“农产品追溯属性”，输入任意追溯码或生产批次→搜索
3. 搜索结果可点击文件在线预览，也可点击“批量下载”或“导出元数据（Excel）”

五、常见问题快速解决

• 问题1：登录提示“连接失败”→检查部署电脑的OpenKM服务是否启动：右键“此电脑”→管理→服务和应用程序→服务→找到“OpenKM”服务，右键启动
• 问题2：上传大文件失败→修改C:\openkm\tomcat\conf\server.xml文件，找到
• 问题3：忘记admin密码→打开CMD窗口，进入C:\openkm\bin目录，输入openkm reset-admin，按提示输入新密码即可