档案软件单机版与局域网版架构部署实操指南

一、 核心架构差异与选型逻辑

在开始部署前，必须明确单机版与局域网版在底层技术实现上的本质区别，这直接决定了后续的配置文件修改方向。

• 单机版架构：采用嵌入式数据库（如SQLite、H2或Firebird）。数据库文件直接存储在应用程序安装目录下，数据服务与应用进程在同一个内存空间中运行，无需独立安装数据库服务。
• 局域网版架构：采用客户端/服务器（C/S）或浏览器/服务器（B/S）架构。数据存储在独立的数据库服务器（如MySQL、PostgreSQL、SQL Server）中，应用程序仅作为服务端或客户端通过网络协议（TCP/IP）进行远程数据读写。

二、 单机版环境搭建实战

单机版部署的核心在于“零依赖”，即确保软件启动时能自动识别本地文件型数据库。以下以基于Java开发的通用档案管理系统为例，演示如何通过配置文件将其锁定为单机模式。

1. 目录结构规划

在Windows Server或Windows 10/11环境下，创建如下目录结构以保证数据安全：

D:\ArchiveSystem\（程序根目录）

• app\：存放 archive-system.jar 或可执行文件 Archive.exe
• data\：存放数据库文件 archive.db 及附件存储
• logs\：存放运行日志
• config\：存放配置文件 application.properties

2. 修改核心配置文件

打开 config\application.properties，将数据库连接源修改为本地嵌入式模式。以下是完整的配置内容，可直接复制覆盖：

```properties 服务器配置 server.port=8080 单机版仅允许本机访问，关闭外网接口 server.address=127.0.0.1 数据源配置 - 使用H2嵌入式数据库 spring.datasource.driver-class-name=org.h2.Driver 数据库文件直接指向data目录下的archive.mv.db（H2自动识别） spring.datasource.url=jdbc:h2:file:./data/archive;MODE=MySQL;AUTO_SERVER=TRUE spring.datasource.username=sa spring.datasource.password= JPA/Hibernate 配置 spring.jpa.database-platform=org.hibernate.dialect.H2Dialect spring.jpa.hibernate.ddl-auto=update spring.jpa.show-sql=false 文件上传路径（指向本地data目录） file.upload.path=./data/uploads ```

关键操作项：请务必检查 spring.datasource.url 中的路径。如果软件是.exe打包版，通常需要在设置界面中勾选“使用本地数据库”，并将数据存储路径手动指定为 D:\ArchiveSystem\data。

3. 启动与验证

进入 app 目录，打开命令行窗口，执行以下命令启动服务：

java -jar archive-system.jar --spring.config.location=../config/application.properties

看到日志输出 “Started ArchiveApplication in X.XXX seconds” 即表示单机版启动成功。此时访问 http://127.0.0.1:8080 即可进行档案录入，数据将全部写入 data 文件夹。

三、 局域网版服务端部署实战

局域网版部署需要构建独立的数据服务层。本章节以 CentOS 7 + MySQL 8.0 为环境，演示如何搭建标准的服务端。

1. 安装并初始化MySQL数据库

首先卸载系统自带的mariadb，然后安装MySQL。执行以下命令序列：

sudo yum remove -y mariadb-libs

sudo yum localinstall -y https://dev.mysql.com/get/mysql80-community-release-el7-7.noarch.rpm

sudo yum install -y mysql-server

sudo systemctl start mysqld

sudo systemctl enable mysqld

获取临时root密码并修改：

sudo grep 'temporary password' /var/log/mysqld.log

mysql -uroot -p (输入上一步获取的密码)

进入MySQL命令行后，执行以下SQL语句建立档案专用库：

```sql ALTER USER 'root'@'localhost' IDENTIFIED BY 'Root@123!'; CREATE DATABASE archive_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'archive_user'@'%' IDENTIFIED BY 'User@Pass123'; GRANT ALL PRIVILEGES ON archive_db. TO 'archive_user'@'%'; FLUSH PRIVILEGES; EXIT; ```

2. 配置防火墙与网络策略

确保局域网内其他PC能访问服务器的8080端口（应用端口）和3306端口（数据库端口，如果客户端直连数据库）：

sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent

sudo firewall-cmd --reload

3. 修改服务端配置文件

在服务器上创建目录 /opt/archive-server/config，编辑 application.properties。核心修改点在于将数据源指向远程MySQL，并将服务地址绑定到 0.0.0.0 以允许外网连接。

```properties 服务器配置 - 监听所有网卡 server.port=8080 server.address=0.0.0.0 数据源配置 - 连接本地MySQL服务 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/archive_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false spring.datasource.username=archive_user spring.datasource.password=User@Pass123 JPA/Hibernate 配置 spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect spring.jpa.hibernate.ddl-auto=update spring.jpa.show-sql=false 文件上传路径 - 指向服务器本地存储 file.upload.path=/data/archive/uploads ```

关键操作项：注意 server.address 必须为 0.0.0.0，否则局域网内其他电脑无法访问。同时，file.upload.path 建议配置在容量充足的数据盘上，并提前使用 mkdir -p /data/archive/uploads 创建目录。

4. 启动服务端

上传jar包至服务器 /opt/archive-server/app 目录，执行启动命令：

nohup java -jar /opt/archive-server/app/archive-system.jar --spring.config.location=/opt/archive-server/config/application.properties > /opt/archive-server/logs/sys.log 2>&1 &

四、 局域网版客户端连接配置

局域网版部署完成后，客户端（或其他PC上的浏览器）需要修改连接地址以指向服务器IP。

1. B/S架构（浏览器端）配置

无需安装软件，直接在浏览器地址栏输入：

http://[服务器内网IP]:8080

例如：http://192.168.1.100:8080。如果无法打开，请使用 ping 192.168.1.100 测试网络连通性，并检查服务器防火墙是否放行8080端口。

2. C/S架构（客户端软件）配置

如果软件包含独立的客户端安装包，安装完成后会在安装目录下生成 config.ini 或 application.properties。需要手动编辑该文件：

```ini 服务器地址配置 server.host=192.168.1.100 server.port=8080 如果客户端直连数据库模式（不推荐，仅用于老旧系统），则配置如下： db.type=mysql db.host=192.168.1.100 db.port=3306 db.name=archive_db db.user=archive_user db.pass=User@Pass123 ```

关键操作项：修改配置文件后，必须完全退出客户端程序（包括托盘图标）并重新启动，配置才会生效。登录时使用的账号密码由数据库中的 sys_user 表决定，通常默认管理员账号为 admin，密码 123456（具体以软件说明文档为准）。

五、 数据迁移与维护差异

部署上线后，两者的维护方式存在显著差异，以下是具体的操作指令。

1. 单机版数据备份

单机版数据即文件，备份操作极为简单，直接打包复制即可：

xcopy D:\ArchiveSystem\data D:\Backup\%date%\ /E /I /Y (Windows)

或者直接将 data 目录下的 .db 或 .mv.db 文件复制到U盘或移动硬盘。

2. 局域网版数据备份

局域网版依赖MySQL服务，必须使用 mysqldump 工具进行逻辑备份，确保数据一致性：

mysqldump -uarchive_user -p'User@Pass123' archive_db > /backup/archive_db_$(date +%Y%m%d).sql

恢复数据时，需先删除旧库或清空表，再执行导入：

mysql -uarchive_user -p'User@Pass123' archive_db < /backup/archive_db_20231001.sql

3. 常见故障排查

• 单机版常见报错：“Database is locked”。这是因为单机版文件型数据库不支持高并发写入。解决方法：确保同一时间只有一个程序实例在运行，或者检查是否有杀毒软件正在扫描 .db 文件。
• 局域网版常见报错：“Communications link failure”。这是典型的网络连接失败。解决步骤：
  1. 检查服务器IP是否变动（ip addr）。
  2. 检查MySQL服务是否存活（systemctl status mysqld）。
  3. 检查防火墙（firewall-cmd --list-all）。