mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-10-29 11:56:02 +08:00
62 lines
2.2 KiB
Plaintext
62 lines
2.2 KiB
Plaintext
---
|
||
title: "Docker部署"
|
||
description: "在 Windows、Linux 或 macOS 上使用 Docker Compose 部署 LangBot。"
|
||
---
|
||
|
||
## 1. 准备环境
|
||
|
||
- 安装 Git。
|
||
- **Windows / macOS**：安装并启动 Docker Desktop。
|
||
- **Linux**：安装 Docker 和 Docker Compose。
|
||
|
||
## 2. 下载项目
|
||
|
||
请选择有写入权限的普通目录。Linux 用户请避开 `/root`、`/etc` 等系统目录，建议放在 `/opt` 下，以免沙箱功能被安全规则拦截。
|
||
|
||
在准备存放项目的目录打开终端（Windows 可用 PowerShell），逐行执行：
|
||
|
||
```bash
|
||
git clone https://github.com/langbot-app/LangBot
|
||
cd LangBot/docker
|
||
```
|
||
|
||
### 中国大陆用户：启动前更换镜像源（可选）
|
||
|
||
如果 Docker Hub 下载较慢，先编辑 `LangBot/docker/docker-compose.yaml`，将文件中的所有 `rockchin/langbot:latest` 替换为：
|
||
|
||
```text
|
||
docker.langbot.app/langbot-public/rockchin/langbot:latest
|
||
```
|
||
|
||
保存后再启动，无需更改其他配置。
|
||
|
||
## 3. 启动 LangBot
|
||
|
||
<Note>
|
||
如果部署在服务器上，请通过防火墙限制管理页面和运行时端口的访问，仅允许可信来源连接。
|
||
</Note>
|
||
|
||
在刚才的终端中执行：
|
||
|
||
```bash
|
||
docker compose --profile all up -d
|
||
```
|
||
|
||
首次启动需要下载镜像。Windows / macOS 用户请保持 Docker Desktop 运行。
|
||
|
||
## 4. 打开管理页面
|
||
|
||
- **本机部署**：打开 `http://localhost:5300`。
|
||
- **服务器部署**：打开 `http://你的服务器IP:5300`，确保防火墙允许你的设备访问该端口。
|
||
|
||
按照页面提示完成初始化，再添加[模型](/zh/usage/models/readme)和[机器人](/zh/usage/platforms/readme)。
|
||
|
||
## Beta 版本（可选）
|
||
|
||
如需试用 Beta 而非上述稳定版，请将 [dev/4.11.x 的 Compose 文件](https://raw.githubusercontent.com/langbot-app/LangBot/dev/4.11.x/docker/docker-compose.yaml)下载为 `compose.yaml`，保存到单独的可写目录。手动将**所有** `rockchin/langbot` 镜像改为 `rockchin/langbot:beta`：包括 Core（`langbot`）、插件运行时（`langbot_plugin_runtime`）和 Box（`langbot_box`，若存在）。每次发布 Beta 都会更新 `beta` 标签。在该目录执行以下命令启动或更新：
|
||
|
||
```bash
|
||
docker compose --profile all pull
|
||
docker compose --profile all up -d
|
||
```
|