OpenHuman 云端部署指南：如何用 Docker 在服务器上快速运行你自己的 AI Agent

OpenHuman 云端部署指南如何用 Docker 在服务器上快速运行你自己的 AI Agent【免费下载链接】openhumanOpenHuman is an open source agent harness with local-first memory, agent orchestration, and workflows项目地址: https://gitcode.com/GitHub_Trending/op/openhumanOpenHuman 是一款开源的 AI Agent 框架内置本地优先的记忆系统、Agent 编排与自动化工作流。本篇OpenHuman 云端部署指南教你用 Docker 在 Linux 服务器上运行自己的 AI Agent只需 4 步即可完成部署。为什么要部署 OpenHuman 到云端桌面应用很强大但云端部署的 OpenHuman 能解锁更多场景 场景云端部署带来的好处多设备访问多台电脑指向同一个云端核心记忆与配置完全同步长任务运行定时任务、Webhook 自动触发不怕电脑关机团队协作内部成员无需本地 Rust 环境即可使用同一 Agent云端部署后你的 Agent 还能持续执行 gitbooks/features/workflows.md 中描述的自动化工作流例如自动创建 Notion 任务、向 Slack 频道推送结果这些任务即使你的笔记本合盖也能照常完成。部署前 3 分钟看懂架构OpenHuman 的核心是一个名为openhuman-core的无头 Rust 服务源码位于 crates/openhuman-core/它对外只暴露一个端口7788提供两个关键端点GET /health公开的健康检查接口用于确认服务存活POST /rpc需要 Bearer Token 认证的 JSON-RPC 入口所有指令都走这里它采用本地优先local-first的记忆设计所有记忆以树状摘要存储在工作区目录中部署到服务器后数据完全归你掌控⚠️ 工作区目录在容器内是/home/openhuman/.openhuman必须挂载到持久化卷否则重启会丢失记忆和配置。仓库根目录的 docker-compose.yml 已默认配好命名卷openhuman-workspace直接用它最省心。Docker Compose 一键部署最快启动步骤适用于任何装有 Docker 的 Linux 服务器Docker Engine ≥ 24 Compose 插件包括云主机 VPS 或家里的 NAS。第 1 步克隆仓库到服务器git clone https://gitcode.com/GitHub_Trending/op/openhuman cd openhuman第 2 步配置密钥文件仓库自带 Dockerfile多阶段构建产物极简和 .env.example 环境变量模板cp .env.example .env打开.env至少填好这两项Token 用openssl rand -hex 32生成拿到 Token 的人可以完全操控你的 Agent请像密码一样保管BACKEND_URLhttps://api.tinyhumans.ai OPENHUMAN_CORE_TOKEN刚生成的64位随机串第 3 步构建并启动docker compose up -dCompose 文件已经替你处理了很多细节只读根文件系统、no-new-privileges安全加固、4GB 内存/2 核 CPU 上限、自动重启策略以及内置健康检查。第 4 步验证部署成功docker compose ps curl -fsS http://localhost:7788/health返回正常即表示你的 AI Agent 已在服务器上跑起来了 4 个核心配置项说明配置项是否必填说明OPENHUMAN_CORE_TOKEN✅ 是/rpc接口的 Bearer Token远程部署务必显式设置BACKEND_URL✅ 是OpenHuman 后端地址生产环境填https://api.tinyhumans.aiOPENHUMAN_APP_ENV否production默认或stagingRUST_LOG否日志级别info日常足够排查问题改debug完整清单可参考 .env.example官方部署文档见 gitbooks/features/cloud-deploy.md。把桌面客户端连上云端核心服务器跑起来后桌面端无需任何改动即可接入。编辑 app/.env.local不存在则新建OPENHUMAN_CORE_RUN_MODEexternal OPENHUMAN_CORE_RPC_URLhttps://core.example.com/rpc OPENHUMAN_CORE_TOKEN服务器上相同的Token重启桌面应用即可。首次启动界面还提供了Test connection测试连接按钮填入 RPC 地址和 Token 就能提前验证连通性与鉴权失败会直接提示是连不通还是鉴权失败。 私有网络如 Tailscale 内网可用http://100.x.x.x:7788/rpc公网部署必须使用 HTTPS桌面端会拒绝明文 HTTP 的公网地址。安全部署 3 步HTTPS、防火墙与 Token 轮换① 套上 HTTPS。用 Caddy 做反向代理是最省心的方式core.example.com { reverse_proxy localhost:7788 }② 收紧防火墙。服务器防火墙只放行22、80、443端口不要把7788直接暴露到公网。③ 定期轮换 Token。怀疑泄露时立即执行# 更新 .env 中的 OPENHUMAN_CORE_TOKEN 后重建容器 docker compose up -d --force-recreate openhuman-core之后同步更新所有桌面客户端的 Token旧 Token 会收到 HTTP 401属正常现象。日常运维日志、更新与常见问题查看日志docker compose logs -f openhuman-core更新版本git pull docker compose build docker compose up -d常见问题速查症状大概率原因解决方式日志出现Permission denied (os error 13)工作区卷属主错误镜像自带的 scripts/docker-entrypoint-core.sh 会在启动时自动修复老容器可手动docker exec -u 0 openhuman-core chown -R openhuman:openhuman /home/openhuman/.openhuman后重启客户端收到 401Token 不一致或已轮换核对服务器.env与客户端app/.env.local中的OPENHUMAN_CORE_TOKEN是否一致OAuth 登录成功但显示失败BACKEND_URL未配置或服务器无法访问后端确认.env中BACKEND_URL正确且服务器出网正常并更新到最新版本重启后数据没了忘记挂载持久化卷检查 compose 中openhuman-workspace:/home/openhuman/.openhuman挂载是否存在总结跟着本文你已经完成了 OpenHuman 的云端部署全流程克隆仓库 → 配置 Token → docker compose 启动 → 验证健康检查再把桌面客户端指向云端核心一个 7×24 小时在线、数据完全自主的 AI Agent 就运行在你的服务器上了。更多高级玩法如 Fly.io 部署、持续集成、Token 轮换策略可继续阅读 gitbooks/features/cloud-deploy.md 与 fly.toml 模板。现在去和你的云端 Agent 打个招呼吧 【免费下载链接】openhumanOpenHuman is an open source agent harness with local-first memory, agent orchestration, and workflows项目地址: https://gitcode.com/GitHub_Trending/op/openhuman创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考