开源文件档案软件本地化部署全流程实操 零基础可直接落地复用
一、前期环境准备
1. 硬件最低配置
2核4G内存、40G系统盘,数据盘根据实际档案存储量选配,操作系统优先选择CentOS7.9,兼容性最优。
2. 基础软件环境预配置
首先执行系统更新命令:
``` yum update -y ```添加PHP8.1源,安装依赖扩展:
``` rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm rpm -Uvh https://rpms.remirepo.net/enterprise/remi-release-7.rpm yum install yum-utils -y yum-config-manager --enable remi-php81 yum install php php-fpm php-mysqlnd php-gd php-mbstring php-xml php-curl php-zip php-intl php-ldap -y ```安装并初始化MariaDB数据库:
``` yum install mariadb-server mariadb -y systemctl start mariadb systemctl enable mariadb mysql_secure_installation ```执行初始化命令后按以下步骤交互:当前root密码默认空直接回车,输入Y设置root密码(示例:FileRun@2024),后续4个安全配置项全部输入Y回车即可。

创建FileRun专用数据库,执行以下命令:
``` mysql -u root -p 输入刚才设置的数据库root密码后依次执行 CREATE DATABASE filerun CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'filerun'@'localhost' IDENTIFIED BY 'FileRun_DB@2024'; GRANT ALL PRIVILEGES ON filerun. TO 'filerun'@'localhost'; FLUSH PRIVILEGES; exit; ```二、FileRun文件档案软件安装部署
1. 下载安装包
执行以下命令下载最新稳定版安装包并配置权限:
``` cd /usr/share/nginx/html wget https://filerun.com/download-latest-php81 -O filerun.zip unzip filerun.zip chown -R nginx:nginx /usr/share/nginx/html/filerun chmod -R 755 /usr/share/nginx/html/filerun ```2. Nginx站点配置
新建Nginx配置文件`/etc/nginx/conf.d/filerun.conf`,直接复制以下内容:
``` server { listen 80; server_name 你的服务器公网IP或者绑定的域名; root /usr/share/nginx/html/filerun; index index.php index.html; location / { try_files $uri $uri/ /index.php?$args; } location ~ \.php$ { try_files $uri =404; fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } location ~ /\.ht { deny all; } location ~ ^/(system/data|custom/modules)/.\.(php|php5|phtml)$ { deny all; } } ```注意:将配置中的「你的服务器公网IP或者绑定的域名」替换为实际地址,随后验证配置并重启服务:
``` nginx -t 提示test is successful后执行以下命令 systemctl restart nginx systemctl enable nginx systemctl start php-fpm systemctl enable php-fpm ```3. 可视化初始化
打开浏览器输入`http://你的服务器IP`进入安装向导:第一步环境校验全部打勾后点下一步,第二步数据库配置依次填入:数据库名`filerun`、用户名`filerun`、密码`FileRun_DB@2024`、主机`localhost`,第三步设置管理员账号密码,点击完成即可进入后台。
三、核心档案管理功能实操配置
1. 档案分类与权限配置
- 登录后台后点击左侧「文件」-「新建文件夹」,创建一级分类目录:行政档案、人事档案、项目档案、财务档案、合同档案
- 点击每个目录右侧「权限」按钮,绑定对应部门用户权限:例如人事档案仅开放人事部门读写权限,其他部门设置为不可见
- 点击目录右侧「设置」-「版本控制」,勾选保留所有文件修改版本,最长保留180天,覆盖修改前的档案可随时回滚
2. 档案上传与元数据配置
- 支持单文件、批量文件夹上传,默认支持单文件最大10G,自动分片上传断点续传
- 点击左侧「管理」-「元数据字段」,新增自定义字段:档案编号、归档日期、保管期限、密级、责任人,设置为上传文件时必填项,满足档案合规要求
- 在「管理」-「插件」中启用OCR插件,上传扫描件档案时自动识别文字内容,支持全文检索
3. 检索与借阅流程配置
- 顶部搜索框支持按文件名、元数据、文件内容检索,检索结果自动按权限过滤,无权限档案不会显示
- 点击「管理」-「工作流」,新建借阅审批流:用户提交借阅申请→档案管理员审批→通过后自动开放7天只读权限,到期自动回收
- 点击「管理」-「日志」可查看所有用户的上传、下载、修改、借阅操作记录,永久留存可追溯
四、常见问题排查
- 大文件上传失败:编辑`/etc/php.ini`文件,修改`upload_max_filesize = 10G`、`post_max_size = 10G`、`max_execution_time = 3600`,保存后重启php-fpm服务
- 页面访问403:执行`setenforce 0`临时关闭SELinux,永久关闭可编辑`/etc/selinux/config`,将`SELINUX=enforcing`改为`SELINUX=disabled`,同时确认filerun目录权限为nginx用户所有
- 数据库连接失败:执行`systemctl status mariadb`确认数据库服务正常运行,核对配置页填写的数据库用户名、密码与创建时的配置一致
所有配置完成后即可投入使用,支持PC端、手机端直接访问,数据全部本地存储,符合档案安全保密要求。