Skip to content

Docs: AstrBotDevs/AstrBot#4813 #113

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
astrbot-doc-agent wants to merge 1 commit into
base: v4
Choose a base branch
from
Open

Docs: AstrBotDevs/AstrBot#4813 #113

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .vitepress/config.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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" },
Expand Down Expand Up @@ -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" },
Expand Down
86 changes: 86 additions & 0 deletions en/deploy/astrbot/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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.
88 changes: 88 additions & 0 deletions zh/deploy/astrbot/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 用户重新拉取镜像即可，面板用户可通过面板一键更新。