Memoh跨平台部署指南macOS、Windows与中国区镜像加速一键安装教程【免费下载链接】Memoh✨ The open-source multi-agent platform. Every agent gets its own computer, desktop, network, and long-term memory. You can bring your own key, or host your coding agent like Claude Code, Codex and so on.项目地址: https://gitcode.com/gh_mirrors/me/MemohMemoh是一款开源的多智能体Multi-Agent平台每个 AI 智能体都能获得一台专属云电脑——独立的文件系统、桌面、浏览器、网络和长期记忆7×24 小时在线。你可以在 Mac、Windows 或 Linux 上通过 Docker Compose 自托管 Memoh也可以使用自带的 API Key 运行内置智能体或托管 Claude Code、Codex 等编码 Agent。本文手把手带你完成 Memoh 的跨平台部署并教你用中国区镜像加速解决拉取镜像慢的痛点。部署前准备环境要求清单无论选择哪种安装方式请先确认本机满足以下前提条件依赖说明Docker需要 Docker Compose v2Docker Desktop 或 docker compose 插件Git手动安装时需要克隆仓库内存建议 8GB 以上为每个 Agent 容器预留空间提示Memoh 的 Web UI 运行在http://localhost:8082API 服务在http://localhost:8080部署完成后请确认这两个端口未被占用。完整的环境说明可参考官方部署文档DEPLOYMENT.md一键安装3 步跑起完整多智能体平台最快的方式是使用官方一键安装脚本它会自动提示配置、生成config.toml并启动全部服务curl -fsSL https://memoh.sh | sh安装过程要点以普通用户身份运行不要对整个脚本使用sudo脚本会在 Docker 需要时自行调用sudo docker按交互提示选择数据库驱动默认postgres与工作区后端默认containerd脚本生成配置后自动docker compose up -d等待几分钟即可访问控制台。中国区用户推荐直接启用镜像加速详见下文中国区镜像加速一节curl -fsSL https://memoh.sh | USE_CN_MIRRORtrue sh安装脚本的完整实现位于 scripts/install.sh支持--database-driver、--container-backend等参数自定义安装行为。中国区镜像加速memoh.cn 让镜像秒级拉取国内网络直连 Docker Hub 常常超时Memoh 提供了memoh.cn官方镜像源。方式一安装时自动启用curl -fsSL https://memoh.sh | USE_CN_MIRRORtrue sh脚本会生成指向memoh.cn的 Compose 覆盖文件并将config.toml中的镜像源开关自动打开。方式二手动部署时叠加 CN 覆盖层如果已经完成了手动安装只需两步编辑config.toml在[container]段取消注释中国区镜像源[container] backend containerd registry memoh.cn # 中国区镜像加速启动时叠加中国区 Compose 文件定义见 docker/docker-compose.cn.yml包含postgres、pgvector、server、web等服务的memoh.cn镜像地址docker compose -f docker-compose.yml -f docker/docker-compose.cn.yml up -d⚠️注意Webhook 隧道的cloudflared镜像与 Connect-It 镜像不在memoh.cn覆盖范围内如不需要可保持默认关闭不影响核心功能。手动安装用 Docker Compose 自定义部署 Memoh想精细控制部署按以下步骤克隆并启动git clone --depth 1 --recurse-submodules --shallow-submodules https://gitcode.com/gh_mirrors/me/Memoh cd Memoh cp conf/app.docker.toml config.toml修改config.toml模板见 conf/app.docker.toml生产环境务必改动以下项admin.password— 管理后台密码默认admin/admin123auth.jwt_secret— 用openssl rand -base64 32生成postgres.password— 数据库密码同时设置POSTGRES_PASSWORD环境变量然后启动docker compose up -dCompose 栈包含postgres、pgvector、migrate、server、web等服务AI Agent 运行在server进程内pgvector 服务负责记忆语义搜索。macOS 部署两种工作区后端怎么选macOS 上有两条部署路线对应不同的工作区后端[container].backend后端适用场景特点containerd已安装 Docker 的 Mac与官方 Docker Compose 栈一致推荐applemacOS 26使用 Apple 官方容器框架实验性功能无需 Docker使用一键脚本安装时macOS 用户无需sudoApple 后端的配置模板见 conf/app.apple.toml如果你更喜欢原生体验Memoh 还提供 Electron 桌面客户端可直接连接 Memoh Cloud 或自托管服务器源码与打包命令build:mac生成 DMG见 apps/desktop/。Windows 部署实验性功能与配置差异Windows 部署当前为实验性功能官方不建议直接用于生产环境。要点如下配置模板见 conf/app.windows.toml默认使用containerd后端Windows 下的 containerd 通常通过命名管道暴露默认值为npipe:////./pipe/containerd-containerd如你的管道名不同请修改[containerd].socket_path单机部署时保持internal_rpc.shared_secret为空server 会以单进程模式内嵌频道运行时无需额外的memoh-channel进程。 追求最稳定体验的 Windows 用户建议通过 WSL2 Docker Desktop 走标准的 Compose 部署路线。访问控制台登录 Memoh Web 界面完成验证服务启动后浏览器打开http://localhost:8082使用admin/admin123或你修改后的密码登录。登录后建议完成两件事接入模型供应商在 Providers 页面填入你自己的 API Key支持 OpenAI、Anthropic、Google、DeepSeek、Moonshot、Ollama 等点击 Test Connection 验证连通性创建第一个智能体为 Bot 指定模型确认其专属容器状态为 Running然后在 Web、Telegram、Discord、微信等平台与它对话。常用维护命令与故障排查日常运维只需记住这组 Docker Compose 命令docker compose up -d # 启动 docker compose down # 停止 docker compose ps # 查看状态 docker compose logs -f server # 查看日志 docker compose pull docker compose up -d # 拉取新镜像升级遇到启动失败时依次排查docker compose config— 检查配置是否合法确认config.toml存在于项目根目录缺少它容器会直接启动失败docker compose build --no-cache docker compose up -d— 全量重建。安全提醒主服务拥有特权容器访问权限仅建议在受信任环境运行上线前请更换所有默认密码、配置 HTTPS 反向代理并设置防火墙。参考资料部署完整指南DEPLOYMENT.md中国区镜像覆盖层docker/docker-compose.cn.yml一键安装脚本scripts/install.shDocker 配置模板conf/app.docker.tomlApple / Windows 配置模板conf/app.apple.toml · conf/app.windows.toml桌面客户端apps/desktop/开发环境本地开发用devenv/docker-compose.yml按照本指南你应该已经在自己的机器上跑起了一个 7×24 小时在线的多智能体平台。接下来给它一台电脑、一个模型、一个聊天渠道看看你的第一个专属 Agent 能为你做些什么吧 【免费下载链接】Memoh✨ The open-source multi-agent platform. Every agent gets its own computer, desktop, network, and long-term memory. You can bring your own key, or host your coding agent like Claude Code, Codex and so on.项目地址: https://gitcode.com/gh_mirrors/me/Memoh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考