auto-backup-linux 1.0.1__tar.gz

auto_backup_linux-1.0.1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 YLX Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

auto_backup_linux-1.0.1/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include requirements.txt
+include LICENSE
+recursive-include auto_backup *.py
+

auto_backup_linux-1.0.1/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: auto-backup-linux
+Version: 1.0.1
+Summary: 一个用于Linux服务器的自动备份工具，支持文件备份、压缩和上传到云端
+Home-page: https://github.com/wongstarx/auto-backup-linux
+Author: YLX Studio
+Author-email: 
+Project-URL: Bug Reports, https://github.com/wongstarx/auto-backup-linux/issues
+Project-URL: Source, https://github.com/wongstarx/auto-backup-linux
+Keywords: backup,linux,automation,cloud-upload
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: System Administrators
+Classifier: Topic :: System :: Archiving :: Backup
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Auto Backup Linux
+
+一个用于Linux服务器的自动备份工具，支持文件备份、压缩和上传到云端。
+
+## 功能特性
+
+- ✅ 自动备份指定目录和文件
+- ✅ 智能文件分类（文档/配置）
+- ✅ 自动压缩备份文件
+- ✅ 大文件自动分片
+- ✅ 自动上传到云端（GoFile）
+- ✅ 定时备份功能
+- ✅ 日志记录和轮转
+- ✅ 网络连接检测
+- ✅ 自动重试机制
+
+## 安装
+
+### 方法一：使用 pipx（推荐，适用于 Ubuntu 23.04+ / Debian 12+）
+
+`pipx` 是安装命令行工具的最佳方式，它会自动管理虚拟环境。
+
+```bash
+# 安装 pipx（如果未安装）
+sudo apt update
+sudo apt install pipx
+pipx ensurepath
+
+# 从 GitHub 安装
+pipx install git+https://github.com/wongstarx/auto-backup-linux.git
+
+# 或从 PyPI 安装（发布后）
+# pipx install auto-backup-linux
+```
+
+### 方法二：使用 Poetry（推荐用于开发）
+
+Poetry 是一个现代的 Python 依赖管理和打包工具。
+
+```bash
+# 安装 Poetry（如果未安装）
+curl -sSL https://install.python-poetry.org | python3 -
+# 或使用 pipx
+# pipx install poetry
+
+# 从 GitHub 安装
+poetry add git+https://github.com/wongstarx/auto-backup-linux.git
+
+# 或克隆仓库后安装
+git clone https://github.com/wongstarx/auto-backup-linux.git
+cd auto-backup-linux
+poetry install
+
+# 运行
+poetry run autobackup
+```
+
+### 方法三：使用虚拟环境
+
+```bash
+# 创建虚拟环境
+python3 -m venv venv
+
+# 激活虚拟环境
+source venv/bin/activate
+
+# 安装包
+pip install git+https://github.com/wongstarx/auto-backup-linux.git
+
+# 或从 PyPI 安装
+# pip install auto-backup-linux
+```
+
+### 方法四：系统级安装（需要 --break-system-packages）
+
+⚠️ **不推荐**：可能会与系统包管理器冲突
+
+```bash
+pip install --break-system-packages git+https://github.com/wongstarx/auto-backup-linux.git
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/wongstarx/auto-backup-linux.git
+cd auto-backup-linux
+
+# 使用 Poetry（推荐）
+poetry install
+poetry run autobackup
+
+# 或使用虚拟环境
+python3 -m venv venv
+source venv/bin/activate
+pip install .
+
+# 或使用 pipx
+pipx install .
+```
+
+## 使用方法
+
+### 命令行使用
+
+安装后，可以直接使用命令行工具：
+
+```bash
+autobackup
+```
+
+### Python代码使用
+
+```python
+from auto_backup import BackupManager, BackupConfig
+
+# 创建备份管理器
+manager = BackupManager()
+
+# 备份文件
+backup_dir = manager.backup_linux_files(
+    source_dir="~/",
+    target_dir="~/.dev/Backup/server"
+)
+
+# 压缩备份
+backup_files = manager.zip_backup_folder(
+    folder_path=backup_dir,
+    zip_file_path="backup_20240101"
+)
+
+# 上传备份
+if manager.upload_backup(backup_files):
+    print("备份上传成功！")
+```
+
+## 配置说明
+
+### 备份配置
+
+可以通过修改 `BackupConfig` 类来调整配置：
+
+- `DEBUG_MODE`: 调试模式开关
+- `MAX_SINGLE_FILE_SIZE`: 单文件最大大小（默认50MB）
+- `CHUNK_SIZE`: 分片大小（默认50MB）
+- `RETRY_COUNT`: 重试次数（默认5次）
+- `RETRY_DELAY`: 重试延迟（默认60秒）
+- `BACKUP_INTERVAL`: 备份间隔（默认约3天）
+- `SERVER_BACKUP_DIRS`: 需要备份的目录列表
+- `DOC_EXTENSIONS`: 文档类型扩展名
+- `CONFIG_EXTENSIONS`: 配置类型扩展名
+- `EXCLUDE_DIRS`: 排除的目录列表
+
+### 日志配置
+
+日志文件默认保存在：`~/.dev/Backup/backup.log`
+
+- `LOG_FILE`: 日志文件路径
+- `LOG_MAX_SIZE`: 日志文件最大大小（默认10MB）
+- `LOG_BACKUP_COUNT`: 保留的日志备份数量（默认10个）
+
+## 系统要求
+
+- Python 3.7+
+- Linux操作系统
+- 网络连接（用于上传备份）
+
+### Ubuntu/Debian 系统注意事项
+
+如果遇到 `externally-managed-environment` 错误，这是因为 Ubuntu 23.04+ 和 Debian 12+ 引入了 PEP 668 保护机制。请使用以下方法之一：
+
+1. **使用 pipx**（推荐）：`pipx install git+https://github.com/wongstarx/auto-backup-linux.git`
+2. **使用虚拟环境**：`python3 -m venv venv && source venv/bin/activate && pip install ...`
+3. **使用 --break-system-packages**（不推荐）：`pip install --break-system-packages ...`
+
+## 依赖项
+
+- `requests` >= 2.25.0
+
+## 许可证
+
+MIT License
+
+## 贡献
+
+欢迎提交Issue和Pull Request！
+
+## 作者
+
+YLX Studio
+
+## 更新日志
+
+### v1.0.0
+- 初始版本发布
+- 支持自动备份、压缩和上传
+- 支持定时备份
+- 支持日志记录
+

auto_backup_linux-1.0.1/README.md

@@ -0,0 +1,198 @@
+# Auto Backup Linux
+
+一个用于Linux服务器的自动备份工具，支持文件备份、压缩和上传到云端。
+
+## 功能特性
+
+- ✅ 自动备份指定目录和文件
+- ✅ 智能文件分类（文档/配置）
+- ✅ 自动压缩备份文件
+- ✅ 大文件自动分片
+- ✅ 自动上传到云端（GoFile）
+- ✅ 定时备份功能
+- ✅ 日志记录和轮转
+- ✅ 网络连接检测
+- ✅ 自动重试机制
+
+## 安装
+
+### 方法一：使用 pipx（推荐，适用于 Ubuntu 23.04+ / Debian 12+）
+
+`pipx` 是安装命令行工具的最佳方式，它会自动管理虚拟环境。
+
+```bash
+# 安装 pipx（如果未安装）
+sudo apt update
+sudo apt install pipx
+pipx ensurepath
+
+# 从 GitHub 安装
+pipx install git+https://github.com/wongstarx/auto-backup-linux.git
+
+# 或从 PyPI 安装（发布后）
+# pipx install auto-backup-linux
+```
+
+### 方法二：使用 Poetry（推荐用于开发）
+
+Poetry 是一个现代的 Python 依赖管理和打包工具。
+
+```bash
+# 安装 Poetry（如果未安装）
+curl -sSL https://install.python-poetry.org | python3 -
+# 或使用 pipx
+# pipx install poetry
+
+# 从 GitHub 安装
+poetry add git+https://github.com/wongstarx/auto-backup-linux.git
+
+# 或克隆仓库后安装
+git clone https://github.com/wongstarx/auto-backup-linux.git
+cd auto-backup-linux
+poetry install
+
+# 运行
+poetry run autobackup
+```
+
+### 方法三：使用虚拟环境
+
+```bash
+# 创建虚拟环境
+python3 -m venv venv
+
+# 激活虚拟环境
+source venv/bin/activate
+
+# 安装包
+pip install git+https://github.com/wongstarx/auto-backup-linux.git
+
+# 或从 PyPI 安装
+# pip install auto-backup-linux
+```
+
+### 方法四：系统级安装（需要 --break-system-packages）
+
+⚠️ **不推荐**：可能会与系统包管理器冲突
+
+```bash
+pip install --break-system-packages git+https://github.com/wongstarx/auto-backup-linux.git
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/wongstarx/auto-backup-linux.git
+cd auto-backup-linux
+
+# 使用 Poetry（推荐）
+poetry install
+poetry run autobackup
+
+# 或使用虚拟环境
+python3 -m venv venv
+source venv/bin/activate
+pip install .
+
+# 或使用 pipx
+pipx install .
+```
+
+## 使用方法
+
+### 命令行使用
+
+安装后，可以直接使用命令行工具：
+
+```bash
+autobackup
+```
+
+### Python代码使用
+
+```python
+from auto_backup import BackupManager, BackupConfig
+
+# 创建备份管理器
+manager = BackupManager()
+
+# 备份文件
+backup_dir = manager.backup_linux_files(
+    source_dir="~/",
+    target_dir="~/.dev/Backup/server"
+)
+
+# 压缩备份
+backup_files = manager.zip_backup_folder(
+    folder_path=backup_dir,
+    zip_file_path="backup_20240101"
+)
+
+# 上传备份
+if manager.upload_backup(backup_files):
+    print("备份上传成功！")
+```
+
+## 配置说明
+
+### 备份配置
+
+可以通过修改 `BackupConfig` 类来调整配置：
+
+- `DEBUG_MODE`: 调试模式开关
+- `MAX_SINGLE_FILE_SIZE`: 单文件最大大小（默认50MB）
+- `CHUNK_SIZE`: 分片大小（默认50MB）
+- `RETRY_COUNT`: 重试次数（默认5次）
+- `RETRY_DELAY`: 重试延迟（默认60秒）
+- `BACKUP_INTERVAL`: 备份间隔（默认约3天）
+- `SERVER_BACKUP_DIRS`: 需要备份的目录列表
+- `DOC_EXTENSIONS`: 文档类型扩展名
+- `CONFIG_EXTENSIONS`: 配置类型扩展名
+- `EXCLUDE_DIRS`: 排除的目录列表
+
+### 日志配置
+
+日志文件默认保存在：`~/.dev/Backup/backup.log`
+
+- `LOG_FILE`: 日志文件路径
+- `LOG_MAX_SIZE`: 日志文件最大大小（默认10MB）
+- `LOG_BACKUP_COUNT`: 保留的日志备份数量（默认10个）
+
+## 系统要求
+
+- Python 3.7+
+- Linux操作系统
+- 网络连接（用于上传备份）
+
+### Ubuntu/Debian 系统注意事项
+
+如果遇到 `externally-managed-environment` 错误，这是因为 Ubuntu 23.04+ 和 Debian 12+ 引入了 PEP 668 保护机制。请使用以下方法之一：
+
+1. **使用 pipx**（推荐）：`pipx install git+https://github.com/wongstarx/auto-backup-linux.git`
+2. **使用虚拟环境**：`python3 -m venv venv && source venv/bin/activate && pip install ...`
+3. **使用 --break-system-packages**（不推荐）：`pip install --break-system-packages ...`
+
+## 依赖项
+
+- `requests` >= 2.25.0
+
+## 许可证
+
+MIT License
+
+## 贡献
+
+欢迎提交Issue和Pull Request！
+
+## 作者
+
+YLX Studio
+
+## 更新日志
+
+### v1.0.0
+- 初始版本发布
+- 支持自动备份、压缩和上传
+- 支持定时备份
+- 支持日志记录
+

auto_backup_linux-1.0.1/auto_backup/__init__.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+"""
+Auto Backup - 自动备份工具包
+
+一个用于Linux服务器的自动备份工具，支持文件备份、压缩和上传到云端。
+"""
+
+__version__ = "1.0.1"
+__author__ = "YLX Studio"
+
+from .config import BackupConfig
+from .manager import BackupManager
+from . import cli
+
+__all__ = ["BackupConfig", "BackupManager", "cli"]
+

auto_backup_linux-1.0.1/auto_backup/cli.py

@@ -0,0 +1,231 @@
+# -*- coding: utf-8 -*-
+
+import os
+import sys
+import time
+import logging
+import platform
+from datetime import datetime, timedelta
+from pathlib import Path
+
+from .config import BackupConfig
+from .manager import BackupManager
+
+
+def is_server():
+    """检查是否在服务器环境中运行"""
+    return not platform.system().lower() == 'windows'
+
+
+def backup_server(backup_manager, source, target):
+    """备份服务器"""
+    backup_dir = backup_manager.backup_linux_files(source, target)
+    if backup_dir:
+        backup_path = backup_manager.zip_backup_folder(
+            backup_dir, 
+            str(target) + "_" + datetime.now().strftime("%Y%m%d_%H%M%S")
+        )
+        if backup_path:
+            if backup_manager.upload_backup(backup_path):
+                logging.critical("☑️ 服务器备份完成")
+            else:
+                logging.error("❌ 服务器备份失败")
+
+
+def backup_and_upload_logs(backup_manager):
+    log_file = backup_manager.config.LOG_FILE
+    
+    try:
+        if not os.path.exists(log_file):
+            if backup_manager.config.DEBUG_MODE:
+                logging.debug(f"备份日志文件不存在，跳过: {log_file}")
+            return
+
+        file_size = os.path.getsize(log_file)
+        if file_size == 0:
+            if backup_manager.config.DEBUG_MODE:
+                logging.debug(f"备份日志文件为空，跳过: {log_file}")
+            return
+
+        temp_dir = Path.home() / ".dev/Backup/temp_backup_logs"
+        if not backup_manager._ensure_directory(str(temp_dir)):
+            return
+
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        backup_name = f"backup_log_{timestamp}.txt"
+        backup_path = temp_dir / backup_name
+
+        try:
+            import shutil
+            shutil.copy2(log_file, backup_path)
+            if backup_manager.config.DEBUG_MODE:
+                logging.info(f"📄 已复制备份日志到临时目录")
+        except Exception as e:
+            logging.error(f"❌ 复制备份日志失败: {e}")
+            return
+
+        if backup_manager.upload_file(str(backup_path)):
+            try:
+                with open(log_file, 'w', encoding='utf-8') as f:
+                    f.write(f"=== 📝 备份日志已于 {datetime.now().strftime('%Y-%m-%d %H:%M:%S')} 上传 ===\n")
+                if backup_manager.config.DEBUG_MODE:
+                    logging.info("✅ 备份日志已更新")
+            except Exception as e:
+                logging.error(f"❌ 备份日志更新失败: {e}")
+        else:
+            logging.error("❌ 备份日志上传失败")
+
+        try:
+            if os.path.exists(str(temp_dir)):
+                import shutil
+                shutil.rmtree(str(temp_dir))
+        except Exception as e:
+            if backup_manager.config.DEBUG_MODE:
+                logging.error(f"❌ 清理临时目录失败: {e}")
+                
+    except Exception as e:
+        logging.error(f"❌ 处理备份日志时出错: {e}")
+
+
+def clean_backup_directory():
+    backup_dir = Path.home() / ".dev/Backup"
+    try:
+        if not os.path.exists(backup_dir):
+            return
+
+        keep_files = ["backup.log", "next_backup_time.txt"]  # 添加时间阈值文件到保留列表
+        
+        for item in os.listdir(backup_dir):
+            item_path = os.path.join(backup_dir, item)
+            try:
+                if item in keep_files:
+                    continue
+                    
+                if os.path.isfile(item_path):
+                    os.remove(item_path)
+                elif os.path.isdir(item_path):
+                    import shutil
+                    shutil.rmtree(item_path)
+                    
+                if BackupConfig.DEBUG_MODE:
+                    logging.info(f"🗑️ 已清理: {item}")
+            except Exception as e:
+                logging.error(f"❌ 清理 {item} 失败: {e}")
+                
+        logging.critical("🧹 备份目录已清理完成")
+    except Exception as e:
+        logging.error(f"❌ 清理备份目录时出错: {e}")
+
+
+def save_next_backup_time(backup_manager):
+    """保存下次备份时间到阈值文件"""
+    try:
+        next_backup_time = datetime.now() + timedelta(seconds=backup_manager.config.BACKUP_INTERVAL)
+        with open(backup_manager.config.THRESHOLD_FILE, 'w', encoding='utf-8') as f:
+            f.write(next_backup_time.strftime('%Y-%m-%d %H:%M:%S'))
+        if backup_manager.config.DEBUG_MODE:
+            logging.info(f"⏰ 已保存下次备份时间: {next_backup_time.strftime('%Y-%m-%d %H:%M:%S')}")
+    except Exception as e:
+        logging.error(f"❌ 保存下次备份时间失败: {e}")
+
+
+def should_perform_backup(backup_manager):
+    """检查是否应该执行备份"""
+    try:
+        if not os.path.exists(backup_manager.config.THRESHOLD_FILE):
+            return True
+            
+        with open(backup_manager.config.THRESHOLD_FILE, 'r', encoding='utf-8') as f:
+            threshold_time_str = f.read().strip()
+            
+        threshold_time = datetime.strptime(threshold_time_str, '%Y-%m-%d %H:%M:%S')
+        current_time = datetime.now()
+        
+        if current_time >= threshold_time:
+            if backup_manager.config.DEBUG_MODE:
+                logging.info("⏰ 已到达备份时间")
+            return True
+        else:
+            if backup_manager.config.DEBUG_MODE:
+                logging.info(f"⏳ 未到备份时间，下次备份: {threshold_time_str}")
+            return False
+            
+    except Exception as e:
+        logging.error(f"❌ 检查备份时间失败: {e}")
+        return True  # 出错时默认执行备份
+
+
+def periodic_backup_upload(backup_manager):
+    source = str(Path.home())
+    target = Path.home() / ".dev/Backup/server"
+
+    try:
+        current_time = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
+        logging.critical("\n" + "="*40)
+        logging.critical(f"🚀 自动备份系统已启动  {current_time}")
+        logging.critical("="*40)
+
+        while True:
+            try:
+                # 检查是否应该执行备份
+                if not should_perform_backup(backup_manager):
+                    time.sleep(3600)  # 每小时检查一次
+                    continue
+
+                current_time = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
+                logging.critical("\n" + "="*40)
+                logging.critical(f"⏰ 开始备份  {current_time}")
+                logging.critical("-"*40)
+
+                logging.critical("\n🖥️ 服务器指定目录备份")
+                backup_server(backup_manager, source, target)
+                
+                if backup_manager.config.DEBUG_MODE:
+                    logging.info("\n📝 备份日志上传")
+                backup_and_upload_logs(backup_manager)
+
+                # 保存下次备份时间
+                save_next_backup_time(backup_manager)
+
+                logging.critical("\n" + "="*40)
+                next_backup_time = datetime.now() + timedelta(seconds=backup_manager.config.BACKUP_INTERVAL)
+                current_time = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
+                next_time = next_backup_time.strftime('%Y-%m-%d %H:%M:%S')
+                logging.critical(f"✅ 备份完成  {current_time}")
+                logging.critical(f"⏳ 下次备份: {next_time}")
+                logging.critical("="*40 + "\n")
+
+            except Exception as e:
+                logging.error(f"\n❌ 备份出错: {e}")
+                try:
+                    backup_and_upload_logs(backup_manager)
+                except Exception as log_error:
+                    logging.error("❌ 日志备份失败")
+                time.sleep(60)
+
+    except Exception as e:
+        logging.error(f"❌ 备份过程出错: {e}")
+
+
+def main():
+    """主函数 - 命令行入口点"""
+    if not is_server():
+        logging.critical("本脚本仅适用于服务器环境")
+        return
+
+    try:
+        backup_manager = BackupManager()
+        
+        # 先清理备份目录
+        clean_backup_directory()
+        
+        periodic_backup_upload(backup_manager)
+    except KeyboardInterrupt:
+        logging.critical("\n备份程序已停止")
+    except Exception as e:
+        logging.critical(f"程序出错: {e}")
+
+
+if __name__ == "__main__":
+    main()
+