OCtop(部署于vm103)

家族主力 AI Agent 平台的主实例:浏览器自动化 + 多 agent + 记忆体系,经 hk-yunmai 域名对外服务,数据有 HK 异地备份——是全家备份做得最规范的业务。

访问方式

• 对外:https://octop.bianquezhiyin.cn(亦绑 octop.bianquezhiyin.com / oct.bianquezhiyin.cn,hk-yunmai nginx 反代到本机 8088)
• 内网直连:http://100.64.0.20:8088
• SSH:ssh -i ~/.ssh/external_ai_key pev-yunmai2@100.64.0.20
• 登录凭据:/opt/octop-login.txt 与 /opt/octop-data/credential.txt(明文,注意权限)

技术架构

• 源码:/opt/octop(Python 项目:src/plugins/dashboard/desktop/docker/fnos/tests,pyproject.toml + uv.lock + mise.toml,有 README_CN/CHANGELOG/SECURITY,工程化程度高)
• 运行形态:容器化,/app/.venv/bin/python3 /app/.venv/bin/octop run --host 0.0.0.0 --port 8088(root,491M RSS);容器运行时为自装 /opt/docker 二进制
• 运行数据:/opt/octop-data——agents、browser-profiles(浏览器自动化配置)、config.json、credential.txt、embedding_models、logs、memory-slim-control.json(记忆控制)
• 数据库:PostgreSQL octop 库(用户 octop),监听 0.0.0.0:5432
• 配套:bocha-mcp(联网搜索 MCP)、octop-usage(用量看板)、wb-hk-tunnel(agent 隧道 19220)

数据(存储/备份情况)

• 文件数据双保险:hk-yunmai 每日 04:17 备份(保留 7 份,约 200M/份)+ 本地 /opt/octop-data.bak.20261002(手工,已过期 3 周)
• PostgreSQL octop 库无备份(pg_dump 从未配置)——记忆/配置的库损坏即丢失
• /persistent 51G 用 74%(剩 13G),octop-data/logs 会持续吃空间
• 备份目的地无"风险盘"问题(HK 备份在云上)

使用方法

• 日常经域名访问;agent 管理在 dashboard
• 重启主服务:进入容器或 docker restart <容器名>(容器名待确认,sudo docker ps 需权限)
• 新 agent/插件:改 /opt/octop/plugins 后重启容器(参照 /opt/octop/AGENTS.md、docs/)

维护方式(启停/日志/配置)

• 日志:/opt/octop-data/logs/;容器 stdout 待确认
• 服务依赖:systemctl status octop-usage bocha-mcp wb-hk-tunnel
• 升级:git pull /opt/octop → 重建镜像(docker/ 目录有构建配置)→ 重启容器
• 配置:/opt/octop-data/config.json

现状与风险

• 高:PostgreSQL 5432 监听 0.0.0.0,内网全暴露且库无备份
• 中:/persistent 74% 满,剩 13G,日志无轮转清理策略(待确认)
• 低:credential.txt/api_key.txt/mx_key.txt 明文凭据散落 /opt 各目录
• 低:内存 2.9G 余量 1.7G,扩展空间小;8766/3000 端口进程归属待确认

优化建议(3-6条,给可直接执行的命令)

1. 数据库立即加每日备份:echo '30 3 * * * pg_dump -U octop -h 127.0.0.1 octop | gzip > /persistent/pg-octop-$(date +\\%F).sql.gz && ls -t /persistent/pg-octop-*.sql.gz | tail -n +8 | xargs -r rm -f' | sudo tee /etc/cron.d/pg-octop-backup(注意 sudo 环境)
2. 收紧数据库监听:postgresql.conf 改 listen_addresses = '127.0.0.1' 后 sudo systemctl restart postgresql(远程需求走 Tailscale 绑定 100.64.0.20)
3. 重建滚动文件备份(替换过期的手工备份):echo '0 4 * * 0 tar -czf /persistent/octop-data-$(date +\\%F).tar.gz -C /opt octop-data --exclude=octop-data/logs && ls -t /persistent/octop-data-*.tar.gz | tail -n +5 | xargs -r rm -f' | sudo tee /etc/cron.d/octop-data-backup
4. 日志清理:find /opt/octop-data/logs -mtime +14 -type f -delete(先 dry-run 去掉 -delete 看清单)
5. 凭据收权:chmod 600 /opt/bocha-mcp/api_key.txt /opt/octop-data/credential.txt /opt/octop-usage/mx_key.txt /opt/octop-login.txt
6. 磁盘水位告警接入 netwatch:/opt/netwatch/netwatch.sh 里追加 df 阈值检查(74% 已接近 80% 警戒)