中转架构技术方案

🏗️ 什么是中转架构

在已有的阿里云服务器上部署一个轻量中转服务，学校老师的本地电脑不再直接连接 FTP 服务器，而是通过 HTTP API 将图片发给中转服务。中转服务收到图片后直接保存到阿里云本地磁盘（也可选转发到 FTP）。老师电脑上不存储任何 FTP 密码。

注意 已有阿里云 ECS 可以直接作为中转服务器，无需额外机器。

📐 整体架构图

本地服务只配一个 API 地址 + Key，中转服务直接存阿里云磁盘（无需 FTP）

🔄 中转服务 API 定义

POST http://中转IP:8080/upload
Headers:
  X-API-Key: sk_xxxxxx              # 学校身份标识
  Content-Type: application/json

Body:
{
  "image": "data:image/jpeg;base64,...",   // 图片 base64
  "name": "张三",                           // 操作人
  "filename": "张三_时间戳.jpg"              // 文件名
}

成功: { "success": true, "path": "张三_xxx.jpg", "size": 243461 }
失败: { "success": false, "message": "原因" }

📝 改造后的上传函数（两种模式共用）

// 替换原有的 uploadToFtp() — 不再需要 FTP 凭证
async function uploadToRelay(buffer, filename, name) {
  const config = loadRelayConfig();   // 只包含 apiUrl + apiKey
  const base64 = buffer.toString('base64');
  const res = await fetch(config.apiUrl, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': config.apiKey
    },
    body: JSON.stringify({
      image: 'data:image/jpeg;base64,' + base64,
      name: name || '',
      filename: filename
    })
  });
  if (!res.ok) throw new Error('中转服务返回 ' + res.status);
  return res.json();
}

📊 能力对比（中转架构下）

📋 风险清单

⚠️ 两种模式在中转架构下的特有风险

📋 实现工作量总表

📦 老师电脑部署方式

文件监控模式必须在老师本地 Windows 电脑上安装服务，有两种方式：

两种方式底层相同，安装程序只是把解压 + 创建快捷方式 + 开机自启等步骤自动化。老师电脑仍需先安装 Node.js（可打包进安装程序引导安装）。

⚠️ 多人共用电脑的重要注意事项

① 每个老师需要独立的监控文件夹

如果多位数老师共用一台电脑（各自用 Windows 账号登录），不能共用同一个监控文件夹。每个老师的文件应隔离到各自的用户目录下：

推荐路径（每人独立）:
C:\Users\老师A\Pictures\高拍仪扫描\
C:\Users\老师B\Pictures\高拍仪扫描\
C:\Users\老师C\Pictures\高拍仪扫描\

每个老师运行自己的 start.bat，各自监控自己的文件夹，上传时携带不同的 API Key（区分学校）或同一 Key（区分老师靠文件名中的姓名）。

② EloamCamera.exe 保存路径需要手动设置

文件监控依赖 EloamCamera 把图片存到监控文件夹。EloamCamera 默认保存路径不是监控文件夹，需要老师第一次使用时手动设置：

设置方法:
EloamCamera.exe → 设置/配置 → 保存路径
→ 修改为: C:\Users\当前用户名\Pictures\高拍仪扫描\
→ 确认保存

安装程序可以在首次运行时弹出提示引导老师完成此设置。