【免费下载链接】hope-agent A cross-device desktop AI agent with memory, autonomous goals, dynamic workflows, and headless deployment | 会记忆、能持续推进目标、会动态编排多 Agent 的跨端桌面 AI 助手也可服务化常驻 NAS / 云端项目地址https://gitcode.com/gh_mirrors/ho/hope-agent点击查看免费下载Hope Agent 是一款会记忆、能持续推进目标、可动态编排多 Agent 的跨端桌面 AI 助手除了装在本机它还支持 Docker 容器化部署。本教程带你用 Docker 把 Hope Agent 自托管到 NAS 或云 VPS 上打造一个 7x24 小时在线、手机/电脑远程访问的个人 AI 服务——即使电脑关机它仍在后台执行定时任务、积累记忆、推进长期目标。为什么要把 AI 助手部署成 7x24 在线服务桌面端 AI 助手有个天然限制电脑一关机服务就停。而 Hope Agent 的服务端模式hope-agent server内嵌了完整的 Web GUI浏览器打开端口就能看到与桌面端一致的界面。这意味着夜间跑长任务Goal 持续推进、定时任务cron按计划执行第二天早上直接看结果随时随地访问出差、通勤路上用手机浏览器就能和家里的 AI对话记忆持续沉淀会话历史、记忆库、知识空间常驻在一台机器上跨设备共享同一份状态硬件成本低一台闲置 NAS群晖、威联通等 ARM 设备或低配云 VPS 即可官方镜像同时提供linux/amd64与linux/arm64两种架构官方文档说明容器化的是完整的 HTTP/WebSocket 服务器包含 Onboarding 向导、Provider / MCP / IM 渠道配置面板与全部对话功能详见 docs/deployment/docker.md。部署前准备一台有 Docker 的机器你需要任意一种环境环境典型配置说明家用 NAS群晖 / 威联通 / UNR 等ARM 架构跑 arm64 镜像功耗极低云 VPS2 核 2G 起公网可达适合远程访问闲置 Linux 主机任意局域网或公网暴露均可唯一的硬性要求是装好Docker 与 docker compose。无需提前 clone 源码官方多架构镜像已构建好ghcr.io/shiwenwen/hope-agent:latest 生产环境建议固定具体版本 tag如v0.2.1而非latest升级更可控。一键启动docker compose 最快部署方法仓库根目录已提供官方 docker-compose.yml把它放到服务器后执行# 1. 启动容器 docker compose up -d # 2. 查看自动生成的 Owner Token首次访问的关键凭据 docker compose exec hope-agent hope-agent server token show # 3. 跟踪日志确认启动成功 docker compose logs -f hope-agentcompose 文件的关键点见 docker-compose.yml默认只监听127.0.0.1:8420——只允许本机访问最安全所有数据持久化在命名卷hope-data对应容器内/data即HA_DATA_DIR首次启动若未提供 TokenDocker 会自动生成一枚以 0600 权限保存在/data/credentials/server-auth.json也支持一行docker run启动docker run -d --name hope-agent \ -p 127.0.0.1:8420:8420 \ -v hope-data:/data \ ghcr.io/shiwenwen/hope-agent:latest首次访问拿到 Owner Token 完成 Onboarding浏览器打开http://你的服务器IP:8420局域网直连或 SSH 端口转发首次会看到 Auth Gate 登录页粘贴刚才token show输出的 Owner Token 即可。它会换取一个HttpOnly SameSiteStrict的浏览器会话 Cookie——Root Token 永远不会进入 URL 或 localStorage。登录后跟着 Onboarding 向导走完三步添加 Provider填入你常用大模型服务的 API Key记忆设置确认跨会话记忆的开启方式IM 渠道可选接入常用聊天软件从此手机聊天软件里直接指挥它完成后的界面与桌面端完全一致左侧是会话与项目右侧是会话元信息面板7x24 在线能干什么定时任务、长期目标与数据洞察服务常驻后Hope Agent 的自主性才真正发挥出来⏰定时任务用 cron 让它在每天固定时间抓取信息、生成日报TZ环境变量决定调度时区长期 Goal设定结果与完成标准它会持续分解、执行、检查、推进支持预算控制、暂停与恢复Dashboard 洞察Web 端内置数据面板可查看会话量、Token 用量、成本趋势、错误率与健康评分7x24 运行情况一目了然知识空间你与 AI 共同维护真实 Markdown 笔记支持全文与向量检索、反向链接随时远程补充第二大脑远程访问公网暴露与 Caddy TLS 反向代理⚠️安全底线公网访问必须上 HTTPS且必须持有 Owner Token。非回环监听缺少 Token 时服务会直接拒绝启动不会静默降级。要把服务暴露到 LAN 或公网做三件事保留 Owner Token或改用HA_API_KEY_FILE挂载 Secret 文件生产环境推荐修改端口映射去掉127.0.0.1:前缀8420:8420前置 Nginx / Caddy / Traefik 做 TLS 终止Caddy 配置最简自动处理 WebSocket upgrade而 Hope Agent 的流式回复依赖/api/ws/...WebSocket 通道hope.example.com { reverse_proxy 127.0.0.1:8420 }Token 泄露了怎么办在 Web 端「设置 → 服务器」可在线轮换新 Token 只显示一次且旧会话与 Bearer 客户端立即全部失效CLI 方式hope-agent server token rotate轮换后需重启容器生效。常用环境变量速查变量默认值用途HA_BIND0.0.0.0:8420监听地址容器内勿改成回环否则拒绝外部连接HA_API_KEY/HA_API_KEY_FILE未设置外部托管 Owner Token文件形式优先生产推荐TZUTC时区影响 cron 定时任务NAS 部署建议设为Asia/ShanghaiHA_DATA_DIR/data数据根目录所有配置、会话、记忆、凭据都在此进阶一接入 Ollama 本地模型免费跑推理不想用云端 API Key 的话compose 文件内置了 Ollama sidecardocker compose --profile with-ollama up -d然后在 Web 面板添加 Provider类型选OpenAI ChatOllama 提供 OpenAI 兼容端点Base URL 填http://ollama:11434/v1模型名按docker compose exec ollama ollama pull qwen2.5-coder:7b拉取后的模型填写即可。带 GPU 的 VPS 可解开 compose 里 ollama 服务的 NVIDIA 透传注释块需宿主机安装 nvidia-container-toolkit。进阶二Docker 隔离沙箱让 Agent 安全执行命令容器部署下 Hope Agent 的工具执行支持isolated沙箱模式它会先创建有界临时副本流式上传到一次性子容器的匿名/workspace命令结束后子容器连同数据一并删除修改不回写真实工作区。启用方式见 docker-compose.yml 注释volumes: - hope-data:/data - /var/run/docker.sock:/var/run/docker.sock group_add: - ${DOCKER_GID}其中DOCKER_GID用stat -c %g /var/run/docker.sock获取。安全警告Docker socket 等价于宿主机高权限只在可信的单租户部署中启用切勿把 socket 改成 0666 或让 Hope Agent 以 root 运行。升级与备份数据不丢的运维要点升级只需两条命令数据卷自动复用配置/历史/凭据全部保留docker compose pull hope-agent docker compose up -d hope-agent注意HA_DEPLOYMENTdocker这个变量不要改——它会提示更新器跳过容器内 binary swap引导你走docker pull路径见 docker/docker-entrypoint.sh。备份则只需要卷/data下包含config.json全局配置、sessions.db/memory.db会话与记忆、credentials/凭据0600 权限等用docker run --rm -v hope-data:/d -v /backup:/b alpine tar czf /b/hope-data.tar.gz -C /d .定期打包即可。若用 bind mount 替代命名卷记得给目录赋 UID 1000 写权限容器内运行用户hope。常见问题速答端口拒绝连接容器内必须绑定0.0.0.0检查HA_BIND是否被错误覆盖为127.0.0.1:...ARM Mac / 树莓派 / NAS 能跑吗能linux/arm64镜像与 amd64 完全等价升级后历史消失数据卷没挂对重建容器时确保/datavolume 名称一致忘记 Owner Tokendocker compose exec hope-agent hope-agent server token show切勿把输出贴进日志或工单server status报 no server容器内服务是前台进程这是正常现象用docker logs或内置 HEALTHCHECK 查状态写在最后从docker compose up -d到打开 Web 面板全程不超过 10 分钟你就拥有了一个永不掉线的私人 AI 服务NAS 里安静运行着 Hope Agent白天在手机上问它问题、让它整理知识空间睡前给它一个长期 Goal醒来查看 Dashboard 里的执行结果。更多环境变量细节与自建镜像指南可查阅官方 docs/deployment/docker.md 与 Dockerfile 中的多阶段构建注释。赞分享【免费下载链接】hope-agent A cross-device desktop AI agent with memory, autonomous goals, dynamic workflows, and headless deployment | 会记忆、能持续推进目标、会动态编排多 Agent 的跨端桌面 AI 助手也可服务化常驻 NAS / 云端项目地址https://gitcode.com/gh_mirrors/ho/hope-agent点击查看免费下载相关推荐Refly部署完全教程从云服务到自托管的完整解决方案Refly部署完全教程从云服务到自托管的完整解决方案 Refly是一款开源的AI原生创作引擎提供直观的自由画布界面结合多线程对话、知识库集成和智能搜索功能人工智能AI 应用大模型AI AgentAgent 工作流AI 技能RAGPaseo Docker 部署完全指南在服务器与 NAS 上自托管多智能体编排守护进程Paseo Docker 部署完全指南在服务器与 NAS 上自托管多智能体编排守护进程 本文基于 docker/README.md https://link.Shlink Docker部署教程容器化自托管URL服务Shlink Docker部署教程容器化自托管URL服务 Shlink是终极自托管URL短链接服务解决方案让您完全掌控自己的短链接服务。通过Docker容器后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考