sgcSSH:面向 Delphi 和 .NET 的后量子 SSH、SFTP 与 SCP

· 组件
sgcSSH:面向 Delphi 和 .NET 的后量子 SSH、SFTP 与 SCP | eSeGeCe 博客
新产品 · sgcSSH

面向 Delphi 和 .NET 的 SSH、SFTP 与 SCP。
默认即后量子。

三个客户端和两个服务器,让 SSH 直接运行在您自己的应用程序中。混合密钥交换 mlkem768x25519-sha256 在两端都被优先提供,加密则以原生代码运行。

  • ML-KEM-768 + X25519
  • SFTP v3
  • SCP
  • Ed25519
  • AES-GCM
并排展示的 sgcSSH 演示程序:运行命令和交互式 shell 的 SSH 客户端,浏览远程文件夹的 SFTP 客户端,提供根文件夹服务的 SFTP 服务器,以及显示密钥交换 mlkem768x25519-sha256 的终端
5个组件
16个并行 SFTP 请求
~1 s局域网内每 100 MB
0个 OpenSSL DLL(使用原生加密)

SSH 是管理服务器和安全交换文件的标准方式。sgcSSH 以普通组件的形式,把它带到您的 Delphi、C++Builder 和 .NET 应用程序中,客户端和服务器端都支持。

借助 sgcSSH,您可以在 Linux 服务器上运行命令并以字符串形式获得输出,打开交互式 shell,转发端口,通过 SFTP 或 SCP 上传文件夹,或者把自己的应用程序变成 SSH 和 SFTP 服务器,并为每个用户提供独立的文件夹。客户端和服务器都会优先提供混合后量子密钥交换,这也是最新 SSH 版本默认使用的方式。

sgcSSH 概览:客户端、服务器和后量子密钥交换。也可在 YouTube 观看。

三个客户端,两个服务器

每个都是位于 SGC SSH 组件面板页上的非可视组件。您可以把它放到窗体上,或在代码中创建,设置主机和凭据,连接事件,然后连接或开始监听。.NET 类使用相同的名称。

SSH 客户端TsgcSSHClient命令、带 pty 的交互式 shell、端口转发和重新密钥交换。
SFTP 客户端TsgcSFTPClientSFTP v3 文件传输,支持 16 个并行请求。
SCP 客户端TsgcSCPClient使用 scp 传输文件和整个文件夹,并保留文件时间。
SSH 服务器TsgcSSHServer密码和公钥登录、exec、shell 以及子系统。
SFTP 服务器TsgcSFTPServer从根文件夹提供 SFTP v3 和 SCP 服务,为每个用户设置独立的限制目录。

后量子密钥交换,默认启用

今天加密的流量,明天可能被攻破。攻击者现在记录加密会话,等到出现足够强大的量子计算机后再解密。这被称为先收集,后解密,对于需要保密数年的内容尤为重要,例如凭据、合同和客户文件。

sgcSSH 使用混合密钥交换 mlkem768x25519-sha256 来应对这一威胁。它把后量子算法 ML-KEM-768(FIPS 203)与经典的 X25519 结合起来,只要两者之一没有被攻破,会话密钥就保持保密。这也是最新 SSH 版本的默认方式。

下面是标准的 ssh 命令行客户端连接到 SSH 服务器演示程序。两端使用默认设置即可协商出混合密钥交换:

ssh -v 连接 TsgcSSHServer
$ ssh -v -p 2290 deploy@127.0.0.1 "echo hello"
debug1: Remote protocol version 2.0, remote software version sgcSSH
debug1: kex: algorithm: mlkem768x25519-sha256
debug1: kex: host key algorithm: ssh-ed25519
debug1: kex: client->server cipher: aes128-ctr MAC: hmac-sha2-256 compression: none
Authenticated to 127.0.0.1 ([127.0.0.1]:2290) using "password".
hello

原生加密,无需部署 DLL

在 Delphi 中,CryptoLibrary 属性决定经典算法(ECDH、Diffie-Hellman、AES、HMAC 和主机密钥签名)由谁来计算:

无论选择哪个选项,混合的 ML-KEM-768 和 X25519 密钥交换都由库自身的原生代码完成。.NET 组件是完全托管的代码,完全不使用 OpenSSL,并且在 .NET 8 及更高版本中,AES-GCM 由硬件加速。

使用后量子密钥交换和原生加密通过 SFTP 上传文件,只需寥寥几行代码:

uses
  sgcSSH_Crypto, sgcSSH_Client;

procedure TForm1.UploadInvoices;
var
  SFTP: TsgcSFTPClient;
begin
  SFTP := TsgcSFTPClient.Create(nil);
  try
    SFTP.Host := 'files.example.com';
    SFTP.Authentication.Username := 'partner';
    SFTP.Authentication.Password := 'secret';
    SFTP.PostQuantumKex := True;      // the default: mlkem768x25519-sha256 first
    SFTP.CryptoLibrary := sshcNative; // sgcCrypto units, no OpenSSL DLL
    SFTP.Connect;
    SFTP.Put('C:\export\invoices.zip', '/upload/invoices.zip');
    Memo1.Lines.Add('Uploaded ' +
      IntToStr(SFTP.FileSize('/upload/invoices.zip')) + ' bytes');
    SFTP.Disconnect;
  finally
    SFTP.Free;
  end;
end;

SSH 客户端:命令、Shell 和隧道

TsgcSSHClient 可以使用密码或私钥登录,OnSSHHostKey 会把主机密钥类型及其指纹交给您,方便与已知主机比对,并拒绝未知或已更改的密钥。

SSH 客户端演示程序:使用后量子密钥交换和原生加密库完成连接,显示远程命令的输出、列出文件夹的交互式 shell,以及日志中已接受的 Ed25519 主机密钥
SSH 客户端演示程序:远程命令、交互式 shell 和主机密钥检查。

使用私钥并检查主机密钥来运行维护命令:

procedure TForm1.CheckDisk;
var
  SSH: TsgcSSHClient;
begin
  SSH := TsgcSSHClient.Create(nil);
  try
    SSH.Host := 'build01.example.com';
    SSH.Authentication.Username := 'deploy';
    SSH.Authentication.PrivateKeyFile := 'C:\keys\id_ed25519.pem';
    SSH.OnSSHHostKey := DoHostKey;
    SSH.Connect;
    Memo1.Text := SSH.Execute('df -h /var');
    SSH.Disconnect;
  finally
    SSH.Free;
  end;
end;

procedure TForm1.DoHostKey(Sender: TObject; const aHostKeyType,
  aFingerprint: string; var aAction: TIdSSHHostKeyVerification);
begin
  if aFingerprint <> FKnownFingerprint then
    aAction := sshHostKeyReject;
end;

SFTP 与 SCP:快速文件传输

TsgcSFTPClient 在同一个 SSH 连接上使用 SFTP v3,每项任务对应一个方法:RealPath 解析主目录,ListDirectory 返回名称、大小和日期,Put 和 Get 上传和下载文件,Rename、Delete、MakeDirectory 和 RemoveDirectory 则涵盖文件管理器的其余功能。OnSFTPProgress 报告已传输的字节数,可用于进度条。

传输速度很快,因为客户端不会等待每个数据块。它同时保持 16 个并行请求,因此在局域网上传输 100 MB 的文件大约只需一秒。

SFTP 客户端演示程序:列出带有名称、大小、日期和文件夹标记的远程文件夹,以及大文件下载的进度条
SFTP 客户端演示程序在下载大文件的同时浏览远程文件夹。

TsgcSCPClient 通过 SSH 把文件复制到任何允许 scp 命令的服务器,无需单独的文件传输服务。Upload 和 Download 复制单个文件,UploadFolder 和 DownloadFolder 复制整个文件夹树,PreserveTimes 则在另一端保留修改时间和访问时间。

SCP 客户端演示程序:包含上传和下载文件或整个文件夹的按钮、保留文件时间选项以及传输进度
SCP 客户端演示程序:单个文件或整个文件夹,可选择是否保留文件时间。

您自己的 SSH 和 SFTP 服务器

TsgcSSHServer 在您选择的端口上监听,并使用从 HostKeyFiles 加载的 Ed25519、ECDSA 或 RSA 主机密钥证明自己的身份。GenerateHostKeyEd25519 可以为您生成一个。OnSSHAuthPassword 和 OnSSHAuthPublicKey 决定谁可以登录,后者会提供密钥类型及其 SHA256 指纹。OnSSHExec 响应远程命令,OnSSHShell 提供交互式会话。任何标准 SSH 客户端都可以连接,包括 ssh、sftp 和 scp 命令行工具。

关联一个 TsgcSFTPServer,同一个服务器就变成了文件服务器:

uses
  sgcSSH_Crypto, sgcSSH_Server, sgcSSH_SFTP_Server;

procedure TForm1.StartServer;
begin
  if not FileExists('hostkey_ed25519.pem') then
    TsgcSSHServer.GenerateHostKeyEd25519('hostkey_ed25519.pem');

  SFTP := TsgcSFTPServer.Create(Self);
  SFTP.RootFolder := 'D:\sftp';
  SFTP.OnSFTPUserRoot := DoUserRoot;
  SFTP.OnSFTPOperation := DoOperation;

  SSH := TsgcSSHServer.Create(Self);
  SSH.Port := 22;
  SSH.HostKeyFiles.Text := 'hostkey_ed25519.pem';
  SSH.CryptoLibrary := sshcNative;
  SSH.SFTPServer := SFTP;
  SSH.OnSSHAuthPassword := DoAuthPassword;
  SSH.Active := True;
end;

procedure TForm1.DoAuthPassword(Sender: TObject;
  aConnection: TsgcSSHServerConnection; const aUsername, aPassword: string;
  var aAccept: Boolean);
begin
  aAccept := CheckUser(aUsername, aPassword); // your own user store
end;

procedure TForm1.DoUserRoot(Sender: TObject; const aUsername: string;
  var aRootFolder: string);
begin
  aRootFolder := 'D:\sftp\' + aUsername; // every user in its own folder
  ForceDirectories(aRootFolder);
end;

procedure TForm1.DoOperation(Sender: TObject; const aUsername: string;
  aOperation: TsgcSFTPOperation; const aPath, aNewPath: string;
  var aAccept: Boolean);
begin
  if aOperation = sfoRemove then
    aAccept := False; // the client gets permission denied
end;

下面是标准的 sftp 命令行工具与 SFTP 服务器演示程序配合使用的情形:

sftp 连接 TsgcSFTPServer
$ sftp -P 2291 -b batch.txt deploy@127.0.0.1
sftp> cd reports
sftp> put Q4-summary-2026.xlsx
sftp> ls -l
-rw-r--r--   1 deploy   deploy     150000 Nov 13 10:28 Q3-summary-2026.xlsx
-rw-r--r--   1 deploy   deploy     204800 Nov 13 10:28 Q4-summary-2026.xlsx
sftp> cd ..
sftp> get catalog-2026.pdf
sftp> mkdir archive-2026

在服务器端,上述每个操作都经过 OnSFTPOperation,演示程序会在其中记录日志:

SFTP 服务器演示程序使用原生加密库和 Ed25519 主机密钥进行监听,并提供每用户一个子文件夹、只读、SCP 和拒绝删除等选项;日志显示了密码登录、列表、写入打开、读取打开以及新建文件夹
SFTP 服务器演示程序记录上述会话,每个操作一行。

安全细节

Delphi、C++Builder 和 .NET

同样的五个组件可用于 sgcSSH 支持的所有平台:

.NET 代码的写法与 Delphi 代码如出一辙:

using esegece.sgcWebSockets;

using (var sftp = new TsgcSFTPClient())
{
    sftp.Host = "files.example.com";
    sftp.Authentication.Username = "partner";
    sftp.Authentication.Password = "secret";
    sftp.Connect();
    sftp.Put(@"C:\export\invoices.zip", "/upload/invoices.zip");
    foreach (var item in sftp.ListDirectory("/upload"))
        Console.WriteLine($"{item.FileName}  {item.Size}");
    sftp.Disconnect();
}

Demos\27.SSH 中的五个演示程序展示了每个组件的实际运行:01.SSH_Client、02.SFTP_Client、03.SCP_Client、04.SSH_Server 和 05.SFTP_Server。本文中的截图均来自它们。

版本

sgcSSH 包含在 sgcWebSockets Enterprise 和 sgcWebSockets All-Access 中。在 .NET 上,这些组件随已注册的 sgcWebSockets 包一起提供,而不在免费的 Community 版本中。

如果您只需要 SSH 和 SFTP,独立的 sgcSSH 包是自包含的:它捆绑了 sgcWebSockets Core 运行时以及密钥交换所依赖的原生加密,Delphi 组件所基于的 sgcCustomIndy 附加组件始终包含在订单中,并且每个许可证都附带完整源代码。

温馨提示。购买之前,请先确认您的 sgcWebSockets 版本已经包含哪些内容。如果您拥有 Enterprise 或 All-Access,那么五个组件您都已经拥有。

把 SSH 集成到您的应用程序中,从容迎接未来

下载试用版,运行 SSH 服务器演示程序,并用任意 SSH 客户端连接它。然后把 TsgcSFTPClient 放到您自己的窗体上。

有问题或反馈?请联系我们,您将收到编写这些代码的人的回复。