药品监管档案软件本地化部署与全流程合规配置实操指南

一、前置准备

1.1 硬件要求（最低配置）

4核8G内存、100G云硬盘/本地硬盘、公网带宽最低2M，适配CentOS7+/Ubuntu20.04+操作系统。

1.2 软件依赖清单

• JDK 1.8
• MySQL 8.0
• Redis 6.2
• Nginx 1.20

1.3 安装包获取

直接执行下载命令获取开源合规版安装包：

``` wget https://gitee.com/opensource-med/pharma-archive/releases/download/v1.2.0/pharma-archive-v1.2.0.tar.gz ```

二、分步部署操作

2.1 基础环境安装

CentOS系统执行以下命令，Ubuntu替换yum为apt即可：

安装JDK：

``` yum install -y java-1.8.0-openjdk-devel 验证安装 java -version ```

安装MySQL：

``` yum install -y mysql-server systemctl start mysqld && systemctl enable mysqld 初始化数据库 mysql -e "CREATE DATABASE pharma_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;" mysql -e "CREATE USER 'pharma'@'%' IDENTIFIED BY 'Pharma@2024';" mysql -e "GRANT ALL PRIVILEGES ON pharma_archive. TO 'pharma'@'%'; FLUSH PRIVILEGES;" ```

安装Redis：

``` yum install -y redis sed -i 's/bind 127.0.0.1/bind 0.0.0.0/' /etc/redis.conf sed -i 's/ requirepass foobared/requirepass PharmaRedis@2024/' /etc/redis.conf systemctl start redis && systemctl enable redis ```

安装Nginx：

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

2.2 后端服务部署

解压安装包：

``` tar -zxvf pharma-archive-v1.2.0.tar.gz cd pharma-archive/backend ```

修改配置文件application.yml，完整可直接复制内容如下：

``` server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/pharma_archive?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai username: pharma password: Pharma@2024 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: PharmaRedis@2024 servlet: multipart: max-file-size: 100MB max-request-size: 100MB 档案文件存储路径，需提前创建并赋予读写权限 file: save-path: /opt/pharma-archive/files 操作日志加密配置 encrypt: enabled: true key: 32位自定义随机字符串，例如a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6 ```

提前创建存储目录：mkdir -p /opt/pharma-archive/files && chmod 777 /opt/pharma-archive/files

启动后端服务：

``` nohup java -jar pharma-archive.jar > log.log 2>&1 & 等待10秒后验证启动 netstat -tunlp | grep 8080 ```

2.3 前端页面部署

移动前端包到Nginx目录：

``` cp -r ../frontend/dist /usr/share/nginx/html/pharma-archive ```

修改Nginx配置文件/etc/nginx/conf.d/pharma.conf，完整内容如下：

``` server { listen 80; server_name 你的服务器公网IP; location / { root /usr/share/nginx/html/pharma-archive; index index.html index.htm; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```

重载Nginx配置：nginx -s reload，云服务器需在安全组开放80端口。

三、核心功能配置实操

3.1 系统初始化登录

访问http://服务器IP，默认账号：admin，默认密码：123456，首次登录强制修改密码，密码需包含大小写字母+数字+特殊字符，长度不少于8位。

3.2 监管档案模板配置

进入【系统设置-档案模板-新增模板】，必须添加以下符合《药品监督管理档案管理办法》的必填字段：药品通用名、批准文号、生产企业、生产批号、有效期、批签发证明文件、抽检记录、不良反应上报记录、退市/召回记录，每个字段设置是否可编辑、是否必填，保存后设为默认模板。

3.3 药品追溯数据对接

进入【数据中心-追溯对接】，填写国家药品追溯协同服务平台分配的appKey和appSecret，接口地址默认填写：https://api.zsxt.nmpa.gov.cn/api/queryBatch，保存后点击测试连接，提示连接成功即可自动同步药品追溯数据到档案库。

3.4 权限角色配置

进入【系统设置-角色管理】，新增3个默认角色：

• 超级管理员：全权限，仅分配给系统运维人员
• 监管人员：仅档案查询、审核、预警处理权限，无修改/删除权限
• 企业上报人员：仅本企业档案提交、修改权限，无法查看其他企业数据

四、合规校验与上线

4.1 功能合规校验

• 测试档案修改留痕：任意修改一条档案记录，进入【操作日志】查看是否留存修改人、修改时间、修改前后内容对比
• 测试过期预警：录入一个有效期不足30天的药品批次，查看是否自动推送预警消息给监管人员
• 测试文件加密：上传的批签发文件下载后打开，确认无篡改风险

4.2 自动备份配置

执行crontab -e添加定时备份任务，每天凌晨2点备份数据库和档案文件，备份文件保留30天：

``` 0 2 mysqldump -upharma -pPharma@2024 pharma_archive > /opt/backup/db_$(date +\%Y\%m\%d).sql 0 2 tar -zcvf /opt/backup/file_$(date +\%Y\%m\%d).tar.gz /opt/pharma-archive/files 0 3 find /opt/backup -mtime +30 -name ".sql" -o -name ".tar.gz" | xargs rm -f ```

五、常见问题排查

• 页面无法访问：检查Nginx状态、80端口是否开放、配置文件语法是否正确
• 后端启动失败：查看log.log日志，排查数据库/Redis连接信息是否正确、存储目录是否有权限
• 文件上传失败：检查application.yml中file.save-path路径是否存在、是否有读写权限
• 追溯对接失败：检查appKey/appSecret是否正确、服务器公网是否能访问国家追溯平台接口