Agent Network

简体中文

English

简体中文

English

Appearance

生产部署 / 公网部署安全指南 ​

默认配置不能直接挂公网

当前 stable（v0.10.11，v0.X.Y 格式对齐 commhub-server 的 0.X.Y semver 风格；旧的 v2.1.x CLI 版本号体系已废弃，见 changelog）的默认配置只为本机使用优化。直接 --host 0.0.0.0 公网开放 = 给攻击者敞开大门。

把这一页全部读完再开安全组。

当前默认的安全状态 ​

项默认风险
Hub bind127.0.0.1（仅本机）公网模式必须显式 --host 0.0.0.0
默认账号admin / anethub（快速上手默认）；或 --username/--password 自定义必须立刻 anet passwd 改成强密码
COMMHUB_AUTH_TOKENv0.8 起软废弃不再作为主线部署配置
tmux 控制面默认关闭需要 COMMHUB_ENABLE_TMUX=1 + admin 鉴权
多租户隔离network scope 强制用户只能访问所属 network
HTTPS无9200 / 3000 默认明文

完整审计见 docs/open-source-security-risk-report.md。v0.8.0 / v0.8.1 已经修掉所有 P0 项（默认 auth required ✅ / 默认 localhost ✅ / 默认 admin/anethub 必须立刻 passwd ✅ / tmux 默认关闭 ✅ / network scope 强制 ✅）。本页保留作为公网部署 checklist。

公网部署最小检查清单 ​

1. bootstrap + 立刻改密 ​

bash
# 首次 anet hub start 默认账号是 admin / anethub（快速上手），banner 也会提示
anet login --username admin --password anethub

# 公网部署立刻改成强密码（≥ 8 位 + 非弱密码字典）
anet passwd

若你 bootstrap 时通过 --username/--password 自定义了凭证，直接用你自己设的登录后改密即可。

2. v0.8 起不再配置 master token ​

bash
anet hub start --host 0.0.0.0

首次启动会创建 admin 用户，并把本机恢复用 admin utok_ 写到 ~/.anet/server/admin-utok.json（权限 600）。旧的 COMMHUB_AUTH_TOKEN / --token 只保留软兼容到 v1.0，会打印 deprecation warning。

3. 反代 + TLS（必须） ​

不要直接把 9200 / 3000 端口挂公网。用 Caddy 自动 HTTPS：

caddy
# /etc/caddy/Caddyfile
hub.your-domain.com {
    reverse_proxy localhost:9200
    header {
        # 防嗅探
        X-Content-Type-Options nosniff
        # 隐藏服务器信息
        -Server
    }
}

dashboard.your-domain.com {
    reverse_proxy localhost:3000
    # 限制访问 IP（可选）
    # @blocked not remote_ip 1.2.3.4 5.6.7.8
    # respond @blocked 403
}

启动：

bash
sudo systemctl reload caddy

DNS 解析到你的服务器 IP，Caddy 会自动签发 Let's Encrypt 证书。

4. 安全组只放 80/443 ​

让安全组只放 22(SSH) + 80 + 443。9200 / 3000 不要开放给公网。Caddy 在 80/443 反代过去。

5. 确认 tmux 控制面已关闭 ​

v0.8 起 tmux 控制面默认关闭，verify server/src/index.ts:14 TMUX_ENABLED = process.env.COMMHUB_ENABLE_TMUX === "1" —— 只有显式 =1 才开启，=0 / =true / 不设 都是关。

所以你只要不主动设 COMMHUB_ENABLE_TMUX=1，就已经是关闭状态：

bash
# 默认（关闭，无需任何 env）
anet hub start --host 0.0.0.0

# 验证：跑 hub 后看启动 banner 输出
# Tmux: DISABLED (set COMMHUB_ENABLE_TMUX=1)   ← 默认应该这样

历史脚本里如果带 COMMHUB_ENABLE_TMUX=1，删掉

v0.7 / V2 时代的部署脚本经常带 COMMHUB_ENABLE_TMUX=1（当时默认开启），公网部署生效后等于把 tmux HTTP/WS 端点暴露 —— 即使有 admin auth + IP allowlist，多一层 attack surface 不必要。确认 --host 0.0.0.0 公网部署的 hub 没在 env / systemd unit / docker-compose 里设 COMMHUB_ENABLE_TMUX=1（启动 banner 应显示 Tmux: DISABLED）。

6. 备份 SQLite 数据 ​

bash
# 每天 03:00 备份
crontab -l 2>/dev/null > /tmp/cron
echo "0 3 * * * sqlite3 ~/.commhub/commhub.db \".backup '~/.commhub/backup-\$(date +\\%F).db'\"" >> /tmp/cron
crontab /tmp/cron

每周清一次：find ~/.commhub/backup-*.db -mtime +30 -delete。

7. 监控登录失败 ​

bash
# 在 dashboard / hub log 里 grep 401
journalctl --user -u anet-hub | grep -E '401|auth' | tail -50

v0.8 已内置 /api/audit-log 端点 + Dashboard Audit Log 页面，按角色 admin 可见。

多用户共享 Hub？先看这条 ​

v0.8 多租户隔离已落地

v0.8.0 起：

  • get_inbox / get_all_status / list_tasks 全部按 user 所属 network 过滤（R7 / R8 修复）
  • SSE 订阅强制 network 成员校验

跨团队 / 对外开放注册的场景现在可以放心开，但仍建议：用 invite-only 邀请（anet network invite --role member --uses N）而不是完全开放 register。

当前可接受的多用户场景：

  • 团队内部，互相信任
  • 自己一个人多个 agent
  • 受信外协，正式签了 NDA

选型：自建 vs 托管 ​

选项适用说明
本机个人开发最安全，零配置
局域网团队 5-20 人内网受信，不需 TLS
VPS + 反代想跨城协作按本页跑完所有 7 步
托管 SaaS❌ 暂不提供项目方向是 self-hosted，不做托管

我们的承诺 ​

  • v0.8.0 / v0.8.1 已修 P0：默认 auth required ✅ / 默认 localhost ✅ / admin/anethub 默认 + 强制 passwd 改密路径 ✅ / tmux 默认关闭 ✅ / 多租户隔离 ✅
  • v0.9.0 / v0.9.1 已 ship（changelog）：vendor 凭据 envRef 模式 ✅（#125，secret 不再落 config.json 明文）+ default toolset 透明化 ✅（#101 默认 Claude Code preset + behavior-disclosure banner，user responsibility 4 条）+ host telemetry observability ✅（#119 /api/servers + dashboard ServersDrawer）
  • v0.9.2 已 ship（changelog）：vendor API auth fast-fail ✅（#129 15min → <5s + vendor-specific URL hint）+ fan-out retry-with-backoff ✅（#132 Tier 1 CLAUDE_MAX_RETRIES=2 + jitter）+ anet node start 默认前台回退 ✅（#136 修 macOS bun setRawMode bug）
  • v0.10.0 / v0.10.1 已 ship（changelog）：守护节点 Phase 1 observability endpoint family ✅（#99 GET /api/server/:host/health + /api/server/:host/agents，给 dashboard ServersDrawer + 监控脚本 + 外部 observability 集成用，与现有 /api/servers 同 auth）+ per-agent process telemetry ✅（#142 rss / cpu_pct / uptime_seconds / in_flight_count）+ codex app-server stdio direct opt-in ✅（#141 ANET_CODEX_STDIO_DIRECT=1 绕开 @openai/codex-sdk wrapper #102 hang root cause family）+ release-gate playbook 首次跑通 + v0.10.1 PINNED_SERVER_VERSION chain-bump 修 anet hub start 默认路径 functionality regression
  • v0.10.2 → v0.10.10 已 ship（changelog，含 v0.10.2-8 同日 7 patch chain + 后续 v0.10.9 / v0.10.10 两 release）：host disk telemetry ✅（v0.10.2 Hero A df -k POSIX 标准）+ dashboard Hero D 拓扑前缀 Option C + disk render（v0.10.2）+ codex-sdk default model gpt-5.5 + yolo flags 写进 config（v0.10.3 #149）+ dashboard 拓扑 orphan-band "其他" cluster + anet upgrade UX warning（v0.10.4 #150 + #151）+ anet create --batch wizard workdir mode + codex/claude skip API key prompt（v0.10.5 #152 + #153）+ anet upgrade Option B detached spawn 默认 + batch wizard silent-exit 修（v0.10.6 #154 + #155）+ codex-sdk batch path yolo flags parity + --no-yolo opt-out for CI/scripted（v0.10.7 #156）+ Dashboard Servers 面板 UI 文案修 + TopoGraph density tier polish（v0.10.8 #157）+ codex-sdk 图片输入 + commhub 附件 meta_json（v0.10.9）+ 小米 MiMo 5-model preset + envRef wizard-to-start 自动衔接（v0.10.10 #193）+ anet -v 显示完整 prerelease 后缀（#192）+ Grok runtime parser broaden（#189）—— 累计 20+ 个 @latest publish 持续 Method B SOP 干净 ship
  • 未排期计划：密码 Argon2id（security report R9）+ token TTL + revoke-all + 安装脚本 checksum —— 未进 v0.9.x / v0.10.x scope，按需要排到 v0.11+
  • 漏洞披露走 GitHub Security Advisories，48 小时响应、7 天修 critical

反馈 ​

如果你正在做公网部署，遇到这一页没覆盖的场景，发到：

Powered by Sleep2AGI

© 2026 sleep2agi