Files

85 lines
5.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 海诺中继服务 0.1.0
田泽远实施版,2026-10-26。根据当前目录的领导方案和接入安全手册独立开发。
已补齐官方ARM64镜像离线包:`hainuo-relay-offline-arm64-0.1.0.tar.gz`。包内包含四个官方镜像、41项ARM64依赖及本项目源码,按[离线镜像说明](docs/OFFLINE_IMAGES.md)安装,不需要访问镜像仓库或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部署](docs/DEPLOY_LINUX_ARM64.md) | 服务器初始化、启动、平台配置、两台PC接入 |
| [接口和设备协议](docs/PROTOCOL.md) | 与海诺客户端开发者对接,含本地Agent契约 |
| [方案调整清单](docs/CHANGES.md) | 相对领导方案改了什么、为何修改 |
| [验收步骤](docs/ACCEPTANCE.md) | 两人两机、安全与故障用例 |
| [六台拆分](docs/SPLIT_SIX_NODES.md) | 服务归属、端口、主备与迁移事项 |
| [测试报告](docs/TEST_REPORT.md) | 本机实测结果与尚未验证项 |
## 本地运行测试
需要Python 3.12:
```bash
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单机部署摘要
```bash
# 在解压后的项目目录执行;需要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/*`。
## 当前部署关系
```mermaid
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透传。这一差异在调整清单中单独说明。