ManusAI部署需将外部存储挂载至沙盒容器内以保障AI Agent文件操作稳定，步骤包括：确认设备识别（lsblk）、格式化（mkfs.ext4）、创建挂载点（mkdir）、挂载测试（mount），并在docker-compose.yml中配置“/mnt/manus-data:/workspace/output:shared”实现自动绑定与非root写入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
ManusAI部署时需要将外部存储卷挂载到沙盒容器内部，确保AI Agent在执行文件读写、模型缓存、输出保存等操作时有稳定、持久且容量充足的路径，否则任务中途会因磁盘满或权限拒绝而失败。
确认宿主机上已接入并识别外部存储设备
先物理连接硬盘（推荐USB 3.0+带独立供电硬盘盒），再登录宿主机终端执行：
lsblk
观察输出中是否有新增的未挂载块设备，例如sdb或nvme0n1，注意其SIZE是否与硬盘标称容量一致；若无显示，检查USB接口是否为主板原生接口，避免使用USB HUB——【USB HUB可能导致esxi或Linux内核无法正确枚举设备】。
若设备显示为sdb但无分区（TYPE=disk），说明尚未分区；若已有sdb1但MOUNTPOINT为空，则进入下一步；若MOUNTPOINT非空且指向系统盘，请立即停止操作，防止误格式化。
格式化并创建专用挂载点
对新硬盘执行格式化前，必须确认该设备无任何重要数据：
sudo mkfs.ext4 -L MANUS_DATA /dev/sdb1
这一步会清除所有原有数据，-L参数为卷标命名，便于后续fstab识别；ext4是Docker容器兼容性最好、日志稳健的文件系统，不建议用xfs或btrfs——【Docker overlay2在xfs上偶发inode泄漏，会导致沙盒启动失败】。
创建挂载目录：
sudo mkdir -p /mnt/manus-data
挂载测试：
sudo mount /dev/sdb1 /mnt/manus-data && ls -l /mnt/manus-data
这款全能AI助手融合了深度推理、多模态对话与图像生成等前沿技术，全面赋能职场、学习与生活。它支持多模态搜索，精准响应各类信息需求；内置AI文档助手，快速提炼要点并生成思维导图；更有智能创作功能，一键生成报告与文案。强大的AI能力助你高效处理复杂任务，让工作与生活更轻松便捷。
若返回空目录且无报错，说明挂载成功；若提示“wrong fs type”，说明mkfs未生效或设备路径错误。
配置容器启动时自动绑定挂载
ManusAI默认使用Docker Compose部署，需修改docker-compose.yml中的services.manusai.volumes段：
将原本类似"./data:/app/data"的本地映射，替换为：
- "/mnt/manus-data:/workspace/output:shared"
其中/shared是关键标志，它允许容器内进程以非root身份（如manus用户）写入该目录；若省略此选项，在Ubuntu系宿主机上Docker默认以private挂载模式运行，会导致容器内mkdir或touch失败。
保存后重启服务：
docker-compose down && docker-compose up -d
验证挂载是否生效：
docker exec -it manusai ls -ld /workspace/output
应返回类似drwxr-xr-x 2 root root 4096 ... /workspace/output，且属主不是root而是manus组——若仍为root，说明shared未生效，需检查Docker daemon.json中是否启用userns-remap或seccomp限制。
