Docker部署

1. 准备环境

• 安装 Git。
• Windows / macOS：安装并启动 Docker Desktop。
• Linux：安装 Docker 和 Docker Compose。

2. 下载项目

请选择有写入权限的普通目录。Linux 用户请避开 /root、/etc 等系统目录，建议放在 /opt 下，以免沙箱功能被安全规则拦截。

在准备存放项目的目录打开终端（Windows 可用 PowerShell），逐行执行：

git clone https://github.com/langbot-app/LangBot
cd LangBot/docker

中国大陆用户：启动前更换镜像源（可选）

如果 Docker Hub 下载较慢，先编辑 LangBot/docker/docker-compose.yaml，将文件中的所有 rockchin/langbot:latest 替换为：

docker.langbot.app/langbot-public/rockchin/langbot:latest

保存后再启动，无需更改其他配置。

3. 启动 LangBot

在刚才的终端中执行：

docker compose --profile all up -d

首次启动需要下载镜像。Windows / macOS 用户请保持 Docker Desktop 运行。

4. 打开管理页面

• 本机部署：打开 http://localhost:5300。
• 服务器部署：打开 http://你的服务器IP:5300，确保防火墙允许你的设备访问该端口。

按照页面提示完成初始化，再添加模型和机器人。

Beta 版本（可选）

如需试用 Beta 而非上述稳定版，请将 dev/4.11.x 的 Compose 文件下载为 compose.yaml，保存到单独的可写目录。手动将所有 rockchin/langbot 镜像改为 rockchin/langbot:beta：包括 Core（langbot）、插件运行时（langbot_plugin_runtime）和 Box（langbot_box，若存在）。每次发布 Beta 都会更新 beta 标签。在该目录执行以下命令启动或更新：

docker compose --profile all pull
docker compose --profile all up -d