从零搭建适配中小单位的轻量天门数字档案馆系统快速落地指南

前置准备（硬件+软件环境全明确）

先确认你手上的硬件和软件能跑起来，避免踩坑：

• 硬件要求（最低配置，5000份以下档案够用）：双核2.4GHz以上CPU、4G以上内存、100G以上可用固态存储（机械盘做备份盘）
• 软件要求（全开源免费，无版权问题）：Windows Server 2016/2019/2022 或 Ubuntu 22.04 LTS（本文用Windows 2022演示，命令适配同思路转Linux）
• 轻量天门数档替代方案选择：中小单位预算/人手有限，选开源框架「档案之星Lite」二次适配成天门风格的轻量系统，下载地址：https://gitee.com/starfile/starfile-lite/releases/tag/v1.0.3

第一步：基础服务部署（数据库+Web容器）

1.1 安装MySQL 8.0

MySQL是轻量数档的核心数据库，必须配置utf8mb4字符集存中文生僻字：

1. 直接下载MySQL 8.0.36 Windows免安装版：https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.36-winx64.zip
2. 解压到D:\mysql8，创建my.ini配置文件，内容如下，可直接复制：

   

   [mysqld]
   设置3306端口
   port=3306
   设置mysql的安装目录
   basedir=D:\mysql8
   设置mysql数据库的数据的存放目录
   datadir=D:\mysql8\data
   允许最大连接数
   max_connections=200
   允许连接失败的次数
   max_connect_errors=10
   服务端使用的字符集默认为utf8mb4
   character-set-server=utf8mb4
   创建新表时将使用的默认存储引擎
   default-storage-engine=INNODB
   默认使用“mysql_native_password”插件认证
   default_authentication_plugin=mysql_native_password
   [mysql]
   设置mysql客户端默认字符集
   default-character-set=utf8mb4
   [client]
   设置mysql客户端连接服务端时默认使用的端口
   port=3306
   default-character-set=utf8mb4

3. 管理员身份运行CMD，依次执行以下命令：

   cd D:\mysql8\bin
   mysqld --initialize --console  注意最后一行会输出临时密码，比如root@localhost: xxxxxxxx，一定要记！
   mysqld --install
   net start mysql
   mysql -u root -p  输入临时密码登录
   ALTER USER 'root'@'localhost' IDENTIFIED BY 'TianMen2024@dangan';  设置固定密码，建议带大小写+数字+符号
   CREATE DATABASE starfile_tianmen CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;  创建适配的数据库
   exit

1.2 部署Web容器（Tomcat 9.0）

档案之星Lite是Java开发的，用Tomcat 9最稳定：

1. 直接下载Tomcat 9.0.87 Windows免安装版：https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.87/bin/apache-tomcat-9.0.87-windows-x64.zip
2. 解压到D:\tomcat9，用记事本打开D:\tomcat9\conf\server.xml，找到标签，修改为：

第二步：轻量数档二次适配+部署

2.1 适配天门风格（10分钟快速替换）

1. 解压「档案之星Lite v1.0.3」压缩包，找到webapps/ROOT文件夹内的static/images和templates/index.html
2. 天门风格替换操作：
   • 替换static/images/logo.png为天门档案馆logo（建议尺寸200x60px，透明底）
   • 替换static/images/banner.jpg为天门档案馆大厅/数字化场景图（建议尺寸1920x400px）
   • 用记事本打开templates/index.html，找到「XX区（县）数字档案馆」字样，全局替换为「天门数字档案馆」

2.2 配置数据库连接

打开webapps/ROOT/WEB-INF/classes/application.yml，替换所有内容为：

server:
port: 8080  这里的端口不影响，因为我们要通过Tomcat部署，修改后会被覆盖
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/starfile_tianmen?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai&useSSL=false
username: root
password: TianMen2024@dangan
jpa:
hibernate:
ddl-auto: update
show-sql: false
servlet:
multipart:
max-file-size: 50MB  单个档案附件最大50MB
max-request-size: 200MB  单次上传附件总大小200MB
file:
upload-path: D:\dangan_data  档案附件存储目录，必须提前创建
backup-path: E:\dangan_backup  备份目录，必须提前创建（如果有机械备份盘）

2.3 正式部署到Tomcat

1. 提前创建D:\dangan_data和E:\dangan_backup文件夹
2. 删除D:\tomcat9\webapps下原有的ROOT文件夹
3. 把解压后并适配好的webapps/ROOT文件夹复制到D:\tomcat9\webapps下
4. 管理员身份运行CMD，执行：

   cd D:\tomcat9\bin
   startup.bat

5. 等待1-2分钟，看到控制台输出「Started StarfileLiteApplication in X.XXX seconds」即为部署成功

第三步：系统初始化+档案录入测试

3.1 系统初始化

1. 打开任意浏览器，输入「http://你的电脑IP/」（局域网访问用局域网IP，本机访问用127.0.0.1）
2. 首次登录默认账号：admin，默认密码：123456
3. 登录后强制修改密码，建议设置成带大小写+数字+符号的强密码
4. 进入「系统管理-档案分类」，点击「一键导入标准分类」，选择「综合档案馆标准分类」（适配天门数档常用门类）

3.2 档案录入测试

1. 进入「档案管理-新增档案」，填写必填项：档案号、题名、责任者、日期、保管期限（永久/长期/短期）、密级（公开/内部/秘密/机密/绝密）、分类（比如文书档案-永久-2024）
2. 上传PDF/Word/JPG等格式的档案附件（单个≤50MB）
3. 点击「保存」，返回「档案管理-档案列表」，查看是否成功录入并能预览附件

第四步：基础安全设置+定时备份

4.1 基础安全设置

• 修改MySQL端口：编辑my.ini，把3306改成3307，重启MySQL服务
• 修改Tomcat shutdown端口：编辑D:\tomcat9\conf\server.xml，找到标签，改成8006，重启Tomcat
• 创建普通用户：进入「系统管理-用户管理」，新增档案录入员、档案查询员等角色并分配权限，不要直接用admin账号日常操作

4.2 定时备份（Windows任务计划程序）

1. 创建backup_dangan.bat备份脚本，内容如下，可直接复制：

   @echo off
   set date_str=%date:~0,4%%date:~5,2%%date:~8,2%
   set time_str=%time:~0,2%%time:~3,2%%time:~6,2%
   set time_str=%time_str: =0%
   rem 备份数据库
   "D:\mysql8\bin\mysqldump" -u root -pTianMen2024@dangan starfile_tianmen > "E:\dangan_backup\db_%date_str%_%time_str%.sql"
   rem 备份附件
   xcopy "D:\dangan_data" "E:\dangan_backup\file_%date_str%_%time_str%" /e /i /y
   rem 删除30天前的备份
   forfiles /p "E:\dangan_backup" /m .sql /d -30 /c "cmd /c del @path"
   forfiles /p "E:\dangan_backup" /m file_ /d -30 /c "cmd /c rd /s /q @path"

2. 把backup_dangan.bat放到D:\tomcat9\bin下
3. 打开「Windows管理工具-任务计划程序」，创建基本任务：
   • 名称：天门数档每日备份
   • 触发器：每天，凌晨2点
   • 操作：启动程序，程序路径选D:\tomcat9\bin\backup_dangan.bat
   • 条件：勾选「不管用户是否登录都要运行」「使用最高权限运行」

常见问题快速解决

• Tomcat启动失败：检查80端口是否被占用，打开CMD执行「netstat -ano | findstr 80」，找到占用PID后在任务管理器结束对应进程
• 附件无法上传/预览：检查D:\dangan_data文件夹是否给了Users用户组完全控制权限，右键文件夹-属性-安全-编辑-添加-输入Users-确定-勾选完全控制
• 数据库连接失败：检查application.yml的数据库密码是否正确，MySQL服务是否启动