USSH

USSH 是一种基于 USTP-Secure 构建的 shell 协议及客户端/服务器端程序对。

它不是 TCP 隧道，也不会将 SSH 封装在 TCP 中。

状态：Beta

许可证：MIT

AEAD 密码名称

• chacha20 = CHACHA20_POLY1305
• aes-256-gcm = AES_256_GCM
• aes-128-gcm = AES_128_GCM
• 默认 AEAD 密码：chacha20

默认端口

• 5322

服务器端

python3 ussh_server.py \
  --peer-ip <CLIENT_IP_OR_DOMAIN> \
  --peer-port 0 \
  --bind-ip 0.0.0.0 \
  --bind-port 5322 \
  --cipher chacha20 \
  --congestion-control auto

如果省略 --password，服务器端将在启动时提示输入 USSH 登录密码。

在交互式启动时，服务器端会询问是否将其自身安装为 systemd 服务。回答 n 可正常运行。使用 --no-systemd-prompt 可跳过该问题。

客户端

python3 ussh_client.py \
  --peer-ip <SERVER_IP_OR_DOMAIN> \
  --peer-port 5322 \
  --bind-ip 0.0.0.0 \
  --bind-port 0 \
  --cipher chacha20 \
  --congestion-control off \
  --cleartext off

客户端会像 SSH 一样交互式地提示输入密码。

客户端将首次看到的服务器 X25519 公钥存储在 ~/.ussh_known_hosts.json 中。 如果该密钥之后发生变化，客户端会以 TOFU 不匹配错误中止，而不是静默信任新密钥。 如果你有意轮换服务器主机密钥，请使用 --regen-key 运行客户端，以便在交互式确认后允许替换存储的 TOFU 密钥。

Internet-Draft

• USSH Internet-Draft：https://datatracker.ietf.org/doc/draft-x1co-ussh/

说明

• 传输层为基于 UDP 的 USTP-Secure。
• USSH 还支持可选的明文 DATA 模式，并带有逐包 HMAC 完整性校验：
  • 服务器端：--cleartext auto|on|off
  • 客户端：--cleartext on|off
  • 当服务器端为 auto 时，USSH 遵循客户端请求。
  • 当服务器端为 on 或 off 时，服务器端强制指定最终的明文模式。
  • 使用 --cleartext on 时，USSH 会打印警告，提示明文在真实互联网上存在危险，仅建议在受控环境（如本地网络）中使用。
• 在 USSH 之下，USTPS 使用可读的 ASCII 控制行，如 ACK: 10 MAC:<tag>、NACK: 42 MAC:<tag>、HELLO: ...、CLOSE:，以及二进制 UPACK（UPAK）DATA 帧。
• ACK 和 NACK 保持明文以便调试，但它们带有每会话 HMAC 标签进行认证，以防止伪造的 ACK/NACK 控制攻击。

传输层握手

• USSH 继承了与 USTP-Secure 相同的 USTPS 重试令牌握手。
• 服务器端首先使用重试令牌和会话元数据向客户端发起挑战。
• 客户端必须在加密的 USSH 会话被接受之前回显该令牌。
• 同一握手还协商最终的 AEAD 密码以及 USTPS Congestion 为 on 还是 off。
• 同一握手还协商 DATA 使用 AEAD 加密还是明文加 HMAC。
• 重试令牌仅在会话创建前作为可达性证明。
• 它不是会话密钥，不是包 nonce，也不是后续派生的 AEAD 会话密钥的替代品。