I2FTPServer

introduire

Ce projet est un serveur de transfert de fichiers basé sur le protocole de communication I2TCP. La longueur de clé effective atteint 512 bits. Il dispose également d'un mécanisme d'authentification à double facteur comme Google pour s'assurer que le service peut survivre en toute sécurité dans un environnement de réseau public.

caractéristiques

• Prise en charge de la transmission continue du point de rupture du fichier
• Soutenir la vérification du hachage du fichier
• Uniquement accès aux fichiers dans le répertoire des paramètres
• Le mode en lecture seule peut être défini
• 512 bits Longueur de clé valide
• Authentification d'identité de jeton dynamique
• Cryptage TLS en option

Méthode d'installation

pip install i2ftp-server

Exigences environnementales

• Python3.6+
• i2cylib >= 1.8.14

Commandes d'intégration

• Assistant de configuration du serveur i2ftps-setup
• Démarrage / arrêt du serveur i2ftps

Chemin de fichier de configuration par défaut

/usr/share/i2ftp/server_conf.json

Attachement: Contrat de communication Description

Processus de communication:

1. Établir la connexion TCP entre le client et le serveur
2. Établir une connexion I2TCP entre le client et le serveur
3. Le serveur envoie le numéro de version b"I2FTP xx"
4. Le client envoie la commande utilisateur
5. Le serveur répond à la commande utilisateur

Structure du protocole:

TCP/IP sous-jacent ← I2TCP ← Niveau supérieur User

Paquets de calque utilisateur:

• Commande client - "Query": LIST,<PATH>

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

• Commande client - "Demand Download": GETF,<PATH>

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

• Commande client - "Télécharger via Session ID": DOWN,<16 bytes 下载会话ID>,<uint64 文件指针偏移量>,<uint64 截止文件指针偏移量>

  • Si un seul paquet de retour ne peut pas transmettre la longueur demandée à la fois, le serveur enverra plusieurs paquets à son tour tant que la longueur demandée n'est pas satisfaite.

  • Si截止文件指针偏移量≤文件指针偏移量, le serveur examinera que les données du文件指针偏移量à la fin du fichier sont demandées.

  • Retour: <bool 操作是否有效>,[uint64 文件指针偏移量],[bytes 数据内容最大长度524128 Bytes] (simple ou séquence)

• Commande client - "Demande Téléchargement": PULF,<PATH>,<str_hex 文件哈希校验值>

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

• Commande client - "Télécharger via Session ID": UPLD,<16 bytes 上传会话ID>,<uint64 文件指针偏移量>,<bytes 数据内容最大长度524128 Bytes>

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

• Commande client - "Session de clôture": CLOZ,<16 bytes 会话ID>

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

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

  • Retour: <bool 操作是否成功>

• Commande d'administrateur - "Contrôle de processus": PCTL,[raw 保留字段]

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