I2FTPServer

introduzir

Este projeto é um servidor de transferência de arquivos com base no protocolo de comunicação i2TCP. O comprimento -chave efetivo atinge 512 bits. Ele também possui um mecanismo de autenticação de fator duplo como o Google para garantir que o serviço possa sobreviver com segurança em um ambiente de rede pública.

característica

• Suporte Arquivo Ponto de interrupção Transmissão contínua
• Verificação de hash de arquivo de suporte
• Acesso apenas a arquivos no diretório de configurações
• O modo somente leitura pode ser definido
• 512 bits Comprimento de chave válido
• Autenticação de identidade de token dinâmica
• Criptografia TLS opcional

Método de instalação

pip install i2ftp-server

Requisitos ambientais

• Python3.6+
• i2cylib >= 1.8.14

Comandos de integração

• Assistente de configuração do servidor i2ftps-setup
• i2ftps START/STOP

Caminho de arquivo de configuração padrão

/usr/share/i2ftp/server_conf.json

Anexo: Descrição do Contrato de Comunicação

Processo de comunicação:

1. Estabelecer a conexão TCP entre o cliente e o servidor
2. Estabeleça a conexão i2TCP entre o cliente e o servidor
3. O servidor envia o número da versão b"I2FTP xx"
4. O cliente envia o comando do usuário
5. O servidor responde ao comando do usuário

Estrutura do protocolo:

TCP/IP subjacente ← I2TCP ← Nível superior User

Pacotes de camada de usuário:

• Comando do cliente - "Query": LIST,<PATH>

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

• Comando do Cliente - "Solicite Download": GETF,<PATH>

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

• Comando do cliente - "Download via ID da sessão": DOWN,<16 bytes 下载会话ID>,<uint64 文件指针偏移量>,<uint64 截止文件指针偏移量>

  • Se um único pacote de retorno não puder transmitir o comprimento solicitado de uma só vez, o servidor enviará vários pacotes, por sua vez, até que o comprimento solicitado seja atendido.

  • Se截止文件指针偏移量≤文件指针偏移量, o servidor considerará que os dados do文件指针偏移量até o final do arquivo serão solicitados.

  • Retorno: <bool 操作是否有效>,[uint64 文件指针偏移量],[bytes 数据内容最大长度524128 Bytes] (single ou sequência)

• Comando do cliente - "Solicite upload": PULF,<PATH>,<str_hex 文件哈希校验值>

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

• Comando do Cliente - "Carregar via ID da sessão": UPLD,<16 bytes 上传会话ID>,<uint64 文件指针偏移量>,<bytes 数据内容最大长度524128 Bytes>

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

• Comando do cliente - "Fechar sessão": CLOZ,<16 bytes 会话ID>

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

• Comando do cliente-"Operação de arquivo/pasta": FIOP,<int 命令：0-重命名，1-移动，2-复制，3-删除，4-创建目录>,<str 路径1>,[str 路径2]

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

• Comando de administrador - "Controle do processo": PCTL,[raw 保留字段]

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