Nginx配置子路径代理本地Joplin Server服务异常如何解决

此前尝试的两类配置存在两个核心问题：

• 第一版配置proxy_pass末尾未加斜杠，Nginx默认会将完整的请求路径（包含/joplinServer前缀）直接转发给后端服务，而Joplin Server默认没有适配该子路径，自然无法处理请求。
• 第二版配置在rewrite中写了完整的http://127.0.0.1:22300地址，Nginx会直接向客户端返回302重定向响应，导致用户访问时跳转到本地的127.0.0.1地址，完全无法访问服务。

另外要注意：仅修改Nginx配置无法完全解决问题，Joplin Server本身需要配置基础路径参数，否则服务返回的静态资源、接口路径会默认指向根路径，出现静态资源404、同步失败的问题。

1. 调整Joplin Server启动配置 #

在启动Joplin Server时添加APP_BASE_PATH环境变量，值设置为/joplinServer，告知服务本身运行在子路径下，自动适配所有路由和资源路径：

• 如果是Docker启动，在启动命令中添加参数：-e APP_BASE_PATH=/joplinServer
• 如果是直接运行二进制/Node服务，启动前执行export APP_BASE_PATH=/joplinServer即可

注意：配置前请确认Joplin Server实际监听的端口，问题描述中先后提到23000、22300两个端口，后续Nginx配置中要和实际监听端口保持一致。

2. 修改Nginx配置 #

替换原有joplin相关的location配置为以下内容：

# 处理不带末尾斜杠的访问，自动补全斜杠避免相对路径错误
location = /joplinServer {
    return 301 /joplinServer/;
}

location /joplinServer/ {
    # 注意proxy_pass末尾必须加斜杠，且端口和Joplin实际监听端口一致
    proxy_pass http://127.0.0.1:23000/;
    
    # 基础反向代理头
    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;
    
    # 支持Joplin同步所需的WebSocket连接
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

配置完成后先执行nginx -t检查语法是否正确，确认无误后执行nginx -s reload重载Nginx配置，同时重启Joplin Server让APP_BASE_PATH参数生效即可。如果访问时出现静态资源加载异常，清空浏览器缓存后重试即可。

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