diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 4cfded2e6..266219fc6 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -32,11 +32,12 @@ export default defineConfig({ text: "部署 LangBot", collapsed: true, items: [ - { text: "一键部署", - items: [ - { text: "宝塔面板(推荐)", link: "/deploy/langbot/one-click/bt" }, - ], - }, + // { text: "一键部署", + // items: [ + // { text: "宝塔面板(推荐)", link: "/deploy/langbot/one-click/bt" }, + // ], + // }, + { text: "宝塔一键部署", link: "/deploy/langbot/one-click/bt" }, { text: "Docker部署", link: "/deploy/langbot/docker" }, { text: "手动部署", link: "/deploy/langbot/manual" }, ], diff --git a/docs/deploy/langbot/one-click/bt.md b/docs/deploy/langbot/one-click/bt.md index aefc477b7..91c94d9a2 100644 --- a/docs/deploy/langbot/one-click/bt.md +++ b/docs/deploy/langbot/one-click/bt.md @@ -1,40 +1,36 @@ # 一键部署(宝塔版) -> 即使用[宝塔面板](https://www.bt.cn/new/download.html?r=dk_LangBot)来进行LangBot的一键部署 +使用[宝塔面板](https://www.bt.cn/new/download.html?r=dk_LangBot)一键部署 LangBot。 ## 安装宝塔 :::warning - 如果你已经安装了宝塔,请更新到 **9.2.0** 及以上 - ::: > 服务器系统推荐(来自宝塔):Debian 12,Ubuntu 22等 > -> 本文默认所述的是拥有公网IPv4地址的服务器,如果是家用机器没有的,可以通过下文中的内网来访问相关页面 +> 本文默认所述的是拥有公网IPv4地址的服务器,如果是家用机器没有公网 IP,可以通过下文中的内网来访问相关页面 打开[宝塔面板](https://www.bt.cn/new/download.html?r=dk_LangBot),使用宝塔官方提供的Linux面板安装脚本,根据自己使用的系统选择对应的脚本 ![安装宝塔](/assets/image/bt_install_01.png) -复制对应脚本,粘贴到服务器,回车 - -按需更改用户名和密码 +复制对应脚本,粘贴到服务器执行。 ## 安装LangBot 等待一段时间后,宝塔安装完成 -可以看到提示信息中类似这样的一段,将外网面板地址复制到浏览器打开即可 +可以看到提示信息中类似这样的一段,将外网面板地址复制到浏览器打开。 ![宝塔访问地址](/assets/image/bt_install_02.png) -首次打开应该会弹出`推荐安装套件`,无需安装,关闭跳过即可 +首次打开应该会弹出`推荐安装套件`,无需安装,关闭跳过即可。 然后点击侧边栏的`docker`,首次会提示安装Docker和Docker Compose服务,点击立即安装,若已安装请忽略。 -然后在`Docker-应用商店`,搜索`LangBot`(注意大小写),然后点击`安装`,使用默认配置即可 +然后在`Docker -> 应用商店`,搜索`LangBot`(注意大小写),点击`安装`,使用默认配置。 稍等一段时间,可以看到提示名为`langbot_XXXX`的容器显示`运行中` @@ -46,10 +42,10 @@ 可以看到WebUI的配置页面(可视化配置页面)的外网和内网访问路径,复制公网地址,例如`http://xxx.xxx.xxx.xxx:5300`(xxx.xxx.xxx.xxx为宝塔面板IP,5300为端口号,可能变化,具体如图) -打开后输入管理员邮箱和密码(并记忆),然后点击初始化 +打开后输入管理员邮箱和密码,然后点击初始化。 -然后就可以在可视化界面进行配置了 +然后就可以在可视化界面进行配置了。 -如果你更偏好于直接修改json配置文件,你可以看上图的查看本地映射目录,进入安装目录,`data`文件夹用于存储配置文件,`plugins`文件夹用于存储插件相关 +如果你更偏好于直接修改json配置文件,你可以看上图的查看本地映射目录,进入安装目录,`data`文件夹用于存储配置文件,`plugins`文件夹用于存储插件相关。 -接下来你需要继续查看[部署消息平台](/deploy/platforms/aiocqhttp/napcat.html)页 +接下来请继续阅读[部署消息平台](/deploy/platforms/aiocqhttp/napcat.html)页。 diff --git a/docs/deploy/network-details.md b/docs/deploy/network-details.md index f3efcb66f..178d9b269 100644 --- a/docs/deploy/network-details.md +++ b/docs/deploy/network-details.md @@ -1,16 +1,12 @@ # 网络配置详解 -:::tip -LangBot和消息平台均可采用Docker部署, - -进而产生了四种不同的方式: +LangBot 和部分消息平台均可采用 Docker 部署,以下是四种情况下的网络配置详解。 +:::info 目录 [[toc]] - -本文旨在介绍这四种情况下的网络配置 ::: -## LangBot和消息平台都采用Docker +## LangBot 和消息平台均运行在 Docker 容器中 如果消息平台(NapCat/Lagrange)和 LangBot 均使用 Docker 启动,那么你需要配置 Docker 的网络连接。 @@ -41,20 +37,21 @@ networks: -## 仅LangBot使用使用Docker +## 仅 LangBot 运行在 Docker 容器中 -当只有LangBot采用Docker部署时,默认情况就已经映射了2280到2290这些端口给消息平台(因为只支持消息平台作为客户端连接)使用 +当只有 LangBot 采用 Docker 部署时,默认已经映射 2280 到 2290 端口到容器外。此时 LangBot 只能作为 WebSocket 服务器,接受消息平台作为客户端连接。 -所以消息平台设置为ReverseWebSocket(反向ws),端口在2280到2290之间,连接本地127.0.0.1即可 +请把消息平台设置为 ReverseWebSocket(称为 `反向 ws` 或 `WebSocket 客户端`),端口对应 LangBot 的 aiocqhttp 适配器启用的端口,连接本地 127.0.0.1 即可。 -## LangBot和消息平台都不使用Docker部署 +## LangBot 和消息平台都不使用 Docker 部署 -直接看文档配置消息平台和设置platforms即可,两者端口设置为统一的不被占用的即可,都连接本地127.0.0.1 +根据文档配置消息平台和 LangBot 设置,两者端口设置为统一的不被占用的即可,都连接本地 127.0.0.1。 - -## 仅消息平台使用Docker(这个不建议) +## 仅消息平台运行在 Docker 容器中(不建议) :::warning -这种情况不建议 -::: \ No newline at end of file +仅支持 Linux ,或其他支持 host 模式 docker 网络的系统。 +::: + +目前 LangBot 的 aiocqhttp 适配器仅支持 反向 WebSocket 连接,当消息平台运行在 Docker 容器中而 LangBot 直接运行在宿主机时,必须由 消息平台作为客户端连接 LangBot。此时只能将 消息平台的 network 设置为 `host` 模式,再设置其 WS 连接地址为 127.0.0.1,端口对应 LangBot 的 aiocqhttp 适配器启用的端口。 diff --git a/docs/index.md b/docs/index.md index bd3eeb7df..8f676351e 100644 --- a/docs/index.md +++ b/docs/index.md @@ -19,18 +19,19 @@ hero: features: - title: 丰富生态 - details: 支持事件监听、AI Agent 等插件扩展方式,具有多种插件或相关支持项目 + details: 支持事件监听、Agent 等插件扩展方式,具有数十种插件生态 - title: 功能直观 details: 集成黑名单、限速、选择响应、上下文控制、Prompt 管理等多种常用功能 - title: 多种模型 details: 适配 OpenAI、Moonshot、Anthropic、Gitee AI 等多个提供商,同时深度支持 OneAPI + - title: 高稳定性 details: 采用主流的设计思想,架构清晰,具有高测试覆盖率 - - title: 生产就绪 - details: 符合生产环境的高可用性要求,已被多家公司商用部署 + - title: 快速部署 + details: 支持多种部署方式,包括 宝塔一键部署、Docker 部署、源码部署 - title: 持续维护 details: 长期维护、迭代,持续跟进大模型领域的最新应用实践