LoopForge 平台可以通过官方仓库的 start.sh 脚本部署。准备 Docker、Compose、Git、Python 3 和 curl 后,检出 v0.4.0 再启动。访问安装器输出的地址创建首个管理员账号,然后用体验流程验证脚本和人工审批。
先检查主机依赖和端口
在要部署的主机上打开终端,依次运行下面的命令做校验。docker 的客户端和守护进程都要能正常调用:macos 用户得先启动 docker desktop,linux 用户要确认当前登录账号有权限访问 docker 服务。
git --version python3 --version curl --version docker version docker compose version
官方安装器会自动扫描所有依赖,在适配的 Linux 发行版上还会提示缺失依赖的安装方式。部署机网络要能正常拉取容器镜像,平台默认对外暴露 8090 端口,部署前先确认这个端口没被占用,同时把端口的访问范围限制在团队内部需要的网段里,别直接对公网全开。
检出发行版本并启动安装器
git clone --branch v0.4.0 https://github.com/Tencent/LoopForge.git cd LoopForge ./start.sh
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

这个 v0.4.0 版本默认用 compose.yaml 里写死的镜像 ghcr.io/tencent/loopforge:0.4.0,安装器会自动生成配置文件、启动数据库和平台所有服务,最后输出可访问的地址。第一次拉取镜像的耗时完全看当前网络情况,要是运行中途报了错,先把终端的原始报错信息存好,再考虑要不要重试。
GHCR 拉取慢时怎样核对镜像来源
官方支持通过 MIRROR 环境变量指定兼容的镜像源,比如下面的命令就会从指定的镜像站拉取,拉完之后自动给镜像打上平台需要的正确标签。用第三方镜像源等于你信任这个站点的内容,拉取完成后可以把镜像的 RepoDigests 与官方发行页给出的摘要做比对,确认内容没被篡改。
MIRROR=ghcr.nju.edu.cn ./start.sh
docker image inspect --format '{{index .RepoDigests 0}}' ghcr.io/tencent/loopforge:0.4.0
创建首个账号并验证页面可访问
用浏览器打开安装器终端输出的访问地址,第一个注册的账号自动成为平台管理员,注册完先确认能正常进入平台首页。如果是云主机部署,要同时检查防火墙和云服务商后台的安全组规则,确认 8090 端口已经放开。需要长期对外访问的话,可以参考官方文档配置 HTTPS 反向代理。

进入自带的体验项目,运行「平台验收 · 脚本与审批」流程,等脚本自动生成报告后走一遍人工确认流程,检查最终输出的产物是否正常。这一步能一次性把平台运行、Docker 沙箱、脚本执行、审批全链路都跑通,确认没问题之后再填大模型凭据,开始跑实际的编码任务。
服务未启动或页面打不开时怎么查
./start.sh logs docker compose ps
页面连不上的时候先查容器运行状态和端口映射规则:如果数据库还在初始化,结合日志判断是不是属于正常等待;要是数据库启动失败,优先排查磁盘空间、目录权限或者配置的凭据是否正确;如果是镜像相关报错,先核对镜像下载地址和当前网络连通性。停止服务直接运行 ./start.sh stop 就行,升级版本的时候先对照官方发行说明拉取对应版本的代码,确认好数据迁移要求之后再执行 ./start.sh pull。已经存了业务数据的实例,升级前一定要先做好备份。











