bingshuo/cang-ying

Fork 0

Zhuyuan Operations b086c5e358 feat: 接入苍耳家庭服务器运维与广播授权入口

2026-07-29 18:49:26 +08:00

6.9 KiB

Raw Blame History

苍耳本地 Linux 节点接入

这个模块把苍耳家里的 Ubuntu 接到新加坡大脑服务器，但不把家里的电脑暴露到公网。

工作方式

新加坡控制端运行在 127.0.0.1:8787，由现有 HTTPS 网关转发。
苍耳节点首次使用一次性配对码登记，长期节点令牌只保存在本机 0600 配置中。
systemd 开机自动启动节点；连接只能从家里向新加坡主动发起。
人格体创建任务后，任务保持 pending；苍耳/冰朔在新加坡端批准后才会下发。
节点执行白名单动作并回传退出码、输出和耗时。
执行期间持续回传 started、分段输出和 finished 事件，新加坡端可以实时观察，不必等任务结束才看见错误。

默认安全边界

家里路由器不做端口转发，不开放 SSH 到公网。
控制端默认只监听环回地址，公网入口必须使用 HTTPS。
不接受 Shell 字符串，只接受结构化动作。
安装程序自动建立 /srv/canger 受管工作区，并用没有登录能力的 canger-agent 系统账户执行任务。
编程命令受可执行文件白名单、受管工作区、超时和授权时段共同限制； Agent 没有 sudo 权限。
repo.fetch 只更新远端引用，不自动 merge、reset 或覆盖本地修改。
每个任务和结果都写入 SQLite 审计记录。

新加坡端部署

准备 /etc/canger-control.env，四个令牌分别代表：

ADMIN：创建设备配对码；
OWNER：苍耳主控批准、拒绝或撤销副控权限；
PERSONA：苍耳人格体读取任务、结果和执行上下文；
OPERATOR：冰朔与铸渊副控创建运维会话、任务并读取实时回执。

实际职责为：

苍耳本人：服务器主控、需求方和最终决策者；
冰朔与 ICE-GL-ZY001 铸渊：受苍耳授权的运维副控；
每张工单的实际申请人格体：如实填写名称和正式编号；
本地 Agent：无独立判断权的受限物理执行器；
苍耳本人可随时批准、拒绝或撤销数小时副控运维会话。

安装 systemd/canger-control.service，并把 nginx/canger-node.conf.example 接到已有 TLS 站点。不要直接把 8787 端口开放公网。

首次配对

新加坡端创建十分钟有效的一次性码：

python3 tools/cangerctl.py pair-code

把整个 remote-node 目录交给苍耳。他在 Ubuntu 上只执行一次：

sudo ./install/install-node.sh \
  https://guanghubingshuo.com/canger-node \
  XXXX-XXXX-XXXX \
  canger-home-ubuntu

冰朔交付给苍耳的专用包可直接使用简化入口：

sudo ./install/苍耳一键安装.sh XXXX-XXXX-XXXX

配对码十分钟失效，因此安装包可以提前发送，配对码应在苍耳准备执行时再生成。

安装脚本会完成登记并启用开机自启动。以后不再需要登录本地终端。

安装时还会生成只读环境报告：

/var/lib/canger-node/preflight.json

报告会识别 systemd、虚拟化环境、磁盘文件系统和可能存在的 Windows 双启动，但不会修改分区、引导项或另一个操作系统。

双系统边界

真正的双系统切换会关闭当前操作系统。因此：

启动 Ubuntu 时，本节点会自动运行并连接新加坡；
切到另一个操作系统后，Ubuntu 服务不可能继续运行；
若希望“电脑开机就总有一个节点在线”，另一个系统也需要安装配套节点；
若希望“Ubuntu 服务器本身始终在线”，需要让 Ubuntu 成为宿主机并把另一个系统放进虚拟机，或者使用独立服务器。

安装程序不会自动改造分区、引导和虚拟机。这类操作可能导致数据丢失，必须在确认硬件、另一个系统和磁盘结构后单独处理。

从新加坡端操作

查看节点：

python3 tools/cangerctl.py nodes

人格体创建任务：

python3 tools/cangerctl.py task \
  --node node_xxx \
  --action system.status

正常开发不需要逐任务批准。人格体先申请 1–8 小时的授权时段：

python3 tools/cangerctl.py grant \
  --node node_xxx \
  --hours 4

系统自动读取节点登记的安全能力，向苍耳主控邮箱发送人话版批准链接。主人只看目的和时长后点一次批准，不需要填写命令、目录或权限。授权时段内，匹配固定安全边界的任务自动批准。所有任务仍保留独立审计记录。

查看与撤销授权：

python3 tools/cangerctl.py grants
python3 tools/cangerctl.py revoke grant_xxx

邮件中的链接只用于某一项授权申请，30 分钟失效；打开链接后还需要在确认页点击批准，避免邮件安全扫描器误触发。SMTP 密码、主人邮箱和签名密钥只放在新加坡服务器私有环境文件中，不写入仓库或安装包。

批准任务：

python3 tools/cangerctl.py approve task_xxx

读取回执：

python3 tools/cangerctl.py show task_xxx

实时观察执行过程：

python3 tools/cangerctl.py watch task_xxx

苍耳人格体代码仓库入口

苍耳人格体不使用副控令牌。它从仓库固定门牌 persona/README.md 进入，并使用独立的 CANGER_PERSONA_TOKEN：

python3 tools/canger_persona.py request-access \
  --requester-name "申请者名称" \
  --requester-id "申请者正式编号" \
  --hours 4 \
  --reason "本次开发、诊断或修复目的"

申请回执的 requester_name 和 requested_by 必须与本次实际申请者一致。人格体可以申请、创建任务和读取结果，但不能批准、拒绝或撤销授权；批准权继续属于苍耳主控。固定节点和安全边界登记在 config/pufferfish-persona.json，令牌仍只存在新加坡私有环境文件中。

完整流程见 persona/WORKORDER-GUIDE.md；当天开发回执见 persona/DEVELOPMENT-RECEIPT-20260729.md。

智能体与模型 API

本地 Agent 是执行、观察和审计端，不直接保存大模型供应商的 API 密钥。运维判断由冰朔与铸渊副控在新加坡大脑服务器完成：

苍耳提出需求并授权
        ↓
冰朔与铸渊副控 → 创建运维任务 → 苍耳人格体/本地 Agent 协作执行
               ← 实时事件、错误和回执 ←

如需调用大模型，只把供应商 API 密钥放在新加坡服务器的密钥环境中。本地节点只持有可撤销、仅能代表该节点的身份令牌。禁止把大模型 API 密钥写进安装包、仓库、命令行或配对文件。

动作

system.status：主机、系统、在线时间、根分区状态。
repo.status：只读 Git 状态。
repo.fetch：获取远端引用，不合并。
service.logs：读取指定 systemd 服务日志。
command.run：结构化命令执行；只在受管工作区内、以受限系统账户运行。

6.9 KiB Raw Blame History Unescape Escape