nginx需作为manusai统一https入口网关,通过upstream分别代理前端(5172)、后端api(8000)和ollama(11434),配置ssl、websocket透传及正确路径重写,并验证语法、热重载、端口监听与hosts映射。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

ManusAI本地部署后,前端Web界面(如OpenManus的5172端口)和后端API服务(如Ollama的11434端口、OpenManus的FastAPI服务)通常运行在不同端口且不直接暴露公网,需通过Nginx统一反向代理对外提供HTTPS安全访问,并正确透传WebSocket连接与HTTP请求头。这一步不做,浏览器将无法加载页面或提示502/504错误,用户提交的指令也无法送达本地模型服务。
配置Nginx作为ManusAI统一入口网关
确保Nginx已安装并启用http_ssl_module、http_proxy_module、http_upstream_module模块(主流包管理器安装默认包含)。若从源码编译,需确认configure时含--with-http_ssl_module --with-http_proxy_module。
编辑主配置文件:【/etc/nginx/nginx.conf】,在末尾http块内添加以下内容:
在http块末尾插入:
include /etc/nginx/conf.d/manusai.conf;
编写manusai.conf反向代理配置
创建独立配置文件避免污染主配置:
sudo nano /etc/nginx/conf.d/manusai.conf
填入以下完整配置(适配OpenManus + Ollama默认组合):
upstream manus_frontend {
server 127.0.0.1:5172;
}
upstream manus_backend {
server 127.0.0.1:8000;
}
upstream ollama_api {
server 127.0.0.1:11434;
}
server {
listen 80;
server_name manusai.local;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl http2;
server_name manusai.local;
ssl_certificate /etc/letsencrypt/live/manusai.local/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/manusai.local/privkey.pem;
location / {
proxy_pass http://manus_frontend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /api/ {
proxy_pass http://manus_backend/;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /ollama/ {
proxy_pass http://ollama_api/;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
【注意:/api/ 和 /ollama/ 路径末尾的斜杠 / 必须保留,否则后端路由匹配失败】
验证并启用配置
第一步:检查语法是否合法
sudo nginx -t
第二步:若返回 nginx: configuration file /etc/nginx/nginx.conf test is successful,执行热重载
sudo nginx -s reload
第三步:确认进程监听状态
sudo ss -tlnp | grep ':443\|:80'
看到 nginx: master process 占用443和80端口即表示生效。
第四步:在本地hosts中添加映射(Windows在C:\Windows\System32\drivers\etc\hosts,Linux/macOS在/etc/hosts):
127.0.0.1 manusai.local
第五步:浏览器访问 https://manusai.local —— 页面正常加载且能发送指令即完成。











