feat: 图片迁移脚本

scripts/QUICK_START.md

@@ -0,0 +1,186 @@
+# 图片迁移脚本快速开始指南
+
+## 概述
+这是一个通过SSH将本地图片迁移到远程服务器的Python脚本。支持保持相对路径结构，自动创建目录，批量处理图片文件。
+
+## 环境要求
+- Python 3.6+
+- paramiko库 (SSH客户端库)
+
+## 快速开始
+
+### 1. 安装依赖
+```bash
+cd /var/www/html/orico-official-website/scripts
+pip install -r requirements.txt
+```
+
+### 2. 创建配置文件
+```bash
+# 创建示例配置文件
+python image_migrate.py --create-config config.json
+```
+
+编辑生成的 `config.json` 文件，填写目标服务器信息：
+- 修改 `target.ssh` 部分的目标服务器地址、用户名、密码/密钥
+- 设置 `source.base_dir` 为本地图片目录路径
+
+### 3. 准备图片路径列表
+创建 `images.txt` 文件，每行一个相对路径：
+```txt
+uploads/products/2024/01/product1.jpg
+uploads/products/2024/01/product2.jpg
+assets/images/logo.png
+uploads/banners/main-banner.jpg
+```
+
+### 4. 执行迁移
+```bash
+python image_migrate.py --config config.json --input images.txt --verbose
+```
+
+## 配置文件示例（本地源）
+```json
+{
+    "source": {
+        "type": "local",
+        "base_dir": "/var/www/html/orico-official-website/public/uploads"
+    },
+    "target": {
+        "type": "ssh",
+        "base_dir": "/var/www/html/images",
+        "ssh": {
+            "host": "your-server.com",
+            "port": 22,
+            "username": "deploy",
+            "password": "your_password",
+            "key_file": "/path/to/private/key"
+        }
+    }
+}
+```
+
+## 常用命令
+
+### 基本迁移
+```bash
+python image_migrate.py --config config.json --input images.txt
+```
+
+### 详细输出模式
+```bash
+python image_migrate.py --config config.json --input images.txt --verbose
+```
+
+### 覆盖已存在的文件
+```bash
+python image_migrate.py --config config.json --input images.txt --overwrite
+```
+
+### 直接从命令行指定文件
+```bash
+python image_migrate.py --config config.json \
+    "uploads/test1.jpg" \
+    "uploads/test2.jpg" \
+    "assets/logo.png"
+```
+
+### 不使用配置文件，直接指定参数
+```bash
+python image_migrate.py \
+    --source-type local \
+    --source-dir /path/to/local/images \
+    --target-host server.example.com \
+    --target-user username \
+    --target-dir /remote/path/images \
+    --input images.txt \
+    --verbose
+```
+
+## 常见场景
+
+### 场景1：迁移网站上传目录
+```bash
+# 配置文件中的源目录设置为：
+"source": {
+    "type": "local",
+    "base_dir": "/var/www/html/orico-official-website/public/uploads"
+}
+
+# 执行迁移
+python image_migrate.py --config config.json --input uploads_list.txt
+```
+
+### 场景2：从数据库导出路径并迁移
+```bash
+# 从数据库导出图片路径
+mysql -u username -p database -e "SELECT image_path FROM products" --skip-column-names > products.txt
+
+# 清理路径（如果需要）
+sed -i 's/^\.\///' products.txt
+
+# 迁移图片
+python image_migrate.py --config config.json --input products.txt --verbose
+```
+
+### 场景3：迁移整个目录结构
+```bash
+# 使用find命令生成所有图片文件列表
+find /path/to/local/images -type f \( -name "*.jpg" -o -name "*.png" -o -name "*.gif" -o -name "*.webp" \) | sed 's|^/path/to/local/images/||' > all_images.txt
+
+# 迁移所有图片
+python image_migrate.py --config config.json --input all_images.txt
+```
+
+## 路径说明
+- **相对路径**：相对于配置文件中指定的 `base_dir`
+- **示例**：如果 `base_dir` 是 `/var/www/html/images`，相对路径 `uploads/test.jpg` 对应完整路径 `/var/www/html/images/uploads/test.jpg`
+- **目标路径**：在目标服务器上保持相同的相对路径结构
+
+## 故障排查
+
+### 1. 连接失败
+```bash
+# 测试SSH连接
+ssh -p 22 username@server.example.com
+
+# 检查配置文件中的主机、端口、用户名是否正确
+```
+
+### 2. 文件不存在
+```bash
+# 检查本地文件是否存在
+ls -la /var/www/html/orico-official-website/public/uploads/uploads/test.jpg
+
+# 使用详细模式查看完整路径
+python image_migrate.py --config config.json --input images.txt --verbose
+```
+
+### 3. 权限不足
+```bash
+# 检查本地文件读取权限
+ls -la /path/to/local/images
+
+# 检查目标目录写入权限（通过SSH）
+ssh username@server.example.com "ls -la /remote/path/images"
+```
+
+## 注意事项
+1. 建议使用SSH密钥认证而非密码（更安全）
+2. 首次使用前，建议用少量文件测试
+3. 大文件传输可能需要较长时间，建议分批处理
+4. 使用 `--verbose` 参数可查看详细传输信息
+5. 脚本会自动创建目标服务器上的目录结构
+
+## 获取帮助
+```bash
+# 查看完整帮助
+python image_migrate.py --help
+
+# 查看详细使用说明
+cat README.md
+```
+
+---
+*快速开始指南更新日期：2024年*
+*脚本位置：/var/www/html/orico-official-website/scripts/*