1Panel 快速部署Xboard

1.环境准备

安装 1Panel：

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

2.环境配置

1. 从 App Store 安装：

   • OpenResty（任何版本）

     • ⚠️勾选“外部端口访问”打开防火墙

   • MySQL 5.7（使用适用于 ARM 架构的 MariaDB）

2. 创建数据库：

   • 数据库名称：xboard

   • 用户名:xboard

   • 访问权限：所有主机 (%)

   • 保存安装数据库密码

3.部署步骤

1.添加网站：

• 前往“网站”>“创建网站”>“反向代理”

• 域名：输入您的域名

• 代码：xboard

• 代理地址：127.0.0.1:7001

2.配置反向代理：

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;
}

3.安装Xboard：

# Enter site directory
cd /opt/1panel/apps/openresty/openresty/www/sites/xboard/index

# Install Git (if not installed)
## Ubuntu/Debian
apt update && apt install -y git
## CentOS/RHEL
yum update && yum install -y git

# Clone repository
git clone -b compose --depth 1 https://github.com/cedar2025/Xboard ./

# Configure Docker Compose

4.编辑docker-compose.yml：

services:
  web:
    image: ghcr.io/cedar2025/xboard:new
    volumes:
      - ./.docker/.data/redis/:/data/
      - ./.env:/www/.env
      - ./.docker/.data/:/www/.docker/.data
      - ./storage/logs:/www/storage/logs
      - ./storage/theme:/www/storage/theme
      - ./plugins:/www/plugins
    environment:
      - docker=true
    depends_on:
      - redis
    command: php artisan octane:start --host=0.0.0.0 --port=7001
    restart: on-failure
    ports:
      - 7001:7001
    networks:
      - 1panel-network

  horizon:
    image: ghcr.io/cedar2025/xboard:new
    volumes:
      - ./.docker/.data/redis/:/data/
      - ./.env:/www/.env
      - ./.docker/.data/:/www/.docker/.data
      - ./storage/logs:/www/storage/logs
      - ./plugins:/www/plugins
    restart: on-failure
    command: php artisan horizon
    networks:
      - 1panel-network
    depends_on:
      - redis

  redis:
    image: redis:7-alpine
    command: redis-server --unixsocket /data/redis.sock --unixsocketperm 777
    restart: unless-stopped
    networks:
      - 1panel-network
    volumes:
      - ./.docker/.data/redis:/data

networks:
  1panel-network:
    external: true

5.初始化安装：

# 安装依赖项并初始化
docker compose run -it --rm web php artisan xboard:install

⚠️重要配置说明：

1.数据库配置

• 数据库主机：根据您的部署选择：

  1. 如果数据库和 Xboard 位于同一网络，请使用mysql

  2. 如果连接失败，请转至：数据库 -> 选择数据库 -> 连接信息 -> 容器连接，并使用“主机”值

  3. 如果使用外部数据库，请输入您的实际数据库主机

• 数据库端口：（3306除非另有配置，否则使用默认端口）

• 数据库名称：（xboard之前创建的数据库）

• 数据库用户：（xboard之前创建的用户）

• 数据库密码：输入之前保存的密码

2.Redis 配置

• 选择使用内置Redis

• 无需额外配置

3.管理员信息

• 保存安装后显示的管理员凭据

• 记下管理面板访问 URL

配置完成后，启动服务：

docker compose up -d

6.启动服务：

docker compose up -d

4.版本更新

💡重要提示：更新命令根据安装版本的不同而有所不同：

• 如果您最近安装了（新版本），请使用以下命令：

docker compose pull && \
docker compose run -it --rm web php artisan xboard:update && \
docker compose up -d

• 如果您之前安装了（旧版本），请替换web为xboard：

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

🤔 不确定用哪个？先尝试新版本命令，如果失败，再使用旧版本命令。

重要说明

• ⚠️确保防火墙已启用，以防止端口 7001 暴露给公众

• 代码修改后需要重启服务

• 建议配置SSL证书以确保安全访问