Xboard/docs/en/migration/v2board-dev.md

V2board Dev 迁移指南

本指南说明如何从 V2board Dev 版本（2023/10/27）迁移到 Xboard。

注意：迁移前请先按官方指南升级到 2023/10/27 版本。

1. 数据库变更概览

• v2_order 表：

  • 新增 surplus_order_ids（text, nullable）- 扣费订单

• v2_plan 表：

  • 移除 daily_unit_price - 影响周期价格
  • 移除 transfer_unit_price - 影响流量价格

• v2_server_hysteria 表：

  • 移除 ignore_client_bandwidth - 影响带宽配置
  • 移除 obfs_type - 影响混淆类型配置

2. 前置条件

注意：请先完成 Xboard 基础安装（不支持 SQLite）：

• Docker Compose 部署
• aaPanel + Docker 部署
• aaPanel 部署

3. 迁移步骤

Docker 环境

# 1. 停止服务
docker compose down

# 2. 清空数据库
docker compose run -it --rm web php artisan db:wipe

# 3. 导入旧数据库（重要）
# 请手动导入 V2board Dev 数据库

# 4. 执行迁移
docker compose run -it --rm web php artisan migratefromv2b dev231027

aaPanel 环境

# 1. 清空数据库
php artisan db:wipe

# 2. 导入旧数据库（重要）
# 请手动导入 V2board Dev 数据库

# 3. 执行迁移
php artisan migratefromv2b dev231027

4. 配置迁移

数据迁移完成后，还需要迁移配置文件：

• 配置迁移指南