配置自定义服务器地址：局域网、公网、DDNS 怎么填

地址格式

http://<IP或域名>:<端口>
https://<域名>:<端口>   # 有 HTTPS 时

去掉最后的斜杠、不要带路径。例如：

• http://192.168.1.100:48488（局域网）
• http://80.123.45.67:48488（公网 IP）
• http://kikoeru.myddns.net:48488（DDNS 域名）
• https://kikoeru.example.com（HTTPS + 80/443 默认端口）

四种地址适用场景

局域网 IP（最常用）

http://192.168.x.x:48488

• 适用：手机和 Kikoeru 服务器在同一个 Wi-Fi 下
• 优点：无流量费、低延迟、不需要公网映射
• 缺点：出门在外连不上

公网 IP + 端口映射

http://<你的公网IP>:48488

• 适用：想在任何网络下都能访问（手机蜂窝数据、公司 Wi-Fi、出差）
• 设置：路由器里做端口转发（外部端口 48488 → 内网 Kikoeru 容器端口 8888）
• 风险：公网暴露意味着全网都能扫到你的 Kikoeru——必须开 JWT 鉴权

DDNS 域名（动态 IP 场景）

http://kikoeru.myddns.net:48488

• 适用：家庭宽带公网 IP 经常变（绝大多数家庭宽带）
• 设置：注册一个 DDNS 服务（花生壳、no-ip 等），把域名绑到你变化的公网 IP
• 优点：IP 变了域名不变，客户端不用重新填地址

HTTPS 域名（最安全）

https://kikoeru.example.com

• 适用：已经有自己的域名、或用 Cloudflare Tunnel / 反代 + Let's Encrypt
• 优点：
• 加密传输，JWT Token 不会被窃听
• PWA 的 Service Worker 能正常工作（HTTPS 是 PWA 的硬性要求）
• 浏览器不会警告"不安全"
• 缺点：配置门槛最高（域名 + 反代 + 证书）

测试连接

几乎所有客户端都有"测试连接"按钮：

• 填完地址先测一下
• 显示连接延迟（局域网应该 < 50ms，公网 < 200ms 可接受）
• 失败的话检查：端口映射、防火墙、JWT Token、URL 是否正确

关于 HTTP vs HTTPS 的安全建议

• 局域网 HTTP 没问题——都是自家设备，风险低
• 公网暴露必须 HTTPS + JWT，哪怕麻烦点也别省
• 最低限度：公网端口只对特定 IP 开放（路由器/Cloudflare 访问规则）