资讯动态

AIBro 自托管云同步教程:用 HTTPS 与 SSH 部署独立服务,跨 Mac 同步知识、任务与资料

发布时间:2026/10/30 0:13:24 来源:尧图企业网站定制
【免费下载链接】AIBroAI Bro — a local-first workspace for AI conversations, source-linked knowledge, and tasks.项目地址https://gitcode.com/gh_mirrors/aib/AIBro点击查看免费下载如果你想在多台 Mac 之间同步 AIBro 的知识、任务与资料AIBro 内置的自托管云同步是最直接的选择在任意一台 Linux 服务器上部署独立同步服务即可让多个桌面工作区保持一致无需官方云账号也不依赖模型提供商。本教程将带你完成 HTTPS 与 SSH 两种部署方式并教会你在 Mac 端连接账号、处理冲突与备份数据。为什么选择 AIBro 自托管云同步 AIBro 是本地优先local-first的工作站不连接服务器也能正常保存和使用。云同步是可选能力首版已支持自动同步 手动立即同步断网时本地内容照常可用待上传操作会保留跨设备合并按稳定 ID 与版本号核对记录冲突需手动选择保留本机或使用云端附件去重附件原件按 SHA-256 校验和去重避免重复下载设备管理可查看并撤销指定设备的访问权限。完整的能力边界说明见 docs/CLOUD_SYNC.md。需要提醒的是云服务可以读取同步内容明文HTTPS/SSH 只保护传输过程不提供端到端加密因此服务器应由你信任的人管理。两种部署方式怎么选 方式适用场景加密方式需要Docker Compose Caddy有域名、愿意开放 80/443 端口HTTPS域名、Docker ComposeLinux 用户服务 SSH 隧道无域名、只信任 SSH 用户SSH 通道加密已有 SSH 访问权限的 Linux 服务器服务本体只有 app/cloud_server.py 和 app/cloud_web.py 两个 Python 文件只依赖标准库不运行桌面后端、不读取你电脑上的任何本地目录。方式一Docker Compose 部署 HTTPS 服务仓库的 cloud/ 目录已备好完整部署文件包括 cloud/compose.yaml、cloud/Caddyfile 与 cloud/Dockerfile。Caddy 负责自动签发 TLS 证书Python 服务只在容器内部网络暴露 8787 端口公网完全看不到明文端口。第 1 步启动服务。准备一个指向服务器的域名然后在cloud目录执行export CLOUD_DOMAINsync.example.com docker compose up -d --build第 2 步创建云账号。账号由服务器操作者通过 CLI 创建没有公开注册接口。密码从终端隐式输入不会出现在命令行参数或环境变量中python3 -c import getpass; print(getpass.getpass(初始账号密码至少12字符: )) | docker compose exec -T cloud python /app/cloud_server.py init --username admin --password-stdin需要第二个独立账号时把init换成add-user并更换--username即可。注意一个账号代表同一个人多设备共用同一账号并填不同设备名称而不是为每台电脑新建账号。第 3 步验证健康检查。浏览器访问https://你的域名/v1/health返回{protocol:1}即部署成功。⚠️ 不要把桌面的server.py本机后端暴露到公网也不要另行公开云服务的明文 8787 端口。方式二SSH 隧道部署无域名如果你只有 SSH 访问权限这条路径不需要 Docker、域名和 TLS 证书云服务只监听服务器127.0.0.1:8787你的 Mac 通过 SSH 把它转发到本机127.0.0.1:18787。完整步骤在 cloud/SSH_DEPLOY.md核心流程如下第 1 步检查服务器环境。需要 Python 3.10 且包含hashlib.scrypt同时需要 systemd 用户服务。在服务器上运行文档给出的检查脚本即可。第 2 步上传最小发布目录。在 Mac 上把cloud_server.py、cloud_web.py和用户服务文件 cloud/ai-workstation-cloud.service 传到~/.local/share/ai-workstation-cloud/下并用符号链接current指向本次发布。发布代码与data数据目录严格分开。第 3 步初始化云账号并启动服务。systemctl --user enable --now ai-workstation-cloud.service curl --fail --silent --show-error http://127.0.0.1:8787/v1/health要让服务在你退出 SSH 后继续运行需要管理员执行sudo loginctl enable-linger 用户名并确认输出Lingeryes。第 4 步在 Mac 建立隧道。ssh -N -T -o ExitOnForwardFailureyes \ -o ServerAliveInterval30 -o ServerAliveCountMax3 \ -L 127.0.0.1:18787:127.0.0.1:8787 \ my-sync-host另开一个终端用curl http://127.0.0.1:18787/v1/health验证返回{protocol:1}即可连接。在 Mac 上连接 AIBro 云账号 打开 AIBro 工作站的设置 → 账号与云同步点击连接云账号填写服务器地址HTTPS 部署填https://你的域名SSH 隧道填http://127.0.0.1:18787、用户名、密码和本机设备名称核对目标服务器勾选我确认将当前本地知识与云端合并点击连接并合并。首次连接会把当前工作区支持同步的内容上传并接收云端已有内容——这是双向合并不是谁覆盖谁。同名但 ID 不同的项目、笔记不会自动视为同一条记录独立导入的数据可能同时保留。在另一台 Mac 上连接同一服务和账号时同样需要确认首次合并。一个本地工作区会绑定首次连接的服务器与账号断开后绑定、同步游标和本地内容都会保留无法直接改填另一个地址混入第二套资料需要连接其他目标时请使用独立本地工作区。哪些内容会同步、哪些不会 内容首版行为项目、任务、笔记、论文分析同步记录、状态和关联字段附件原件与解析内容同步受管原件按 SHA-256 去重单附件上限 64 MiB对话同步已保存消息发送中的运行状态留在本机文件夹、关系、回收站、技能同步结构化记录技能内容不会获得执行权限模型 API Key、云会话令牌、本机目录授权、界面设置留在当前设备另一台 Mac 需自行配置论文 Markdown、导出目录属于派生文件会根据同步后的论文记录重新生成。特别注意如果把密码等敏感文字直接写进笔记或对话正文它们仍会作为内容同步——同步字段过滤不等于秘密识别。自动同步与冲突处理 ⚖️本机保存先写本地数据网络同步由后台线程完成关闭自动同步后仍可点立即同步断网时待上传内容保留重连后继续。设置页会实时显示待同步数量、最近同步时间与离线/冲突状态较大的资料库分批处理。两台设备同时保存不同实体或不同字段时可通过三方合并保留但双方修改同一段笔记、同一字段或一端删除另一端修改时系统不会拼接文本而是在处理冲突中让你选择保留本机或使用云端。删除也是同步操作移入回收站会同步状态与恢复记录但永久删除不等于清除云端历史和附件副本。备份与日常维护 ️服务器端升级前先停服务备份整个cloud_data或 SSH 部署的data目录不要只复制运行中的.sqlite3而遗漏 WAL 和附件卷步骤见 cloud/README.md 与 cloud/SSH_DEPLOY.md。Mac 端本地 SQLiteworkspace.sqlite3是规范数据源建议在应用停止写入后备份整个本地数据目录跨设备恢复备份时应排除cloud-sync会话凭据文件并在目标设备重新登录。会话令牌由本地 Python 后端持有保存在权限受限的cloud-session.json目录 0700 / 文件 0600服务端只存令牌哈希。排障顺序先看服务器健康检查 → 再查 SSH 会话与端口占用 → 登录失败时用云账号而非 SSH 账号 → 提示目标不匹配时核对 URL 与账号当前版本不支持迁移绑定。总结 ✅AIBro 自托管云同步让你用一台 Linux 服务器就能实现跨 Mac 的知识、任务与资料同步有域名就上 Docker Compose Caddy 的 HTTPS 方案无域名就用 SSH 隧道方案。部署完成后在设置 → 账号与云同步填写地址和账号确认合并两台电脑就能持续保持一致。记住三个关键点地址绑定一经建立不可随意更改、冲突必须人工裁决、服务器端与本地端都要定期备份。延伸阅读docs/CLOUD_SYNC.md、cloud/README.md、cloud/SSH_DEPLOY.md赞分享【免费下载链接】AIBroAI Bro — a local-first workspace for AI conversations, source-linked knowledge, and tasks.项目地址https://gitcode.com/gh_mirrors/aib/AIBro点击查看免费下载相关推荐Readest服务器配置自托管同步服务指南Readest服务器配置自托管同步服务指南 为什么需要自托管同步服务 你是否曾遇到过在不同设备间切换阅读时进度无法同步的困扰或者担心云端服务的隐私安全问题前端桌面应用移动开发跨平台Readest自托管同步服务3步搭建你的私有阅读云Readest自托管同步服务3步搭建你的私有阅读云 还在为多设备间阅读进度不同步而烦恼吗担心云端服务的隐私安全问题Readest自托管同步服务让你完全掌控前端桌面应用移动开发跨平台如何快速部署 Notesnook 同步服务器完整自托管指南如何快速部署 Notesnook 同步服务器完整自托管指南 Notesnook 同步服务器是为开源笔记应用 Notesnook 提供数据同步功能的核心组件。这创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑