目录前言一、背景二、创建目录结构1. 创建标准化目录结构2. 创建配置文件模板3. 利用硬链接保护配置文件4. 软链接统一日志路径5. 压缩归档日志注意事项与常见问题总结前言RuoYi若依是一款基于 Spring Boot 的权限管理系统广泛应用于企业级后台管理系统的快速开发。一个清晰、规范的目录结构对于项目的可维护性、部署效率和团队协作至关重要。本文旨在为 RuoYi 项目提供一套标准化的目录初始化方案帮助开发者快速搭建符合生产环境要求的基础架构为后续的配置管理、日志收集和备份恢复等工作奠定坚实基础。一、背景本文旨在介绍 RuoYi 项目目录结构初始化命令的背景、用途及注意事项。通过本文读者可以了解如何快速创建 RuoYi 项目所需的标准化目录结构为后续的部署、配置和运维工作奠定基础。文中提供的命令示例可直接用于生产环境帮助开发者规范项目目录管理提升开发效率。注意以下是在 Rocky 10 Server 版下的 root 权限下进行的。二、创建目录结构1. 创建标准化目录结构1.1 创建若依项目目录mkdir -p /opt/ruoyi/{backend,frontend,logs,config,backup}1.2 验证目录结构tree /opt/ruoyi2. 创建配置文件模板2.1 使用 Vim 文本编辑器打开或创建位于/opt/ruoyi/config/目录下的application.yml配置文件。vim /opt/ruoyi/config/application.yml2.2 使用 cat 命令查看/opt/ruoyi/config/application.yml这个配置文件的全部内容。cat /opt/ruoyi/config/application.yml3. 利用硬链接保护配置文件3.1 利用硬链接保护配置文件ln /opt/ruoyi/config/application.yml /opt/ruoyi/config/application.yml.bak3.2 通过 ls -li 查看硬链接是否建立成功还有它们的 iNodels -li /opt/ruoyi/config/application.yml.bak /opt/ruoyi/config/application.yml4. 软链接统一日志路径4.1 软链接统一日志路径ln -s /opt/ruoyi/logs /var/log/ruoyi4.2 通过 ls -l 查看软链接是否建立成功ls -l /var/log/ruoyi5. 压缩归档日志5.1 压缩日志通过date%F命令来区分压缩目录的但是可能会出现以下问题是因为没安装 tartar -czvf /opt/ruoyi/backup/ruoyi-logs-$(date %F).tar.gz /opt/ruoyi/logs5.2 安装 tardnf install -y tar5.3 验证结果是否压缩成功注意这不是错误当你使用tar打包绝对路径以/开头的路径时tar 会出于安全考虑自动把路径开头的/去掉把绝对路径变成相对路径。5.4 通过 tar -tzvf 命令查看压缩包里面的内容tar -tzvf /opt/ruoyi/backup/ruoyi-logs-*.tar.gz注意事项与常见问题在实际部署和运维 RuoYi 项目时以下实践建议和常见问题需要特别注意生产环境使用非 root 用户的建议出于安全考虑建议在生产环境中使用普通用户运行 RuoYi 服务。可以通过以下步骤实现ul创建专用用户useradd -r -s /bin/false ruoyi修改目录权限chown -R ruoyi:ruoyi /opt/ruoyi调整日志目录权限chown -R ruoyi:ruoyi /var/log/ruoyi如果使用软链接硬链接与软链接的区别及适用场景硬链接多个文件名指向同一个 inode删除原文件不影响硬链接文件。适用于配置文件备份因为硬链接不占用额外磁盘空间且与原文件同步更新。软链接类似 Windows 快捷方式是一个独立的文件指向目标路径。适用于统一日志路径方便系统工具如 logrotate统一管理。定期日志归档的 crontab 配置示例建议设置定时任务自动压缩归档日志避免日志文件无限增长。# 每天凌晨 2 点压缩前一天的日志 0 2 * * * tar -czf /opt/ruoyi/backup/ruoyi-logs-$(date -d yesterday \%F).tar.gz /opt/ruoyi/logs/*.log 2/dev/null # 每周日凌晨 3 点清理超过 30 天的备份 0 3 * * 0 find /opt/ruoyi/backup -name ruoyi-logs-*.tar.gz -mtime 30 -delete配置文件权限管理建议配置文件应设置为只读权限chmod 644 /opt/ruoyi/config/application.yml敏感配置如数据库密码建议使用环境变量或配置中心避免明文存储在文件中定期备份配置文件到安全位置可使用版本控制系统如 Git管理配置变更历史快速导航返回目录顶部总结本文详细介绍了 RuoYi 项目目录结构初始化的五个核心步骤创建标准化目录结构建立 backend、frontend、logs、config、backup 等核心目录。创建配置文件模板初始化 application.yml 配置文件为后续服务配置做好准备。利用硬链接保护配置文件通过硬链接实现配置文件的快速备份与恢复。软链接统一日志路径将项目日志目录链接到系统标准日志位置便于集中管理。压缩归档日志使用 tar 命令定期压缩日志文件节省存储空间并保留历史记录。