2025年7月18日，MaxKB V2版本正式发布。MaxKB是一个强大易用的开源企业级智能体平台，致力于解决企业AI落地所面临的技术门槛高、部署成本高、迭代周期长等问题，让企业用户落地AI更简单。
在V2版本中，MaxKB进行了多项重要升级，具体包括：
■ 多租户权限体系全面增强，能够更好地支持团队协作与资源隔离；
■ 新增共享资源管理、对话用户管理，支持用户登录身份验证，权限控制更灵活；
■ 支持按文件夹目录统一管理应用、知识库、工具和模型，资源组织更清晰；
■ 社区版正式开放用户、知识库和应用的数量限制，助力社区用户快速构建并运营生产级别的智能体应用。
需要注意的是，MaxKB v1.10.x版本不支持直接升级至v2.0.x版本。
2025年9月，MaxKB开源项目组推出了专门的MaxKB版本迁移工具，旨在帮助用户实现平滑的版本迁移操作。本文将为您详细讲解MaxKB版本迁移工具的迁移路线、操作方法以及相关注意事项。
一、迁移路线
注意：MaxKB V1版本用户需要先升级至v1.10.10 LTS版本，再使用迁移工具迁移到v2.1.0版本，然后可基于v2.1.0版本升级至更高的V2版本。
二、迁移准备
在迁移前，请先将MaxKB V1升级至v1.10.10 LTS版本，并为MaxKB V2准备一个全新安装的v2.1.0空环境（License除外）。
在迁移前，请确保您的磁盘有足够存储空间存放导出和导入的数据。
迁移过程中，保证MaxKB V1和V2的容器都处于正常运行状态。
在使用工具完成数据迁移后，可以正常将MaxKB从v2.1.0升级到更高版本。
注意：为了避免容器内残留日志等数据可能引发的迁移问题（例如主键冲突），MaxKB v2.1.0环境必须为全新安装，不能使用由旧版本升级或者使用后重置的环境。
三、迁移过程详解
1. 下载版本迁移工具
打开MaxKB版本迁移工具下载页面（*github.com/1Panel-dev/...
2. 在Linux/macOS系统中实现迁移
■ 导出数据
在部署了MaxKB v1.10.10 LTS的服务器下载上传好的MaxKB-v1-to-v2-migrator-.zip文件，解压后进入目录，执行以下命令导出MaxKB V1版本数据。如果V1版本的数据量较大，导出过程中需要一定的时间，请务必耐心等待。
xml
unzip MaxKB-v1-to-v2-migrator-<version>.zip
cd MaxKB-v1-to-v2-migrator-<version>
bash export_v1_data.sh <v1_container_name>上述命令执行完成后，MaxKB-v1-to-v2-migrator-中会生成一个migrate.zip文件，将MaxKB-v1-to-v2-migrator-复制到MaxKB v2.1.0版本所在的服务器上。
■ 导入数据
在MaxKB v2.1.0版本所在的服务器上，确保该版本的容器已经启动且没有任何其他数据。
进入迁移工具目录，执行以下命令将数据导入MaxKB v2.1.0版本。
xml
cd MaxKB-v1-to-v2-migrator-<version>
bash import_v2_data.sh <v2_container_name>
导入成功后，需要重启MaxKB V2的容器服务，方能查看迁移结果。
3. 在Windows系统中实现迁移
■ 操作要求
MaxKB版本迁移工具支持Windows 10、Windows 11、Windows Server 2016及以上版本。
在进行迁移之前，请确保已经安装Docker Desktop for Windows，并且MaxKB的V1和V2容器均处于正常运行状态。此外，如您需要使用PowerShell脚本执行操作，请确认系统中具备PowerShell 5.0或更高版本。
■ 导出数据
在Windows端，MaxKB提供PowerShell脚本（.ps1）用于导出MaxKB v1.10.10 LTS版本数据。请下载并解压迁移工具，以管理员身份进入目录并执行导出命令。
如果数据量较大，请耐心等待。导出后将在工具目录"MaxKB-v1-to-v2-migrator-"中生成migrate.zip文件。
xml
PowerShell脚本
.\export_v1_data.ps1 -ContainerName <v1_container_name>
■ 导入数据
在MaxKB v2.1.0环境中，请确保已启动对应版本的容器，且容器内无任何现有数据。
bash
#PowerShell脚本
.\import_v2_data.ps1 -ContainerName <v2_container_name>
四、迁移变更说明
1. 用户
■ 如果MaxKB V1中用户的"姓名"为空，迁移后自动将"用户名"作为"姓名"；
■ 工作空间内的资源查询均以"姓名"作为查询依据；
■ Admin账户默认被授予系统管理员、工作空间管理员、普通用户权限（X-Pack）；
■ 除Admin账户外，系统用户或其他用户类型迁移后，默认角色为普通用户（X-Pack）。
2. 资源
■ MaxKB V1授权给其他成员的应用、知识库，迁移后被授予相应的权限；
■ 资源创建者拥有管理资源的权限；
■ MaxKB V1函数库迁移后，在工具中创建者拥有管理权限，其他用户默认为不授权状态；
■ 公有模型迁移后，默认资源授权所有普通用户为查看权限，创建者为管理权限。
3. 接口
MaxKB V1与MaxKB V2的接口文档不一致，如有接口调用，需要重新配置。
4. 应用接入
应用接入到企业微信等应用的回调地址会发生变化，应用接入、登录认证（扫码登录）需要重新配置（X-Pack）。
总结
以上就是将数据从MaxKB V1迁移至V2的完整路线、具体操作步骤及各个环节注意事项。为了确保MaxKB的版本迁移顺利进行，请您务必遵循前述指引，提前做好环境准备与数据备份。
如果在实际操作过程中遇到问题，或者希望了解详细的参数说明和故障排查方法，可参考官方版本迁移工具使用指南：maxkb.cn/docs/v2/ins...
欢迎广大用户体验MaxKB V2版本，开启更加强大易用的企业AI落地旅程！