I2FTPServer

einführen

Dieses Projekt ist ein Dateiübertragungsserver basierend auf dem I2TCP -Kommunikationsprotokoll. Die effektive Schlüssellänge erreicht 512 Bit. Es verfügt auch über einen Doppel-Faktor-Authentifizierungsmechanismus wie Google, um sicherzustellen, dass der Dienst in einer öffentlichen Netzwerkumgebung sicher überleben kann.

Merkmal

• Unterstützen Sie die kontinuierliche Übertragung des Datei -Haltepunkts
• Support Datei Hash -Überprüfung
• Zugriff nur auf Dateien im Einstellungsverzeichnis
• Der schreibgeschützte Modus kann eingestellt werden
• 512 Bit Gültige Schlüssellänge
• Dynamische Token -Identitätsauthentifizierung
• Optionale TLS -Verschlüsselung

Installationsmethode

pip install i2ftp-server

Umweltanforderungen

• Python3.6+
• i2cylib >= 1.8.14

Integrationsbefehle

• i2ftps-setup Server-Konfigurationsassistent
• i2ftps -Server starten/Stopp

Standardkonfigurationsdateipfad

/usr/share/i2ftp/server_conf.json

Anhang: Kommunikationsvereinbarung Beschreibung

Kommunikationsprozess:

1. Stellen Sie die TCP -Verbindung zwischen dem Client und dem Server fest
2. Stellen Sie die I2TCP -Verbindung zwischen dem Client und dem Server fest
3. Der Server sendet die Version b"I2FTP xx"
4. Der Client sendet den Benutzerbefehl
5. Der Server reagiert auf den Benutzerbefehl

Protokollstruktur:

Zugrunde liegende TCP/IP ← I2TCP ← User -Top -Ebene

Benutzerschichtpakete:

• Client -Befehl - "Abfrage": LIST,<PATH>

  • Rückgabe: <bool 路径是否存在>,{'文件1':{is_dir:<bool 是否是文件夹> size:<int 大小>, time:<float 文件修改时间戳>}}

• Client -Befehl - "Anfragen herunterladen": GETF,<PATH>

  • Rückgabe: <bool 请求是否接受>,[16 bytes 下载会话ID]

• Client -Befehl - "Über Session -ID herunterladen": DOWN,<16 bytes 下载会话ID>,<uint64 文件指针偏移量>,<uint64 截止文件指针偏移量>

  • Wenn ein einzelnes Return -Paket die angeforderte Länge gleichzeitig nicht übertragen kann, sendet der Server nacheinander mehrere Pakete, bis die angeforderte Länge erfüllt ist.

  • Wenn截止文件指针偏移量≤文件指针偏移量ist, wird der Server beachtet, dass Daten aus文件指针偏移量bis zum Ende der Datei angefordert werden.

  • Rückgabe: <bool 操作是否有效>,[uint64 文件指针偏移量],[bytes 数据内容最大长度524128 Bytes] (einzelne oder Sequenz)

• Client -Befehl - "Anfrage Upload": PULF,<PATH>,<str_hex 文件哈希校验值>

  • Rückgabe: <bool 操作是否有效>,[16 bytes 上传会话ID]

• Client -Befehl - "über Sitzungs -ID hochladen": UPLD,<16 bytes 上传会话ID>,<uint64 文件指针偏移量>,<bytes 数据内容最大长度524128 Bytes>

  • Rückgabe: <bool 上传是否成功>,[int 当前文件指针偏移量]

• Client -Befehl - "Sitzung schließen": CLOZ,<16 bytes 会话ID>

  • Rückgabe: <bool 操作是否成功>,[hex_str 若会话为下载会话，则会同时返回文件的MD5校验值]

• Client-Befehl-"Datei-/Ordneroperation": FIOP,<int 命令：0-重命名，1-移动，2-复制，3-删除，4-创建目录>,<str 路径1>,[str 路径2]

  • Rückgabe: <bool 操作是否成功>

• Befehl Administrator - "Prozesssteuerung": PCTL,[raw 保留字段]

  • Rückgabe: <bool 操作是否成功>,<int 进程PID>