根本原因是宿主机端口被占，如极空间系统服务（8080）、docker网关（5000）、残留容器或历史进程；需用netstat/lsof定位，针对性关闭服务、清理容器或改用高位端口（如8083）并同步更新配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
初次部署ManusAI时，容器反复启动失败、日志报错“Address already in use”，根本原因不是配置写错，而是宿主机上已有服务悄悄占用了它默认监听的端口——比如8080、3001或18080，而你根本没意识到这些端口已被极空间后台、Docker网关或历史残留进程锁定。
确认端口是否真被占用
SSH登录NAS设备（如极空间Z4），执行：
netstat -tuln | grep -E ':(8080|3001|18080|11434)'
重点看输出中绑定地址是 【0.0.0.0:8080】 还是 【127.0.0.1:8080】：前者表示该端口对外暴露，必然冲突；后者仅本地监听，通常不影响容器映射。
若看到 zs-httpd 或 docker-proxy 占用8080，就坐实了极空间系统级服务抢占问题。
四类典型占用源与对应处理路径
方法一：极空间内置App动态抢占（如「文件同步」Web界面）
→ 进入极空间App中心 → 找到「文件同步」→ 点击「设置」→ 关闭「启用Web访问」开关 → 重启该App
方法二：Docker桥接网关固定占用5000端口影响host.docker.internal解析
→ 不要尝试释放5000端口，这是docker0网关必需端口 → 改用 【host.docker.internal:18080】 替代 localhost:18080 调用内部服务
这款全能AI助手融合了深度推理、多模态对话与图像生成等前沿技术，全面赋能职场、学习与生活。它支持多模态搜索，精准响应各类信息需求；内置AI文档助手，快速提炼要点并生成思维导图；更有智能创作功能，一键生成报告与文案。强大的AI能力助你高效处理复杂任务，让工作与生活更轻松便捷。
方法三：旧容器未完全退出残留监听
→ 执行 docker ps -a | grep manus → 若看到Exited状态容器，运行 docker rm -f 容器ID → 再执行 docker system prune -f 清理网络和悬空卷
方法四：MySQL/Redis等历史服务长期运行并绑定3306/6379等端口
→ 检查 /etc/init.d/ 下是否有 mysql、redis-server 启动脚本 → 若存在且非业务必需，执行 systemctl disable mysql → reboot 后验证
修改ManusAI服务端口的实操步骤
第一步：进入ManusAI项目根目录，打开 application.yml 文件
第二步：定位 server.port 配置项，将其从默认的8080改为高位端口，例如 8083
（避免使用8081/8082——极空间相册服务可能动态启用）
第三步：若项目含前端构建环节，还需检查 vite.config.ts 或 webpack.config.js 中的 proxy.target 地址，同步更新为 http://localhost:8083
第四步：重新构建镜像并启动容器，命令中 -p 参数必须与配置一致：
docker run -p 8083:8083 -d manusai-image
