中医医院档案软件本地化部署及日常运维全流程实操指南

前期准备工作

硬件配置要求

满足日活100人以内的中小规模中医医院使用，配置如下：

• CPU：4核8线程及以上
• 内存：16G及以上
• 硬盘：2T SATA硬盘（推荐做RAID1冗余，存储病历、影像档案）
• 网络：如需分院/外网访问，需配备1个公网固定IP

基础软件依赖

所有依赖均为开源稳定版本，无需额外付费：

• 操作系统：CentOS7.9，下载地址：https://mirrors.aliyun.com/centos/7.9.2009/isos/x86_64/CentOS-7-x86_64-DVD-2009.iso
• 数据库：MySQL5.7
• 运行环境：JDK1.8
• 反向代理：Nginx1.20

软件部署实操步骤

第一步：系统初始化配置

操作系统安装完成后，依次执行以下命令完成基础配置：

``` 关闭防火墙和SELinux，避免端口拦截 systemctl stop firewalld systemctl disable firewalld setenforce 0 sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config 安装基础工具 yum install -y wget vim unzip net-tools 配置时间同步，保障档案时间准确性 yum install -y chrony systemctl start chronyd systemctl enable chronyd timedatectl set-timezone Asia/Shanghai ```

第二步：数据库部署配置

执行以下命令安装MySQL5.7并创建专属档案库：

``` 安装MySQL源 wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm rpm -ivh mysql57-community-release-el7-11.noarch.rpm rpm --import https://repo.mysql.com/RPM-GPG-KEY-mysql-2022 安装并启动MySQL yum install -y mysql-community-server systemctl start mysqld systemctl enable mysqld 获取初始密码 grep 'temporary password' /var/log/mysqld.log ```

用获取到的初始密码登录数据库，执行以下SQL完成配置：

``` 登录数据库，将下方占位符替换为实际初始密码 mysql -uroot -p'你查到的初始密码' 修改root密码，符合等保复杂度要求 ALTER USER 'root'@'localhost' IDENTIFIED BY 'ZyYa2024_Archive'; 创建专属档案库 CREATE DATABASE tcm_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; 创建专属访问用户，限制本地访问提升安全性 CREATE USER 'tcm_user'@'localhost' IDENTIFIED BY 'TcM_User@2024'; GRANT ALL PRIVILEGES ON tcm_archive. TO 'tcm_user'@'localhost'; FLUSH PRIVILEGES; exit; ```

导入初始表结构：将软件包自带的init.sql上传到/opt目录，执行mysql -utcm_user -p'TcM_User@2024' tcm_archive < /opt/init.sql即可。

第三步：主程序部署

先安装JDK1.8运行环境：

``` yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel 验证安装，返回版本号即为成功 java -version ```

上传软件包到/opt目录，开源版可从https://gitee.com/tcm-open/tcm-archive/attach_files/1689210/download/tcm-archive-v1.2.0.jar下载，商用版替换为厂商提供的jar包即可。

创建systemd服务实现开机自启，编辑配置文件vim /etc/systemd/system/tcm-archive.service，完整内容如下：

``` [Unit] Description=TCM Hospital Archive Service After=network.target mysqld.service [Service] Type=simple User=root WorkingDirectory=/opt ExecStart=/usr/bin/java -jar -Xms8G -Xmx12G /opt/tcm-archive-v1.2.0.jar Restart=always RestartSec=10 [Install] WantedBy=multi-user.target ```

执行以下命令启动服务：

``` systemctl daemon-reload systemctl start tcm-archive systemctl enable tcm-archive 验证启动，返回8080端口监听即为成功 netstat -ntlp | grep 8080 ```

第四步：反向代理配置

安装Nginx：

``` yum install -y nginx systemctl start nginx systemctl enable nginx ```

编辑配置文件vim /etc/nginx/conf.d/tcm-archive.conf，完整内容如下：

``` server { listen 80; server_name 你的服务器IP或域名; client_max_body_size 1024M; 支持1G以内的影像、病历档案上传 location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } ```

验证配置并重载：nginx -t && nginx -s reload，此时访问服务器IP即可进入软件登录页，默认账号admin，默认密码Admin@123456，首次登录必须修改密码。

注意：如需符合等保2.0要求，可申请免费SSL证书配置HTTPS，关闭80端口强制跳转443端口即可。

中医专属功能配置

档案模板配置

登录后台进入【系统设置】-【档案模板】，添加中医专属字段：脉象记录、舌象记录、证候诊断、中药处方、针灸理疗记录、随访记录，可根据医院需求设置字段为必填/选填，配置后所有新建档案自动套用该模板。

权限分级配置

进入【权限管理】-【角色配置】，按照医院角色设置对应权限：

• 院领导：全量档案查阅权
• 临床医生：仅可查阅分管患者档案、书写自己负责的患者档案
• 医技人员：仅可上传影像、检验数据到对应患者档案
• 档案管理员：可归档、导出、销毁过期档案

禁止给普通用户开放删除、归档权限，避免档案丢失。

归档规则配置

进入【归档设置】，按照《中医病案管理规范》设置规则：门诊病历归档时效为就诊后24小时，住院病历归档时效为出院后7天，过期未归档自动推送提醒给主治医生，归档后的档案不可修改，仅可添加后续诊疗备注。

日常运维及问题排查

自动备份配置

创建备份脚本vim /opt/backup.sh，完整内容如下：

``` !/bin/bash 创建备份目录 mkdir -p /backup 备份数据库 mysqldump -utcm_user -p'TcM_User@2024' tcm_archive > /backup/$(date +%Y%m%d)_tcm_archive.sql 备份上传的档案文件 tar -zcf /backup/$(date +%Y%m%d)_archive_files.tar.gz /opt/upload 删除7天前的备份，释放磁盘空间 find /backup -mtime +7 -name ".sql" -o -name ".tar.gz" | xargs rm -f ```

添加执行权限并配置定时任务：

``` chmod +x /opt/backup.sh crontab -e 添加以下内容，每天凌晨2点自动执行备份 0 2 /opt/backup.sh ```

注意：每周需将备份文件拷贝到外置存储或云端，避免服务器硬件故障导致数据丢失。

常见问题排查

• 档案上传失败：首先检查Nginx配置的client_max_body_size参数是否大于上传文件大小，其次查看/opt/logs/archive.log日志排查报错，若提示磁盘不足则清理过期备份文件即可。
• 访问卡顿：执行top命令查看CPU、内存占用，若MySQL占用过高，登录数据库执行show processlist排查慢SQL，给档案编号、患者身份证号等高频查询字段添加索引即可解决。
• 登录失败：检查密码输入是否正确，若多次锁定可登录数据库执行update tcm_archive.sys_user set status=1, password='$2a$10$7JZ6k4yU8xQ9zL0mN1oP2qR3sT4uV5wX6yZ7a8b9c0d1e2f3g4h5i6j' where username='admin';重置密码为Admin@123456。