零门槛西医医院数字档案馆系统全流程搭建部署实操指南

一、前置准备

1.1 硬件配置要求

根据医院规模选择对应配置，所有配置均满足5年以上业务扩容需求：

• 三甲医院（年病案量≥10万份）：4核8G云服务器/物理机，1T SSD固态硬盘，公网带宽10M，操作系统CentOS7.9
• 二级及以下医院（年病案量<10万份）：2核4G云服务器/物理机，500G SSD固态硬盘，公网带宽5M，操作系统CentOS7.9
• 本地测试环境：2核4G虚拟机，CentOS7.9系统即可

1.2 基础环境依赖安装

所有命令均在root账号下执行，全程可直接复制运行：

• 安装JDK1.8：
  yum install -y java-1.8.0-openjdk-devel
  校验命令：java -version，返回版本号为1.8.x即为成功
• 安装MySQL5.7：
  wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm
rpm -ivh mysql57-community-release-el7-11.noarch.rpm
yum install -y mysql-community-server --nogpgcheck
  启动并设置开机自启：
  systemctl start mysqld && systemctl enable mysqld
  获取初始密码：grep 'temporary password' /var/log/mysqld.log
  登录修改密码：mysql -uroot -p初始密码，登录后执行
  ALTER USER 'root'@'localhost' IDENTIFIED BY '自定义强密码';
• 安装Redis6.x：
  yum install -y epel-release && yum install -y redis
  启动并设置开机自启：systemctl start redis && systemctl enable redis
• 安装Nginx1.20：
  yum install -y nginx
  启动并设置开机自启：systemctl start nginx && systemctl enable nginx

二、系统部署实操步骤

2.1 源码拉取与基础配置

拉取已适配西医医院业务的开源稳定版本：
git clone https://gitee.com/open-medical/medical-archive-system.git
进入配置文件目录：cd medical-archive-system/src/main/resources
编辑application.yml配置文件，完整可直接复制内容如下，只需修改对应密码即可：

```yaml server: port: 8088 servlet: context-path: /archive spring: datasource: url: jdbc:mysql://127.0.0.1:3306/medical_archive?useUnicode=true&characterEncoding=utf8&useSSL=false username: root password: 你设置的MySQLroot密码 driver-class-name: com.mysql.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: 无密码则留空 servlet: multipart: max-file-size: 100MB max-request-size: 100MB 病案存储路径 file: upload-path: /data/medical-archive/files/ ```

2.2 数据库初始化

登录MySQL执行创建库命令：
CREATE DATABASE medical_archive DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
导入初始表结构与基础数据：
use medical_archive;
source /root/medical-archive-system/sql/init.sql;
导入完成后执行show tables;，返回21张表即为成功

2.3 服务打包启动与反向代理配置

首先安装maven打包工具：yum install -y maven
进入项目根目录执行打包：mvn clean package -Dmaven.test.skip=true
进入target目录启动后端服务：
nohup java -jar medical-archive-1.0.0.jar > log.out 2>&1 &
校验启动成功：执行curl http://127.0.0.1:8088/archive/doc.html，返回swagger页面代码即为成功

配置Nginx反向代理，新建/etc/nginx/conf.d/archive.conf文件，完整内容如下：

```nginx server { listen 80; server_name 你的服务器公网IP/医院专属域名; 前端页面配置 location / { root /root/medical-archive-system/dist; index index.html index.htm; try_files $uri $uri/ /index.html; } 后端接口转发 location /archive { proxy_pass http://127.0.0.1:8088/archive; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; client_max_body_size 100M; } } ```

校验配置合法性：nginx -t，返回success后执行重载：nginx -s reload
此时访问服务器公网IP/域名即可进入系统，默认管理员账号：admin，默认密码：123456，首次登录必须修改为强密码

2.4 西医医院专属业务适配

• 病案批量导入：进入「系统设置-数据导入-下载模板」，按照模板填入西医病案号、就诊人身份信息、门诊/住院诊断记录、附件（支持pdf、jpg、dicom格式），单次导入上限1万条，导入后可在「档案管理-全部档案」中查看
• 权限配置：进入「系统设置-角色管理」，按照医院实际需求配置4类核心角色权限：院领导（全权限）、病案科人员（编辑/导出权限）、临床医生（仅查询本科室病案）、患者（仅查询本人病案），配置完成后绑定对应用户账号即可
• 医保对接配置：如需对接医保局病案调取接口，进入「系统设置-第三方对接」，填入医保局提供的接口地址、appkey、secret，点击「测试连通」成功后保存即可自动同步医保要求的病案数据

三、日常运维与故障排查

3.1 自动备份配置

新建数据库自动备份脚本/data/backup/backup.sh，内容如下：

```shell !/bin/bash 备份数据库 mysqldump -uroot -p你的MySQL密码 medical_archive > /data/backup/archive_$(date +%Y%m%d).sql 删除7天前的备份文件 find /data/backup -mtime +7 -name ".sql" -exec rm -rf {} \; 备份病案文件 rsync -av /data/medical-archive/files/ /data/backup/files/ ```

添加定时任务：执行crontab -e，加入以下内容实现每天凌晨2点自动备份：
0 2 /bin/bash /data/backup/backup.sh

3.2 常见故障排查

• 系统无法访问：首先执行ps -ef|grep java查看后端服务是否运行，未运行则重新执行启动命令，若启动失败查看/root/medical-archive-system/target/log.out日志，90%以上为数据库密码配置错误或MySQL服务未启动
• 文件上传失败：检查application.yml和Nginx配置中的上传大小限制是否一致，均设置为100M即可
• 大数据量查询慢：给核心字段加索引，执行以下SQL：
  ALTER TABLE `archive_info` ADD INDEX idx_patient_id (`patient_id`);
ALTER TABLE `archive_info` ADD INDEX idx_archive_id (`archive_id`);
ALTER TABLE `archive_info` ADD INDEX idx_department (`department`);