白山档案软件：从零开始搭建企业级档案管理系统的完整实操指南

一、环境准备与软件安装

在开始部署前，请确保服务器满足以下最低配置要求：

• 操作系统：CentOS 7.6 或 Ubuntu 18.04 LTS
• CPU：4核以上
• 内存：8GB以上
• 硬盘：100GB可用空间（建议使用SSD）
• 网络：固定公网IP地址

1.1 基础环境部署

首先更新系统并安装必要的依赖包：

``` sudo yum update -y CentOS sudo yum install -y wget curl vim git unzip ```

或

``` sudo apt update && sudo apt upgrade -y Ubuntu sudo apt install -y wget curl vim git unzip ```

1.2 数据库安装与配置

白山档案软件使用MySQL作为后端数据库，执行以下命令安装MySQL 5.7：

``` CentOS sudo rpm -Uvh https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm sudo yum install -y mysql-community-server Ubuntu wget https://dev.mysql.com/get/mysql-apt-config_0.8.15-1_all.deb sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb sudo apt update sudo apt install -y mysql-server ```

启动MySQL并设置开机自启：

``` sudo systemctl start mysqld sudo systemctl enable mysqld ```

获取初始密码并修改：

``` sudo grep 'temporary password' /var/log/mysqld.log mysql -uroot -p ```

登录后执行以下SQL语句：

``` ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourNewPassword123!'; CREATE DATABASE baishan_archive CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; GRANT ALL PRIVILEGES ON baishan_archive. TO 'archive_user'@'localhost' IDENTIFIED BY 'ArchivePass123!'; FLUSH PRIVILEGES; EXIT; ```

1.3 白山档案软件安装

从官方仓库下载最新版本：

``` cd /opt sudo wget https://download.baishan.com/archive/archive-server-2.3.1.zip sudo unzip archive-server-2.3.1.zip sudo mv archive-server /usr/local/baishan-archive ```

设置目录权限：

``` sudo chown -R www-data:www-data /usr/local/baishan-archive Ubuntu sudo chown -R apache:apache /usr/local/baishan-archive CentOS sudo chmod -R 755 /usr/local/baishan-archive/storage ```

二、系统配置与初始化

2.1 配置文件设置

进入配置目录并复制示例配置文件：

``` cd /usr/local/baishan-archive sudo cp .env.example .env ```

编辑.env文件，修改以下关键配置：

``` sudo vim .env ```

将以下内容替换为你的实际配置：

``` APP_NAME=白山档案管理系统 APP_ENV=production APP_KEY=base64:your_32_char_random_string_here APP_DEBUG=false APP_URL=http://your-server-ip:8080 DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=baishan_archive DB_USERNAME=archive_user DB_PASSWORD=ArchivePass123! REDIS_HOST=127.0.0.1 REDIS_PASSWORD=null REDIS_PORT=6379 FILE_STORAGE_PATH=/var/baishan-archive/files BACKUP_PATH=/var/baishan-archive/backups MAX_UPLOAD_SIZE=2048 ```

生成应用密钥：

``` sudo php artisan key:generate ```

2.2 数据库迁移与数据初始化

执行数据库迁移命令：

``` sudo php artisan migrate --force ```

导入基础数据：

``` sudo php artisan db:seed --class=BasicDataSeeder ```

创建管理员账户：

``` sudo php artisan archive:create-admin ```

按照提示输入管理员信息：

用户名：admin 邮箱：admin@yourcompany.com 密码：Admin@123456

三、Web服务器配置

3.1 Nginx配置

安装Nginx：

``` CentOS sudo yum install -y nginx Ubuntu sudo apt install -y nginx ```

创建Nginx配置文件：

``` sudo vim /etc/nginx/conf.d/baishan-archive.conf ```

添加以下配置内容：

``` server { listen 80; server_name your-server-ip; root /usr/local/baishan-archive/public; index index.php index.html index.htm; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } location ~ /\.ht { deny all; } client_max_body_size 2048M; } ```

测试配置并重启Nginx：

``` sudo nginx -t sudo systemctl restart nginx sudo systemctl enable nginx ```

3.2 PHP环境配置

安装PHP 7.4及相关扩展：

``` CentOS sudo yum install -y epel-release sudo yum install -y http://rpms.remirepo.net/enterprise/remi-release-7.rpm sudo yum install -y yum-utils sudo yum-config-manager --enable remi-php74 sudo yum install -y php php-fpm php-mysql php-xml php-mbstring php-zip php-gd Ubuntu sudo apt install -y php7.4 php7.4-fpm php7.4-mysql php7.4-xml php7.4-mbstring php7.4-zip php7.4-gd ```

修改PHP配置文件：

``` sudo vim /etc/php/7.4/fpm/php.ini ```

找到并修改以下参数：

``` upload_max_filesize = 2048M post_max_size = 2048M max_execution_time = 300 memory_limit = 512M ```

启动PHP-FPM：

``` sudo systemctl start php7.4-fpm sudo systemctl enable php7.4-fpm ```

四、系统功能配置与使用

4.1 档案分类设置

登录系统后，按以下步骤创建档案分类：

1. 点击左侧菜单"系统管理" → "档案分类"
2. 点击右上角"新增分类"按钮
3. 填写分类信息：
   • 分类名称：人事档案
   • 分类编码：RSDA
   • 保管期限：永久
   • 密级：内部
4. 点击"保存"完成创建

4.2 档案录入与上传

创建档案条目：

1. 点击"档案管理" → "档案录入"
2. 选择档案分类：人事档案
3. 填写档案基本信息：
   • 档案张三入职材料
   • 档案编号：RSDA-2023-001
   • 责任者：人力资源部
   • 形成时间：2023-01-15
4. 点击"上传文件"按钮，选择要上传的文档
5. 设置文件属性：
   • 文件名称：张三身份证复印件
   • 文件类型：图像文件
   • 页数：2
6. 点击"提交审核"

4.3 档案检索与借阅

检索档案：

1. 在首页搜索框输入关键词，如"张三"
2. 或使用高级检索：
   • 点击"档案检索" → "高级检索"
   • 设置检索条件：分类=人事档案，时间范围=2023年
   • 点击"开始检索"

申请借阅：

1. 在检索结果中找到目标档案
2. 点击"申请借阅"按钮
3. 填写借阅信息：
   • 借阅事由：办理入职手续
   • 预计归还时间：2023-10-30
   • 使用方式：现场查阅
4. 提交申请等待审批

五、系统维护与备份

5.1 定期备份设置

创建备份脚本：

``` sudo vim /usr/local/bin/backup-archive.sh ```

添加以下内容：

``` !/bin/bash BACKUP_DIR="/var/baishan-archive/backups" DATE=$(date +%Y%m%d_%H%M%S) DB_NAME="baishan_archive" DB_USER="archive_user" DB_PASS="ArchivePass123!" 备份数据库 mysqldump -u$DB_USER -p$DB_PASS $DB_NAME > $BACKUP_DIR/db_backup_$DATE.sql 备份文件存储 tar -czf $BACKUP_DIR/files_backup_$DATE.tar.gz /var/baishan-archive/files/ 删除7天前的备份 find $BACKUP_DIR -type f -name ".sql" -mtime +7 -delete find $BACKUP_DIR -type f -name ".tar.gz" -mtime +7 -delete echo "Backup completed at $(date)" >> $BACKUP_DIR/backup.log ```

设置脚本权限并创建定时任务：

``` sudo chmod +x /usr/local/bin/backup-archive.sh sudo crontab -e ```

添加以下行（每天凌晨2点执行备份）：

``` 0 2 /usr/local/bin/backup-archive.sh ```

5.2 系统日志监控

查看系统日志：

``` sudo tail -f /usr/local/baishan-archive/storage/logs/laravel.log ```

查看操作审计日志：

1. 登录系统管理后台
2. 点击"系统监控" → "操作日志"
3. 可查看所有用户的操作记录，包括：
   • 操作时间
   • 操作用户
   • 操作类型
   • 操作详情
   • IP地址

5.3 系统更新

执行系统更新前，请务必先完成备份：

``` sudo /usr/local/bin/backup-archive.sh cd /usr/local/baishan-archive sudo git pull origin master sudo php artisan migrate sudo php artisan cache:clear sudo php artisan config:cache sudo systemctl restart php7.4-fpm sudo systemctl restart nginx ```

六、故障排除

6.1 常见问题解决

问题1：文件上传失败

检查步骤：

1. 确认storage目录权限：sudo chmod -R 755 storage
2. 检查Nginx配置中的client_max_body_size值
3. 检查PHP配置中的upload_max_filesize和post_max_size

问题2：数据库连接失败

解决步骤：

1. 检查MySQL服务状态：sudo systemctl status mysqld
2. 测试数据库连接：mysql -uarchive_user -pArchivePass123! -e "SHOW DATABASES;"
3. 检查.env文件中的数据库配置

问题3：页面显示404错误

解决步骤：

1. 检查Nginx配置中的root路径是否正确
2. 重启Nginx服务：sudo systemctl restart nginx
3. 检查文件权限：sudo chown -R www-data:www-data /usr/local/baishan-archive

6.2 性能优化建议

1. 启用Redis缓存：

   sudo apt install -y redis-server
   sudo systemctl enable redis
   

   在.env文件中设置：

   CACHE_DRIVER=redis
   SESSION_DRIVER=redis
   

2. 配置OPcache加速PHP：

   sudo vim /etc/php/7.4/fpm/php.ini
   

   找到并修改：

   opcache.enable=1
   opcache.memory_consumption=128
   opcache.interned_strings_buffer=8
   opcache.max_accelerated_files=4000
   opcache.revalidate_freq=60
   

3. 定期清理临时文件：

   sudo crontab -e
   添加：0 3    php /usr/local/baishan-archive/artisan schedule:run