[Feat]:服务器备份功能完善

[starsers]

检查

• 我确认我使用的是 最新版本 的MSLX.
• 我确认我提交的功能请求没有人提交过.
• 我认为这个功能是可以实现的，是对大部分人有用的.

描述功能

feature 服务器备份功能完善

现有的备份功能只能提供定期备份存档，备份间隔固定 且能设置最多保留多少份存档

我认为可以添加一个将过去的备份分离出来，如我想要每10分钟保存一次备份，保存24小时的，再将每天的第一个（或最后一个）备份单独提取出来，最多存个10天，再将每月的第一个或最后一个备份提取出来 等等 如有必要还可以添加老备份压缩功能（毕竟大部分备份内容是一致的，理论上压缩率会很高）

本来想尝试通过控制台命令调用cp指令实现，但是好像无法调用

实现方法

添加多个目录，按常规备份、日期归档备份分开 将日期归档备份设置集成到服务器设置，定时任务部分可保留原样作为常规备份

[luluxiaoyu]

有点乱。有什么相关实现了此功能的模组/插件/软件做参考？

…

---Original--- From: ***@***.***> Date: Thu, Mar 12, 2026 00:04 AM To: ***@***.***>; Cc: ***@***.***>; Subject: [MSLTeam/MSLX] [Feat]: (Issue #79) starsers created an issue (MSLTeam/MSLX#79) 检查 我确认我使用的是 最新版本 的MSLX. 我确认我提交的功能请求没有人提交过. 我认为这个功能是可以实现的，是对大部分人有用的. 描述功能 feature 服务器备份功能完善 现有的备份功能只能提供定期备份存档，备份间隔固定 且能设置最多保留多少份存档 我认为可以添加一个将过去的备份分离出来，如我想要每10分钟保存一次备份，保存24小时的，再将每天的第一个（或最后一个）备份单独提取出来，最多存个10天，再将每月的第一个或最后一个备份提取出来 等等 如有必要还可以添加老备份压缩功能（毕竟大部分备份内容是一致的，理论上压缩率会很高） 本来想尝试通过控制台命令调用cp指令实现，但是好像无法调用 实现方法 添加多个目录，按常规备份、日期归档备份分开 将日期归档备份设置集成到服务器设置，定时任务部分可保留原样作为常规备份 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[starsers]

有点乱。有什么相关实现了此功能的模组/插件/软件做参考？
…

我让ai整理了下我的需求，麻烦看看这是否表述的足够清晰

一、Issue #79 精准需求总结

核心诉求

为 MSLX 服务器的备份功能做分层级、多维度的完善，解决现有备份功能仅支持「固定间隔+固定保留份数」的单一模式问题，具体需求如下：

1. 分层备份策略：
   • 基础层：保留高频短周期备份（如每10分钟1次，留存24小时）；
   • 归档层1：从日维度提取备份（每天首个/最后1个备份），留存10天；
   • 归档层2：从月维度提取备份（每月首个/最后1个备份），支持长期留存；
2. 备份优化：添加老备份自动压缩功能（利用备份内容高相似度提升压缩率）；
3. 实现约束：曾尝试通过控制台调用 cp 指令手动实现，但调用失败，希望框架原生支持该分层备份逻辑；
4. 配置集成：将日期归档备份的规则（留存时长、提取规则）集成到服务器设置中，保留原有定时任务作为「常规备份」基础。

二、类似应用/参考案例

这些工具/软件已实现同类分层备份逻辑，可作为参考：

应用/工具	核心匹配点
rsync + cron（Linux）	支持按分钟/小时/天/月配置分层定时任务，结合 tar 实现备份压缩，可自定义留存规则
Time Machine（macOS）	增量备份+分层归档：小时级近期备份、天级中期备份、月级长期备份，自动清理旧备份
Duplicati	开源跨平台备份工具，支持「时间轴分层备份」+ 重复数据删除+压缩，可自定义留存策略
宝塔面板备份功能	支持「定时备份+按天/周/月归档」+ 备份压缩+自定义留存份数，配置可视化

三、伪代码实现（核心分层备份逻辑）

以下伪代码基于 Python 实现（适配服务器端定时任务场景），覆盖「分层备份+自动压缩+规则配置」核心逻辑，可直接映射到 MSLX 框架的备份模块：

import os
import time
import shutil
import tarfile
from datetime import datetime, timedelta

class MSLXServerBackup:
    def __init__(self, config):
        # 初始化配置（可集成到MSLX服务器设置）
        self.backup_src = config["backup_source"]  # 待备份目录
        self.base_backup_dir = config["base_dir"]  # 基础备份根目录
        # 分层备份规则配置
        self.rules = {
            "short_term": {  # 短周期（10分钟/次，留存24小时）
                "interval_min": 10,
                "retention_hours": 24,
                "dir": os.path.join(self.base_backup_dir, "short_term")
            },
            "daily": {  # 日归档（提取每日首个/最后1个，留存10天）
                "extract_rule": "last",  # last/first：提取每日最后/首个备份
                "retention_days": 10,
                "dir": os.path.join(self.base_backup_dir, "daily")
            },
            "monthly": {  # 月归档（提取每月首个/最后1个，长期留存）
                "extract_rule": "first",
                "retention_days": 90,  # 示例：留存90天
                "dir": os.path.join(self.base_backup_dir, "monthly")
            }
        }
        # 创建备份目录（确保存在）
        for rule in self.rules.values():
            os.makedirs(rule["dir"], exist_ok=True)

    def create_short_term_backup(self):
        """创建短周期基础备份（每10分钟执行一次）"""
        # 1. 生成备份文件名（带时间戳）
        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
        backup_filename = f"backup_{timestamp}"
        backup_path = os.path.join(self.rules["short_term"]["dir"], backup_filename)
        
        # 2. 复制备份源文件（替代手动cp指令，避免调用失败）
        try:
            if os.path.isdir(self.backup_src):
                shutil.copytree(self.backup_src, backup_path)
            else:
                shutil.copy2(self.backup_src, backup_path)
            print(f"短周期备份创建成功：{backup_path}")
            # 3. 完成短周期备份后，触发归档逻辑
            self.archive_to_daily()
            self.archive_to_monthly()
            # 4. 清理过期短周期备份
            self.clean_expired_backups("short_term")
        except Exception as e:
            print(f"短周期备份失败：{str(e)}")

    def archive_to_daily(self):
        """从短周期备份中提取日归档备份"""
        short_term_dir = self.rules["short_term"]["dir"]
        daily_dir = self.rules["daily"]["dir"]
        extract_rule = self.rules["daily"]["extract_rule"]
        
        # 1. 获取当天所有短周期备份（按时间排序）
        today = datetime.now().strftime("%Y%m%d")
        today_backups = [
            f for f in os.listdir(short_term_dir)
            if f.startswith(f"backup_{today}") and os.path.isdir(os.path.join(short_term_dir, f))
        ]
        if not today_backups:
            return
        
        # 2. 按提取规则选备份（first=最早，last=最晚）
        today_backups.sort()
        target_backup = today_backups[0] if extract_rule == "first" else today_backups[-1]
        target_backup_path = os.path.join(short_term_dir, target_backup)
        
        # 3. 复制到日归档目录（避免重复归档：当天仅存1份）
        daily_backup_name = f"daily_backup_{today}"
        daily_backup_path = os.path.join(daily_dir, daily_backup_name)
        if not os.path.exists(daily_backup_path):
            shutil.copytree(target_backup_path, daily_backup_path)
            # 压缩老备份（仅压缩已归档的非当日备份）
            self.compress_backup(daily_backup_path)
            print(f"日归档备份创建成功：{daily_backup_path}")
        # 4. 清理过期日归档备份
        self.clean_expired_backups("daily")

    def archive_to_monthly(self):
        """从日归档备份中提取月归档备份"""
        daily_dir = self.rules["daily"]["dir"]
        monthly_dir = self.rules["monthly"]["dir"]
        extract_rule = self.rules["monthly"]["extract_rule"]
        
        # 1. 获取当月所有日归档备份
        current_month = datetime.now().strftime("%Y%m")
        monthly_backups = [
            f for f in os.listdir(daily_dir)
            if f.startswith(f"daily_backup_{current_month}") and os.path.isdir(os.path.join(daily_dir, f))
        ]
        if not monthly_backups:
            return
        
        # 2. 按规则选备份并归档
        monthly_backups.sort()
        target_backup = monthly_backups[0] if extract_rule == "first" else monthly_backups[-1]
        target_backup_path = os.path.join(daily_dir, target_backup)
        monthly_backup_name = f"monthly_backup_{current_month}"
        monthly_backup_path = os.path.join(monthly_dir, monthly_backup_name)
        
        if not os.path.exists(monthly_backup_path):
            shutil.copytree(target_backup_path, monthly_backup_path)
            self.compress_backup(monthly_backup_path)
            print(f"月归档备份创建成功：{monthly_backup_path}")
        # 3. 清理过期月归档备份
        self.clean_expired_backups("monthly")

    def compress_backup(self, backup_path):
        """压缩备份目录（提升存储效率）"""
        try:
            # 生成压缩包名（替换原目录，压缩后删除原目录）
            tar_path = f"{backup_path}.tar.gz"
            with tarfile.open(tar_path, "w:gz", compresslevel=9) as tar:
                tar.add(backup_path, arcname=os.path.basename(backup_path))
            # 删除原未压缩目录
            shutil.rmtree(backup_path)
            print(f"备份压缩完成：{tar_path}")
        except Exception as e:
            print(f"备份压缩失败：{str(e)}")

    def clean_expired_backups(self, backup_type):
        """清理过期备份（按不同层级规则）"""
        rule = self.rules[backup_type]
        backup_dir = rule["dir"]
        now = datetime.now()
        
        for item in os.listdir(backup_dir):
            item_path = os.path.join(backup_dir, item)
            # 获取文件/目录的创建时间
            create_time = datetime.fromtimestamp(os.path.getctime(item_path))
            
            # 按不同层级判断是否过期
            if backup_type == "short_term":
                expire_time = now - timedelta(hours=rule["retention_hours"])
            else:
                expire_time = now - timedelta(days=rule["retention_days"])
            
            if create_time < expire_time:
                # 删除过期备份（支持压缩包和目录）
                if os.path.isdir(item_path):
                    shutil.rmtree(item_path)
                else:
                    os.remove(item_path)
                print(f"过期备份已清理：{item_path}")

# ---------------------- 调用示例 ----------------------
if __name__ == "__main__":
    # 配置示例（可集成到MSLX服务器设置界面）
    backup_config = {
        "backup_source": "/path/to/mslx/server/data",  # 待备份的服务器数据目录
        "base_dir": "/path/to/mslx/backup"  # 备份根目录
    }
    
    # 初始化备份管理器
    backup_manager = MSLXServerBackup(backup_config)
    
    # 执行短周期备份（实际部署时可配置定时任务，如每10分钟调用一次）
    backup_manager.create_short_term_backup()

伪代码关键说明

1. 替代 cp 指令：用 Python 内置的 shutil.copytree/copy2 替代手动调用 cp，避免控制台指令调用失败的问题；
2. 分层逻辑：短周期备份作为基础，自动触发日/月归档，且每层都有独立的留存规则和清理逻辑；
3. 压缩优化：仅对归档后的备份进行压缩（利用内容相似度提升压缩率），且压缩后自动删除原目录；
4. 配置化：所有规则（间隔、留存时长、提取规则）均可配置，可直接集成到 MSLX 服务器的设置界面。

总结

1. 核心需求：为 MSLX 服务器备份功能添加「短周期+日归档+月归档」的分层策略，支持备份压缩，替代手动 cp 指令实现原生备份；
2. 实现核心：以短周期备份为基础，按时间维度自动提取归档备份，每层配置独立的留存/清理规则，内置压缩逻辑；
3. 参考方向：可借鉴 Time Machine/宝塔面板的分层备份思路，伪代码通过 Python 实现了核心逻辑，可适配 MSLX 框架的定时任务体系。

[luluxiaoyu]

说实在不觉得特别有意义且工程量较大。 目前我没发现有相关的模组/插件有此类备份功能实现，基本都是单一的定时备份。

…

---Original--- From: ***@***.***&gt; Date: Thu, Mar 12, 2026 12:41 PM To: ***@***.***&gt;; Cc: ***@***.******@***.***&gt;; Subject: Re: [MSLTeam/MSLX] [Feat]: (Issue #79) starsers left a comment (MSLTeam/MSLX#79) 有点乱。有什么相关实现了此功能的模组/插件/软件做参考？ … 我让ai整理了下我的需求，麻烦看看这是否表述的足够清晰 一、Issue #79 精准需求总结 核心诉求 为 MSLX 服务器的备份功能做分层级、多维度的完善，解决现有备份功能仅支持「固定间隔+固定保留份数」的单一模式问题，具体需求如下： 分层备份策略： 基础层：保留高频短周期备份（如每10分钟1次，留存24小时）； 归档层1：从日维度提取备份（每天首个/最后1个备份），留存10天； 归档层2：从月维度提取备份（每月首个/最后1个备份），支持长期留存； 备份优化：添加老备份自动压缩功能（利用备份内容高相似度提升压缩率）； 实现约束：曾尝试通过控制台调用 cp 指令手动实现，但调用失败，希望框架原生支持该分层备份逻辑； 配置集成：将日期归档备份的规则（留存时长、提取规则）集成到服务器设置中，保留原有定时任务作为「常规备份」基础。 二、类似应用/参考案例 这些工具/软件已实现同类分层备份逻辑，可作为参考： 应用/工具 核心匹配点 rsync + cron（Linux） 支持按分钟/小时/天/月配置分层定时任务，结合 tar 实现备份压缩，可自定义留存规则 Time Machine（macOS） 增量备份+分层归档：小时级近期备份、天级中期备份、月级长期备份，自动清理旧备份 Duplicati 开源跨平台备份工具，支持「时间轴分层备份」+ 重复数据删除+压缩，可自定义留存策略 宝塔面板备份功能 支持「定时备份+按天/周/月归档」+ 备份压缩+自定义留存份数，配置可视化 三、伪代码实现（核心分层备份逻辑） 以下伪代码基于 Python 实现（适配服务器端定时任务场景），覆盖「分层备份+自动压缩+规则配置」核心逻辑，可直接映射到 MSLX 框架的备份模块： import os import time import shutil import tarfile from datetime import datetime, timedelta class MSLXServerBackup: def __init__(self, config): # 初始化配置（可集成到MSLX服务器设置） self.backup_src = config["backup_source"] # 待备份目录 self.base_backup_dir = config["base_dir"] # 基础备份根目录 # 分层备份规则配置 self.rules = { "short_term": { # 短周期（10分钟/次，留存24小时） "interval_min": 10, "retention_hours": 24, "dir": os.path.join(self.base_backup_dir, "short_term") }, "daily": { # 日归档（提取每日首个/最后1个，留存10天） "extract_rule": "last", # last/first：提取每日最后/首个备份 "retention_days": 10, "dir": os.path.join(self.base_backup_dir, "daily") }, "monthly": { # 月归档（提取每月首个/最后1个，长期留存） "extract_rule": "first", "retention_days": 90, # 示例：留存90天 "dir": os.path.join(self.base_backup_dir, "monthly") } } # 创建备份目录（确保存在） for rule in self.rules.values(): os.makedirs(rule["dir"], exist_ok=True) def create_short_term_backup(self): """创建短周期基础备份（每10分钟执行一次）""" # 1. 生成备份文件名（带时间戳） timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") backup_filename = f"backup_{timestamp}" backup_path = os.path.join(self.rules["short_term"]["dir"], backup_filename) # 2. 复制备份源文件（替代手动cp指令，避免调用失败） try: if os.path.isdir(self.backup_src): shutil.copytree(self.backup_src, backup_path) else: shutil.copy2(self.backup_src, backup_path) print(f"短周期备份创建成功：{backup_path}") # 3. 完成短周期备份后，触发归档逻辑 self.archive_to_daily() self.archive_to_monthly() # 4. 清理过期短周期备份 self.clean_expired_backups("short_term") except Exception as e: print(f"短周期备份失败：{str(e)}") def archive_to_daily(self): """从短周期备份中提取日归档备份""" short_term_dir = self.rules["short_term"]["dir"] daily_dir = self.rules["daily"]["dir"] extract_rule = self.rules["daily"]["extract_rule"] # 1. 获取当天所有短周期备份（按时间排序） today = datetime.now().strftime("%Y%m%d") today_backups = [ f for f in os.listdir(short_term_dir) if f.startswith(f"backup_{today}") and os.path.isdir(os.path.join(short_term_dir, f)) ] if not today_backups: return # 2. 按提取规则选备份（first=最早，last=最晚） today_backups.sort() target_backup = today_backups[0] if extract_rule == "first" else today_backups[-1] target_backup_path = os.path.join(short_term_dir, target_backup) # 3. 复制到日归档目录（避免重复归档：当天仅存1份） daily_backup_name = f"daily_backup_{today}" daily_backup_path = os.path.join(daily_dir, daily_backup_name) if not os.path.exists(daily_backup_path): shutil.copytree(target_backup_path, daily_backup_path) # 压缩老备份（仅压缩已归档的非当日备份） self.compress_backup(daily_backup_path) print(f"日归档备份创建成功：{daily_backup_path}") # 4. 清理过期日归档备份 self.clean_expired_backups("daily") def archive_to_monthly(self): """从日归档备份中提取月归档备份""" daily_dir = self.rules["daily"]["dir"] monthly_dir = self.rules["monthly"]["dir"] extract_rule = self.rules["monthly"]["extract_rule"] # 1. 获取当月所有日归档备份 current_month = datetime.now().strftime("%Y%m") monthly_backups = [ f for f in os.listdir(daily_dir) if f.startswith(f"daily_backup_{current_month}") and os.path.isdir(os.path.join(daily_dir, f)) ] if not monthly_backups: return # 2. 按规则选备份并归档 monthly_backups.sort() target_backup = monthly_backups[0] if extract_rule == "first" else monthly_backups[-1] target_backup_path = os.path.join(daily_dir, target_backup) monthly_backup_name = f"monthly_backup_{current_month}" monthly_backup_path = os.path.join(monthly_dir, monthly_backup_name) if not os.path.exists(monthly_backup_path): shutil.copytree(target_backup_path, monthly_backup_path) self.compress_backup(monthly_backup_path) print(f"月归档备份创建成功：{monthly_backup_path}") # 3. 清理过期月归档备份 self.clean_expired_backups("monthly") def compress_backup(self, backup_path): """压缩备份目录（提升存储效率）""" try: # 生成压缩包名（替换原目录，压缩后删除原目录） tar_path = f"{backup_path}.tar.gz" with tarfile.open(tar_path, "w:gz", compresslevel=9) as tar: tar.add(backup_path, arcname=os.path.basename(backup_path)) # 删除原未压缩目录 shutil.rmtree(backup_path) print(f"备份压缩完成：{tar_path}") except Exception as e: print(f"备份压缩失败：{str(e)}") def clean_expired_backups(self, backup_type): """清理过期备份（按不同层级规则）""" rule = self.rules[backup_type] backup_dir = rule["dir"] now = datetime.now() for item in os.listdir(backup_dir): item_path = os.path.join(backup_dir, item) # 获取文件/目录的创建时间 create_time = datetime.fromtimestamp(os.path.getctime(item_path)) # 按不同层级判断是否过期 if backup_type == "short_term": expire_time = now - timedelta(hours=rule["retention_hours"]) else: expire_time = now - timedelta(days=rule["retention_days"]) if create_time < expire_time: # 删除过期备份（支持压缩包和目录） if os.path.isdir(item_path): shutil.rmtree(item_path) else: os.remove(item_path) print(f"过期备份已清理：{item_path}") # ---------------------- 调用示例 ---------------------- if __name__ == "__main__": # 配置示例（可集成到MSLX服务器设置界面） backup_config = { "backup_source": "/path/to/mslx/server/data", # 待备份的服务器数据目录 "base_dir": "/path/to/mslx/backup" # 备份根目录 } # 初始化备份管理器 backup_manager = MSLXServerBackup(backup_config) # 执行短周期备份（实际部署时可配置定时任务，如每10分钟调用一次） backup_manager.create_short_term_backup() 伪代码关键说明 替代 cp 指令：用 Python 内置的 shutil.copytree/copy2 替代手动调用 cp，避免控制台指令调用失败的问题； 分层逻辑：短周期备份作为基础，自动触发日/月归档，且每层都有独立的留存规则和清理逻辑； 压缩优化：仅对归档后的备份进行压缩（利用内容相似度提升压缩率），且压缩后自动删除原目录； 配置化：所有规则（间隔、留存时长、提取规则）均可配置，可直接集成到 MSLX 服务器的设置界面。 总结 核心需求：为 MSLX 服务器备份功能添加「短周期+日归档+月归档」的分层策略，支持备份压缩，替代手动 cp 指令实现原生备份； 实现核心：以短周期备份为基础，按时间维度自动提取归档备份，每层配置独立的留存/清理规则，内置压缩逻辑； 参考方向：可借鉴 Time Machine/宝塔面板的分层备份思路，伪代码通过 Python 实现了核心逻辑，可适配 MSLX 框架的定时任务体系。 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: ***@***.***&gt;

[starsers]

说实在不觉得特别有意义且工程量较大。
目前我没发现有相关的模组/插件有此类备份功能实现，基本都是单一的定时备份。
…

那我尝试自己写吧

对于没有什么特别的意义 回复：假如一个为朋友开的服务器，中途被陌生人登录上并实施破坏后 一旦自身没有第一时间察觉，然后备份存档又被新的存档覆盖 相当于整个存档报废

想要使用现有的存档方案，则只能通过空间换取对时间的需求 即现在每十分钟存一份，存144份能覆盖24小时的存档需求 存1440份覆盖10天的需求 存52560份满足一年的存档需求 问题是 其中的空间利用率过于低，144份中可能实际有效的就14份；1440份中我实际需要的只是存档被破坏前的1分钟的存档，而非那么那么多存档

这个需求也只是作为个人用户实际拥有的需求，如果是大型服务器，每分每秒都有人在线、每分每秒都有管理员在线并维护服务器，而个人用户是做不到这种维护

[luluxiaoyu]

可以考虑下coreprotect类似的插件模组

…

---原始邮件--- 发件人: ***@***.***&gt; 发送时间: 2026年3月12日(周四) 中午1:00 收件人: ***@***.***&gt;; 抄送: ***@***.******@***.***&gt;; 主题: Re: [MSLTeam/MSLX] [Feat]:服务器备份功能完善 (Issue #79) starsers left a comment (MSLTeam/MSLX#79) 说实在不觉得特别有意义且工程量较大。 目前我没发现有相关的模组/插件有此类备份功能实现，基本都是单一的定时备份。 … 那我尝试自己写吧 对于没有什么特别的意义 回复：假如一个为朋友开的服务器，中途被陌生人登录上并实施破坏后 一旦自身没有第一时间察觉，然后备份存档又被新的存档覆盖 相当于整个存档报废 想要使用现有的存档方案，则只能通过空间换取对时间的需求 即现在每十分钟存一份，存144份能覆盖24小时的存档需求 存1440份覆盖10天的需求 存52560份满足一年的存档需求 问题是 其中的空间利用率过于低，144份中可能实际有效的就14份；1440份中我实际需要的只是存档被破坏前的1分钟的存档，而非那么那么多存档 这个需求也只是作为个人用户实际拥有的需求，如果是大型服务器，每分每秒都有人在线、每分每秒都有管理员在线并维护服务器，而个人用户是做不到这种维护 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: ***@***.***&gt;