remote-fs

统一的远程文件系统抽象，一套 API 覆盖 SMB / FTP / SFTP。

基于 Tokio 异步运行时，按 Cargo feature 按需启用协议后端。

特性

安装

# 按需启用协议
remote-fs = { version = "0.1", features = ["ftp"] }

# 或一次全开
remote-fs = { version = "0.1", features = ["full"] }

快速开始

三套协议共用同一套 RemoteFileSystem 接口：

use remote_fs::{Client, FtpConfig, RemoteFileSystem};

#[tokio::main]
async fn main() -> remote_fs::Result<()> {
    let mut client = Client::ftp(&FtpConfig::new("ftp.example.com", "user", "pass")).await?;

    let entries = client.list("/").await?;
    for entry in &entries {
        println!("{}  {} bytes", entry.name, entry.size);
    }

    client.write("/hello.txt", b"hello").await?;
    client.download("/hello.txt", std::path::Path::new("./hello.txt")).await?;
    client.disconnect().await?;
    Ok(())
}

SMB

use remote_fs::{Client, SmbConfig};

# async fn demo() -> remote_fs::Result<()> {
let cfg = SmbConfig::new("192.168.1.10", "Documents", "user", "pass")
    .workgroup("WORKGROUP");
let mut client = Client::smb(&cfg).await?;
# let _ = client;
# Ok(())
# }

SFTP

use remote_fs::{Client, SftpConfig};

# async fn demo() -> remote_fs::Result<()> {
// 密码认证
let mut client = Client::sftp(
    &SftpConfig::with_password("host", "user", "pass"),
).await?;

// 或私钥认证
let mut client = Client::sftp(
    &SftpConfig::with_key("host", "user", "/path/to/id_rsa"),
).await?;
# let _ = client;
# Ok(())
# }

Builder

use remote_fs::{ClientBuilder, SftpConfig};

# async fn demo() -> remote_fs::Result<()> {
let client = ClientBuilder::new()
    .sftp(SftpConfig::with_password("host", "user", "pass"))
    .build()
    .await?;
# let _ = client;
# Ok(())
# }

API

所有后端共享 RemoteFileSystem trait：

运行测试

# 仅跑不依赖协议后端的测试
cargo test

# 跑全部协议相关集成测试
cargo test --features full

# 只跑某一协议
cargo test --features ftp --test ftp_offline