概述

1Panel 是一款开源的轻量级服务器管理面板，其默认存储目录通常用于存放网站文件、数据库及备份数据。随着业务增长或磁盘空间规划调整，可能需要将默认存储目录迁移到更大的数据盘或不同分区。本文提供标准操作流程，帮助管理员安全、完整地完成目录更换。

操作前准备

• 确认已安装 1Panel 且版本不低于 1.0.0（不同版本配置文件路径可能略有差异）。
• 拥有服务器 root 权限或具有 sudo 执行权限。
• 准备新的存储目录（例如 /data/1panel），确保该目录所在磁盘有足够剩余空间，并已挂载到系统。
• 重要：备份现有存储目录数据。可使用以下命令打包原目录（假设原目录为 /opt/1panel）：
  tar -czf /tmp/1panel_backup.tar.gz /opt/1panel

操作步骤

1. 停止 1Panel 服务

运行命令停止面板主进程和相关服务，确保数据一致性：

systemctl stop 1panel

2. 修改配置文件

1Panel 的默认存储路径定义在配置文件 /opt/1panel/conf/app.conf 中（若使用 Docker 安装，则需修改容器挂载卷映射）。

• 使用文本编辑器打开配置文件：
  vim /opt/1panel/conf/app.conf
• 找到参数 dir = /opt/1panel（或类似字段），将其改为新目录路径，例如：
  dir = /data/1panel
• 保存并退出编辑器。

3. 迁移数据

将原目录的全部内容复制到新目录：

cp -a /opt/1panel/* /data/1panel/

若原目录包含隐藏文件（如 .env），可使用 rsync 确保完整迁移：

rsync -av /opt/1panel/ /data/1panel/

4. 设置目录权限

确保新目录的所有者与 1Panel 运行用户一致（通常为 root 或 1panel 用户，具体可查看原目录权限）：

chown -R root:root /data/1panel

若使用专用用户，替换 root:root 为相应用户组。

5. 重启 1Panel 服务

启动面板并验证状态：

systemctl start 1panel
systemctl status 1panel

确保服务 active（running）且无报错日志。

6. 验证迁移效果

登录 1Panel 管理后台，检查“系统设置”中的“存储目录”是否显示为新路径。可尝试新建网站或数据库，确认文件正确写入新目录。

注意事项

• 若使用 Docker 安装 1Panel，需修改 docker-compose.yml 中的 volume 映射路径，而非直接更改容器内配置文件。
• 迁移过程中切勿中断操作或重启服务器，以免数据损坏。
• 建议保留旧目录并观察一段时间，待确认新目录运行正常后再删除备份。

总结

通过上述步骤，即可无缝完成 1Panel 默认存储目录的更换。该操作不会影响已有网站和数据库的访问，仅需短暂停机（约 1-2 分钟）。建议在业务低峰期执行，并事先做好完整备份。