update docs
Some checks are pending
Docker Build and Publish / build (push) Waiting to run

This commit is contained in:
xboard 2025-01-22 21:16:51 +08:00
parent 7acae3dcc4
commit 6c67cbf85a

View File

@ -1,27 +1,27 @@
# 关于Xboard # About Xboard
Xboard是基于V2board二次开发在性能上和功能上都有大部分增强的**面板 Xboard is a panel based on V2board's secondary development, with significant enhancements in both performance and functionality.
# 免责声明 # Disclaimer
本项目只是本人个人学习开发并维护,本人不保证任何可用性,也不对使用本软件造成的任何后果负责。 This project is personally developed and maintained by me for learning purposes. I do not guarantee any availability and am not responsible for any consequences resulting from the use of this software.
# Xboard 特点 # Xboard Features
基于V2board 二次开发,增加了以下特性 Based on V2board's secondary development, with the following added features:
- 升级Laravel10 - Upgraded to Laravel 10
- 适配Laravels 提升至10+倍并发) - Adapted to Laravels (10+ times concurrent improvement)
- 适配Webman 比laravels快50%左右) - Adapted to Webman (about 50% faster than laravels)
- 修改配置从数据库中获取 - Modified configuration retrieval from database
- 支持Docker部署、分布式部署 - Support for Docker deployment and distributed deployment
- 支持根据用户IP归属地来下发订阅 - Support for subscription distribution based on user IP location
- 增加Hy2支持 - Added Hy2 support
- 增加sing-box下发 - Added sing-box distribution
- 支持直接从cloudflare获取访问者真实IP - Support for obtaining real visitor IP directly from Cloudflare
- 支持根据客户端版本自动下发新协议 - Support for automatic new protocol distribution based on client version
- 支持线路筛选(订阅地址后面增加 &filter=香港|美国) - Support for route filtering (add &filter=HongKong|USA after subscription URL)
- 支持Sqlite安装代替Mysql自用用户福音 - Support for Sqlite installation (alternative to MySQL, great for personal use)
- 使用Vue3 + TypeScript + NaiveUI + Unocss + Pinia重构用户前端 - User frontend rebuilt using Vue3 + TypeScript + NaiveUI + Unocss + Pinia
- 修复大量BUG - Fixed numerous bugs
# **系统架构** # **System Architecture**
- PHP8.1+ - PHP8.1+
- Composer - Composer
@ -29,36 +29,36 @@ Xboard是基于V2board二次开发在性能上和功能上都有大部分增
- Redis - Redis
- Laravel - Laravel
## 性能对比 [查看详情](./docs/性能对比.md) ## Performance Comparison [View Details](./docs/性能对比.md)
> xboard 无论前端还是后端性能都有巨大的提升 > xboard shows tremendous performance improvements in both frontend and backend
|场景 | php-fpm(传统) | php-fpm(传统开启opcache) | laravels | webman(docker)| |Scenario | php-fpm(traditional) | php-fpm(traditional with opcache) | laravels | webman(docker)|
|---- | ---- |---- |----| ---| |---- | ---- |---- |---- | ---|
|首页 | 6请求/秒 | 157请求/秒 | 477请求/秒 | 803请求/秒 | |Homepage | 6 req/s | 157 req/s | 477 req/s| 803 req/s|
|用户订阅 | 6请求/秒 | 196请求/秒 | 586请求/秒 | 1064请求/秒 | |User Subscription| 6 req/s | 196 req/s | 586 req/s| 1064 req/s|
|用户首页延迟| 308ms | 110ms | 101ms | 98ms | |User Homepage Latency| 308ms | 110ms | 101ms | 98ms|
## 页面展示 ## Page Display
![示例图片](./docs/images/dashboard.png) ![Example Image](./docs/images/dashboard.png)
## 安装 / 更新 / 回滚 ## Installation / Update / Rollback
你可以点击查看下列方式的**安装、更新**步骤 You can click to view the **installation and update** steps for the following methods:
- [1panel 部署](./docs/1panel安装指南.md) - [1panel Deployment](./docs/1panel安装指南.md)
- [Docker Compose 纯命令行快速部署](./docs/docker-compose安装指南.md) - [Docker Compose Command-line Quick Deployment](./docs/docker-compose安装指南.md)
- [aapanel + Docker Compose (推荐)](./docs/aapanel+docker安装指南.md) - [aapanel + Docker Compose (Recommended)](./docs/aapanel+docker安装指南.md)
- [aapanel 部署](./docs/aapanel安装指南.md) - [aapanel Deployment](./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)
### Migrating from Other Versions
#### Database Migration
**Check the corresponding migration guide according to your version**
- v2board dev version 23/10/27 [Jump to Migration Guide](./docs/v2b_dev迁移指南.md)
- v2board 1.7.4 [Jump to Migration Guide](./docs/v2b_1.7.4迁移指南.md)
- v2board 1.7.3 [Jump to Migration Guide](./docs/v2b_1.7.3迁移指南.md)
- v2board wyx2685 [Jump to Migration Guide](./docs/v2b_wyx2685迁移指南.md)
### 注意 ### Note
> 修改后台路径需要重启才能生效 > Modifying the admin path requires a restart to take effect
``` ```
docker compose restart docker compose restart
``` ```
> 如果是是aapanel安装则需要重启 webman守护进程 > If using aapanel installation, you need to restart the webman daemon process