Xboard/README.md
xboard 4728784d1f fix: frontend styling and bug fixes, update deployment docs
- Fix class styling issues and adjust UI components
- Fix various minor bugs across the application
- Update deployment documentation with improved instructions
2025-01-07 12:41:52 +08:00

69 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 关于Xboard
Xboard New是基于Xboard二次开发重写后台管理并优化系统架构的**面板,提升可维护性
# 免责声明
本项目只是本人个人学习开发并维护,本人不保证任何可用性,也不对使用本软件造成的任何后果负责。
# Xboard New 特点
基于Xboard 二次开发,增加了以下特性
- 增加Octane支持
- 使用React + Shadcn UI + TailwindCSS重构后台管理
- 使用Vue3 + TypeScript + NaiveUI + Unocss + Pinia重构用户前端
- 使用Docker Compose作为容器化部署工具
- 使用Docker作为容器化部署工具
- 重构主题管理,增加主题上传,并且只暴露激活主题
- 使用Octane Cache作为设置的缓存
- 优化系统架构,提升可维护性
# **系统架构**
- PHP8.1+
- Composer
- MySQL5.7+
- Redis
- Laravel
- Octane
## 快速体验
使用以下命令快速部署并体验 Xboard基于 Docker + SQLite
```bash
git clone -b docker-compose --depth 1 https://github.com/cedar2025/Xboard && \
cd Xboard && \
docker compose run -it --rm \
-e enable_sqlite=true \
-e enable_redis=true \
-e admin_account=admin@demo.com \
web php artisan xboard:install && \
docker compose up -d
# 安装完成后访问 http://服务器IP:7001
```
> 提示:安装过程中会显示管理员账号密码,请务必保存。
## 页面展示
![示例图片](./docs/images/dashboard.png)
## 安装 / 更新 / 回滚
你可以点击查看下列方式的**安装、更新**步骤
- [1panel 部署](./docs/1panel安装指南.md)
- [Docker Compose 纯命令行快速部署](./docs/docker-compose安装指南.md)
- [aapanel + Docker Compose (推荐)](./docs/aapanel+docker安装指南.md)
- [aapanel 部署](./docs/aapanel安装指南.md)
### 从其他版本迁移
#### 数据库迁移
**根据你的版本查看对应的迁移指南进行迁移**
- v2board dev 23/10/27的版本 [点击跳转迁移指南](./docs/v2b_dev迁移指南.md)
- v2board 1.7.4 [点击跳转迁移指南](./docs/v2b_1.7.4迁移指南.md)
- v2board 1.7.3 [点击跳转迁移指南](./docs/v2b_1.7.3迁移指南.md)
- v2board wyx2685 [点击跳转迁移指南](./docs/v2b_wyx2685迁移指南.md)
### 注意
> 修改后台路径需要重启才能生效
```
docker compose restart
```
> 如果是是aapanel安装则需要重启 webman守护进程