Files

海诺中继服务 0.1.0

田泽远实施版,2026-10-26。根据当前目录的领导方案和接入安全手册独立开发。

已补齐官方ARM64镜像离线包:hainuo-relay-offline-arm64-0.1.0.tar.gz。包内包含四个官方镜像、41项ARM64依赖及本项目源码,按离线镜像说明安装,不需要访问镜像仓库或PyPI。宿主机仍需预先安装Docker Engine/Compose。

这是可运行、可测试的单机联调版本。默认采用独立容器:入口、B1连接器、B2路由器、PostgreSQL、Redis;可选启用海能Work官方SDK长连接进程。以后拆机沿用相同协议和服务镜像。

已交付

  • B1:平台事件接入、私聊过滤、应用校验、消息去重、按人路由、原消息回复。
  • B2:PC主动出站WebSocket、证书身份与挑战应答、单设备单连接、在线租约、断连清理、仅允许在途请求的回复。
  • 设备端:本机生成私钥、公钥证书注册、一次性绑定、连接器签名验证、密文指令处理、持久化去重、断线重连。
  • 内容保护:Ed25519认证、每连接X25519临时接收密钥、每消息临时发送密钥、HKDF-SHA256、AES-256-GCM。B2不接收消息正文或解密密钥。
  • OAuth:服务端state、取件密钥请求头、立即换令牌、错误密钥不销毁、一次领取、并发刷新保护、内存事务过期清理。
  • 平台数据代理:固定上游、GET只读白名单、用户身份验证、拒绝鉴权接口/重定向/路径穿越,默认关闭。
  • H5:响应式入口壳,OAuth授权、查找本人设备、显示在线状态及设备入口。令牌不进入URL或浏览器持久存储。
  • 运维:健康/就绪检查、元数据审计、设备吊销断连、Docker Compose、systemd样例、备份工具、测试用例。

真实边界

  1. 不能确认直接兼容1.065安装包。 只有Inno安装EXE,没有客户端隧道协议或源代码。本版定义独立协议,并附可运行PC桥接端;未运行或修改原安装包。
  2. 桥接端默认仅支持 /主机名、/回显 内容、/读取 测试目录内相对路径,不执行shell命令。提供可选本地HTTP Agent适配器,但必须由海诺本机服务实现文档中的接口;未声称完成1.065实际Agent对接。
  3. H5壳不是完整远程桌面/聊天产品。 PC网页的TLS透传、设备端会话登录、海能Work JSAPI免登、文件回传与手机实测尚需集成;不会用“能跳到域名”冒充已完成授权。
  4. 本版CA为离线人工签发,设备私钥为文件保护;Windows DPAPI/TPM不可导出、自动续期及集团规模容量不在已验证范围。
  5. 吊销会切断并禁止中继连接,不会远程停止海诺Windows服务。
  6. 未连接真实ECS或海能Work,不提供虚构的环境参数。Docker/ARM64运行、真实PostgreSQL、平台与1.065联调必须按验收文档执行。

先读什么

文件 用途
Linux ARM64部署 服务器初始化、启动、平台配置、两台PC接入
接口和设备协议 与海诺客户端开发者对接,含本地Agent契约
方案调整清单 相对领导方案改了什么、为何修改
验收步骤 两人两机、安全与故障用例
六台拆分 服务归属、端口、主备与迁移事项
测试报告 本机实测结果与尚未验证项

本地运行测试

需要Python 3.12:

python -m venv .venv
# Linux: source .venv/bin/activate
# Windows PowerShell: .\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.lock
python -m pip install --no-deps -e .
python -m pytest -q

测试会启动真实本地HTTP/WebSocket服务,使用FakeRedis和平台桩,不会访问公司服务或执行系统指令。真实PostgreSQL用例需要额外设置 HN_TEST_DATABASE_URL,否则明确跳过。

Linux单机部署摘要

# 在解压后的项目目录执行;需要Docker Engine与Compose插件。
bash scripts/bootstrap.sh relay.your-company-domain
# 编辑.env;替换runtime/tls内的服务器证书;离线保管operator/ca.key。
bash scripts/start.sh
bash scripts/verify_deployment.sh

初始化默认 HN_ENVIRONMENT=development、平台关闭,允许先用管理员测试入口验证链路。临时自签TLS证书仅供受控测试;正式验收使用公司认可证书。管理员API只通过服务器回环端口18081访问,公网入口屏蔽 /admin/* 和 /internal/*。

当前部署关系

flowchart TB
    IM[海能Work] -->|webhook 或 官方SDK长连接| B1[B1连接器]
    B1 -->|密文指令| R[Redis临时消息与在线状态]
    R --> B2[B2路由器]
    PC[PC桥接端] -->|主动WSS连接| A[HTTPS入口]
    A --> B2
    B2 -->|密文回复| R
    R --> B1
    B1 -->|回复原消息| IM
    B1 --> PG[PostgreSQL 元数据与去重台账]
    H5[H5入口壳] --> A
    A --> B1

公网HTTPS入口目前在边缘代理解密传输层,但PC指令和回复另有B1↔PC应用层加密;它不是原方案阶段B的浏览器TLS透传。这一差异在调整清单中单独说明。