I2FTPServer

介紹

本項目為一款基於I2TCP通訊協議的文件傳輸服務器， 有效密鑰長度達到512bit，同時嵌有類Google雙重認證機制， 確保服務能在公網環境下安全存活。

特性

• 支持文件斷點續傳
• 支持文件哈希校驗
• 僅允許訪問設定目錄下的文件
• 可設置只讀模式
• 512 bits有效密鑰長度
• 動態token身份認證
• 可選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. 客戶端發送User指令
5. 服務器響應User指令

協議結構：

底層TCP/IP ← I2TCP ← User頂層

User層數據包：

• 客戶端命令- “查詢”： LIST,<PATH>

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

• 客戶端命令- “請求下載”： GETF,<PATH>

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

• 客戶端命令- “通過會話ID下載”： DOWN,<16 bytes 下载会话ID>,<uint64 文件指针偏移量>,<uint64 截止文件指针偏移量>

  • 若單個返回包無法一次傳輸請求的長度，服務器會依次發送多個數據包，直到滿足請求的長度為止。

  • 若截止文件指针偏移量≤文件指针偏移量，則服務器會認為是請求了從文件指针偏移量開始到文件末尾的數據。

  • 返回： <bool 操作是否有效>,[uint64 文件指针偏移量],[bytes 数据内容最大长度524128 Bytes] （單個或序列）

• 客戶端命令- “請求上傳”： PULF,<PATH>,<str_hex 文件哈希校验值>

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

• 客戶端命令- “通過會話ID上傳”： UPLD,<16 bytes 上传会话ID>,<uint64 文件指针偏移量>,<bytes 数据内容最大长度524128 Bytes>

  • 返回： <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>