fix: correct know issues

app/Http/Controllers/V1/Client/ClientController.php

@@ -120,18 +120,15 @@ class ClientController extends Controller
         if ($this->isBrowserAccess($request)) {
             return $this->handleBrowserSubscribe($user, $userService);
         }
-
-        $types = $this->getFilteredTypes($request->input('types', 'all'));
-        $filterArr = $this->getFilterArray($request->input('filter'));
         $clientInfo = $this->getClientInfo($request);
-
+        $types = $this->getFilteredTypes($request->input('types'), $clientInfo['supportHy2']);
+        $filterArr = $this->getFilterArray($request->input('filter'));
         // Get available servers and apply filters
         $servers = ServerService::getAvailableServers($user);
         $serversFiltered = $this->filterServers(
             servers: $servers,
             types: $types,
             filters: $filterArr,
-            supportHy2: $clientInfo['supportHy2']
         );
 
         $this->setSubscribeInfoToServers($serversFiltered, $user, count($servers) - count($serversFiltered));
@@ -154,14 +151,21 @@ class ClientController extends Controller
         return (new General($user, $serversFiltered))->handle();
     }
 
-    private function getFilteredTypes(string $types): array
+    private function getFilteredTypes(string|null $types, bool $supportHy2): array
     {
-        return $types === 'all'
+        if ($types === 'all') {
+            return self::ALLOWED_TYPES;
+        }
+
+        $allowedTypes = $supportHy2
             ? self::ALLOWED_TYPES
-            : array_values(array_intersect(
+            : array_diff(self::ALLOWED_TYPES, ['hysteria2']);
-                explode('|', str_replace(['|', '｜', ','], '|', $types)),
+        if (!$types) {
-                self::ALLOWED_TYPES
+            return array_values($allowedTypes);
-            ));
+        }
+
+        $userTypes = explode('|', str_replace(['|', '｜', ','], '|', $types));
+        return array_values(array_intersect($userTypes, $allowedTypes));
     }
 
     private function getFilterArray(?string $filter): ?array
@@ -199,12 +203,16 @@ class ClientController extends Controller
         return $result || !count(self::CLIENT_VERSIONS);
     }
 
-    private function filterServers(array $servers, array $types, ?array $filters, bool $supportHy2): array
+    private function filterServers(array $servers, array $types, ?array $filters): array
     {
-        return collect($servers)->reject(function ($server) use ($types, $filters, $supportHy2) {
+        return collect($servers)->reject(function ($server) use ($types, $filters) {
             // Check Hysteria2 compatibility
             if ($server['type'] === 'hysteria' && optional($server['protocol_settings'])['version'] === 2) {
-                if (!in_array('hysteria2', $types) || !$supportHy2) {
+                if (!in_array('hysteria2', $types)) {
+                    return true;
+                }
+            } else {
+                if (!in_array($server['type'], $types)) {
                     return true;
                 }
             }

docs/zh-CN/installation/aapanel-docker.md

@@ -114,6 +114,7 @@ docker compose up -d
 ```
 > - 如果您是较早安装的旧版本，需要将命令中的 `web` 改为 `xboard`，即：
 ```bash
+git fetch --all && git reset --hard origin/master && git pull origin master
 docker compose pull && \
 docker compose run -it --rm xboard php artisan xboard:update && \
 docker compose up -d

docs/zh-CN/installation/aapanel.md

@@ -1,47 +1,69 @@
-## aaPanel 快速部署指南
+## Xboard 在 aaPanel 环境下的部署指南
 
-本指南介绍如何使用 aaPanel 部署 Xboard。
+## 目录
+1. [环境要求](#环境要求)
+2. [快速部署](#快速部署)
+3. [详细配置](#详细配置)
+4. [维护指南](#维护指南)
+5. [故障排查](#故障排查)
 
-⚠️ 不建议在 CentOS 7 上部署，可能会遇到兼容性问题。
+## 环境要求
 
-### 1. 环境准备
+### 硬件配置
+- CPU: 1核心及以上
+- 内存: 2GB及以上
+- 硬盘: 10GB及以上可用空间
 
-安装 aaPanel：
+### 软件要求
+- 操作系统: Ubuntu 20.04+ / Debian 10+ (⚠️ 不建议使用 CentOS 7)
+- aaPanel 最新版
+- PHP 8.2
+- MySQL 5.7+
+- Redis
+- Nginx（任意版本）
+
+## 快速部署
+
+### 1. 安装 aaPanel
 ```bash
 URL=https://www.aapanel.com/script/install_6.0_en.sh && \
 if [ -f /usr/bin/curl ];then curl -ksSO "$URL" ;else wget --no-check-certificate -O install_6.0_en.sh "$URL";fi && \
 bash install_6.0_en.sh aapanel
 ```
 
-### 2. 环境配置
+### 2. 基础环境配置
 
-1. 在 aaPanel 中安装 LNMP：
+#### 2.1 安装 LNMP 环境
-   - Nginx（任意版本）
+在 aaPanel 面板中安装：
-   - MySQL 5.7
+- Nginx（任意版本）
-   - PHP 8.2
+- MySQL 5.7
+- PHP 8.2
 
-2. 安装 PHP 扩展：
+#### 2.2 安装 PHP 扩展
-   - redis
+必需的 PHP 扩展：
-   - fileinfo
+- redis
-   - swoole4
+- fileinfo
-   - readline
+- swoole4
-   - event
+- readline
+- event
 
-3. 解除 PHP 禁用函数：
+#### 2.3 解除 PHP 禁用函数
-   - putenv
+需要启用的函数：
-   - proc_open
+- putenv
-   - pcntl_alarm
+- proc_open
-   - pcntl_signal
+- pcntl_alarm
+- pcntl_signal
 
-### 3. 部署步骤
+### 3. 站点配置
 
-1. 添加站点：
+#### 3.1 创建站点
-   - 进入 aaPanel > Website > Add site
+1. 导航至：aaPanel > Website > Add site
-   - 填写域名
+2. 填写信息：
-   - 数据库选择 MySQL
+   - 域名：填写您的站点域名
-   - PHP 版本选择 8.1
+   - 数据库：选择 MySQL
+   - PHP 版本：选择 8.2
 
-2. 安装 Xboard：
+#### 3.2 部署 Xboard
 ```bash
 # 进入站点目录
 cd /www/wwwroot/你的域名
@@ -57,9 +79,9 @@ git clone https://github.com/cedar2025/Xboard.git ./
 sh init.sh
 ```
 
-3. 配置站点：
+#### 3.3 配置站点
-   - 设置运行目录为 `/public`
+1. 设置运行目录为 `/public`
-   - 配置伪静态规则：
+2. 添加伪静态规则：
 ```nginx
 location /downloads {
 }
@@ -76,30 +98,32 @@ location ~ .*\.(js|css)?$
 }
 ```
 
-4. 配置守护进程：
+## 详细配置
-   - 安装 Supervisor
-   - 添加队列守护进程：
-     - 名称：`Xboard`
-     - 运行用户：`www`
-     - 运行目录：站点目录
-     - 启动命令：`php artisan horizon`
-     - 进程数：1
 
-5. 添加计划任务：
+### 1. 配置守护进程
-   - 类型：Shell Script
+1. 安装 Supervisor
-   - 任务名：v2board
+2. 添加队列守护进程：
-   - 周期：1分钟
+   - 名称：`Xboard`
-   - 脚本内容：`php /www/wwwroot/站点目录/artisan schedule:run`
+   - 运行用户：`www`
-
-### 4. 开启 Octane（可选）
-1. 添加 Octane 守护进程：
-   - 名称：Octane
-   - 运行用户：www
    - 运行目录：站点目录
-   - 启动命令：`/www/server/php/81/bin/php artisan octane:start --port 7010`
+   - 启动命令：`php artisan horizon`
    - 进程数：1
 
-2. 更新伪静态规则：
+### 2. 配置计划任务
+- 类型：Shell Script
+- 任务名：v2board
+- 周期：1分钟
+- 脚本内容：`php /www/wwwroot/站点目录/artisan schedule:run`
+
+### 3. Octane 配置（可选）
+#### 3.1 添加 Octane 守护进程
+- 名称：Octane
+- 运行用户：www
+- 运行目录：站点目录
+- 启动命令：`/www/server/php/81/bin/php artisan octane:start --port 7010`
+- 进程数：1
+
+#### 3.2 Octane 专用伪静态规则
 ```nginx
 location ~* \.(jpg|jpeg|png|gif|js|css|svg|woff2|woff|ttf|eot|wasm|json|ico)$ {
 }
@@ -120,18 +144,30 @@ location ~ .* {
 }
 ```
 
-### 5. 版本更新
+## 维护指南
 
+### 版本更新
 ```bash
-# 更新代码
+# 进入站点目录
 cd /www/wwwroot/你的域名
+
+# 执行更新脚本
+git fetch --all && git reset --hard origin/master && git pull origin master
 sh update.sh
 
 # 如果启用了 Octane，需要重启守护进程
 # aaPanel > App Store > Tools > Supervisor > 重启 Octane
 ```
 
-### 注意事项
+### 日常维护
+- 定期检查日志
+- 监控系统资源使用情况
+- 定期备份数据库和配置文件
 
-- 修改后台路径需要重启服务才能生效
+## 故障排查
-- 启用 octane 后的任何代码修改都需要重启才能生效
+
+### 常见问题
+1. 修改后台路径需要重启服务才能生效
+2. 启用 Octane 后的任何代码修改都需要重启才能生效
+3. PHP 扩展安装失败时，请检查 PHP 版本是否正确
+4. 数据库连接失败时，请检查数据库配置和权限