diff --git a/.vitepress/config.mjs b/.vitepress/config.mjs index c826893..5341661 100644 --- a/.vitepress/config.mjs +++ b/.vitepress/config.mjs @@ -47,7 +47,9 @@ export default defineConfig({ text: "部署 AstrBot", base: "/deploy/astrbot", collapsed: false, + link: "/index", items: [ + { text: "🚀 部署概览", link: "/index" }, { text: "🦈 Docker 部署", link: "/docker" }, { text: "☸️ Kubernetes 部署", link: "/kubernetes" }, { text: "☁️ 雨云一键云部署(NEW)", link: "/rainyun" }, @@ -271,7 +273,9 @@ export default defineConfig({ text: "Deploy AstrBot", base: "/en/deploy/astrbot", collapsed: true, + link: "/index", items: [ + { text: "🚀 Deployment Overview", link: "/index" }, { text: "🦈 Docker Deployment", link: "/docker" }, { text: "☸️ Kubernetes Deployment", link: "/kubernetes" }, { text: "👍 Manual Deployment", link: "/cli" }, diff --git a/en/deploy/astrbot/index.md b/en/deploy/astrbot/index.md new file mode 100644 index 0000000..65616d0 --- /dev/null +++ b/en/deploy/astrbot/index.md @@ -0,0 +1,86 @@ +# Deploy AstrBot + +Choose the deployment method that best suits your needs: + +## 🚀 Recommended for Beginners (Simple & Fast) + +### Docker Deployment (Highly Recommended) +Using Docker / Docker Compose is the easiest way to deploy AstrBot. + +```bash +# 1. Download docker-compose.yml +wget https://raw.githubusercontent.com/AstrBotDevs/AstrBot/main/docker/docker-compose.yml + +# 2. Start the service +docker-compose up -d + +# 3. Access WebUI +# Default address: http://localhost:8000 +``` + +For detailed instructions, see [Docker Deployment](./docker.md). + +### BT Panel Deployment +AstrBot is available in the BT Panel App Store. +1. Log in to BT Panel +2. Go to [App Store] +3. Search for "AstrBot" +4. Click [One-click Deployment] + +For detailed instructions, see [BT Panel Deployment](./btpanel.md). + +### 1Panel Deployment +AstrBot is available in the 1Panel App Store. +1. Log in to 1Panel +2. Go to [App Store] +3. Search for "AstrBot" +4. Click [Install] + +For detailed instructions, see [1Panel Deployment](./1panel.md). + +## 🔧 Advanced Deployment + +### uv Deployment (Python Users) +If you are familiar with the Python environment, you can use uv: +```bash +# Install and start AstrBot +uvx astrbot +``` + +For detailed instructions, see [Manual Deployment](./cli.md). + +## ☁️ Cloud Deployment + +### Deploy on RainYun +AstrBot is available on the RainYun cloud application platform for one-click deployment. +[Click here to deploy on RainYun](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0) + +## 💻 Special Platform Deployment + +### Windows One-click Installer +Graphical installation for Windows users. +[Download Windows Installer](./windows.md) + +### CasaOS Deployment +Deployment for CasaOS users. +[Deploy AstrBot on CasaOS](./casaos.md) + +## 📋 Comparison of Deployment Methods + +| Method | Pros | Cons | Use Case | +|----------|------|------|----------| +| Docker | Isolation, Simple | Requires Docker knowledge | Recommended for Production | +| BT Panel | GUI, Easy | Linux only | Server O&M | +| 1Panel | Modern GUI, Feature-rich | Newer project | Modern O&M | +| uv | Lightweight, Native Python | Requires Python env | Local Development | + +## 🛠️ FAQ + +**Q: Cannot access WebUI after Docker deployment?** +A: Check firewall settings and ensure port 8000 is open. + +**Q: How to change the default port?** +A: Modify the port mapping in `docker-compose.yml`. + +**Q: How to update after deployment?** +A: Docker users can pull the latest image. Panel users can update via the panel. diff --git a/zh/deploy/astrbot/index.md b/zh/deploy/astrbot/index.md new file mode 100644 index 0000000..7c1e3e4 --- /dev/null +++ b/zh/deploy/astrbot/index.md @@ -0,0 +1,88 @@ +# 部署 AstrBot + +选择最适合您需求的部署方式: + +## 🚀 初学者推荐(简单快捷) + +### Docker 部署(最推荐) +使用 Docker / Docker Compose 是部署 AstrBot 最简单的方式。 + +```bash +# 1. 下载 docker-compose.yml 文件 +wget https://raw.githubusercontent.com/AstrBotDevs/AstrBot/main/docker/docker-compose.yml + +# 2. 启动服务 +docker-compose up -d + +# 3. 访问 WebUI +# 默认地址: http://localhost:8000 +``` + +详细教程请参阅 [Docker 部署](./docker.md)。 + +### 宝塔面板部署 +AstrBot 与宝塔面板合作,已上架至宝塔面板应用商店。 +1. 登录宝塔面板 +2. 进入【软件商店】 +3. 搜索"AstrBot" +4. 点击【一键部署】 + +详细教程请参阅 [宝塔面板部署](./btpanel.md)。 + +### 1Panel 部署 +AstrBot 已由 1Panel 官方上架至 1Panel 应用商店。 +1. 登录 1Panel 控制台 +2. 进入【应用商店】 +3. 搜索"AstrBot" +4. 点击【安装】 + +详细教程请参阅 [1Panel 部署](./1panel.md)。 + +## 🔧 进阶部署方式 + +### uv 部署(Python 用户) +如果您熟悉 Python 环境,可以使用 uv 部署: +```bash +# 安装并启动 AstrBot +uvx astrbot +``` + +详细教程请参阅 [手动部署](./cli.md)。 + +## ☁️ 云平台部署 + +### 在 雨云 上部署 +AstrBot 已由雨云官方上架至云应用平台,可一键部署。 +[点击这里在雨云上部署](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0) + +详细教程请参阅 [雨云部署](./rainyun.md)。 + +## 💻 特殊平台部署 + +### Windows 一键安装器 +适合 Windows 用户的图形化安装方式。 +[下载 Windows 一键安装器](./windows.md) + +### CasaOS 部署 +适合 CasaOS 用户的部署方式。 +[在 CasaOS 上部署 AstrBot](./casaos.md) + +## 📋 部署方式对比 + +| 部署方式 | 优点 | 缺点 | 适用场景 | +|----------|------|------|----------| +| Docker | 环境隔离、部署简单 | 需要学习 Docker | 生产环境推荐 | +| 宝塔面板 | 图形界面、操作简单 | 仅限 Linux 服务器 | 服务器运维 | +| 1Panel | 现代化界面、功能丰富 | 较新项目 | 现代化运维 | +| uv | 轻量级、Python 原生 | 依赖 Python 环境 | 本地开发 | + +## 🛠️ 常见问题 + +**Q: Docker 部署后无法访问 WebUI?** +A: 检查防火墙设置,确保 8000 端口已开放。 + +**Q: 如何修改默认端口?** +A: 在 docker-compose.yml 中修改端口映射配置。 + +**Q: 部署后如何更新版本?** +A: Docker 用户重新拉取镜像即可,面板用户可通过面板一键更新。