I2FTPServer

導入

このプロジェクトは、I2TCP通信プロトコルに基づくファイル転送サーバーです。有効なキーの長さは512ビットに達します。また、Googleのようなデュアルファクター認証メカニズムがあり、パブリックネットワーク環境でサービスが安全に生き残ることができるようにします。

特性

• サポートファイルブレークポイント連続伝送
• サポートファイルハッシュ検証
• 設定ディレクトリ内のファイルへのアクセスのみ
• 読み取り専用モードを設定できます
• 512ビット有効なキー長
• 動的トークンアイデンティティ認証
• オプションのTLS暗号化

インストール方法

pip install i2ftp-server

環境要件

• Python3.6+
• i2cylib >= 1.8.14

統合コマンド

• i2ftps-setupサーバー構成ウィザード
• i2ftpsサーバーの開始/停止

デフォルトの構成ファイルパス

/usr/share/i2ftp/server_conf.json

添付ファイル：通信契約の説明

コミュニケーションプロセス：

1. クライアントとサーバーの間にTCP接続を確立します
2. クライアントとサーバーの間にI2TCP接続を確立します
3. サーバーはバージョン番号b"I2FTP xx"を送信します
4. クライアントはユーザーコマンドを送信します
5. サーバーはユーザーコマンドに応答します

プロトコル構造：

基礎となるTCP/IP ← I2TCP ← Userトップレベル

ユーザーレイヤーパケット：

• クライアントコマンド - 「クエリ」： LIST,<PATH>

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

• クライアントコマンド - 「リクエストダウンロード」： GETF,<PATH>

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

• クライアントコマンド - 「セッションID経由でダウンロード」： DOWN,<16 bytes 下载会话ID>,<uint64 文件指针偏移量>,<uint64 截止文件指针偏移量>

  • 単一の返品パケットが要求された長さを一度に送信できない場合、サーバーは要求された長さが満たされるまで複数のパケットを順番に送信します。

  • 截止文件指针偏移量≤の文件指针偏移量の場合、サーバーは文件指针偏移量からファイルの最後までのデータが要求されることを検討します。

  • return： <bool 操作是否有效>,[uint64 文件指针偏移量],[bytes 数据内容最大长度524128 Bytes] （シングルまたはシーケンス）

• クライアントコマンド - 「リクエストアップロード」： PULF,<PATH>,<str_hex 文件哈希校验值>

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

• クライアントコマンド - 「セッションID経由のアップロード」： UPLD,<16 bytes 上传会话ID>,<uint64 文件指针偏移量>,<bytes 数据内容最大长度524128 Bytes>

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

• クライアントコマンド - 「セッションを閉じる」： CLOZ,<16 bytes 会话ID>

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

• クライアントコマンド - 「ファイル/フォルダー操作」： FIOP,<int 命令：0-重命名，1-移动，2-复制，3-删除，4-创建目录>,<str 路径1>,[str 路径2]

  • 返品： <bool 操作是否成功>

• 管理者コマンド - 「プロセスコントロール」： PCTL,[raw 保留字段]

  • 返品： <bool 操作是否成功>,<int 进程PID>