Xboard面板安装教程 | 春田花花疯人院

关于Xboard

Xboard是基于V2board二次开发，在性能上和功能上都有大部分增强的**面板

Xboard 特点

基于V2board 二次开发，增加了以下特性

升级Laravel10

适配Laravels （提升至10+倍并发）

适配Webman （比laravels快50%左右）

修改配置从数据库中获取

支持Docker部署、分布式部署

支持根据用户IP归属地来下发订阅

增加Hy2支持

增加sing-box下发

支持直接从cloudflare获取访问者真实IP

支持根据客户端版本自动下发新协议

支持线路筛选（订阅地址后面增加 &filter=香港｜美国）

支持Sqlite安装（代替Mysql，自用用户福音）

使用Vue3 + TypeScript + NaiveUI + Unocss + Pinia重构用户前端

修复大量BUG

系统架构

PHP8.1+

Composer

MySQL5.7+

Redis

Laravel

页面展示

xboard 无论前端还是后端性能都有巨大的提升

安装 / 更新

1panel 部署教程：

步骤 1：安装 1panel

1、执行以下命令安装 1panel：

shell


curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

2、安装完成后，登录 1panel 进行环境的安装。

步骤 2：安装应用

打开应用商店，安装以下应用：

☑️ OpenResty 任意版本（安装时需要勾选 "端口外部访问" 来打开防火墙>

☑️ MySQL 5.7.* （arm 架构可以选择 mariadb 进行代替）

⚠️ ：安装过程中配置默认即可。

步骤 3：添加站点

在 1panel 面板中，选择“网站”并点击“创建网站”，然后选择“反向代理”。

在 “主域名” 中填写你指向服务器的域名，

在 “代号” 中填写 xboard

在 “在代理地址” 中填写 127.0.0.1:7001，

最后点击“创建”按钮。

点击刚创建的网站的 "配置" > "反向代理" > "源文" 修改反向代理规则为以下内容：

shell


location ^~ / {
    proxy_pass http://127.0.0.1:7001;
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Real-PORT $remote_port;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_set_header Scheme $scheme;
    proxy_set_header Server-Protocol $server_protocol;
    proxy_set_header Server-Name $server_name;
    proxy_set_header Server-Addr $server_addr;
    proxy_set_header Server-Port $server_port;
    proxy_cache off;
}

步骤 4：创建数据库

在 1panel 面板中，选择“数据库”并点击“创建数据库”。

在“名称”中填写 xboard。

在“用户”中填写 xboard。

在“权限”中选择“所有人(%)”。

最后点击“创建”按钮。

记住数据库账号密码进行下一步

步骤 5：安装 Xboard

通过 SSH 登录到服务器后，访问站点路径如：/opt/1panel/apps/openresty/openresty/www/sites/xboard/index。

如果系统没有安装 git，请执行以下命令安装 git：

Ubuntu/Debian：

shell


apt update
apt install -y git

CentOS/RHEL：

shell


yum update
yum install -y git

在站点目录中执行以下命令从 Github 克隆到当前目录：

shell


git clone -b  docker-compose --depth 1 https://github.com/cedar2025/Xboard ./

执行以下命令安装 Xboard：

shell


docker compose run -it --rm xboard php artisan xboard:install

根据提示输入上述创建的数据库账号密码，选择使用内置 redis 完成安装。

执行这条命令之后，会返回你的后台地址和管理员账号密码（你需要记录下来）。

你需要执行下面的“启动 Xboard”步骤之后才能访问后台。

步骤 6：启动 Xboard

在站点目录中执行以下命令：

shell


docker compose up -d

🎉：到这里，你已经可以通过域名访问你的站点了。

更新

通过 SSH 登录到服务器后，访问站点路径如：/opt/1panel/apps/openresty/openresty/www/sites/xboard/index，然后在站点目录中执行以下命令：

shell


docker compose down xboard
docker compose pull 
docker compose up -d

🎉：在此，你已完成 Xboard 的更新。

Docker-Compose 部署教程

使用docker-compose 2分钟部署

安装docker

shell


curl -sSL https://get.docker.com | bash
systemctl enable docker
systemctl start docker

获取Docker compose 文件

shell


git clone -b  docker-compose --depth 1 https://github.com/cedar2025/Xboard
cd Xboard

执行数据库安装命令

选择 启用sqlite 和 Docker内置的Redis

shell


docker compose run -it --rm xboard php artisan xboard:install

启动Xboard

shell


docker compose up -d

安装完成之后即可访问你的站点

访问站点

启动之后网站端口默认为7001, 你可以配置nginx反向代理使用80端口

网站地址:

http://你的IP:7001/

在此你已经成功部署了，你可以访问网址体验Xboard的完整功能。

如果你需要使用mysql，请自行安装Mysql后重新部署

更新

修改版本

shell


cd Xboard
nano docker-compose.yaml

修改docker-compose.yaml 当中image后面的版本号为你需要的版本
如果为版本为latest 则可以忽略这一步，直接进行第二步

更新数据库（可以执行多次都是安全的）

shell


docker compose pull
docker compose down
docker compose run -it --rm xboard php artisan xboard:update
docker compose up -d

即可更新成功

aapanel+docker部署教程

部署：

安装aaPanel + 和docker

shell


# 安装Docker
curl -sSL https://get.docker.com | bash
systemctl enable docker
systemctl start docker

shell


# 安装宝塔
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

安装完成后我们登陆 aaPanel 进行环境的安装。 2. 选择使用LNMP的环境安装方式勾选如下信息

☑️ Nginx 任意版本 ☑️ MySQL 5.7 选择 Fast 快速编译后进行安装。

⚠️ ：无需安装php 与 redis

添加站点

aaPanel 面板 > Website > Add site。

在 Domain 填入你指向服务器的域名
在 Database 选择MySQL
在 PHP Verison 选择纯静态

安装 Xborad

1. 通过SSH登录到服务器后访问站点路径如：

/www/wwwroot/你的站点域名。以下命令都需要在站点目录进行执行。

shell


# 删除目录下文件
chattr -i .user.ini
rm -rf .htaccess 404.html 502.html index.html .user.ini

执行命令从 Github 克隆到当前目录。

shell


git clone https://github.com/cedar2025/Xboard.git ./

复制一份docker-compose.yaml文件

shell


cp docker-compose.sample.yaml docker-compose.yaml

执行命令安装依赖包以及Xboard

shell


docker compose run -it --rm xboard sh init.sh

根据提示完成安装执行这条命令之后，会返回你的后台地址和管理员账号密码（你需要记录下来）
你需要执行下面的 启动xborad 步骤之后才能访问后台

启动xboard

shell


docker compose up -d

设置反向代理

站点设置 > 反向代理 > 添加反向代理

在 代理名称 填入 Xboard
在 目标URL 填入
plain
http://127.0.0.1:7001
Plain text
修改反向代理规则为：

shell


location ^~ / {
    proxy_pass http://127.0.0.1:7001;
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Real-PORT $remote_port;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_set_header Scheme $scheme;
    proxy_set_header Server-Protocol $server_protocol;
    proxy_set_header Server-Name $server_name;
    proxy_set_header Server-Addr $server_addr;
    proxy_set_header Server-Port $server_port;
    proxy_cache off;
}

🎉：到这里，你可以已经可以通过域名访问你的站点了

更新

更新代码

通过SSH登录到服务器后访问站点路径如：

/www/wwwroot/你的站点域名。

以下命令都需要在站点目录进行执行。

shell


docker compose pull
docker compose run -it --rm xboard sh update.sh

重启Xboard

shell


docker compose restart

🎉：在此你已完成Xboard的更新

aapanel部署教程

⚠️：Centos7有部分反馈部署失败，请尽量避免使用Centos7进行部署

安装

安装aaPanel

shell


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

安装完成后我们登陆 aaPanel 进行环境的安装。

选择使用LNMP的环境安装方式勾选如下信息

☑️ Nginx 任意版本

☑️ MySQL 5.7

☑️ PHP 8.1 （如果没看到8.1先不选，去App Store安装）选择 Fast 快速编译后进行安装。

安装扩展

aaPanel 面板 > App Store > 找到PHP 8.1点击Setting > Install extentions选择以下扩展进行安装：

redis

fileinfo

swoole4

readline

event

inotify (可选，热重载依赖)

解除被禁止函数

aaPanel 面板 > App Store > 找到PHP 8.1点击Setting > Disabled functions 将以下函数从列表中删除：

putenv

proc_open

pcntl_alarm

pcntl_signal

添加站点

aaPanel 面板 > Website > Add site

在 Domain 填入你指向服务器的域名
在 Database 选择MySQL
在 PHP Verison 选择PHP-81

安装 Xborad

通过SSH登录到服务器后访问站点路径如：

/www/wwwroot/你的站点域名。以下命令都需要在站点目录进行执行。

shell


# 删除目录下文件
chattr -i .user.ini
rm -rf .htaccess 404.html 502.html index.html .user.ini

执行命令从 Github 克隆到当前目录。

shell


git clone https://github.com/cedar2025/Xboard.git ./

执行命令安装依赖包以及V2board

shell


sh init.sh

根据提示完成安装

添加完成后编辑添加的站点 > Site directory > Running directory 选择 /public 保存。
添加完成后编辑添加的站点 > URL rewrite 填入伪静态信息。

shell


location /downloads {
}

location / {  
    try_files $uri $uri/ /index.php$is_args$query_string;  
}

location ~ .*\.(js|css)?$
{
    expires      1h;
    error_log off;
    access_log /dev/null; 
}

配置守护进程

Xboard的系统强依赖队列服务，正常使用XBoard必须启动队列服务。下面以aaPanel中supervisor服务来守护队列服务作为演示。

1️⃣. aaPanel 面板 > App Store > Tools

2️⃣. 找到Supervisor进行安装，安装完成后点击设置 > Add Daemon按照如下填写

在 Name 填写 Xboard

在 Run User 选择 www

在 Run Dir 选择站点目录在 Start Command 填写 php artisan horizon 在 Processes 填写 1

填写后点击Confirm添加即可运行。

配置定时任务# aaPanel 面板 > Cron。

在 Type of Task 选择 Shell Script

在 Name of Task 填写 v2board

在 Period 选择 N Minutes 1 Minute

在 Script content 填写 php /www/wwwroot/路径/artisan schedule:run

根据上述信息添加每1分钟执行一次的定时任务。

开启webman

在上述安装的基础上开启webman提高性能

配置php.ini

通过SSH登录到服务器后访问站点路径如：

/www/wwwroot/你的站点域名。

shell


cp /www/server/php/81/etc/php.ini cli-php.ini

sed -i 's/^disable_functions[[:space:]]*=[[:space:]]*.*/disable_functions=header,header_remove,headers_sent,http_response_code,setcookie,session_create_id,session_id,session_name,session_save_path,session_status,session_start,session_write_close,session_regenerate_id,set_time_limit/g' cli-php.ini

添加守护进程

下面以aaPanel中supervisor服务来守护队列服务作为演示。

1️⃣. aaPanel 面板 > App Store > Tools

2️⃣. 找到Supervisor进行安装，安装完成后点击设置 > Add Daemon按照如下填写

在 Name 填写 webman

在 Run User 选择 www

在 Run Dir 选择站点目录在 Start Command 填写 /www/server/php/81/bin/php -c cli-php.ini webman.php start 在 Processes 填写 1

填写后点击Confirm添加即可运行。

修改伪静态

站点设置 > URL Rewrite(伪静态) 填入一下内容(覆盖前伪静态配置)

shell


location ~* \.(jpg|jpeg|png|gif|js|css|svg|woff2|woff|ttf|eot|wasm|json|ico)$ {

}
location ~ .* {
        proxy_pass http://127.0.0.1:7010;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Real-PORT $remote_port;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_set_header Scheme $scheme;
        proxy_set_header Server-Protocol $server_protocol;
        proxy_set_header Server-Name $server_name;
        proxy_set_header Server-Addr $server_addr;
        proxy_set_header Server-Port $server_port;
  }

在此你的webman已经成功部署了

更新

更新代码

通过SSH登录到服务器后访问站点路径如：

/www/wwwroot/你的站点域名。

shell


sh update.sh

重启webman 守护进程(如果启用了webman)

1️⃣. aaPanel 面板 > App Store > Tools

2️⃣. 找到Supervisor点击设置，找到名为webman的守护进程点击重启即可

注意

修改后台路径需要重启才能生效

shell


docker compose restart

如果是是aapanel安装则需要重启 webman守护进程

启用 webman 后做的任何代码修改都需要重启生效。

Xboard对接 XrayR

一个基于Xray的后端框架，支持V2ay,Trojan,Shadowsocks协议，极易扩展，支持多面板对接。

一键安装

shell


wget -N https://raw.githubusercontent.com/XrayR-project/XrayR-release/master/install.sh && bash install.sh

项目地址: https://github.com/XrayR-project

Debian/Ubuntu

shell


wget -N https://raw.githubusercontent.com/wyx2685/XrayR-release/master/install.sh && bash install.sh

shell


nano /etc/XrayR/config.yml

shell


XrayR

Alpine

shell


apk add wget sudo curl && wget -N https://github.com/Cd1s/alpineXrayR/releases/download/one-click/install-xrayr.sh && chmod +x install-xrayr.sh && bash install-xrayr.sh

shell


nano /etc/XrayR/config.yml

shell


/etc/init.d/XrayR restart

Xboard对接 V2bX

一个基于多种内核的V2board节点服务端，修改自XrayR，支持V2ay,Trojan,Shadowsocks协议。

一键安装

shell


wget -N https://raw.githubusercontent.com/wyx2685/V2bX-script/master/install.sh && bash install.sh

项目地址：https://github.com/wyx2685/V2bX

关于Xboard

Xboard 特点

系统架构

页面展示

安装 / 更新

1panel 部署教程：

shell

shell

shell

shell

shell

shell

shell

更新

shell

Docker-Compose 部署教程

shell

shell

shell

shell

更新

shell

shell

aapanel+docker部署教程

部署：

shell

shell

shell

shell

shell

shell

shell

plain

shell

更新

shell

shell

aapanel部署教程

安装

shell

shell

shell

shell

shell

开启webman

shell

shell

更新

shell

注意

shell

Xboard对接 XrayR

一键安装

shell

shell

shell

shell

shell

shell

shell

Xboard对接 V2bX

一键安装

shell

欢迎来到我的博客