树莓派同时运行Octoprint与Nginx站点的冲突问题咨询

第一步：确认端口占用 #

首先执行以下命令查看80端口的占用进程：
ss -tulpn | grep :80
如果返回结果中进程名是haproxy（OctoPi官方镜像默认带的反向代理服务）或者octoprint，即可确认是80端口被占导致的跳转问题。

可选解决方案 #

方案1：释放80端口给Nginx（配置最简单，适合新手） #

绝大多数情况下是OctoPi镜像自带的HAProxy占用了80端口，按以下步骤修改即可：

• 编辑HAProxy配置文件：sudo nano /etc/haproxy/haproxy.cfg
• 找到配置中bind :80的行，将80改为未被占用的端口，例如8080
• 保存退出后重启HAProxy服务：sudo systemctl restart haproxy
• 重启Nginx服务即可恢复个人网站访问：sudo systemctl restart nginx

修改后OctoPrint的访问地址变为树莓派IP:8080，原80端口完全交给Nginx使用。

方案2：Nginx同时代理个人网站和OctoPrint（适合有域名的场景） #

如果不想修改OctoPrint的访问端口，可以用Nginx做统一反向代理，通过域名或者路径区分两个服务：

1. 首先先修改HAProxy或者OctoPrint的配置，让它们只监听本地127.0.0.1的端口，不要占用公网80端口
2. 给Nginx添加两个站点配置，示例配置参考：

# 个人网站配置
server {
    listen 80;
    server_name your-domain.com; # 替换成你的个人网站域名
    root /var/www/your-site; # 替换成你的网站文件目录
    index index.html index.htm;
}

# OctoPrint配置
server {
    listen 80;
    server_name octo.your-domain.com; # 替换成OctoPrint的专属域名
    location / {
        proxy_pass http://127.0.0.1:5000; # OctoPrint默认本地端口
        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;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

3. 保存配置后执行nginx -t测试配置无误，再执行sudo systemctl restart nginx生效。

安全建议 #

• 不要直接将OctoPrint暴露在公网，远程访问优先使用VPN接入内网访问
• OctoPrint必须设置强密码，同时开启后台的两步验证功能
• Nginx配置中可以给OctoPrint的站点添加IP白名单限制，仅允许信任的IP访问
• 定期执行sudo apt update && sudo apt upgrade更新系统、Nginx和OctoPrint的版本，修复安全漏洞
• 如果站点对公网开放，建议配置SSL证书开启HTTPS，避免账号密码等敏感信息明文传输

内容的提问来源于stack exchange，提问作者ShnoggerHead