服务器迁移
通过 Web 管理后台将数据库从一种类型迁移到另一种,支持 SQLite、MySQL、PostgreSQL 和 SQL Server 之间的互相迁移。
一、适用场景
HelpChat Server 默认使用 SQLite 数据库,开箱即用,适合 50 人以内的团队。当在线人数增长或需要更高的并发性能时,可以迁移到 MySQL、PostgreSQL 或 SQL Server。反之,也可以从外部数据库迁移回 SQLite。
| 数据库类型 | 默认端口 | 适用场景 |
|---|---|---|
| SQLite | — | 50 人以内,无需额外安装,零配置 |
| MySQL | 3306 | 中大规模部署,推荐 MySQL 8.0 或 MariaDB 10.6+ |
| PostgreSQL | 5432 | 对数据一致性要求高的场景 |
| SQL Server | 1433 | Windows Server 环境,与现有 SQL Server 整合 |
二、操作步骤
操作前请先进入维护模式
在管理后台左侧菜单中点击「数据库维护」,切换到「迁移」标签页。页面分为左右两栏:左侧显示当前数据库信息(类型、版本、大小、连接数),右侧为目标数据库配置。
1. 选择目标数据库类型:系统会自动排除当前正在使用的数据库类型,只显示可迁移的目标类型。
2. 填写连接信息(迁移到 MySQL / PostgreSQL / SQL Server 时)
| 字段 | 说明 | 示例 |
|---|---|---|
| 主机地址 | 数据库服务器 IP 或域名 | 127.0.0.1 |
| 端口 | 数据库端口(会根据类型自动填入默认值) | 3306 |
| 用户名 | 数据库登录用户 | root |
| 密码 | 数据库登录密码 | •••••• |
| 数据库名 | 目标数据库名称(需预先创建) | helpchat |
说明
imdata/ 目录下。3. 测试连接:对于 MySQL / PostgreSQL / SQL Server,请先点击「测试连接」按钮,确认显示「连接成功」后再进行下一步。
4. 配置选项:勾选「迁移完成后自动更新配置文件」后,系统会自动将目标数据库的连接信息写入 config/helpchatsvr.ini,无需手动修改。
5. 开始迁移:点击「开始迁移」按钮,系统会先自动备份当前数据库,然后将所有数据写入目标数据库,并显示实时进度。
三、迁移后操作
迁移完成后,请重启 HelpChat Server 服务使新的数据库配置生效。
如果迁移前未勾选「自动更新配置文件」,需要手动编辑 config/helpchatsvr.ini 的 [database] 段,将 type 改为目标数据库类型,并填写对应的连接信息。
四、注意事项
迁移操作不会删除原数据库的数据,原数据库会保持原样。如果迁移后发现问题,可以在 config/helpchatsvr.ini 中将数据库类型改回原来的值,重启服务即可回退。
聊天文件(imdata/data/)和云盘文件(imdata/cloud/)存储在文件系统中,与数据库类型无关,迁移过程中不受影响。
提示