Joplin Server配置端口转发的一个小坑

🌟 问题描述

在配置 Joplin Server 时，遇到了一个关于校园网端口转发的有趣问题。具体表现为：从 Windows 客户端连接时出现 “Invalid origin” 错误。

🔍 问题分析

测试发现：

• 内部端口：连接超时
• 外部端口：返回 HTTP 400 和 Invalid origin 错误

通过 telnet 测试：

telnet localhost 12345  # 连接超时
telnet 10.42.xx.xxx 54321  # 返回 HTTP 400

🎯 解决方案

关键在于理解 Joplin Server 的配置逻辑：

1. 在 .env 文件中：

# 这是外部实际访问的地址（校园网IP）
APP_BASE_URL=http://10.42.xx.xxx:54321

# 这是内部服务监听地址
APP_PORT=12345

2. 在 docker-compose.yml 中：

services:
  joplin:
    ports:
      - "12345:12345"  # 内部服务端口

💡 重要说明

• APP_BASE_URL：必须是外部用户实际访问的 URL（校园网地址）
• APP_PORT：是容器内部服务监听的端口
• Docker 端口映射：确保外部请求能正确路由到内部服务

🌈 经验总结

1. 不要混淆内部访问地址和公共访问地址
2. 正确设置 APP_BASE_URL 是解决 Invalid origin 错误的关键
3. 端口映射要与内部服务端口保持一致
4. 校园网环境下需要特别注意 IP 和端口的正确配置

🚀 参考资料

https://github.com/laurent22/joplin/issues/5300