让AI助手在服务器上7×24小时在线Docker部署Kiro Crew完整教程多架构镜像数据持久化【免费下载链接】KiroCrewA persistent workspace for development work that self-improves and continues beyond one session.项目地址: https://gitcode.com/gh_mirrors/ki/KiroCrewKiro Crew 是一个会自我改进、并能跨会话持续工作的 AI 开发工作区。通过Docker 部署 Kiro Crew你可以在服务器或 NAS 上让 AI 助手 7×24 小时在线——无需桌面会话频道机器人Slack / Discord / Telegram / 企业微信 / Webex全天候待命。官方镜像同时提供linux/amd64和linux/arm64多架构版本配合单个命名卷完成数据持久化升级时聊天历史、Agent 和技能配置全部原样保留。一、为什么用 Docker 部署 Kiro Crew Docker 官方镜像运行的是 Kiro Crew 的gateway网关仪表盘 频道机器人 定时任务 kiro-cli 智能体运行时全部封装在一个无头容器里。它是最适合常驻服务器的形态无需桌面环境网关以无头方式运行服务器、NAS、树莓派ARM 架构都能跑官方公共镜像无需登录镜像仓库docker pull直接拉取数据全在一个卷里网关状态、登录凭据、Agent、技能都放在/home/kirocrew一个命名卷全部持久化内置健康检查镜像自带HEALTHCHECK编排器可直接使用二、一键启动docker run 快速部署环境只需 DockerDocker 23 默认带 BuildKit 即可。在服务器上执行docker run -d --name kirocrew \ -p 127.0.0.1:5476:5476 \ -v kirocrew-home:/home/kirocrew \ ghcr.io/kirodotdev/kirocrew:stable三个参数各有用途参数作用-p 127.0.0.1:5476:5476仪表盘端口 5476默认仅本机可访问安全默认值-v kirocrew-home:/home/kirocrew命名卷持久化全部状态推荐命名卷而非目录绑定属主与镜像内非 root 用户一致:stable标签最新稳定版多架构清单自动匹配 amd64 / arm64 容器内以 uid 1000 的非 root 用户运行所有持久状态都位于/home/kirocrew下。三、多架构镜像与版本标签怎么选每个标签都同时发布linux/amd64与linux/arm64两种架构Docker 会自动匹配当前服务器标签含义stable/latest最新稳定版每次稳定发布后滚动更新insider最新内测预发布版nightly最新每日构建0.1.0、0.1.0-insider.4等精确不可变版本号生产建议固定版本号甚至摘要 digest部署保证可复现稳定尝鲜则用stable。镜像构建细节可参考 docker/Dockerfile——它使用 CI 构建的 wheel 包确保 Docker 与 pip 安装的字节级一致。四、首次运行两步走登录 Agent 打开仪表盘容器跑起来后只需两个一次性步骤4.1 登录智能体运行时聊天会话依赖 kiro-cli首次需要交互登录务必加-it分配终端docker exec -it kirocrew kiro-cli login凭据保存在kirocrew-home卷中容器升级、重建后登录状态依然保留只需做一次。4.2 生成仪表盘访问令牌仪表盘的所有请求都需要 token自己签发一个带 2 小时有效期的登录链接docker exec kirocrew kirocrew token --ttl 2h复制输出的链接把主机名替换为你访问容器的方式本机即http://localhost:5476/?token...立刻在浏览器打开——登录链接生成几分钟后就过期先签发、后打开。登录后可以看到仪表盘全貌会话、定时任务、工件、频道、自动改进等模块全部集中在这一处。五、接入频道机器人让助手真正 7×24 在线这是 Docker 部署最值钱的场景——在 compose 文件中通过环境变量传入频道凭据compose 会自动读取同目录.env切勿提交真实值环境变量对应频道SLACK_BOT_TOKEN、SLACK_APP_TOKEN、KIROCREW_OWNER_IDSlack 机器人DISCORD_BOT_TOKENDiscord 机器人TELEGRAM_BOT_TOKENTelegram 机器人WECOM_BOT_ID、WECOM_SECRET企业微信机器人WEBEX_BOT_TOKENWebex 机器人KIRO_API_KEYkiro-cli 模型凭据免交互登录的替代方式推荐直接使用仓库内置的 compose 模板复制 docker/compose.yaml 后执行docker compose up -d。凭据卫生方面有个巧妙设计每次启动时docker/entrypoint.sh 会把环境变量中的凭据写入数据主目录的.env文件权限 600再从进程环境中清除——凭据不会长期暴露在网关进程的/proc/pid/environ里。六、数据持久化与升级一个卷全部搞定持久化范围网关状态~/.kiro/crew、kiro-cli 登录凭据、Agents、技能——全部位于/home/kirocrew即kirocrew-home一个命名卷。升级只需两行docker compose pull docker compose up -d镜像不可变、状态在卷里拉取新镜像重启后历史原样延续。容器内没有自动更新标签就是版本选择器渠道标签随渠道滚动版本标签锁定。七、常见问题速查 ⚡问题解决思路仪表盘打不开用docker port kirocrew检查端口映射确认容器内KIROCREW_BIND仍为0.0.0.0覆盖成 127.0.0.1 会导致宿主机无法访问Agent 命令被拒绝沙箱容器沙箱探测失败时默认失败即关闭。推荐加载 docker/seccomp/kirocrew-seccomp.json 安全配置启用内部沙箱或明确设置-e KIROCREW_ALLOW_UNSANDBOXED1接受容器为唯一隔离边界权限被拒绝卷属主须为 uid 1000镜像内 kirocrew 用户命名卷首次使用会自动继承属主局域网/远程访问发布5476:5476只是第一步还需在config.json设置dashboard.url或KIROCREW_CORS_ORIGINS推荐在 TLS 反向代理后面提供服务健康检查镜像内置HEALTHCHECK探测/api/health编排器还可使用免 token 的/api/live与/api/ready更多端口、沙箱、健康检查与数据恢复的深度排障见 docs/guides/docker-troubleshooting.md。八、延伸阅读完整 Docker 部署指南docs/guides/docker.mdCompose 模板含全部频道凭据映射docker/compose.yaml镜像构建与安全设计docker/Dockerfile启动脚本与沙箱探测逻辑docker/entrypoint.sh照这篇文章走完你的 AI 助手就已经在服务器上 7×24 小时值守了白天在仪表盘里派活夜里频道机器人在群里待命升级时一条命令完成且状态无损。【免费下载链接】KiroCrewA persistent workspace for development work that self-improves and continues beyond one session.项目地址: https://gitcode.com/gh_mirrors/ki/KiroCrew创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考