一、前置准备
1.1 硬件环境要求
当前主流统信UOS支持的x86_64/ARM64架构设备均可，推荐配置：4核CPU、8GB内存、20GB可用磁盘空间。
1.2 系统安装确认
已安装统信UOS桌面版V20（专业版/家庭版均可，专业版更推荐）或V23 beta版，点击任务栏「设置」-「关于」可查看系统版本与架构。
1.3 软件环境准备（一键安装包优先）
- 统信UOS V20/V23桌面版自带「应用商店」，搜索并安装以下软件：
- Deepin Terminal（深度终端）（默认已安装，可按Ctrl+Alt+T快速打开）
- Java Development Kit 17（JDK17）：专业版/家庭版应用商店都有官方认证的龙蜥OpenJDK17/ Oracle JDK17替代版，直接点击「安装」即可
- MySQL 8.0：应用商店搜索「MySQL Server 8.0」，选择龙蜥社区开源认证版安装
- 验证软件是否安装成功，打开深度终端执行以下命令：
```bash
验证JDK版本，输出openjdk version "17.x.x"或类似内容即为成功
java -version
验证MySQL服务状态，输出Active: active (running)即为成功
sudo systemctl status mysqld
```
二、档案管理系统源码准备
2.1 获取适配前的基础源码
使用GitHub上开源的轻量级档案管理系统demo作为基础（适合快速上手适配），打开深度终端执行：
```bash
先安装Git（应用商店也可搜索安装）
sudo apt update && sudo apt install -y git
克隆轻量级demo到当前用户的「文档」目录
cd ~/Documents && git clone https://github.com/xiaobai2024/light-archive-demo.git
```
2.2 解压并进入项目目录
克隆完成后无需解压，直接进入：
```bash
cd light-archive-demo
```
三、统信UOS核心适配步骤
3.1 修改MySQL数据库配置
应用商店安装的MySQL默认root密码为空？不，龙蜥版MySQL首次安装需重置临时密码：
- 获取临时密码：
```bash
sudo grep 'temporary password' /var/log/mysqld.log
```
- 登录MySQL并修改root密码（密码需包含大小写字母、数字、特殊字符，至少8位）：
```bash
mysql -u root -p
输入临时密码后回车，进入MySQL命令行
ALTER USER 'root'@'localhost' IDENTIFIED BY 'Uos@2024Archive';
FLUSH PRIVILEGES;
EXIT;
```
- 创建档案系统专用数据库：
```bash
mysql -u root -pUos@2024Archive
进入后执行
CREATE DATABASE light_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
EXIT;
```
- 修改项目配置文件，编辑`src/main/resources/application.yml`：
```bash
用系统自带的文本编辑器gedit打开
gedit src/main/resources/application.yml
```
- 将配置文件中的数据库部分替换为以下完整内容：
```yaml
spring:
datasource:
url: jdbc:mysql://localhost:3306/light_archive?useUnicode=true&characterEncoding=utf8mb4&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
username: root
password: Uos@2024Archive
driver-class-name: com.mysql.cj.jdbc.Driver
jpa:
hibernate:
ddl-auto: update
show-sql: false
```
3.2 修改前端资源路径适配统信UOS
该demo前端使用静态HTML/CSS/JS，默认部署路径适配Linux通用，但需确认文件权限：
```bash
给整个项目目录添加读写执行权限
sudo chmod -R 755 ~/Documents/light-archive-demo
```
3.3 修改Maven镜像源为国内源（统信UOS默认源下载依赖慢）
- 先检查项目是否自带Maven wrapper（该demo已带），无需单独安装Maven；
- 编辑Maven配置文件`~/.m2/settings.xml`（如果没有则新建）：
```bash
新建目录（如果不存在）
mkdir -p ~/.m2
编辑配置文件
gedit ~/.m2/settings.xml
```
- 粘贴以下完整配置内容：
```xml
aliyunmaven
阿里云公共仓库
https://maven.aliyun.com/repository/public
```
四、项目打包与部署验证
4.1 项目打包
使用Maven wrapper打包成独立JAR文件（无需额外配置Web容器）：
```bash
在项目根目录执行
./mvnw clean package -DskipTests
```
4.2 启动项目验证适配
- 打包完成后，JAR文件会生成在`target`目录下，文件名格式为`light-archive-demo-x.x.x.jar`（x.x.x为版本号，demo当前为1.0.0）；
- 启动JAR文件：
```bash
cd ~/Documents/light-archive-demo/target
java -jar light-archive-demo-1.0.0.jar
```
- 等待10-20秒，看到终端输出`Started LightArchiveDemoApplication in x.xxx seconds`即为启动成功；
- 打开统信UOS自带的浏览器（如深度浏览器），访问`http://localhost:8080`，即可看到档案管理系统登录界面（默认账号admin，密码123456）；
五、设置系统自启动（可选但实用）
5.1 创建systemd服务文件
用gedit创建`/etc/systemd/system/light-archive.service`：
```bash
sudo gedit /etc/systemd/system/light-archive.service
```
5.2 粘贴完整服务配置
注意将「your_username」替换为当前统信UOS的用户名（可在深度终端执行`whoami`查看）：
```ini
[Unit]
Description=Light Archive Management System
After=network.target mysqld.service
[Service]
Type=simple
User=your_username
WorkingDirectory=/home/your_username/Documents/light-archive-demo/target
ExecStart=/usr/bin/java -jar /home/your_username/Documents/light-archive-demo/target/light-archive-demo-1.0.0.jar
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
```
5.3 启用并启动服务
```bash
重载systemd配置
sudo systemctl daemon-reload
启用自启动
sudo systemctl enable light-archive.service
启动服务
sudo systemctl start light-archive.service
查看服务状态
sudo systemctl status light-archive.service
```
六、常见问题排查
- JDK版本不匹配：确保安装的是JDK17，若有多个版本，执行`sudo update-alternatives --config java`切换；
- MySQL服务未启动：执行`sudo systemctl start mysqld`；
- 8080端口被占用：修改`application.yml`中的`server.port`为8081等未被占用的端口，重新打包部署；
- Maven下载依赖慢：确认`~/.m2/settings.xml`配置正确，可重启深度终端后再打包；
微信咨询
电话联系
QQ客服
微信咨询一对一服务